* Improve Title page
- Made it full page (almost)
- Added a second page with links to github, license info and hard-copy
book
* Add an xbb target for the cover page
For some reasons using picture outside float environment confuses the
ebook/dvi building
---------
Co-authored-by: Cedric <ced@awase.ostal>
* Use standard practices for website build
- Declare your dependencies
- Do not rebuild unless dependencies changed
- Cleanup after yourself
- Document your targets
- COMMANDS in upper case and variables/rules in lowercase
* Prevent bundle install to re-run
Split it into two separate targets one for installing env and one for
actually reworking the html.
* Fix typo in makefile comment
Co-authored-by: Hendrik Kleinwaechter <hendrik.kleinwaechter@gmail.com>
---------
Co-authored-by: Hendrik Kleinwaechter <hendrik.kleinwaechter@gmail.com>
- Declare your dependencies
- Do not rebuild unless dependencies changed
- Cleanup after yourself
- Document your targets
- COMMANDS in upper case and variables/rules in lowercase
* 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.
* 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...
* Fix issue of book not building
* add dependencies
* fix
* test make4ht
* fix cmd
* Use own docker image
* Add label
* fix urls
* Add validate command
* build non mac version
* tmp run
* use smaller tex version
* build full
This is a minimal alpha version of the book as static html website. More
stuff needs to be added, but should be okay for a working prototype.
Fixes#128
* 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.
* 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.
* Update .gitignore
Hide the svg file created during ebook builds and the new directories
after makefile changes
* Fix a makefile variable that stayed in uppercase
* Do not clean ebook systematically anymore
Should be fixed with new way to build ebooks
* Add rule showing version of tools on build machine
This helps with debugging on another machine.. or a build server.
* Add figures/vars.tex to the list of dependencies
Was missing...
* Add a makefile variable print facility
Quite a neat trick, avoids having to add it manually when you debug
* Add a target to print all variables in the makefile
* Fix the src_tables target
typos one s too many...
* Add a makefile variable to run tools in debug mode
Only ebook for now.
* Make default build the serif version of pdf
This is what the documentation said but both serif and sans were built
* Explicit serif in makefile and flattens rules
We had default (serif) and sans, better we have target named after their
fonts family
Flatten them as well so we can build ebooks or sans serif only as we
wish.
Simplified rules tree before:
-----------------------------
all/ bake
release_serif
build_pdf
build_serif_pdf
book_serif/book.pdf
build_sans_serif_pdf
book_sans_serif/book_sans_serif.pdf
build_ebook
build_serif_ebook
epub/book.epub
epub/book.mobi
epub/book.azw3
build_sans_serif_ebook
epub/book_sans_serif.epub
epub/book_sans_serif.mobi
epub/book_sans_serif.azw3
release_sans_serif
build_sans_serif_pdf
book_sans_serif/book_sans_serif.pdf
build_sans_serif_ebook
epub/book_sans_serif.epub
epub/book_sans_serif.mobi
epub/book_sans_serif.azw3
Simplified rules tree now:
--------------------------
all: bake
bake:
release_serif
build_serif_pdf
book_serif/book.pdf
build_serif_ebook:
epub/book.epub
epub/book.mobi
epub/book.azw3
release_sans_serif
build_sans_serif_pdf
book_sans_serif/book_sans_serif.pdf
build_sans_serif_ebook
epub/book_sans_serif.epub
epub/book_sans_serif.mobi
epub/book_sans_serif.azw3
build_pdf:
build_serif_pdf
build_sans_serif_pdf
build_ebook:
build_serif_ebook
build_sans_serif_ebook
release_serif:
build_serif_pdf
build_serif_ebook
release_sans_serif:
build_sans_serif_pdf
build_sans_serif_ebook
* Explicit the dependency on TikZ figures
latexmk figured that out but better if makefile is aware of it as well
* 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
* 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
* 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
* 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.
* 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..
* Ebook improvements
Removes fixed height and width from the resulting HTML and adds an
additional css for the ebook formats.
* Update gitignore
* Strip tags
* 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
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.
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
