{"id":13469107,"url":"https://github.com/hendricius/the-sourdough-framework","last_synced_at":"2025-05-15T11:05:13.677Z","repository":{"id":37041191,"uuid":"450634273","full_name":"hendricius/the-sourdough-framework","owner":"hendricius","description":"Open source book dedicated to helping you to make the best possible sourdough bread at home.","archived":false,"fork":false,"pushed_at":"2025-03-26T23:05:47.000Z","size":211627,"stargazers_count":3235,"open_issues_count":23,"forks_count":157,"subscribers_count":42,"default_branch":"main","last_synced_at":"2025-04-10T00:15:46.075Z","etag":null,"topics":["baking","bread","cooking","sourdough"],"latest_commit_sha":null,"homepage":"https://breadco.de/book","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-sa-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hendricius.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-01-21T20:43:13.000Z","updated_at":"2025-04-09T20:21:11.000Z","dependencies_parsed_at":"2024-05-30T10:28:14.610Z","dependency_job_id":null,"html_url":"https://github.com/hendricius/the-sourdough-framework","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hendricius%2Fthe-sourdough-framework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hendricius%2Fthe-sourdough-framework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hendricius%2Fthe-sourdough-framework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hendricius%2Fthe-sourdough-framework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hendricius","download_url":"https://codeload.github.com/hendricius/the-sourdough-framework/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248131315,"owners_count":21052819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["baking","bread","cooking","sourdough"],"created_at":"2024-07-31T15:01:26.663Z","updated_at":"2025-04-10T00:16:07.144Z","avatar_url":"https://github.com/hendricius.png","language":"TeX","funding_links":[],"categories":["TeX","The projects","others","Cookbooks","Baking"],"sub_categories":[],"readme":"# The Sourdough Framework\n\nThe sourdough framework is an open-source book dedicated to\nhelping you to make the best possible sourdough bread at home.\n\n![The book cover](book/cover/cover-page.jpg)\n\nRather than providing recipes this book intends to provide a\nframework that enables you to bake bread in your respective\nenvironment. Every flour, every sourdough, and every home setup\nis different. This makes following recipes without background\ninformation so hard and a fail-prone endeavor. This book\nintends to close that gap.\n\n## Background\n\n4 years after launching the repositories [the-bread-code](https://github.com/hendricius/the-bread-code)\nand [pizza-dough](https://github.com/hendricius/pizza-dough) I\ncreated this project to merge the knowledge together. This\nproject intends to go one step deeper into the workings of\nnatural fermentation. At the same time as many scientific references\nas possible are provided.\n\n![A whole wheat sourdough bread](./book/images/whole-wheat-crumb.jpg)\n\n\n## 🍞 Baking the book (Docker)\n\n```console\nmake\n```\n\nThen you can check out the file `book/book.pdf`\n\nIf you want to 🍞 bake all the versions including ebook variants (.pdf, .epub\nin colour and size optimized Black\u0026White), run:\n\n```console\nmake bake\n```\n\nYou can check the files in  the folder `book/release/`\n\n## 🍞 Baking the book locally (LaTeX)\n\nMake sure you have `biber`, `latexmk` and ``ImageMagick`` installed. Refer to\nyour system's installation instructions for LaTeX. To create the serif .pdf\nformat, run:\n\n```console\ncd book/\nmake\n```\n\nIf you want to 🍞 bake all the versions including ebook variants (.pdf, .epub\nin colour and size optimized Black\u0026White, as well as website), run:\n\n```console\ncd book/\nmake -j bake\n```\n\nYou can check the files in the folder `book/release/`\n\nPlease note that while everything should build without any errors but you will get a fair amount of warnings, especially when building the ebook/website. \n\nYou can get some help on building various versions with:\n\n```console\ncd book/\nmake help\n```\n## Compiled versions\n\nThe below versions are automatically built on every push to the `main` branch.\n\n* [Download compiled .pdf version](https://www.the-bread-code.io/book.pdf)\n* [Download compiled .epub version](https://www.the-bread-code.io/book.epub)\n\nThere's an additional enhanced accessibility version using a sans-serif font:\n\n* [Download compiled sans-serif .pdf version](https://www.the-bread-code.io/book-sans-serif.pdf)\n\nAn additional black and white ebook is provided with a greatly reduced file\nsize. This shrinks the book from more than 20MB down to ~5MB:\n\n* [Download compiled B\u0026W .epub version](https://www.the-bread-code.io/bw-book.epub)\n\nFor those who prefer a concise reference (about 15 pages), we offer a \"too long;didn't read\" (TL;DR)\nversion. This condensed guide contains the essential flowcharts, crucial information,\nand space for your notes - perfect for quick kitchen reference.\nIt provides the key information you need without reading the complete book.\n\n* [Read TL;DR version on your device](https://the-bread-code.io/book-tldr-digital.pdf)\n* [Download TL;DR version for printing](https://the-bread-code.io/book-tldr-print.pdf)\n\nWe recommend using double-sided printing if your printer supports it.\n\n## Online HTML version\n\nHead over to [https://www.the-sourdough-framework.com](https://www.the-sourdough-framework.com)\n\nTo build the website make sure to have the ruby version installed specified in\n`website/.ruby-version`.\n\n```console\ncd book/\nmake website\n```\n\nAlternatively you can build the website directly with Docker:\n\n```console\nmake website\n```\n\n## Hardcover version\n\nThere is a hardcover version of the book available for purchase. [You can\nread more details here.](https://breadco.de/physical-book)\n\n## Support\n\nDid you find a typo, or feel the wording could be improved?\nFeel free to open up a pull request at any time.\n\nI believe that the knowledge this book provides is essential to everyone.\nThat's why I decided to open source my knowledge hoping\nthat it will reach more people all over the world without\nbudget constraints.\n\nIf you would like to contribute with a small donation you can do so\nvia my [ko-fi page.](https://breadco.de/book) Your donation will tremendously\nhelp me to cover costs related to running the-bread-code. It furthermore allows\nme to dedicate time to continuously update and improve this book.\n\n## Links\n\n* [My YouTube channel](https://youtube.com/c/thebreadcode)\n* [Ask a question on Discord](https://breadco.de/discord)\n\n## License\n\nThis work is licensed under a [Creative Commons Attribution-ShareAlike 4.0\nInternational License][cc-by-sa].\n\n[![CC BY-SA 4.0][cc-by-sa-image]][cc-by-sa]\n\n[cc-by-sa]: http://creativecommons.org/licenses/by-sa/4.0/\n[cc-by-sa-image]: https://licensebuttons.net/l/by-sa/4.0/88x31.png\n[cc-by-sa-shield]: https://img.shields.io/badge/License-CC%20BY--SA%204.0-lightgrey.svg\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhendricius%2Fthe-sourdough-framework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhendricius%2Fthe-sourdough-framework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhendricius%2Fthe-sourdough-framework/lists"}