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.
$ 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.
$ 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 firstname.lastname@example.org with the
tralics binary attached and with the result of running the following command:
$ ruby -e 'puts RUBY_PLATFORM'
- Fork it
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Add some feature')
- Push to the branch (
git push origin my-new-feature)
- Create new Pull Request
- Check out the fork
- Add new feature
- 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.