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: 5 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 (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2017-09-21T12:23:35.000Z (over 8 years ago)
- Last Synced: 2025-01-26T03:45:32.220Z (over 1 year 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