https://github.com/jd/asciidoc-book-toolchain

Book publishing toolchain based on AsciiDoc
https://github.com/jd/asciidoc-book-toolchain

asciidoc books publishing toolchain

Last synced: about 2 months ago
JSON representation

Book publishing toolchain based on AsciiDoc

• Host: GitHub
• URL: https://github.com/jd/asciidoc-book-toolchain
• Owner: jd
• Created: 2016-09-05T14:32:15.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2017-09-21T12:23:35.000Z (over 7 years ago)
• Last Synced: 2024-10-14T21:12:57.545Z (3 months ago)
• Topics: asciidoc, books, publishing, toolchain
• Language: XSLT
• Size: 5.23 MB
• Stars: 123
• Watchers: 9
• Forks: 19
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• my-awesome-github-stars - jd/asciidoc-book-toolchain - Book publishing toolchain based on AsciiDoc (XSLT)

README

        
# AsciiDoc Book Toolchain

This repository contains a basic toolchain used to publish book using

[AsciiDoc]. It compiles the book down to:

  - HTML

  - PDF

  - PDF (printable)

  - ePub

  - MOBI

This toolchain has been created and is used in the first place to publish

[The Hacker's Guide to Python].

# Required software

- [AsciiDoc]

- Xetex

- [Calibre]

- [Ghostscript]

- [Docbook]

If you run on a Fedora system, just run the `deps` target of the makefile as root to install them like in :

 - sudo make deps

## Usage

The book content should be written in the `book.txt` source file. Once you've

made some change you can recompile all the output formats by typing `make`, or

selecting each one you want by typing `make book.`: such as:

  - `make book.pdf`

  - `make book.epub`

  - `make book.mobi`

  - `make book.html`

  - `make book.printable.pdf`

## Difference between the normal and printable PDF

The `Makefile` generates two different PDF format. The first one named

`book.pdf` is for the electronic version of the book, and embed the cover

image. The second one, named `book.printable.pdf` is intended to be printed on

paper, so it does not include the cover and have slightly different dimensions.

   [AsciiDoc]: 

   [The Hacker's Guide to Python]: 

   [Calibre]: https://calibre-ebook.com/

   [Ghostscript]: http://www.ghostscript.com/

   [Docbook]: https://pypi.python.org/pypi/docbook