wtf-eg/handbuch-gen
Archived
1
0
Fork 2
forked from gulliver/rtfm
Code Issues Pull Requests Projects Releases Wiki Activity
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.
85 Commits 1 Branch 2 Tags 19 MiB
CSS 81.3%
HTML 15.2%
Python 2.7%
Makefile 0.8%
203afb1c4c
Go to file
Gulliver 203afb1c4c added recursive git cloning
2021-12-04 18:01:45 +01:00
source handbuch module and version information updated to v0.2.0 2021-12-04 17:58:16 +01:00
theme fix: got rid of woff fonts to create minmal size build 2021-10-13 08:48:05 +02:00
.drone.yml added recursive git cloning 2021-12-04 18:01:45 +01:00
.gitignore removed crowbook and mdbook configand moved sphinx dirs one level up 2021-09-08 16:34:25 +02:00
.gitmodules submodule url adapted to changed organisation for submodule handbuch 2021-09-23 21:52:06 +02:00
LICENSE Initial commit 2021-07-12 10:07:43 +02:00
Makefile fix: cleanup html build 2021-10-13 08:47:41 +02:00
README.md Final corrections in README 2021-11-17 22:57:32 +01:00
requirements.txt fix: copied sphinx_rtd_theme to further shrink filesize 2021-10-13 08:47:40 +02:00

README.md

Build Status

About

This project is an experiment of how to generate the WTF handbook in various output formats (HTML, epub and pdf) from the git repository for the WTF handbook. The handbuch sources are included as git submodule.

This repository contains the Sphinx configuration and a Sphinx theme adapted for the corporate identity of WTF cooperation.

How to build

Checkout with submodules

This repository accesses the required WTF handbook's content as a git submodule. Therefore, make sure to check out this repository including its submodule:

git clone --recurse-submodules https://git.wtf-eg.de/wtf-eg/handbuch-gen.git

Python based dependencies

In order to generate the documentation, first create a Python 3 virtual environment using the venv module included in Python 3:

  1. Create a virtual Python environment in the directory venv: python3 -m venv venv
  2. Activate the virtual Python environment: source venv/bin/activate
  3. Install the packages listed in requirements.txt using pip: pip install -r requirements.txt

Other dependencies

For generating the images from PlantUML sources (*.plantuml), PlantUML is required.

For pdf output the LaTeX builder is used, so latex and pdflatex need to be installed.

Running the document generation via make

The top level directory contains a Makefile, for generation with all output formats use

make bundle

The output files of the final handbook can be found in the subfolder ./bundle.

All generated intermediate artifacts and the final output files can be found in the ./build subfolder.