letterpress/README.md
2024-07-23 20:28:18 +02:00

1.7 KiB

letterpress

version

Gutenberg the 💩 out of it!

Letterpress is a project aimed at simplifying the self-publishing process for books.

It provides a ready-to-use template based on AsciiDoctor, catering to authors who need robust support for diagramming, coding examples, and mathematical formulas.

Contributing

Contributions to Letterpress are welcome! If you have suggestions, improvements, or bug fixes, please fork the repository and submit a pull request.

Tools

This Project makes use of the following tools:

Batteries included

Everything you need to get started is included in the package

  • Devcontainers: Allows you to build your book locally
  • GitHub Workflows: Allows you to build your book on GitHub CI
  • Front matter and Back matter setup
  • PDF and EPUB output

Bring your own

  • Content
  • Images

Commands

Generate

In order to generate the PDF and the EPUB versions of the book you can just run:

make

If you just need to generate the PDF:

make output/book.pdf

If you just need to generate the EPUB:

make output/book.epub

Count

make count

Clean

In order to remove the generated files you can run:

make clean

Structure

The entry point of the book is book.adoc.

The book.adoc consists of 3 sections:

The body is where should be placing the main content of your book.