ePub production of MightyOhm's FullSolderComic
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
e-book
original-images
.DS_Store
FullSolderComic_EN.pdf
LICENSE.md
README.md

README.md

FullSolderComic-ebook

Download the latest release of the ePub by going to the releases section of this repository.

Overview:

This is an ePub production of MightyOhm's soldering tutorial comic Solder is Easy: Here's How to Do It at (http://mightyohm.com/blog/2011/04/soldering-is-easy-comic-book/).

E-book:

I have provided an ePub and the code needed to recreate it, feel free to use the code for your own projects as per the licenses stated below.

The e-book currently passes epubcheck 4.0.2 with No errors or warnings detected. and looks pretty good in Google Books, iBooks and Adobe Digital Editions. However the images need consistent borders, so at some point I'll re-crop them.

Compiling:

A new ePub file can be made by using the provided CreateE-book.py via installing Python 3 and then running the script on IDLE, Thonny or the python3 CreateE-book.py command on the macOS/GNU-Linux Terminal. The script however does not work with Python 2 and I have no plans to backport.

The ePub's compliance to the standard can be verified using the supplied epubcheck by running java -jar epubcheck.jar FullSolderComic.epub.

I recommend combining these commands as python3 CreateE-book.py && java -jar epubcheck.jar FullSolderComic.epub.

XHTML, CSS and the metadata.json files can be edited using a text editor such as Atom and Notepad++.

The toc.ncx and content.opf are generated by the CreateE-book.py and shouldn't be edited as they would be overwritten.

Licensing:

The e-book's content such as text and images are licensed under the Creative Commons Attribution-ShareAlike 4.0 International Public License (CC BY-SA 4.0).

The e-book's XHTML, CSS and JSON code is licensed under CC0 1.0 Universal (CC0 1.0) Public Domain Dedication.

ebookbuild's Python code is licensed under GNU General Public License v3.0 (GNU GPLv3).

epubcheck itself is licensed under the 3-Clause BSD License, though its dependencies use the Mozilla Public License Version 1.0 (MPL) and Apache License 2.0. See e-book/readme+licenses for a full list of contributors and a readme specifically for epubcheck.