docs/zensical.toml

[project]
site_name = "koharu"
site_description = "ML-powered manga translator, written in Rust."
site_author = "Mayo"
site_url = "https://koharu.rs/"
repo_url = "https://github.com/mayocream/koharu"
repo_name = "mayocream/koharu"
edit_uri = "edit/main/docs/en-US/"
docs_dir = "en-US"
site_dir = "site"
nav = [
  {"Overview" = "index.md"},
  {"Tutorials" = [
    "tutorials/index.md",
    "tutorials/translate-your-first-page.md",
  ]},
  {"How-To Guides" = [
    "how-to/index.md",
    "how-to/install-koharu.md",
    "how-to/runtime-and-model-downloads.md",
    "how-to/run-gui-headless-and-mcp.md",
    "how-to/configure-mcp-clients.md",
    "how-to/use-openai-compatible-api.md",
    "how-to/use-codex-image-generation.md",
    "how-to/export-and-manage-projects.md",
    "how-to/build-from-source.md",
    "how-to/troubleshooting.md",
  ]},
  {"Explanation" = [
    "explanation/index.md",
    "explanation/how-koharu-works.md",
    "explanation/technical-deep-dive.md",
    "explanation/text-rendering-and-vertical-cjk-layout.md",
    "explanation/acceleration-and-runtime.md",
    "explanation/models-and-providers.md",
  ]},
  {"Reference" = [
    "reference/index.md",
    "reference/cli.md",
    "reference/http-api.md",
    "reference/mcp-tools.md",
    "reference/settings.md",
    "reference/keyboard-shortcuts.md",
  ]},
  {"Contribute" = [
    "contribute/introduction.md",
    "contribute/development.md",
  ]},
]

[project.extra]
generator = false
og_image = "assets/koharu-screenshot-en.png"
og_image_alt = "Koharu manga translator interface"
twitter_card = "summary_large_image"

[[project.extra.alternate]]
name = "English"
link = "/"
lang = "en"

[[project.extra.alternate]]
name = "日本語"
link = "/ja-JP/"
lang = "ja-JP"

[[project.extra.alternate]]
name = "简体中文"
link = "/zh-CN/"
lang = "zh-CN"

[[project.extra.alternate]]
name = "Português (Brasil)"
link = "/pt-BR/"
lang = "pt-BR"

[[project.extra.social]]
icon = "fontawesome/brands/github"
link = "https://github.com/mayocream"

[[project.extra.social]]
icon = "fontawesome/brands/x-twitter"
link = "https://x.com/mayo_irl"

[[project.extra.social]]
icon = "fontawesome/brands/discord"
link = "https://discord.gg/mHvHkxGnUY"

[project.theme]
language = "en"
custom_dir = "overrides"
logo = "assets/Koharu_Halo.png"
favicon = "assets/Koharu_Halo.png"
font.text = "Nunito"
font.code = "Fira Code"
features = [
  "navigation.sections",
  "navigation.indexes",
  "navigation.instant",
  "navigation.tracking",
  "navigation.tabs",
  "navigation.tabs.sticky",
  "navigation.expand",
  "navigation.footer",
  "toc.follow",
  "content.code.copy",
  "content.action.edit",
  "content.action.view",
  "content.tabs.link",
]

[project.theme.icon]
repo = "fontawesome/brands/github"

[project.theme.icon.admonition]
question = "fontawesome/solid/paper-plane"
user = "lucide/user-round"

# Palette toggle for automatic mode
[[project.theme.palette]]
media = "(prefers-color-scheme)"
primary = "pink"
accent = "teal"
toggle.icon = "lucide/sun-moon"
toggle.name = "Switch to light mode"

# Palette toggle for light mode
[[project.theme.palette]]
media = "(prefers-color-scheme: light)"
primary = "pink"
accent = "teal"
scheme = "default"
toggle.icon = "lucide/sun"
toggle.name = "Switch to dark mode"

# Palette toggle for dark mode
[[project.theme.palette]]
media = "(prefers-color-scheme: dark)"
primary = "pink"
accent = "teal"
scheme = "slate"
toggle.icon = "lucide/moon"
toggle.name = "Switch to system preference"

[project.markdown_extensions.admonition]
[project.markdown_extensions.attr_list]
[project.markdown_extensions.md_in_html]
[project.markdown_extensions.tables]

[project.markdown_extensions.pymdownx.emoji]
emoji_index = "zensical.extensions.emoji.twemoji"
emoji_generator = "zensical.extensions.emoji.to_svg"

[project.markdown_extensions.pymdownx.tabbed]
alternate_style = true

[project.markdown_extensions.pymdownx.tasklist]
custom_checkbox = true

[project.markdown_extensions.toc]
permalink = true

[project.markdown_extensions.pymdownx.superfences]
custom_fences = [
  { name = "mermaid", class = "mermaid", format = "pymdownx.superfences.fence_code_format" },
]