Archived

rendering of wtf handbook with sphinx

This repository has been archived on 2023-04-12. You can view files and clone it, but cannot push or open issues or pull requests.

Go to file

Gulliver c2949a7257 outputs added to ignore list		2021-08-01 18:23:06 +02:00
crowbook	added initiall README.md for each tool	2021-08-01 09:16:50 +02:00
handbuch@d7127ce68e	added chapter dineste from new version of handbuch	2021-08-01 09:15:44 +02:00
mdbook	added initiall README.md for each tool	2021-08-01 09:16:50 +02:00
sphinx	added initiall README.md for each tool	2021-08-01 09:16:50 +02:00
.gitignore	outputs added to ignore list	2021-08-01 18:23:06 +02:00
.gitmodules	added handbuch as submodule and refactored mdbook config for this	2021-07-28 20:40:02 +02:00
LICENSE	Initial commit	2021-07-12 10:07:43 +02:00
Makefile	all result are copied into one (bundle) dir as make target	2021-08-01 18:14:46 +02:00
README.md	added issues and TODO	2021-08-01 18:15:18 +02:00

README.md

rtfm

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

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