Commit graph

11 commits

Author SHA1 Message Date
Maximilian Nitsch
a837c7d722 docs: Add manpage to mkdocs
Uses pandoc to convert the manpage into a markdown document and add it
to the mkdocs documentation.

Signed-off-by: Maximilian Nitsch <maximilian.nitsch@d3tn.com>
2025-06-13 17:55:24 +02:00
Maximilian Nitsch
5fa7220ac6 mkdocs: Update icon paths
The `simple/linkedin` icon is no longer available in mkdocs-material
v9.6.4. The `material/linkedin` icon is now used instead. To harmonize
all icons, the youtube icon is also changed to `material/youtube`.

Signed-off-by: Maximilian Nitsch <maximilian.nitsch@d3tn.com>
2025-06-03 16:19:45 +02:00
Maximilian Nitsch
66a47d91e6 doc: Add protoc-gen-doc markdown template
In order to adjust the resulting markdown files to our needs, the
upstream markdown template[^1] is added. The markdown template itself is
added to exclude_docs in the mkdocs.yaml file.

[^1]: https://github.com/pseudomuto/protoc-gen-doc/blob/master/resources/markdown.tmpl

Signed-off-by: Maximilian Nitsch <maximilian.nitsch@d3tn.com
2024-12-05 09:31:37 +01:00
Maximilian Nitsch
ecc8400d48 doc: Add protobuf reference
Adds the AAP2 and StorageAgent protobuf reference to the documentation
by generating markdown files using protoc-gen-doc and adding them as
input for mkdocs.

Signed-off-by: Maximilian Nitsch <maximilian.nitsch@d3tn.com>
2024-12-05 09:31:37 +01:00
Felix Walter
b4b7ffeaf2 doc, README: Move "build and run" instructions to documentation
This moves most of the extended instructions to the mkDocs pages. The
intention is to keep the bare minimum in the README for developers that
just want to quickly try it out.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2024-11-16 12:01:22 +01:00
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
Felix Walter
c640089dee doc: Add architecture overview page
This adds a page to the web documentation that provides a high-level
overview of µD3TN's architecture. The existing architecture figure is
updated and renamed appropriately.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2024-11-16 12:01:21 +01:00
Felix Walter
718353c39f doc: Exclude doc/README.md from mkDocs explicitly
Fixes a warning. index.md is the doc index, whereas README.md is for
developers who want to build the mkDocs site.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2024-11-15 11:33:11 +01:00
Fiona Fuchs
e249cc3006 Add index.md file, change documentation structure, add new elements and images to folders, add CSS
This performs the following actions:
- change overall documentation tree to adjust to existing material
- add CSS for improved visuals
- add folders to improve structure
- move the README of the Contact Plan Reader to the doc folder and integrate it into the documentation
- add file for 'Home' to provide a starting point for the documentation

Signed-off-by: Fiona Fuchs <fiona.fuchs@d3tn.com>
2024-11-15 07:59:32 +01:00
Fiona Fuchs
e7c9c7579a Add existing documentation material to MkDocs
This adds existing documentation files for ud3tn to the MkDocs skeleton.

Signed-off-by: Fiona Fuchs <fiona.fuchs@d3tn.com>
2024-11-12 11:33:24 +01:00
Felix Walter
8c80cf994c Move mkdocs root directory to top-level
This makes `doc/` the actual documentation root directory to simplify
the repository structure.

Signed-off-by: Felix Walter <felix.walter@d3tn.com>
2024-10-16 16:06:25 +02:00
Renamed from doc/mkdocs.yaml (Browse further)