shuttleworthfoundation / shuttleworth-foundation-shades-of-green

Book about the Shuttleworth Foundation

The Electric Book Jekyll template

A Jekyll template for creating books in multiple formats:

• print PDFs for high-end book publishing
• screen PDFs for reading on screen
• a website of books
• epubs for ebook distribution
• ebook apps for Android and iOS
• MS Word outputs for old-school editing.

Usage and documentation

1. Copy or clone this folder
2. Edit as needed:
   • _data/meta.yml
   • the stylesheet variables in book/styles
   • the content files in book/text
3. Run the run- script for your operating system.

Read the guide for much more. The guide is also an example of the template in action.

Dependencies

To use the Electric Book template on your machine, you need to have installed:

• Jekyll (and which requires Ruby and Bundler)
• PrinceXML (for PDF output; the only proprietary requirement)
• PhantomJS (to generate search indexes for web and app outputs)
• Node.js, Gulp and GraphicsMagick (to create multiformat images)
• Pandoc (for Word export)
• Cordova, Android Studio, and (on OSX) XCode (for building ebook apps)

And of course a good editor like Sublime, Brackets or Atom.

shuttleworth-foundation-shades-of-green's Issues

Design pullquote-image feature

In PR #3 these were added as figure includes, and placed as close as possible to where they appear in the original print version.

Pullquote text is within the 'caption' field of the include.
The person being quoted is within the 'source' field of the include.

A class of pullquote has been added within each include.

Revisions to print design

• In the original manuscript, the numbers in the ordered lists use the same font as the headings
• In the original manuscript, some of the unordered lists had different bullets that looked like >>

Text overflows pullquote image for screen 'min-width: 600px'

When the screen width is "min-width: 600px" (not sure which screen size this equates to in the CSS) the text of the pullquote in 01-02.html overflows the image and makes it impossible to click the green next arrow. I have tested all of the other pullquotes at all widths and the text remains within the image bounds for all of them, this is the only one that is too long.

Originally posted by @LouiseSteward in #5 (comment)