Thinkertoys Ebook Pdf Template

Posted on by  admin

Download PDF Books Thinkertoys: A Handbook of Creative-Thinking Techniques By - Michael Michalko.Full Pages. Download PDF Books To Selena, with Love By - Chris Perez.Full Books. Download PDF Books Tunnel Engineering Handbook By - Thomas R. Kuesel.Read Online.

This is a new version of the classic template for eBooks. You can use thiscode to kickstart your writing project from scratch.

Design Guidelines

Why using such a complex setup instead of just using a simpler tool likeWord or Pages?

The primary motivation of this template is versioning. Being able to useplain text files as input for the book brings the possibility ofversioning each change individually using Git, Subversion or any othersimilar tool. This also opens up the door to collaboration among teammembers when editing a document.

The second motivation is to separate the presentation and the layout ofthe final book from its contents. Other output file types could be addedin the future.

This also brings the possibility of using any text editor in just aboutany operating system; files are just plain text files that can be editedwith gEdit, Notepad, Emacs, Vim, TextEdit, or any other similar tool.

Markup languages like Markdown or Asciidoc (used in this template) aresimpler and more readable than LaTeX or other SGML-like languages, makingthe files readable and lean even when edited in a text editor without anysyntax highlighting or formatting support.

Finally, being able to streamline the creation of the three versions ofthe book in just one command-line operation allows the whole setup to beautomatized.

The choice of Asciidoctor comes from the followingfeatures:

  • Syntax highlighting of Swift andKotlin code in all outputs(Pandoc does not support Swift at the moment.)

  • Multi-file projects (Pandoc, because of Markdown, does not support theinclude mechanism that AsciiDoc provides.)

History

This toolkit started as a pure LaTeX workflow in 2009. In late 2011 thesystem moved to Markdown and it used Pandoc to generate the artifacts. In2012 the choice was AsciiDoc, and in 2016 this newsystem was finally developed, using AsciiDoctor.

Thinkertoys Ebook Pdf Templates

How To Use

The master.asciidoc file at the root of this project provides theguiding structure of the book. Chapters can be shuffled around,independently of their contents or internal structure.

Individual chapters are stored in the chapters folder, one file perchapter.

Images are stored as PNG files in the images folder. Data files (XML,CSV, etc,) are located in the data folder.

The Makefile creates a temporary _build folder, copies all the differentelements in it (the master file, the chapters and the images) and commandsthe execution of the whole toolchain in order to get the final result:

  • Unix man page

  • Self-contained HTML5

  • PDF

  • EPUB3

  • Kindle (.mobi)

Ebook

UML diagrams are generated by text through PlantUML.

  1. Execute the make command. This will create the PDF, ePub and HTMLversions of the book.

  2. make pdf, make html, make epub and make kindle each generatethe specified version of the booklet.

  3. make clean removes the _build folder.

After the build process completes, the compiled eBooks will be availableat the _build subfolder.

Requirements and Installation Instructions

This section explains the different required libraries, for both macOS andUbuntu Linux.

macOS (Sierra)

Before using this template, make sure to have Homebrew and Rubygems installed,then run the following commands to install the required dependencies:

Install the font dependencies for asciidoctor-mathematical:

If you experience compilation problems with asciidoctor-mathematical you canbrew link gettext --force if needed. Follow the installation instructions fromthe project in case ofissues.

Ubuntu Linux (16.04/16.10/18.04)

[Unfortunately](https://github.com/asciidoctor/asciidoctor-epub3/issues/179)the current versions of Asciidoctor on Ubuntu exhibit a weird behaviour whenusing asciidoctor-diagram during the generation of EPUB output.

Docker

The project includes a Dockerfile which can be built using the followingcommand:

Once built, the Docker container can be used as follows on the local folderwhere the Makefile is located:

License

Comments are closed.