Skip to content
This repository has been archived by the owner on Jan 3, 2018. It is now read-only.

Add EPUB version of lessons (build with pandoc) #435

Merged
merged 7 commits into from
Jun 29, 2014

Conversation

rgaiacs
Copy link

@rgaiacs rgaiacs commented Apr 11, 2014

This is a work in progress. Don't merge it.

This add a entry in Makefile to build EPUB(2) from _site/book.html:

$ make epub

Problem: pandoc will not include HTML classes from _site/book.html into EPUB (more information at jgm/pandoc#1052).

@rgaiacs rgaiacs changed the title Add printed version of lessons (build with pandoc) Add EPUB version of lessons (build with pandoc) Jun 13, 2014
@rgaiacs
Copy link
Author

rgaiacs commented Jun 13, 2014

Need small fixes before be ready for merge:

epub-python

epub-sql

epub-gloss

  • Avoid duplicate id (e.g. challenges)

Others screenshots:

epub-shell

Note: the previous screenshot shows a bug at ebook-viewer from calibre already reported.

epub-toc

Help test it

If you can, please help test the EPUB at the devices and/or softwares that you have. For this you can download the EPUB from https://r-gaia-cs.github.io/bc/book.epub.

@rbeagrie
Copy link
Contributor

Just had a flick through the book using "UB Reader" on my android phone. Looks good to me! All the image embeds seem to have worked fine. Just a few minor points I spotted:

  • The list of team names on page 8 is formatted a little odd. Each person's first and last names are on different lines, and the list as a whole flows over the end of the page without breaking, so I can't read them all.
  • Some tables are formatted as lists, with each field on a new line (table of licences page 69, table of file permissions page 162, table of floats page 177)
  • SQL output on page 122 and the rest of the SQL chapter has all fields in a single row formatted as one word with no spaces, and tab separation between different rows, e.g. identpersonalfamily dyerWilliamDyer
  • Code blocks everywhere do not wrap, and simply flow off the edge of the page. Not sure if this is just an issue with my reader but I found a possible solution here

Raniere Silva added 7 commits June 28, 2014 18:27
Originally the glossary is available at
http://software-carpentry.org/v5/gloss.html but for
http://software-carpentry.org/v5/book.html it is already
available at the same page. So we could change the links
pointing to glossary to the book.

This change is necessary to to avoid problems when creating
the EPUB and PDF version of our lessons.
- Improve to handle err class
- Improve pandoc support
Update Markdown files based on previous commit changes at template.

Built with

    $ python --version
    Python 2.7.7
    $ ipython --version
    2.1.0
- Makefile for EPUB
- Metadata for EPUB
- CSS for EPUB
- Post-processor for EPUB building stack

  When converting HTML to EPUB using pandoc we lose the
  anchors at glossary.  This PR add a post-processor to
  restore this anchors.

  This close swcarpentry#550.
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants