Creative Commons Attribution Share Alike 4.0 International

项目介绍

hendricius/the-sourdough-framework 是一个托管在 GitHub 上的开源项目,主要使用 TeX 编写,采用 Creative Commons Attribution Share Alike 4.0 International 许可证,目前获得 3.6k 个 Star、193 次 Fork。

仓库全名
hendricius/the-sourdough-framework
开源许可证
Creative Commons Attribution Share Alike 4.0 International
Star 数
3.6k
Fork 数
193
未关闭 Issue
27

README 摘要

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…

完整内容见 GitHub 原始 README 或本页 。

常见问题

the-sourdough-framework 用什么语言开发?

主要使用 TeX 编写,采用 Creative Commons Attribution Share Alike 4.0 International 许可证,目前有 3.6k 个 Star。

the-sourdough-framework 可以免费商用吗?

仓库标注的许可证为 Creative Commons Attribution Share Alike 4.0 International,商用前请先阅读仓库 LICENSE 文件确认授权范围。

如何获取 the-sourdough-framework 的源码?

可以直接克隆仓库:git clone https://github.com/hendricius/the-sourdough-framework.git;安装与运行步骤见仓库 README。

the-sourdough-framework 最近还在维护吗?

仓库最近一次更新为 2 周前,当前有 27 个未关闭 Issue;Star 数为 3.6k,可作为社区活跃度的参考。

关于

GitHub 原始描述(英文)

Open source book dedicated to helping you to make the best possible sourdough bread at home.

描述取自 GitHub 官方 API,保持仓库作者书写的原文。

简要分析

热度分
4076
价值分
2246
活跃状态
活跃

语言占比

CSS
Dockerfile
JavaScript
Makefile
Python
Roff
Ruby
Shell
TeX

README

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 variants (.pdf, .epub in colour and size optimized Black&White), run:

make bake

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

🍞 Baking the book locally (LaTeX)

Make sure you have biber, latexmk and ImageMagick installed. Refer to your system’s installation instructions for LaTeX. To create the serif .pdf format, run:

cd book/
make

If you want to 🍞 bake all the versions including ebook variants (.pdf, .epub in colour and size optimized Black&White, as well as website), run:

cd book/
make -j bake

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

Please note that while everything should build without any errors but you will get a fair amount of warnings, especially when building the ebook/website.

You can get some help on building various versions with:

cd book/
make help

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:

An additional black and white ebook is provided with a greatly reduced file size. This shrinks the book from more than 20MB down to ~5MB:

For those who prefer a concise reference (about 15 pages), we offer a “too long;didn’t read” (TL;DR) version. This condensed guide contains the essential flowcharts, crucial information, and space for your notes - perfect for quick kitchen reference. It provides the key information you need without reading the complete book.

We recommend using double-sided printing if your printer supports it.

Online HTML version

Head over to https://www.the-sourdough-framework.com

To build the website make sure to have the ruby version installed specified in website/.ruby-version.

cd book/
make website

Alternatively you can build the website directly with Docker:

make website

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.

Citation

If you use or cite this book, please use the metadata in CITATION.cff (GitHub’s “Cite this repository” button uses it). Plain text:

Kleinwächter, H. (2022). The Sourdough Framework. The Bread Code. https://www.the-sourdough-framework.com

License

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

CC BY-SA 4.0

评论

暂无评论