Commit Graph

26 Commits

Author SHA1 Message Date
Cedric
e73b0f331a Use a sans-serif math font for pgfplots
pgfplots uses math fonts for graphs ticks... and it looks weird when
building sans serif.

Not sure Fira is necessarily a great choice with open-sans but we have
very little math so that should do...
2025-01-21 20:56:40 +00:00
Cedric
ad94b9fabc Enable abbreviations in standalone flowcharts
Spun the file out for inclusion basically... we want to be able to use
\eg in flowcharts even when built standalone.

Fixed dependencies in makefile as well
2025-01-21 20:56:40 +00:00
Cedric
9462f0319e Enable pgfplots package
Will be used by TikZ for graphs/plots
2025-01-01 17:25:53 +00:00
Cedric
b588b55c1a Allow URL to break
This was prevented by ocgcolorlinks which was here to have links printed
in black but looking like colors in the pdf on screen... as Doc
hyperref explains:

• Main disadvantage: Links cannot be broken across lines. PDF reference
1.7: 4.10.2 “Making
2024-12-26 22:14:29 +00:00
Cedric
aa2c80a048 Make flowchart numbering consistent
Now all figures, tables and flowcharts are numbered with chapter.number.

Fixes: https://github.com/hendricius/the-sourdough-framework/issues/395

