Add help-osk-docs stack: Zensical instructions site for 05-osk

Static instructions site for client 05 served at help.osk.team. Markdown + images built by Zensical (zensical build) into public/, served by nginx behind Traefik. Content is bind-mounted from /mnt/containers/help-osk-docs (absolute host path — Portainer GitOps can't resolve relative mounts). Adds the help/help-osk router+service to traefik/dynamic/web.yml (TLS via Let's Encrypt, public/open). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-25 14:59:33 +03:00
parent fb58acea5e
commit 1d6be15448
9 changed files with 311 additions and 0 deletions
@@ -0,0 +1,85 @@
+# Zensical configuration — client 05 (05-osk) instructions site.
+# Docs: https://zensical.org/docs/setup/basics/
+# Build: `zensical build --clean` -> outputs static site to ./public
+
+[project]
+site_name = "ОСК — Инструкции"
+site_description = "Инструкции для пользователей (клиент 05)."
+site_author = "ОСК"
+site_url = "https://help.osk.team/"
+copyright = """
+Copyright &copy; 2026 ОСК
+"""
+
+# Explicit navigation. Add a line per Markdown page you create under docs/.
+# Remove this block to let Zensical derive the nav from the folder structure.
+nav = [
+  { "Главная" = "index.md" },
+  { "Пример инструкции" = "primer-instrukcii.md" },
+]
+
+[project.theme]
+language = "ru"
+features = [
+  "announce.dismiss",
+  "content.code.annotate",
+  "content.code.copy",
+  "content.tooltips",
+  "navigation.footer",
+  "navigation.indexes",
+  "navigation.instant",
+  "navigation.instant.prefetch",
+  "navigation.path",
+  "navigation.sections",
+  "navigation.top",
+  "navigation.tracking",
+  "search.highlight",
+]
+
+# Optional: drop a logo at docs/assets/logo.png and uncomment.
+#logo = "assets/logo.png"
+
+[[project.theme.palette]]
+scheme = "default"
+toggle.icon = "lucide/sun"
+toggle.name = "Тёмная тема"
+
+[[project.theme.palette]]
+scheme = "slate"
+toggle.icon = "lucide/moon"
+toggle.name = "Светлая тема"
+
+# ----------------------------------------------------------------------------
+# Markdown extensions — enables admonitions, image attributes (sizing/align),
+# task lists, code highlighting, tabs, etc. Kept from Zensical's defaults.
+# ----------------------------------------------------------------------------
+[project.markdown_extensions.abbr]
+[project.markdown_extensions.admonition]
+[project.markdown_extensions.attr_list]
+[project.markdown_extensions.def_list]
+[project.markdown_extensions.footnotes]
+[project.markdown_extensions.md_in_html]
+[project.markdown_extensions.toc]
+permalink = true
+[project.markdown_extensions.pymdownx.betterem]
+[project.markdown_extensions.pymdownx.caret]
+[project.markdown_extensions.pymdownx.details]
+[project.markdown_extensions.pymdownx.emoji]
+emoji_generator = "zensical.extensions.emoji.to_svg"
+emoji_index = "zensical.extensions.emoji.twemoji"
+[project.markdown_extensions.pymdownx.highlight]
+anchor_linenums = true
+line_spans = "__span"
+pygments_lang_class = true
+[project.markdown_extensions.pymdownx.inlinehilite]
+[project.markdown_extensions.pymdownx.keys]
+[project.markdown_extensions.pymdownx.magiclink]
+[project.markdown_extensions.pymdownx.mark]
+[project.markdown_extensions.pymdownx.smartsymbols]
+[project.markdown_extensions.pymdownx.superfences]
+[project.markdown_extensions.pymdownx.tabbed]
+alternate_style = true
+combine_header_slug = true
+[project.markdown_extensions.pymdownx.tasklist]
+custom_checkbox = true
+[project.markdown_extensions.pymdownx.tilde]