Commit Graph

35 Commits

Author SHA1 Message Date
cedounet
24a9f5c31e Booklet (#362)
* Initial support for building a booklet

This is really WIP but add support in the makefile for building another
book from the same source.

As the target name suggests, it will be a TL;DR version of the
framework.

* Extract recipes in their own tex file (flat bread)

In order to reuse recipes in the booklet, we need to extract them in
their own tex file sourced by both.

* Add clean and quick targets for booklet

* Initial version of the booklet

Very very WIP, ugly as but need to start somewhere.

* Update the booklet

- Add pics
- Change layout

* Update makefile for booklet

- Add help target
- Follow naming conventions for target

* Remove non-wheat Bread

* Pack the picture together and fix captions

Takes less place, looks better, only good things...

* Remove labels

* Reorder figs and pics more logically

* Fix the fill-yourself baker math table

Much nicer and add rooms for comments

* Center pics and flowcharts and fix indentation

* Add booklet to all target

It will also be part of the release

* Reduce dependencies for booklet

not perfect but better, will avoid rebuild every tiem we work on the
text itself :)

* Add the booklet to the README

* Add docker entry, fix typo

* Add making sourdough starter

---------

Co-authored-by: Hendrik Kleinwaechter <hendrik.kleinwaechter@gmail.com>
2024-05-29 07:49:53 +02: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
Kevin Dungs
a3e94d26d6 Prevent reference from bleeding into the margin.
Because the namedref to the "Wheat sourdough" chapter is not broken up
on space by LaTeX, it bleeds into the margin.

