pyreveal/zensical.toml at main · tavallaie/pyreveal · 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
[project]
site_name = "PyReveal"
site_description = "Build Reveal.js presentations programmatically with Python."
site_author = "Ali Tavallaie"
site_url = "https://tavallaie.github.io/pyreveal/"
repo_url = "https://github.com/tavallaie/pyreveal"
repo_name = "tavallaie/pyreveal"
edit_uri = "edit/dev/docs/"
copyright = "Copyright &copy; 2026 Ali Tavallaie"

nav = [
    { "Home" = "index.md" },
    { "Getting started" = [
        "getting-started/installation.md",
        "getting-started/quickstart.md",
    ]},
    { "User guide" = [
        "user-guide/slides.md",
        "user-guide/choices.md",
        "user-guide/elements.md",
        "user-guide/backgrounds.md",
        "user-guide/fragments.md",
        "user-guide/layouts.md",
        "user-guide/math.md",
        "user-guide/plugins.md",
        "user-guide/search.md",
        "user-guide/pdf-export.md",
        "user-guide/configuration.md",
        "user-guide/reveal-features.md",
    ]},
    { "Reference" = [
        "reference/api.md",
    ]},
    { "Development" = [
        "development/contributing.md",
        "development/versioning.md",
    ]},
]

[project.theme]
# modern: default Zensical look (like zensical.org)
# https://zensical.org/docs/setup/basics/#theme-variant
custom_dir = "overrides"
language = "en"
features = [
    "announce.dismiss",
    "content.action.edit",
    "content.action.view",
    "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.path",
    "navigation.sections",
    "navigation.tabs",
    "navigation.tabs.sticky",
    "navigation.top",
    "navigation.tracking",
    "search.highlight",
]

# Amber palette with light/dark toggle
# https://zensical.org/docs/setup/colors/#color-palette-toggle
[[project.theme.palette]]
scheme = "default"
primary = "amber"
accent = "amber"
toggle.icon = "lucide/moon"
toggle.name = "Switch to dark mode"

[[project.theme.palette]]
scheme = "slate"
primary = "amber"
accent = "amber"
toggle.icon = "lucide/sun"
toggle.name = "Switch to light mode"

[project.extra.version]
provider = "mike"

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

[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.arithmatex]
generic = 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]
custom_fences = [
  { name = "mermaid", class = "mermaid", format = "pymdownx.superfences.fence_code_format" }
]
[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]