2021-07-12 10:07:43 +02:00
|
|
|
# rtfm
|
|
|
|
|
|
2021-07-29 09:50:25 +02:00
|
|
|
this projects is an experiment of how to generate html, epub and pdf
|
|
|
|
|
from the git repository for the WTF Handbook.
|
|
|
|
|
The handbuch sources are inclued as git submodule.
|
|
|
|
|
|
|
|
|
|
It contains a configuration for three different generators:
|
|
|
|
|
|
|
|
|
|
## mdbook and mdbook-epub
|
|
|
|
|
|
|
|
|
|
tbd more details on README.md in mdbook directory
|
|
|
|
|
|
|
|
|
|
## crowbook
|
|
|
|
|
|
|
|
|
|
tbd more details on README.md in crowbook directory
|
|
|
|
|
|
|
|
|
|
## sphinx
|
|
|
|
|
|
|
|
|
|
tbd more details on README.md in sphinx directory
|
|
|
|
|
|
|
|
|
|
## How to build
|
|
|
|
|
|
|
|
|
|
tbd
|
2021-08-01 18:15:18 +02:00
|
|
|
|
|
|
|
|
## Issues
|
|
|
|
|
### mdbook - rendering problem with current inputs
|
|
|
|
|
|
|
|
|
|
### sphinx - Problems rendering latex with .svg image(organigramm.svg)
|
|
|
|
|
|
|
|
|
|
### problems rendering links not starting with http(s)
|
|
|
|
|
mumble and mailto links are not rendered correctly
|
|
|
|
|
tbd have an eye on all outputs
|
|
|
|
|
|
|
|
|
|
## TODO
|
|
|
|
|
|
|
|
|
|
### unify Title and authors in the configurations
|
