ud3tn/doc
Felix Walter 421dec1da5 doc: Add page how to build an AAP 2.0 client
This adds a page explaining the use of the Python module to build an AAP
2.0 client and links it from the corresponding page.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2024-11-16 12:01:22 +01:00
..
css Move file to image-material directory, adjust CSS 2024-11-15 09:52:57 +01:00
development doc: Add page how to build an AAP 2.0 client 2024-11-16 12:01:22 +01:00
image-material doc: Add architecture overview page 2024-11-16 12:01:21 +01:00
references Add index.md file, change documentation structure, add new elements and images to folders, add CSS 2024-11-15 07:59:32 +01:00
tools doc: Fix some broken links 2024-11-15 11:32:21 +01:00
usage doc: Fix some broken links 2024-11-15 11:32:21 +01:00
aap20.md doc: Add architecture overview page 2024-11-16 12:01:21 +01:00
architecture-overview.md doc: Add architecture overview page 2024-11-16 12:01:21 +01:00
Bundle-in-Bundle Encapsulation_(BIBE).md Add index.md file, change documentation structure, add new elements and images to folders, add CSS 2024-11-15 07:59:32 +01:00
contacts_data_format.md Add existing documentation material to MkDocs 2024-11-12 11:33:24 +01:00
index.md Minor changes to URLs and visuals 2024-11-15 12:20:56 +01:00
perf_events.md Add existing documentation material to MkDocs 2024-11-12 11:33:24 +01:00
posix_quick_start_guide.md doc: Fix some broken links 2024-11-15 11:32:21 +01:00
python-venv.md Add existing documentation material to MkDocs 2024-11-12 11:33:24 +01:00
README.md doc: Add MkDocs skeleton 2024-10-16 13:58:40 +02:00
sqlite-storage.md Add existing documentation material to MkDocs 2024-11-12 11:33:24 +01:00
testing.md Add existing documentation material to MkDocs 2024-11-12 11:33:24 +01:00
ud3tn.1 Bump date in Manpage 2024-10-28 09:47:10 +01:00
ud3tn_aap.md Minor changes to URLs and visuals 2024-11-15 12:20:56 +01:00

Documentation

MkDocs

An HTML version of the μD3TN documentation is created via MkDocs. All files stored in the MkDocs directory are taken into account. The MkDocs configuration can be changed in the mkdocs.yaml file. To add further pages to the navigation, they must be added to the nav section.

Prepare

# w/o nix
pip install -U mkdocs
pip install $(mkdocs get-deps)

# w/ nix
nix develop '.?submodules=1'

Develop

mkdocs serve

Build

# w/o nix
mkdocs build --strict --site-dir result/

# w/ nix
nix build .#mkdocs-html

Deploy

When changes are made to the master branch, the latest version of the documentation is automatically built and published at https://d3tn.gitlab.io/ud3tn.

Man Page

There exists also a man page for μD3TN, which can be viewed with

man --local-file ud3tn.1