cedounet 179e8af62e Makefile bugs fix and debug info (#124)
* Update .gitignore

Hide the svg file created during ebook builds and the new directories
after makefile changes

* Fix a makefile variable that stayed in uppercase

* Do not clean ebook systematically anymore

Should be fixed with new way to build ebooks

* Add rule showing version of tools on build machine

This helps with debugging on another machine.. or a build server.

* Add figures/vars.tex to the list of dependencies

Was missing...

* Add a makefile variable print facility

Quite a neat trick, avoids having to add it manually when you debug

* Add a target to print all variables in the makefile

* Fix the src_tables target

typos one s too many...

* Add a makefile variable to run tools in debug mode

Only ebook for now.

* Make default build the serif version of pdf

This is what the documentation said but both serif and sans were built

* Explicit serif in makefile and flattens rules

We had default (serif) and sans, better we have target named after their
fonts family

Flatten them as well so we can build ebooks or sans serif only as we
wish.

Simplified rules tree before:
-----------------------------
all/ bake
    release_serif
        build_pdf
            build_serif_pdf
                book_serif/book.pdf
            build_sans_serif_pdf
                book_sans_serif/book_sans_serif.pdf
        build_ebook
             build_serif_ebook
                epub/book.epub
                    epub/book.mobi
                    epub/book.azw3
             build_sans_serif_ebook
                epub/book_sans_serif.epub
                    epub/book_sans_serif.mobi
                    epub/book_sans_serif.azw3
    release_sans_serif
        build_sans_serif_pdf
            book_sans_serif/book_sans_serif.pdf
        build_sans_serif_ebook
            epub/book_sans_serif.epub
                epub/book_sans_serif.mobi
                epub/book_sans_serif.azw3

Simplified rules tree now:
--------------------------
all: bake
bake:
	release_serif
        build_serif_pdf
            book_serif/book.pdf
        build_serif_ebook:
            epub/book.epub
                epub/book.mobi
                epub/book.azw3
	release_sans_serif
        build_sans_serif_pdf
            book_sans_serif/book_sans_serif.pdf
        build_sans_serif_ebook
            epub/book_sans_serif.epub
                epub/book_sans_serif.mobi
                epub/book_sans_serif.azw3

build_pdf:
    build_serif_pdf
    build_sans_serif_pdf
build_ebook:
    build_serif_ebook
    build_sans_serif_ebook

release_serif:
    build_serif_pdf
    build_serif_ebook

release_sans_serif:
    build_sans_serif_pdf
    build_sans_serif_ebook

* Explicit the dependency on TikZ figures

latexmk figured that out but better if makefile is aware of it as well
2023-06-26 16:03:53 +02:00
2023-06-01 18:49:07 +02:00
2022-01-21 21:43:14 +01:00
2023-06-01 18:49:07 +02:00
2023-06-06 22:31:37 +02:00

The Sourdough Framework

The sourdough framework is an open-source book dedicated to helping you to make the best possible sourdough bread at home.

The book cover

Rather than providing recipes this book intends to provide a framework that enables you to bake bread in your respective environment. Every flour, every sourdough, and every home setup is different. This makes following recipes without background information so hard and a fail-prone endeavor. This book intends to close that gap.

Background

4 years after launching the repositories the-bread-code and pizza-dough I created this project to merge the knowledge together. This project intends to go one step deeper into the workings of natural fermentation. At the same time as many scientific references as possible are provided.

A whole wheat sourdough bread

🍞 Baking the book (Docker)

make

Then you can check out the file book/book.pdf

If you want to 🍞 bake all the versions including ebook formats (.pdf, .epub, .mobi, .azw3) run:

make bake

You can check the files in the folder book/release/

🍞 Baking the book locally (LaTeX)

Make sure you have biber installed. Refer to your system's installation instructions for LaTeX.

cd book/
make

If you want to 🍞 bake all the versions including ebook formats (.pdf, .epub, .mobi, .azw3) run:

cd book/
make bake

You can check the files in the folder book/release/

Compiled versions

The below versions are automatically built on every push to the main branch.

There's an additional enhanced accessibility version using a sans serif font:

Hardcover version

There is a hardcover version of the book available for purchase. You can read more details here.

Support

Did you find a typo, or feel the wording could be improved? Feel free to open up a pull request at any time.

I believe that the knowledge this book provides is essential to everyone. That's why I decided to open source my knowledge hoping that it will reach more people all over the world without budget constraints.

If you would like to contribute with a small donation you can do so via my ko-fi page. Your donation will tremendously help me to cover costs related to running the-bread-code. It furthermore allows me to dedicate time to continuously update and improve this book.

Description
No description provided
Readme CC-BY-SA-4.0 215 MiB
Languages
TeX 87%
Ruby 5.7%
Makefile 3.1%
CSS 2.2%
Roff 1.4%
Other 0.4%