wtf-eg/handbuch-gen
Archived
1
0
Fork 2
forked from gulliver/rtfm
Code Issues Pull Requests Projects Releases Wiki Activity

Change README section with dependencies

Browse Source
This commit is contained in:
maehw 2021-10-23 21:53:49 +02:00
parent 62ab2378e0
commit 427fc4577d
1 changed files with 7 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
README.md
View File

@ -20,22 +20,23 @@ This repository accesses the required WTF handbook's content as a git submodule.
git clone --recurse-submodules https://git.wtf-eg.de/wtf-eg/handbuch-gen.git git clone --recurse-submodules https://git.wtf-eg.de/wtf-eg/handbuch-gen.git
``` ```
### python based - sphinx ### Python based dependencies
First create a Python 3 virtual environment using the venv module included with Python 3. First create a Python 3 virtual environment using the venv module included with Python 3.
1. Create a virtual Python environment in the directory `venv` using the Python module `venv`: ```python3 -m venv venv``` 1. Create a virtual Python environment in the directory `venv` using the Python module `venv`: ```python3 -m venv venv```
2. Activate the virtual Python environment: ```source venv/bin/activate``` 2. Activate the virtual Python environment: ```source venv/bin/activate```
3. Install needed packages from ```requirements.txt```: ```pip install -r requirements.txt``` 3. Install the packages listed in [./requirements.txt](requirements.txt) using `pip`: ```pip install -r requirements.txt```
For generating the images from plantuml-sources it needs also [Plantuml](https://plantuml.com/). ### Other dependencies
For pdf output the latex builder is used, so it needs also an installed latex and pdflatex.
For generating the images from PlantUML sources (`*.plantuml`), [Plantuml](https://plantuml.com/) is required.
For pdf output the latex builder is used, so latex and pdflatex need to be installed.
### Running the document generation via make ### Running the document generation via make
The top level directory contains a Makefile, The top level directory contains a Makefile,
for generation with all output formats use for generation with all output formats use
````` `````
make bundle make bundle