zensical.toml

[project]
site_name = "Practical Python"
site_description = "Rules, resources and projects for the Practical Python Discord community."
site_author = "Practical Python"
site_url = "https://practicalpython.org/"
copyright = "Copyright © 2026 Practical Python"

repo_url = "https://github.com/practical-python-org/practical-python-dot-org"
repo_name = "practical-python-org/practical-python-dot-org"
edit_uri = "edit/main/docs/"

extra_css = ["stylesheets/extra.css"]

# Zensical can derive the nav from the docs/ directory, but that orders pages
# alphabetically, which would put Projects before Rules. So the nav is spelled
# out. Add a page here when you add the file — see CONTRIBUTING.md.
nav = [
  { "Home" = "index.md" },
  { "Getting started" = "getting-started/index.md" },

  { "Python Tutorial" = [
      "python-tutorial/index.md",
      "python-tutorial/chapters/index.md",
      "python-tutorial/chapters/01-python-history.md",
      "python-tutorial/chapters/02-intro-to-variables.md",
      "python-tutorial/chapters/03-data-types-pt01.md",
      "python-tutorial/chapters/04-built-in-functions-pt01.md",
  ] },
  { "Resources" = [
    "resources/index.md",
    "resources/getting-started.md",
    "resources/learning-path.md",
    "resources/cheat-sheets.md",
    "resources/asking-good-questions.md",
  ] },
  { "Projects" = [
    "projects/index.md",
    { "Our projects" = [
      "projects/our-projects/index.md",
      "projects/our-projects/eos.md",
      "projects/our-projects/this-site.md",
    ] },
    { "Build something" = [
      "projects/build-something/index.md",
      "projects/build-something/beginner.md",
      "projects/build-something/intermediate.md",
    ] },
  ] },
  { "Rules" = [
    "rules/index.md",
    "rules/code-of-conduct.md",
    "rules/moderation.md",
    "rules/channels.md",
  ] },
  { "Code Adventure" = [
    "code-adventure/index.md",
  ] },
]

[project.theme]
language = "en"
# Template overrides: overrides/main.html adds Open Graph tags and the like.
custom_dir = "overrides"
features = [
  "content.action.edit",
  "content.code.annotate",
  "content.code.copy",
  "content.code.select",
  "content.footnote.tooltips",
  "content.tabs.link",
  "content.tooltips",
  "navigation.footer",
  "navigation.indexes",
  "navigation.instant",
  "navigation.instant.prefetch",
  "navigation.instant.progress",
  "navigation.sections",
  "navigation.tabs",
  "navigation.tabs.sticky",
  "navigation.top",
  "navigation.tracking",
  "search.highlight",
  "toc.follow",
]

[project.theme.icon]
logo = "material/language-python"
repo = "fontawesome/brands/github"

[project.theme.font]
text = "Inter"
code = "JetBrains Mono"

[[project.theme.palette]]
media = "(prefers-color-scheme: light)"
scheme = "default"
primary = "indigo"
accent = "indigo"
toggle.icon = "material/brightness-7"
toggle.name = "Switch to dark mode"

[[project.theme.palette]]
media = "(prefers-color-scheme: dark)"
scheme = "slate"
primary = "black"
accent = "indigo"
toggle.icon = "material/brightness-4"
toggle.name = "Switch to light mode"

[project.validation]
invalid_links = true
invalid_link_anchors = true

[project.markdown_extensions.zensical.extensions.macros]
on_undefined = "strict"
on_error_fail = true

[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
toc_depth = 3

[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.mark]
[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]

# Available in any page as {{ discord_invite }}, courtesy of the built-in macros
# extension. Treat this like variables.
[project.extra]
discord_invite = "https://discord.gg/cJqZ7SBHz9"

# Rewritten at deploy time by scripts/refresh_member_count.py, which reads the
# invite above and asks Discord. The committed value is the fallback a local
# build (or a deploy that couldn't reach Discord) renders instead — keep it a
# real, rounded-down figure so it stays true rather than merely present.
member_count = "4,300+"
eos_repo = "https://github.com/practical-python-org/Eos"
site_repo = "https://github.com/practical-python-org/practical-python-dot-org"

[[project.extra.social]]
icon = "fontawesome/brands/discord"
link = "https://discord.gg/cJqZ7SBHz9"
name = "Practical Python on Discord"

[[project.extra.social]]
icon = "fontawesome/brands/github"
link = "https://github.com/practical-python-org/practical-python-dot-org"
name = "This site on GitHub"