Skip to content

CLI for book generation, building, and publishing to softcover.io

License

Notifications You must be signed in to change notification settings

softcover/softcover

Repository files navigation

Softcover

Coverage Status

Softcover is an ebook typesetting system for technical authors. This is the main gem, softcover, which depends on polytexnic to convert Markdown or PolyTeX input to HTML and LaTeX, and thence to EPUB, MOBI, and PDF. Authors can use Softcover to publish and optionally sell the resulting ebooks (as well as associated digital goods such as screencasts) on the Softcover publishing platform.

For more details about Softcover, see The Softcover Book.

Installation

$ gem install softcover

On some systems, you may need to add an extra option to handle SSL correctly:

$ gem install softcover -- --with-cppflags=-I/usr/local/opt/openssl/include

Then install the dependencies as described here.

Usage

Run

$ softcover help

for a list of supported commands.

Adding a precompiled binary

We would like Softcover to support as many systems as possible. If you needed to compile your own tralics binary (see here) and would like to contribute it back to the project, please send an email to michael@softcover.io with the tralics binary attached and with the result of running the following command:

$ ruby -e 'puts RUBY_PLATFORM'

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Local Development

  1. Check out the fork
  2. Add new feature
  3. Install it locally with bundle exec rake install

Once your changes are implemented, please update the documentation in the Softcover manual and make another pull request there.