manual/readme.md

83 lines
1.6 KiB
Markdown
Raw Normal View History

# General
[![Build Status](https://drone.wtf-eg.de/api/badges/FreeFleetManagement/manual/status.svg)](https://drone.wtf-eg.de/FreeFleetManagement/manual)
2022-11-14 15:07:36 +01:00
# Introduction
2022-11-14 15:05:16 +01:00
2022-11-14 15:07:36 +01:00
Call ```sphinx-quickstart``` to setup the project.
You can follow this guide to install Sphinx.
```
https://www.sphinx-doc.org/en/master/usage/installation.html
```
You can follow this guid to get started with Sphinx.
```
https://www.sphinx-doc.org/en/master/usage/quickstart.html#
```
# Build Documentation
## Python Dependencies
In order to generate the documentation,
first create a Python virtual environment using the
`venv` module included in Python like this.
* Create a virtual Python environment in the directory `venv` like this.
```
python3 -m venv venv
```
* Activate the virtual Python environment like this.
```
source venv/bin/activate
```
* Install the packages listed in [requirements.txt](./requirements.txt) using `pip` like this.
```
pip install -r requirements.txt
```
## Running Generator via Make
The top level directory contains a Makefile.
Generate HTML output like this.
2022-11-14 15:07:36 +01:00
`````
make html
`````
Generate PDF output like this.
`````
make latexpdf
`````
2022-11-14 15:07:36 +01:00
The output files of the final handbook can be found in the subfolder `./build`.
All generated intermediate artifacts and the final output files can be found in the `./build` subfolder.
2022-12-15 15:41:44 +01:00
Generate all output like this.
```
make bundle
```
2022-11-14 15:07:36 +01:00
### Clean up
1. Deactivate the virtual Python environment: ```deactivate```
2022-12-15 15:44:04 +01:00
2. Clean up the build sources: ```make clean```
2022-11-14 15:07:36 +01:00
# File System
* `build`: build directory
2022-12-15 15:44:04 +01:00
* `Makefile`: build configuration
2022-11-14 15:07:36 +01:00
* `readme.md`: this file
* `source`: source directory