Commit Graph

61 Commits

Author SHA1 Message Date
cedounet
727cf0a16a Move mixing seed from troubleshooting to mix-ins (#415)
Some checks are pending
Release the book and website / build-and-push-image (push) Waiting to run
Release the book and website / release-book-website (push) Blocked by required conditions
Release the book and website / invalidate-book-website-cache (push) Blocked by required conditions
This was written way before the mix-ins sections, made sense back then
but not so much anymore so moving it out.

formatted text and added centering, labels etc while at it.
2025-01-05 15:46:57 +01:00
Cedric
e9f6dba1f5 Use TikZ temperature plots in the book 2025-01-01 17:27:16 +00:00
Ced
1b99fbe1ca Fix some ortho-typographical problems
- Handle space around etc. correctly
- Use dots when at end of a list makes it more obvious.
2024-06-16 19:09:16 +01:00
cedounet
5ba0b99b4e Remove centering for floats (#364)
This was a bad idea...:
https://tex.stackexchange.com/questions/2651/should-i-use-center-or-centering-for-figures-and-tables

floatrows not sure how it should work with flowcharts... so we use
centring

I don't want to redefine all floats either as we use them for chapters
title page.
2024-05-27 09:55:36 +02:00
Hendrik Kleinwaechter
2e25850994 Fix cold proofing spelling
Not cold proofing but cold-proofing
2024-01-10 17:20:19 +01:00
Hendrik Kleinwaechter
5eea8b8bf8 Text improvements
Adds some text improvements from the book review.
2024-01-10 14:04:59 +01:00
Hendrik Kleinwaechter
e773d561a4 Add note on float test (#318)
The float test is not super reliable - this adds some comments on when
it can work and when it does not.
2023-12-21 00:53:26 +01:00
Hendrik Kleinwaechter
0b24e4fd1a Add improvements 2023-10-26 10:09:00 +13:00
Hendrik Kleinwaechter
4b09656723 Improve overfermentation when retarding a dough
This adds retarding to the glossary and adds a note on how the times can
be effected when starting with a warmer dough. This fixes #248
2023-10-23 21:51:23 -10:00
Hendrik Kleinwaechter
b17de32914 This fixes a few images (#251)
1. I used the wrong image for the liquid starter
2. The picture of hooch is replaced with a new one
2023-10-06 23:40:22 +02:00
Hendrik Kleinwaechter
07edb414e1 Fix image not showing on website 2023-09-08 14:17:18 +02:00
cedounet
233ac8d4c7 Use whole-wheat consistantly (#207) 2023-09-04 10:24:41 +02:00
Niklas Baumgart
edd2845f86 Fixed Typos (#197) 2023-08-27 11:09:20 +02:00
cedounet
3f5f752dbd Wrong flowchart (#195)
* Remove unbreakable spaces in supporters list

That is just too much to ask TeX

* Change environnement to Figure for chem equation

This is not a flowchart...
2023-08-25 15:51:04 +02:00
cedounet
35916c15f7 Add a flowchart environnement and its listof (#188)
* Add a flowchart environnement and its listof

So we can more easily access those flowcharts from pdf and website,
rather than looking in the crowded list of figures.

* Update book/troubleshooting/misc.tex

* Temporarily remove list of flow charts from web version

* Update clean target to deal with listofcharts

* Silent KOMA warnings (#190)

No functional change, but less warnings will help to read the logs.
Good idea anyway to use the key/value scheme

Co-authored-by: Cedric <ced@awase.ostal>

* Fix front-page for one sided printing (#189)

As it is manually placed, is prone to break on evry change of the page
geometry...  This one looks good though in today's conditions.

Co-authored-by: Cedric <ced@awase.ostal>

* Enable micro-typographical improvements (#191)

Few people will notice but this actually brings loads of improvements to
line breaking, handing punctuations etc.

* Revert "Temporarily remove list of flow charts from web version"

This reverts commit 9611b250d2.

* Implement listofflowchart for tex4ht

as per michal suggestion:
https://github.com/michal-h21/tex4ebook/issues/114#issuecomment-1688543095

---------

Co-authored-by: Cedric <ced@awase.ostal>
Co-authored-by: Hendrik Kleinwaechter <hendrik.kleinwaechter@gmail.com>
2023-08-24 09:30:38 +02:00
cedounet
2b90763107 Make each chapter introduction stand out (#179)
* Add bibliography to the ToC

* Add a list of tables at the end of the document

It needed shorter description that would fit.

* Add list of figures

* Add table of figures

* Fix a typo in short figure description

* Make each chapter introduction stand out

Not written for each chapter yet, but checking if that is something we
want.

* Increase numwidth in list of figures

Prevents over-run of figure number and text

* Use semibold in chapters intro

Looks like a good compromise for now.

* Add comments

* Add color coding to flow charts

This will hopefully allow easier reading by identifying start and end
point more easily
2023-08-18 15:30:51 +02:00
cedounet
38ac7c6b11 Add list of table and list of figures (#178)
* Add bibliography to the ToC

* Add a list of tables at the end of the document

It needed shorter description that would fit.

* Add list of figures

* Add table of figures

* Fix a typo in short figure description

* Increase numwidth in list of figures

Prevents over-run of figure number and text
2023-08-18 11:27:16 +02:00
cedounet
7cc71dc6ac Small fixes (#155)
* Fix various typos and references or links

- Misuse of product macro the x sign did not appear
- Use macro for milligrams
- Some refes were without hyperlink for some reason ?
- confusion between section and subsections
- a little grammar.. exact value not absolute, don't think a negative
  amount of flower was ever an option :D

* Use siunitx for temperature everywhere

Apparently some files escaped my script last time, or messed up in git
merge... Anyway fixed now and should be more consistent.

* Simplify Fermentolysis table

I woudl hope this is more clear with less lines.

* Remove double bottomrule

* Fix grammar

* Use correct font familly in preface

Small corrections on font familly and extra space for signature.
TODO: I did not change the paragraph breaking but we might want to
revisit it later.

* Fix wrong percentage range

fixes https://github.com/hendricius/the-sourdough-framework/issues/156
2023-07-21 11:46:33 +02:00
cedounet
f1788ff780 Reorg troubleshooting (#150)
* Reorganize troubleshooting section

- Classified in subcategories hopefully more logically

* Reorganise troubleshooting section step 2

Now put crust debugging later. I am not sure this is fundamental, but
maybe just showing my lack of experience here...

* Improve table of contents

- Use short ToC entry when needed
- Remove extra space now that we do not have large numbers in
  section names anymore
2023-07-14 13:53:26 +02:00
cedounet
58004497bd Chemical eq (#141)
* Update README

- Need latexmk
- How to get limited help on build instuctions

* Rewrite chemical equation

Write it from scratch rather than a pixalated picture
2023-07-09 12:56:49 +02:00
cedounet
17b5ae5f52 Various clean up (#134)
* Fix reference and grammar

* Remove obsolete package

* Use colored links in pdf, black when printed

We can debate the colors to use of course, I left the defaults in.
There are accessibility concerns with colors...

* Add supporter.csv to the list of TeX source

So we rebuild everytime we add a new supporter.

* Inline the list of supporters

Those guys are awesome, but do they really need to be in a table one per
line over 3 pages?

* Explicit figure location

h rarelly works, so making it clear top is also an option.
2023-06-30 11:47:09 +02:00
cedounet
4637c29a37 Use Siunitx package for dealing with units (#129)
It is complicated :
[1] The International System of Units (si), https://www.bipm.org/en/
measurement-units/.
[2] International System of Units from nist, http://physics.nist.gov/cuu/Units/
index.html.

And one will never get it right (space or not, half-space?) nor
consistent so using that instead.

I am not sure how times and hours, when to write digits and when in
letter so I did not change much..

Did not touch the tables as ebooks on github actions seems to break when
you look at them funny.

Co-authored-by: Cedric <ced@awase.ostal>
2023-06-28 20:30:12 +02:00
cedounet
5731a49828 Remove superflous equal sign (#126)
and traling spaces while at it
2023-06-27 11:22:25 +02:00
cedounet
05c33a76b6 Use input figs (#123)
* Make figs includable in main document

Remove the capability to build them as standalone document but we can
include them in the main document.  It should simplify things down the
road.

* Replace tikx pics

* Remove figures compilation from makefile

No need to compile figs to pdf anymore, at least to build the books

* Delete svg figures from ebook build

* Create png for TikZ figures

    - Add export_figures back
    - Build a pdf from the the TikZ in standalone mode
    - Change the cleanup to deal with those changes
    - Remove trailing spaces..

* Replace centering by an environment

More LaTeX idomatic

* Increase clean_figures robustness

as we use temporary tex files (.tex.in) we can't run clean_figures twice in a
row

* Center TikZ figures

Because it looks better

* Remove png building

Seems to struggle on CI with \\\b or something, we don't absolutely need
it right now so let's get rid of it.

* Remove trgt_figures dependency for pdf and ebooks

This should not be needed now that we include the TikZ directly, only
needed for png generation.

* Revert "Remove png building"

This reverts commit fdd542de57.

This is now fine to add the code back, so that it can be debugged when
times come.
2023-06-27 11:07:19 +02:00
cedounet
ca43ef0bd9 Improve typography (#120)
* Add unbreakable space before a reference or a citation

avoids ref to be put on next line or page...

* Add unbreakable space between I and verb

* Remove spacing before footnotes

Also moved it before the final sentence dots in many cases... might need
a review of what is best.  But this is a safe default choice from an
esthetic point of view.

* Improve footnotes and punctuations

Reverse order/kerning especially with sans-serif version.

* Remove manual enumerate

* Fix wording in a citation.

Reads better that way and is shorter.

* Use emph instead of italics

1) Markup semantic not style
2) Will deal with various level of empahasis
3) Was a mix of \it and \textit

* Fix usage of quotes

Also replaced some of then by \emph as it is (IMHO) more visually
pleasant.

* Captitalize before reference

* Correct dashes length

see here:
https://www.merriam-webster.com/words-at-play/em-dash-en-dash-how-to-use

* Remove space before label and homogenize caption

Apparently it can create a wrong reference, if notthing else shuts
texcheck up and cost nothing... so let's do it.

While at it adding a dot at the end of each caption.

* Add missing empty line before signature in preface

* Add a static checker target to makefile

Shall help prevent adding mistakes in new versions
2023-06-12 09:12:22 +02:00
Hendrik Kleinwaechter
61c33e4b60 Spelling fixes + Improvements
Thanks again to Adam Carter for sending me the suggestions!
2023-05-25 16:07:11 +02:00
Hendrik Kleinwaechter
55a9366e78 Improve troubleshooting wording (#96)
* Improved wording around dough sticking

* Provide additional reference with more details

---------

Co-authored-by: Ben <ben@st2projects.com>
2023-05-21 11:32:10 +02:00
Niklas Baumgart
a7a069a688 Fixed duplicate word and spaces (#86)
* Fixed duplicate spaces

* fixed duplicate there
2023-05-19 10:48:40 +02:00
gricardo99
6c6c64f8b4 Fixed the wording of the stiff starter ratios, which should be half of the water, instead of half of the flour (#84) 2023-05-17 09:05:57 +02:00
Niklas Baumgart
f279087c96 Fixed Typos (#79) 2023-05-12 14:19:25 +02:00
Hendrik Kleinwaechter
0b79eb7ada Fix duplicate word
Thanks AC!
2023-05-07 12:07:48 +01:00
Hendrik Kleinwaechter
f8c45ade98 What's the best starter feeding ratio? (#78)
This adds a section looking at the topic of what's the best starter
feeding ratio.
2023-05-06 17:15:09 +01:00
julianscodeword
510da641ab Grammatical corrections as per google drive. (#76) 2023-05-02 17:04:26 +02:00
Hendrik Kleinwaechter
653be70603 Spelling/Instruction improvements (#77)
Some more great feedback by Adam Carter that improves spelling and
clarifies some points. Thanks.
2023-05-02 16:56:12 +02:00
hanclintonnyx
0cac64b681 Suggested text re: chlorinated water. (#74) 2023-04-13 16:36:15 +02:00
hanclintonnyx
d74106758d Proofreading for rest of the book text. (#73) 2023-04-13 16:35:46 +02:00
Hendrik Kleinwaechter
36b9c4c7a9 Add sources (#69)
This adds more sources to some places where I didn't add them before.
2023-03-30 14:07:31 +02:00
Hendrik Kleinwaechter
aa40844691 Fix chemical formula display (#65)
This uses the chemformula package to improve the display of chemical
formulas.
2023-03-30 09:15:32 +02:00
Ralph von der Heyden
5772664bf3 Losslessly recompress ALL THE IMAGES 🗜️🖼️ (#55)
By using the tool ImageOptim:
https://imageoptim.com/

This shaves off some MB of the resulting PDF/ebook files without
sacrificing anything.
2023-03-06 01:19:29 +01:00
Hendrik Kleinwaechter
f572a22427 Add more faq items (#57)
This adds more frequently asked questions and possible troubleshooting.
2023-03-06 01:16:41 +01:00
Hendrik Kleinwaechter
6e97f9bbd0 Screen Readers (#53)
* add tikzcache

* ignore files

* add latexmkrc file

* Move figures to new files

* rename images

* Fix build commands

* Release as epub3 and mobi

* Add cover-image support

* use older epub

* Externalize all tables

* change gh actions command

* fix linux xargs rm
2023-03-02 20:33:25 +01:00
Hendrik Kleinwaechter
918370fb9f FAQ: Starter not rising (#51) 2023-02-25 14:36:34 +01:00
Hendrik Kleinwaechter
f9b3bd4ed0 Stiff/liquid starter FAQ (#50) 2023-02-24 23:03:41 +01:00
Hendrik Kleinwaechter
877b1e9dcb FAQ: Should I autolyse (#49)
This updates the FAQ adding a note on autolysis.
2023-02-24 22:43:29 +01:00
Hendrik Kleinwaechter
2b5aeea1dd Fix flowcharts (#47)
* Replace image with coded flowchart

* Fix flat bread process

* Remove flat bread process image

* Maintenance chart fix

* Fix baking process

* Remove conversion graphic
2023-02-24 17:45:15 +01:00
Hendrik Kleinwaechter
cde8cd58e5 Stretch folds (#35)
* Remove whitespaces

* Add troubleshooting section starter size increase

* Finish stretch and fold chapter
2023-01-06 13:07:21 +01:00
Hendrik Kleinwaechter
f078095cb6 Add troubleshooting: Too sour starter
I was asked on YouTube regarding this. I figured I add another
chapter on the topic in the troubleshooting section.
2022-08-11 11:45:37 +01:00
Hendrik Kleinwaechter
94ed1e9b22 Add troubleshooting: Dough tears (#8)
This adds a new section into the troubleshooting section looking at
why a dough tears after a too long period of time.
2022-06-18 11:45:41 +02:00
Hendrik Kleinwaechter
c11243eaa9 Fix typo 2022-06-18 10:13:15 +01:00
Hendrik Kleinwaechter
0129f2f17d Add chewy crust chapter 2022-04-29 14:36:40 +02:00