Project

softcover

0.21
A long-lived project that still receives updates
Command-line interface for softcover.io
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

= 1.0.5
= 0.9.5
~> 1.10
= 4.2.11.3
= 1.15.2
= 6.0.1
= 2.4.0
= 3.7.1
= 0.7.3
= 1.2.10
= 1.4.8
= 1.6.4
= 1.2.2
 Project Readme

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.