practical-python-dot-org/zensical.toml at main · practical-python-org/practical-python-dot-org · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
[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 &copy; 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" },

  { "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",
  ] },
]

[project.theme]
language = "en"
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]
# TODO: replace with a real logo, since this is just a placeholder. Where did I put that...?
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/Xarlos89/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"