mirror of
https://github.com/juanfont/headscale.git
synced 2024-11-26 08:53:05 +00:00
dc17b4d378
* Use a trailing slash recommended by mkdocs-material * Update doc requirements Let mkdocs-material resolve its imaging dependencies (cairosvg and pillow) and fix a dependabot warning along the way. Reference compatible versions by major.minor.
187 lines
5 KiB
YAML
187 lines
5 KiB
YAML
---
|
|
site_name: Headscale
|
|
site_url: https://juanfont.github.io/headscale/
|
|
edit_uri: blob/main/docs/ # Change the master branch to main as we are using main as a main branch
|
|
site_author: Headscale authors
|
|
site_description: >-
|
|
An open source, self-hosted implementation of the Tailscale control server.
|
|
|
|
# Repository
|
|
repo_name: juanfont/headscale
|
|
repo_url: https://github.com/juanfont/headscale
|
|
|
|
# Copyright
|
|
copyright: Copyright © 2024 Headscale authors
|
|
|
|
# Configuration
|
|
theme:
|
|
name: material
|
|
features:
|
|
- announce.dismiss
|
|
- content.action.edit
|
|
- content.action.view
|
|
- content.code.annotate
|
|
- content.code.copy
|
|
# - content.tabs.link
|
|
- content.tooltips
|
|
# - header.autohide
|
|
# - navigation.expand
|
|
- navigation.footer
|
|
- navigation.indexes
|
|
# - navigation.instant
|
|
# - navigation.prune
|
|
- navigation.sections
|
|
- navigation.tabs
|
|
# - navigation.tabs.sticky
|
|
- navigation.top
|
|
- navigation.tracking
|
|
- search.highlight
|
|
- search.share
|
|
- search.suggest
|
|
- toc.follow
|
|
# - toc.integrate
|
|
palette:
|
|
- scheme: default
|
|
primary: white
|
|
toggle:
|
|
icon: material/brightness-7
|
|
name: Switch to dark mode
|
|
- scheme: slate
|
|
toggle:
|
|
icon: material/brightness-4
|
|
name: Switch to light mode
|
|
font:
|
|
text: Roboto
|
|
code: Roboto Mono
|
|
favicon: assets/favicon.png
|
|
logo: ./logo/headscale3-dots.svg
|
|
|
|
# Excludes
|
|
exclude_docs: |
|
|
/packaging/README.md
|
|
/packaging/postinstall.sh
|
|
/packaging/postremove.sh
|
|
/requirements.txt
|
|
|
|
# Plugins
|
|
plugins:
|
|
- search:
|
|
separator: '[\s\-,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
|
|
- macros:
|
|
- include-markdown:
|
|
- minify:
|
|
minify_html: true
|
|
- social: {}
|
|
- redirects:
|
|
redirect_maps:
|
|
acls.md: ref/acls.md
|
|
android-client.md: usage/connect/android.md
|
|
apple-client.md: usage/connect/apple.md
|
|
dns-records.md: ref/dns.md
|
|
exit-node.md: ref/exit-node.md
|
|
faq.md: about/faq.md
|
|
iOS-client.md: usage/connect/apple.md#ios
|
|
oidc.md: ref/oidc.md
|
|
remote-cli.md: ref/remote-cli.md
|
|
reverse-proxy.md: ref/integration/reverse-proxy.md
|
|
tls.md: ref/tls.md
|
|
web-ui.md: ref/integration/web-ui.md
|
|
windows-client.md: usage/connect/windows.md
|
|
|
|
# Customization
|
|
extra:
|
|
annotate:
|
|
json: [.s2]
|
|
social:
|
|
- icon: fontawesome/brands/github
|
|
link: https://github.com/juanfont/headscale
|
|
- icon: material/coffee
|
|
link: https://ko-fi.com/headscale
|
|
- icon: fontawesome/brands/docker
|
|
link: https://github.com/juanfont/headscale/pkgs/container/headscale
|
|
- icon: fontawesome/brands/discord
|
|
link: https://discord.gg/c84AZQhmpx
|
|
headscale:
|
|
version: 0.23.0
|
|
|
|
# Extensions
|
|
markdown_extensions:
|
|
- abbr
|
|
- admonition
|
|
- attr_list
|
|
- def_list
|
|
- footnotes
|
|
- md_in_html
|
|
- toc:
|
|
permalink: true
|
|
- pymdownx.arithmatex:
|
|
generic: true
|
|
- pymdownx.betterem:
|
|
smart_enable: all
|
|
- pymdownx.caret
|
|
- pymdownx.details
|
|
- pymdownx.emoji:
|
|
emoji_generator: !!python/name:material.extensions.emoji.to_svg
|
|
emoji_index: !!python/name:material.extensions.emoji.twemoji
|
|
- pymdownx.highlight:
|
|
anchor_linenums: true
|
|
line_spans: __span
|
|
pygments_lang_class: true
|
|
- pymdownx.inlinehilite
|
|
- pymdownx.keys
|
|
- pymdownx.magiclink:
|
|
repo_url_shorthand: true
|
|
user: squidfunk
|
|
repo: mkdocs-material
|
|
- pymdownx.mark
|
|
- pymdownx.smartsymbols
|
|
- pymdownx.superfences:
|
|
custom_fences:
|
|
- name: mermaid
|
|
class: mermaid
|
|
format: !!python/name:pymdownx.superfences.fence_code_format
|
|
- pymdownx.tabbed:
|
|
alternate_style: true
|
|
- pymdownx.tasklist:
|
|
custom_checkbox: true
|
|
- pymdownx.tilde
|
|
|
|
# Page tree
|
|
nav:
|
|
- Welcome: index.md
|
|
- About:
|
|
- FAQ: about/faq.md
|
|
- Features: about/features.md
|
|
- Clients: about/clients.md
|
|
- Getting help: about/help.md
|
|
- Releases: about/releases.md
|
|
- Contributing: about/contributing.md
|
|
- Sponsor: about/sponsor.md
|
|
|
|
- Setup:
|
|
- Requirements and Assumptions: setup/requirements.md
|
|
- Installation:
|
|
- Official releases: setup/install/official.md
|
|
- Community packages: setup/install/community.md
|
|
- Container: setup/install/container.md
|
|
- Cloud: setup/install/cloud.md
|
|
- Build from source: setup/install/source.md
|
|
- Upgrade: setup/upgrade.md
|
|
- Usage:
|
|
- Getting started: usage/getting-started.md
|
|
- Connect a node:
|
|
- Android: usage/connect/android.md
|
|
- Apple: usage/connect/apple.md
|
|
- Windows: usage/connect/windows.md
|
|
- Reference:
|
|
- Configuration: ref/configuration.md
|
|
- OIDC authentication: ref/oidc.md
|
|
- Exit node: ref/exit-node.md
|
|
- TLS: ref/tls.md
|
|
- ACLs: ref/acls.md
|
|
- DNS: ref/dns.md
|
|
- Remote CLI: ref/remote-cli.md
|
|
- Integration:
|
|
- Reverse proxy: ref/integration/reverse-proxy.md
|
|
- Web UI: ref/integration/web-ui.md
|
|
- Tools: ref/integration/tools.md
|