Also added vertical space for list of tables so it matches the list of
figures and list of flowcharts
2024-12-26 15:25:55 +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
Hendrik Kleinwaechter
4510616f20 Mix-ins Chapter (#319)
* Mixins

This adds additional photos and ideas to the mixins chapter.

* Fix order
2023-12-23 18:11:41 +01:00
Cedric
1c3ebed203 Prevent tex4ht to load enumitem
Apparently it breaks on kobo e-reader.
2023-12-16 13:48:15 +00:00
cedounet
37bd36917d Fix glossary (#260)
* Correct spelling mistakes in glossary

* Rorder glossary

So it actually is in alphabetical order...

Samnly typos here adn there.

* Improve Glossary typography

* Fix make4ht enumitem

Basically we bypass the style for ebook and HTML.
2023-10-25 23:06:29 +02:00
Hendrik Kleinwaechter
187fc1d0fc Glossary (#258)
* Glossary

This adds a glossary with common terms to the book

* Apply ordering changes

* Add PR feedback

* Move to backmatter
2023-10-22 20:18:11 +02:00
cedounet
170763615f Change colors for links and hyperref (#206)
* Change colors for links and hyperref

This is less in your face than what we previously had.

Discussion in :
https://github.com/hendricius/the-sourdough-framework/discussions/201

There might be ways to make that better (not in your face and clickable
?)
https://tex.stackexchange.com/questions/555663/create-a-table-of-contents-with-links-in-all-text-and-different-colours-for-sect

* Remove colors for links in To*

As per @hendricius input
2023-09-04 10:24:23 +02:00
cedounet
5574cb230c Mixins chapter (#203)
* Move mix-ins to its own chapter

I don't think it belongs to wheat one which is already packed,
Schwarzbort for once is usually with seeds added.

Once we have more pics it will be even more cramped in the wheat
chapter.

* Fix TeXnicalilities in mix-ins chapter

looooong lines, no use of sinunitx, abbreviations, etc..

* Fix typo

* Update book/book.tex

---------

Co-authored-by: Hendrik Kleinwaechter <hendrik.kleinwaechter@gmail.com>
2023-08-28 17:05:08 +02:00
cedounet
0600605fb1 Add pdinfo metadata (#202)
Metadata added to the pdf, readable with pdfinfo
Title:           The Sourdough Framework
Subject:         The sourdough bread baking bible
Keywords:        Sourdough, dough, bread, wheat, baking, bake,
    home-baking, yeast, rye, crumb, debug, gluten, dough strength, crust,
    DIY, framework, https://the-sourdough-framework.com,
    https://www.the-bread-code.io/,
    https://github.com/hendricius/the-sourdough-framework, open-source,
    CC-BY-SA
Author:          Hendrik Kleinwächter
Creator:         LaTeX with hyperref
Producer:        LuaTeX-1.16.0
CreationDate:    Sun Aug 27 13:58:19 2023 BST
ModDate:         Sun Aug 27 13:58:19 2023 BST
Custom Metadata: yes
Metadata Stream: no
Tagged:          no
UserProperties:  no
Suspects:        no
Form:            none
JavaScript:      no
Pages:           167
Encrypted:       no
Page size:       595.276 x 841.89 pts (A4)
Page rot:        0
File size:       59180712 bytes
Optimized:       no
PDF version:     1.5
2023-08-28 16:57:06 +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
8395905042 Enable micro-typographical improvements (#191)
Few people will notice but this actually brings loads of improvements to
line breaking, handing punctuations etc.
2023-08-21 14:59:36 +02:00
cedounet
de02adb4c7 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>
2023-08-21 14:59:05 +02:00
Hendrik Kleinwaechter
a8dc6dc210 Change flowchart color (#185)
* Change BG color to white

* Fix flowcharts where graphics overlap with text

* Increase border size

* change arrow style

* Allow standalone building of TikZ flowcharts

Useful for reference or website etc..

* Prevent manual hyphenation in TikZ diagrams

A Bit of a manual tweak.. but worth it to look nicer :D

* Add missing file for flowcharts

---------

Co-authored-by: Cedric <ced@awase.ostal>
2023-08-19 16:35:02 +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
104cbcf6ac Add color coding to flow charts (#180)
This will hopefully allow easier reading by identifying start and end
point more easily
2023-08-18 11:31:33 +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
9e086fab6c Change chapters heading (#173)
* Implement kaobook style chapter headings

Now supports several style of chapters
- plain (default koma)
- bar adds a gray bar
- lines (a box around it)
- kao

This is totally _inspired_ by the kaobook template:
https://github.com/fmarotta/kaobook/

* Use lines style for chapter by default

As Hendrik indicated...
2023-08-17 15:07:28 +02:00
cedounet
8c2e4a3223 Fonts (#171)
* Use sans-serif font in TikZ, match font for units

I think this makes the diagrams easier to read and also makes unit not
looking weird in the HTML version.  Not sure why match ain't the default

* Use palatino for main serif font

- Andale mono
- SourceSansPro for non-serif

* Disable Andale mono font for typwriter

It is not available on GitHub CI.  Need to find an alternative.
2023-08-15 18:43:41 +02:00
cedounet
538df0aa95 Align to hardcover book (#166)
* Align sans-serif font to printed book

- We now use Open Sans
- Also have units in text mode, looks nicer in Sans serif mode at least

See:
https://github.com/hendricius/the-sourdough-framework/pull/158#event-9914405309

* Add colours definition from the printed book

New colors taken from
https://github.com/hendricius/the-sourdough-framework/pull/158#event-9914405309
2023-08-07 22:14:27 +02:00
cedounet
0fd5f3431a Use Lualatex (#159)
* Use LuaLaTeX instead of pdfTeX

Will allow to use Open Type Fonts in the future

Other less important reasons:
    - Uniform encoding in UTF-8
    - We could maybe use some luaTeX only packages
    - It's more modern, should be better

* Use Tex Gyre Heros as helvetica clone

As it does not seem available by default on the CI machine and might
have some licensing issues.
2023-08-03 21:38:31 +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
fa91b6f06f Komascript (#148)
* Add chemfig package

Somhow forgot it in chemical equation commit 8004497b

* Change links colors to codeblue

Closes https://github.com/hendricius/the-sourdough-framework/issues/142

* Use KOMA-Script and twosided printing

Because it looks better.  Also gets rid of headers/footers on empty
pages

* Fix tex4ebook and komascript clash

See https://github.com/michal-h21/tex4ebook/issues/110

* Factor out packages into a sty file

Separates style details out of the main file, now that we start having
more and more style-related settings.

* Remove parskip

Not needed with Koma-script

* Remove tocloft package

Not needed with koma-script

* Use tocbasics instead of floats

to please kpmascript internal algorithm

* Add a bit more breathing space in ToC

so they are not stuck together at 11.11 onwards...
2023-07-13 16:32:00 +02:00