Files
infix/mkdocs.yml
T
Joachim Wiberg 83f2c27e6d doc: initial support for pdf export at doc. generation
- custom cover page for pdf
 - Center and resize logo
 - Place slogan just below logo
 - Ensure all text on cover page is in matching grey

Please note, the mkdocs-to-pdf plugin works, but it has a bug in the
enumeration of sections.  We may need to fork it to make it work the
way users expect.

Signed-off-by: Joachim Wiberg <troglobit@gmail.com>
2025-07-30 14:58:10 +02:00

133 lines
3.5 KiB
YAML

site_name: User's Guide
site_description: Infix Documentation
site_url: https://kernelkit.github.io/infix/
repo_url: https://github.com/kernelkit/infix/
repo_name: kernelkit/infix
copyright: Copyright &copy; 2022-2025 The KernelKit Team
docs_dir: doc/
edit_uri: edit/master/doc/
exclude_docs: |
ChangeLog.md
cli/README.md
README.md
TODO.org
nav:
- About: index.md
- Introduction: introduction.md
- Network Configuration: networking.md
- System Configuration: system.md
- System Management: management.md
- System Upgrade: upgrade.md
- CLI:
- Introduction : cli/introduction.md
- Configuration: cli/configure.md
- Keybindings: cli/keybindings.md
- Network Calculator: cli/netcalc.md
- Network Monitoring: cli/tcpdump.md
- Quickstart Guide: cli/quick.md
- Text Edítor: cli/text-editor.md
- Upgrading: cli/upgrade.md
- In-Depth:
- Boot Procedure: boot.md
- DHCP Server: dhcp.md
- Docker Containers: container.md
- Hardware Info & Status: hardware.md
- Network Discovery: discovery.md
- Scripting Infix:
- Introduction: scripting.md
- Advanced Usage: scripting-sysrepocfg.md
- Remote RESTCONF: scripting-restconf.md
- Production Testing: scripting-prod.md
- Tunneling (L2/L3): tunnels.md
- Quality of Service: qos.md
- RMON Counters: eth-counters.md
- Syslog Support: syslog.md
- Virtual Environments: virtual.md
- Wireless LAN (WiFi): wifi.md
- For Developers:
- Branding & Releases: branding.md
- Developer's Guide: developers-guide.md
- Developing with Buildroot: override-package.md
- Netboot HowTo: netboot.md
- Regression Testing: testing.md
- Test System Architechture: test-arch.md
- Vital Product Data (VPD): vpd.md
- Origin & Licensing: license.md
theme:
logo: logo-plain.png
name: material
features:
- toc.follow
# - toc.integrate
- navigation.path
# - navigation.prune
- navigation.instant
# - navigation.instant.progress
- navigation.tracking
# - navigation.tabs
# - navigation.sections
# - navigation.expand
# - navigation.top
# - navigation.footer
- search.highlight
- search.share
# - content.action.edit
- content.code.copy
- content.code.annotate
- content.footnote.tooltips
palette:
- media: "(prefers-color-scheme: light)"
scheme: default
primary: orange
accent: orange
toggle:
icon: material/weather-night
name: Switch to dark mode
- media: "(prefers-color-scheme: dark)"
scheme: slate
primary: black
accent: orange
toggle:
icon: material/weather-sunny
name: Switch to light mode
markdown_extensions:
- admonition
- attr_list
- footnotes
- pymdownx.details
- pymdownx.superfences
- pymdownx.highlight:
anchor_linenums: true
- pymdownx.inlinehilite
- pymdownx.snippets
- pymdownx.tabbed:
alternate_style: true
- tables
- toc:
permalink: true
plugins:
- search
- callouts
- mike
- to-pdf:
cover: true
enabled_if_env: PDF_EXPORT
cover_logo: logo-plain.png
cover_subtitle: Immutable.Friendly.Secure
custom_template_path: doc/templates
output_path: pdf/infix-user-guide.pdf
toc_level: 2
ordered_chapter_level: 3
heading_shift: false
extra:
generator: false
homepage: https://kernelkit.org/
version:
provider: mike