forked from wtf-eg/handbuch-gen
„README.md“ ändern
This commit is contained in:
parent
87ef72dcab
commit
284ea1f911
33
README.md
33
README.md
@ -8,15 +8,19 @@ It contains a configuration for three different generators:
|
|||||||
|
|
||||||
## mdbook and mdbook-epub
|
## mdbook and mdbook-epub
|
||||||
|
|
||||||
tbd more details on README.md in mdbook directory
|
tbd
|
||||||
|
|
||||||
## crowbook
|
## crowbook
|
||||||
|
|
||||||
tbd more details on README.md in crowbook directory
|
tbd
|
||||||
|
|
||||||
## sphinx
|
## sphinx
|
||||||
|
|
||||||
tbd more details on README.md in sphinx directory
|
tbd
|
||||||
|
|
||||||
|
### sphinx html theme for wtf coop
|
||||||
|
|
||||||
|
the sphinx build uses an adapted sphinx theme for the wtf cooperatives CI.
|
||||||
|
|
||||||
## How to build
|
## How to build
|
||||||
|
|
||||||
@ -56,13 +60,26 @@ Expected Output
|
|||||||
In the virtual environment install the following modules with pip:
|
In the virtual environment install the following modules with pip:
|
||||||
|
|
||||||
`````
|
`````
|
||||||
(py3-sphinx) $ pip install sphinx3 sphinxcontrib-plantuml myst_parser
|
(py3-sphinx) $ pip install sphinx3 sphinxcontrib-plantuml myst-parser
|
||||||
``````
|
``````
|
||||||
|
|
||||||
For generating the images from plantuml-sources it needs also [Plantuml](https://plantuml.com/).
|
For generating the images from plantuml-sources it needs also [Plantuml](https://plantuml.com/).
|
||||||
For pdf output the latex builder is used, so it needs also an installed latex and pdflatex.
|
For pdf output the latex builder is used, so it needs also an installed latex and pdflatex.
|
||||||
|
|
||||||
##
|
### Running the document generation via make
|
||||||
|
|
||||||
|
The top level directory contains a Makefile
|
||||||
|
|
||||||
|
For generation with all tools use
|
||||||
|
`````
|
||||||
|
make all
|
||||||
|
`````
|
||||||
|
|
||||||
|
For generation with single tool use:
|
||||||
|
`````
|
||||||
|
make mdbook [crowbook sphinx]
|
||||||
|
`````
|
||||||
|
|
||||||
## Issues
|
## Issues
|
||||||
### mdbook - rendering problem with current inputs
|
### mdbook - rendering problem with current inputs
|
||||||
|
|
||||||
@ -73,5 +90,7 @@ mumble and mailto links are not rendered correctly
|
|||||||
tbd have an eye on all outputs
|
tbd have an eye on all outputs
|
||||||
|
|
||||||
## TODO
|
## TODO
|
||||||
|
- [ ] complete wtf coop HTML theme
|
||||||
### unify Title and authors in the configurations
|
- [ ] add frontpage with wtf coop CI
|
||||||
|
- [ ] adapt generated pdf to WTF design
|
||||||
|
- [ ] unify Title and authors in the configurations
|
||||||
|
Loading…
Reference in New Issue
Block a user