mirror of
https://github.com/hendricius/the-sourdough-framework
synced 2025-11-08 20:21:12 -06:00
126 lines
3.8 KiB
Markdown
126 lines
3.8 KiB
Markdown
# The Sourdough Framework
|
|
|
|
The sourdough framework is an open-source book dedicated to
|
|
helping you to make the best possible sourdough bread at home.
|
|
|
|
|
|
|
|
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](https://github.com/hendricius/the-bread-code)
|
|
and [pizza-dough](https://github.com/hendricius/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.
|
|
|
|
|
|
|
|
|
|
## 🍞 Baking the book (Docker)
|
|
|
|
```console
|
|
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:
|
|
|
|
```console
|
|
make bake
|
|
```
|
|
|
|
You can check the files in the folder `book/release/`
|
|
|
|
## 🍞 Baking the book locally (LaTeX)
|
|
|
|
Make sure you have `biber` and `latexmk` installed. Refer to your system's
|
|
installation instructions for LaTeX. To create the serif .pdf format, run:
|
|
|
|
```console
|
|
cd book/
|
|
make
|
|
```
|
|
|
|
If you want to 🍞 bake all the versions including ebook formats (.pdf, .epub, .mobi, .azw3) run:
|
|
|
|
```console
|
|
cd book/
|
|
make bake
|
|
```
|
|
|
|
You can check the files in the folder `book/release/`
|
|
|
|
You can get some help on building various versions with:
|
|
|
|
```console
|
|
cd book/
|
|
make help
|
|
```
|
|
## Compiled versions
|
|
|
|
The below versions are automatically built on every push to the `main` branch.
|
|
|
|
* [Download compiled .pdf version](https://www.the-bread-code.io/book.pdf)
|
|
* [Download compiled .epub version](https://www.the-bread-code.io/book.epub)
|
|
* [Download compiled .mobi version](https://www.the-bread-code.io/book.mobi)
|
|
* [Download compiled .azw3 version](https://www.the-bread-code.io/book.azw3)
|
|
|
|
There's an additional enhanced accessibility version using a sans serif font:
|
|
|
|
* [Download compiled .pdf version](https://www.the-bread-code.io/book-sans-serif.pdf)
|
|
* [Download compiled .epub version](https://www.the-bread-code.io/book-sans-serif.epub)
|
|
* [Download compiled .mobi version](https://www.the-bread-code.io/book-sans-serif.mobi)
|
|
* [Download compiled .azw3 version](https://www.the-bread-code.io/book-sans-serif.azw3)
|
|
|
|
## Online HTML version (WIP)
|
|
|
|
Head over to [https://www.the-sourdough-framework.com](https://www.the-sourdough-framework.com)
|
|
|
|
To build the website make sure to have the ruby version installed specified in
|
|
`website/.ruby-version`.
|
|
|
|
```console
|
|
cd book/
|
|
make website
|
|
```
|
|
|
|
Alternatively you can build the website directly with Docker:
|
|
|
|
```console
|
|
make website
|
|
```
|
|
|
|
## Hardcover version
|
|
|
|
There is a hardcover version of the book available for purchase. [You can
|
|
read more details here.](https://breadco.de/physical-book)
|
|
|
|
## 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.](https://breadco.de/book) 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.
|
|
|
|
## Links
|
|
|
|
* [My YouTube channel](https://youtube.com/c/thebreadcode)
|
|
* [Ask a question on Discord](https://breadco.de/discord)
|