Commit Graph

19 Commits

Author SHA1 Message Date
Ced
e54c5b3b24 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..
2023-06-13 16:01:34 +01:00
Ced
9b6c852fed Delete svg figures from ebook build 2023-06-13 08:02:09 +01:00
Ced
eed82c8b64 Remove figures compilation from makefile
No need to compile figs to pdf anymore, at least to build the books
2023-06-13 07:58:04 +01:00
cedounet
0c2fb17439 Ebooks build (#121)
* Use kindlegen for Kindle formats

.mobi and .azw3 are now built directly from .epub saving a few latex
runs, and double build of .mobi.

* Factorize amkefile rules and change coding gudelines

Simplify with a single rule for both serif and sans-serif

several makefiles are that way..
    - variables lower-case
    - commands/tools upper-case

* Simplify cleaning rules as per new rules

the directory structure has changed, so that shall change as well
2023-06-12 16:19:15 +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
e451a47d55 improve makefiles (#113)
* 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.

* Use latexmk and dedicated build_directory

- Generic rule for building pdf from tex
- build the book in its own directory
- do not clean before

* Make accessible pdf a command line option

* Simplify accessible version generation

using the option in book.tex instead of copying files around.
TODO: figures/Tkiz still are with serif.

* Specify some dependencies as order only

We don't want to trigger a rebuild everytime the directory timestamp
changes

* Remove force rebuild

* Fix dependencies handling

- Explicit some dependencies
- Ebook must be handled manually as we don't have latexmk working with
  latexmk or not sure how to do it...

* Improve clean

- Use latexmk to clean where possible
- clean the sans-serif as well
- failing rm will output a non-stopping error now

* Cleanup and comment makefile

For clarity, also move things around

* Add an mrproper target

clean now only removes intermediate files, keeps pdf and ebook in there.
Mr proper will remove evrything

* Add dependency of figures for ebook

* Add default rules you expect

make will build the pdf
make all will build all

* Add a make help command

Gives list of useful targets and their action

* Use latexmk to build TikZ pictures

* Use latexmk for building ebooks

* Let latexmk handle dependencies

would get it wrong otherwise...

* Add rule for sans serif ebook

* Add dependencies on TikZ figures for ebooks

* add mk4 file for the sans_serif version of ebook

symlink to the other one as they should be the same.

* Reorder the makefile variables declaration

Looks like I did not fully understood how it works..

Also added some PHONY targets and comments

* Add missing actions in clean target

Some file got forgotten... clean the makefile as well.

* Split the clean in a clean ebook section

* Clean the ebook before building the pdf

Not idel but I have no idea how to have the intermediate files in
another directory with tex4ebook
2023-06-06 17:45:57 +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
Hendrik Kleinwaechter
5412aa6e50 Ebook improvements (#103)
* Ebook improvements

Removes fixed height and width from the resulting HTML and adds an
additional css for the ebook formats.

* Update gitignore

* Strip tags
2023-05-26 13:35:04 +02:00
Hendrik Kleinwaechter
6c8839da87 🤡 Add "make bake" command (#97)
I feel like since this is bread related, release should be renamed to
"bake". So `make bake` will bake you the final book versions.
2023-05-21 20:19:56 +02:00
Hendrik Kleinwaechter
c2d5e88377 Accessibility Sans Serif Option (#90)
* Accessibility Sans Serif Option

This adds another build processs where the book is built using a sans
serif font. This can facilitate reading the book for some users.

* Update readme
2023-05-21 12:19:59 +02:00
Hendrik Kleinwaechter
e0d5422041 Export figures feature (#70)
This adds a `make export_figures` command which exports all the flow
charts into nicely looking pngs. The command requires that you have
docker running locally.
2023-03-30 15:09:56 +02:00
Hendrik Kleinwaechter
43391f1369 Improvements grammar/spelling sourdough works (#63)
* improve clean

* Grammar improvements
2023-03-24 09:56:19 +01:00
Hendrik Kleinwaechter
201d0872e6 Adjust image names 2023-03-02 16:34:50 -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
8617acc687 Release book to S3 (#38)
This will automatically release the book to S3 after merging pull
requests
2023-01-12 15:49:47 +01:00
Hendrik Kleinwaechter
7ef372c98f Update makefile 2022-12-28 12:03:39 +01:00
Robert Schadek
0485e0c490 A tiny makefile (#22)
the makefile has three targets

* all, which does the complete build
* fast, which only runs pdflatex once
* clean, that removes files generated by the makefile
2022-12-16 14:12:47 +01:00