Openstax Import for Pressbooks

Description

Adds an option to the Pressbooks import tool named Zip (OpenStax zip file). This new option asks for a link of the OpenStax Zip file. (You can get the link from the downloads section of the OpenStax book you’d like to import.)

Primary Use Case

This plugin was built primarily to support the creation, remixing, and distribution of open textbooks.

Development Sprint

The inspiration for this plugin came from wanting to improve our own process for bringing in OpenStax Textbooks;
a laborious affair. In the fall of 2016 a Development Sprint was held in Houston at Rice University. One of the goals of the sprint
was to be able to find a programmatic solution to the problem of converting equations during the import process. The XSL files
by Vasil Yaroshevich are the key component used to convert equations to something that can be rendered in Pressbooks. While I was only able to
attend the sprint for a couple days remotely, would like to acknowledge the work that other people did at that sprint.

Screenshots

  • This new option asks for a link of the OpenStax Zip file

Installation

IMPORTANT!

You must first install Pressbooks. This plugin won’t work without it.
The Pressbooks github repository is updated frequently. Stay up to date.

ALSO IMPORTANT!

The value of this plugin is it’s ability to transform MathML to LaTeX. Rendering that LaTeX in the browser requires a separate piece of functionality. The best results for rendering LaTeX equations in the browser is with WP QuickLaTeX. For best results, use that plugin and activate at the book level. The built-in LaTeX rendering functionality in Pressbooks still works, but does not have as robust support for multi-line equations.

FAQ

Installation Instructions

IMPORTANT!

You must first install Pressbooks. This plugin won’t work without it.
The Pressbooks github repository is updated frequently. Stay up to date.

ALSO IMPORTANT!

The value of this plugin is it’s ability to transform MathML to LaTeX. Rendering that LaTeX in the browser requires a separate piece of functionality. The best results for rendering LaTeX equations in the browser is with WP QuickLaTeX. For best results, use that plugin and activate at the book level. The built-in LaTeX rendering functionality in Pressbooks still works, but does not have as robust support for multi-line equations.

What is an Open Textbook?

Open Textbooks are open educational resources (OER); they are instructional resources created and shared in ways so that more people have access to them.
OER are defined as “teaching, learning, and research resources that reside in the public domain or have been released under an intellectual property license that permits their free use and re-purposing by others” (Hewlett Foundation).

Contributors & Developers

“Openstax Import for Pressbooks” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

See: https://github.com/BCcampus/pressbooks-openstax-import/commits/dev for more detail

1.1.1 2018/04/06

  • fix upload zip file functionality

1.0.1 2018/03/15

  • minor update to label
  • add PB compatibility declaration

1.0.0 2018/02/27

  • compatibility with PB 5

1.0.0-rc.1 2018/02/23

  • compatibility with PB 5

0.1.3 2017/10/26

  • fixed an issue where front-matter and back-matter were not importing
  • modified autogenerated [link] text to (Figure)
  • changed network admin notice, better to activate WP QuickLaTeX at book level
  • removed chapter metadata from import

0.1.0 2017/08/30

  • initial release…early, often

0.1.0-RC1

  • Release Candidate
  • Will work with >= v4.0.0 of Pressbooks