wieerwill/letterpress
1
0
Fork 0
mirror of https://github.com/dunyakirkali/letterpress.git synced 2025-01-22 11:27:00 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
Gutenberg the 💩 out of it!
39 Commits 4 Branches 3 Tags 27 MiB
Makefile 100%
main
Go to file
Dunya Kirkali 1890774875
Enable vale for prose linting (#3) 
* Enable vale in CI

* Add vale config

* Tweak vale

* Update config

* Update .gitignore

* Switch back

* Rename CI

* Add badges

* Tidy up CI

* Change image

* Configure vale

* Delint

* Update README
2024-09-28 22:58:25 +02:00
.devcontainer Switch to official docker image 2024-09-06 19:47:20 +02:00
.github Enable vale for prose linting (#3) 2024-09-28 22:58:25 +02:00
backgrounds Add main structure 2024-06-24 07:23:43 +02:00
figures Improve example 2024-07-07 23:02:46 +02:00
source Enable vale for prose linting (#3) 2024-09-28 22:58:25 +02:00
.editorconfig Add editorconfig 2024-06-15 10:51:17 +02:00
.gitignore Add gitignore 2024-07-07 22:38:05 +02:00
.vale.ini Enable vale for prose linting (#3) 2024-09-28 22:58:25 +02:00
book.adoc Move book.adoc to root 2024-09-06 19:47:31 +02:00
LICENSE Create LICENSE 2024-07-07 00:17:48 +02:00
Makefile Enable vale for prose linting (#3) 2024-09-28 22:58:25 +02:00
metadata.yaml Update metadata 2024-07-07 18:27:10 +02:00
README.md Enable vale for prose linting (#3) 2024-09-28 22:58:25 +02:00

README.md

letterpress

CI CD

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

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

Linting

letterpress comes with vale. Once you've installed vale on your machine you can run it with:

make lint

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.