Also: fix quotation marks and capitalization of "chapter".
2024-01-30 21:03:43 +00:00
Kevin Dungs
a037ae43f2 Fix tiny typo in bread types. (#339) 2024-01-29 09:43:50 +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
4572a8b17b Book changes after reading through physical book (#322)
* Add word

* Add W-value

* Add note for wheat

* Specify

* Lowercase

* Add dry out note

* Add levain

* Add note

* Add bassinage

* Add ali

* Use qty/gram

* Add proofing

* Add fridge proofing

* Add apple

* Add more links, remove BG

* Update bread-types.tex
2024-01-04 09:23:19 +01:00
Cedric
33c0f71a5e Fix broken links 2023-12-10 18:09:40 +00:00
cedounet
4b4d80d231 Bread types (#301)
* Review bread types chapter

* Fine tune bread tables

* Collect all flat bread into one section

Makes more sense to have it all within a section.

* Correct typos in bread types chap.

gasses is less ambigous than gases even if correct.

* Remove uppercases

More consistent withe the rest of the text.

* Rewrite bread type intro

* Rewrite some of the flatbread section

there is a lot of repetition though..

---------

Co-authored-by: Cedric <ced@awase.ostal>
2023-12-10 17:54:22 +01:00
cedounet
78628adc3c Correct LaTeX crime (#233)
* Add missing pic dependency on quick_ebook target

* Correct crime against LaTeX

Mostly proper use of LaTeX and one word changed.  Moving forward we
could have a proper recipe environment so we have also a listofrecipe
at the end in the pdf/website.
2023-09-20 14:38:27 +02:00
Hendrik Kleinwaechter
d72d6c65b2 Improve flatbread recipe (#230)
This creates a short section with detailed instructions on how to make a
flatbread.
2023-09-15 10:17:49 +02:00
Hendrik Kleinwaechter
ec43cf2add Replace one flat bread image (#229)
We used the same image several times. This adds a new different image.
2023-09-15 08:37:25 +02:00
Hendrik Kleinwaechter
722449c5ac Fix duplicate flowchart (#222)
* Fix duplicate flowchart

This combines both flowcharts into one

* Start on pink for starter readiness flowchart

* Add braces to TikZ flowcharts

* Rewired flowchart with right-angled transitions

* Change Arrows from right-angled to star connected

As I could not really find a way not to have diagonal arrows... I
decided to embrace it instead.  YMMV

* Homogenize box sizes

* Align on unit inside the flowchart node

* Fix code typo in starter readiness flowchart

* Create a MWE showing (known) ebook issues

Those issues are:
- Temp in flowchart
- No front image
- Chemical formula
- No list of flowcharts
- Weird looking table

Also test fonts, accents, etc.. seems ok.

* Make ebook the default target

* Revert "Create a MWE showing (known) ebook issues"

This reverts commit dac7f8f21d.

* Revert "Make ebook the default target"

This reverts commit e92e464459.

---------

Co-authored-by: Ced <ced@sdf.org>
2023-09-12 07:25:34 +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
Hanso707
cd1130903d Fixed typos and grammar (#130)
* Update sourdough-starter.tex

Fixed 'typo'

* Update sourdough-starter.tex

take 3 days or so -> take about 3 days

* Update sourdough-starter-types.tex

logical mistake

* Update sourdough-starter-types.tex

logic: doesnt make sense to apply the method without any mold

* Update flour-types.tex

grammar

* Update bread-types.tex

grammar

* Update baking.tex

grammar

* Update sourdough-starter-types.tex

recommendation, wording

* Update flour-types.tex

recommendation, wording

* Update wheat-sourdough.tex

recommendation, wording

* Update wheat-sourdough.tex

get rid of repetition of 'hardly' - recommendation, wording

* Update baking.tex

get rid of 'so'
recommendation, wording

---------

Co-authored-by: Hendrik Kleinwaechter <hendrik.kleinwaechter@gmail.com>
2023-06-28 20:32:03 +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
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
e72d6e1771 Remove a manual enumerate (#125)
Now using adequate environment for it
2023-06-26 16:04:17 +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
cedounet
50bf7f1de4 Nicer tables episode II (#111)
* Make headrow in tables bold

* Simplify tables markup

- Markup is definitely simpler.
- Will not be built separately in a pdf anymore.
- Fixed some typo as well
- Relatively coherent look
- Can be better, some sizes are relatively arbitrary

* Remove horizontal separation inside tables

Not very nice if you ask me..

* Fix some tables for the ebook

The alignement trick to have nicely alignment on = sign or on unit (g)
used broke the html. Reverting to a less optimal version on pdf while
not breaking the html.

* Simplify table for html output

* Revert "Simplify table for html output"

This reverts commit f85d65adb7.

* Revert pancake table

This way it builds ebook correctly.
2023-06-03 00:02:39 +02:00
Hendrik Kleinwaechter
0d1602cc17 Revert "Nicer/Simpler tables (#107)"
This reverts commit 037ae6d7fd.
2023-06-01 18:49:38 +02:00
cedounet
037ae6d7fd Nicer/Simpler tables (#107)
* Make headrow in tables bold

* Simplify tables markup

- Markup is definitely simpler.
- Will not be built separately in a pdf anymore.
- Fixed some typo as well
- Relatively coherent look
- Can be better, some sizes are relatively arbitrary

* Remove horizontal separation inside tables

Not very nice if you ask me..
2023-06-01 14:38:37 +02:00
cedounet
77d3a9c75b Improve the look of tables (#99)
In order tho make the tables look better in document:
    1) Remove the vertical separation
    2) Add different width for top/mid/bottom rules
    3) Center them in the page

Co-authored-by: Cédric Andrieu <cedric@cirrus.com>
2023-05-25 13:36:30 +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
julianscodeword
510da641ab Grammatical corrections as per google drive. (#76) 2023-05-02 17:04:26 +02:00
hanclintonnyx
d74106758d Proofreading for rest of the book text. (#73) 2023-04-13 16:35:46 +02:00
Hendrik Kleinwaechter
941c1a4822 Bread types feedback (#68)
This adds additional feedback by adam carter on the the bread types
chapter.
2023-03-30 12:00:26 +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
Hendrik Kleinwaechter
2473e1e1c6 Fix .mobi table size
This just removes the full-width setting. This way the .mobi displays
the table images properly
2023-03-02 21:14:39 -05: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
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
Ned Park
4bf9e6c9b5 Typo fixes (#39)
* Typo fixes and phrasing improvements to flour types

* Fix typos
2023-01-19 16:46:25 +01:00
Hendrik Kleinwaechter
1b29e32168 Bread types + Flat bread recipe (#15)
This adds the different bread types section including the flat bread recipe.

The flat bread is the most simple and easiest type of bread you can
make.
2022-07-22 18:25:21 +02:00