Skip to content

Commit 77fc77d

Browse files
MariusStorhaugCopilot
MariusStorhaug
and
Copilot
committed
Use the shared native Zensical design
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
1 parent 02ca898 commit 77fc77d

4 files changed

Lines changed: 81 additions & 70 deletions

File tree

‎.github/zensical.toml‎

Lines changed: 60 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,69 +1,104 @@
1+
# Zensical configuration
2+
# https://zensical.org/docs/setup/basics/
3+
14
[project]
25
site_name = "-{{ REPO_NAME }}-"
6+
site_url = "https://psmodule.io/-{{ REPO_NAME }}-/"
7+
docs_dir = "docs"
38
repo_name = "-{{ REPO_OWNER }}-/-{{ REPO_NAME }}-"
49
repo_url = "https://github.com/-{{ REPO_OWNER }}-/-{{ REPO_NAME }}-"
510

611
[project.theme]
7-
variant = "classic"
812
language = "en"
13+
font.text = "Mona Sans"
14+
font.code = "Source Code Pro"
915
logo = "Assets/icon.png"
1016
favicon = "Assets/icon.png"
1117
features = [
12-
"navigation.instant",
13-
"navigation.instant.progress",
14-
"navigation.indexes",
15-
"navigation.top",
16-
"navigation.tracking",
17-
"navigation.expand",
18-
"search.suggest",
19-
"search.highlight",
20-
"content.code.copy"
18+
"announce.dismiss",
19+
"content.code.annotate",
20+
"content.code.copy",
21+
"content.tooltips",
22+
"navigation.footer",
23+
"navigation.indexes",
24+
"navigation.instant",
25+
"navigation.instant.prefetch",
26+
"navigation.instant.preview",
27+
"navigation.instant.progress",
28+
"navigation.tabs",
29+
"navigation.top",
30+
"navigation.tracking",
31+
"search.highlight",
32+
"search.share",
33+
"search.suggest",
34+
"toc.follow",
2135
]
2236

37+
[project.theme.icon]
38+
repo = "material/github"
39+
link = "material/link-variant"
40+
41+
# Palette toggle for automatic mode
2342
[[project.theme.palette]]
2443
media = "(prefers-color-scheme)"
25-
toggle.icon = "lucide/sun-moon"
44+
toggle.icon = "material/link"
2645
toggle.name = "Switch to dark mode"
2746

47+
# Palette toggle for dark mode
2848
[[project.theme.palette]]
2949
media = "(prefers-color-scheme: dark)"
3050
scheme = "slate"
3151
primary = "black"
32-
accent = "green"
33-
toggle.icon = "lucide/moon"
52+
accent = "light blue"
53+
toggle.icon = "material/toggle-switch-off-outline"
3454
toggle.name = "Switch to light mode"
3555

56+
# Palette toggle for light mode
3657
[[project.theme.palette]]
3758
media = "(prefers-color-scheme: light)"
3859
scheme = "default"
39-
primary = "indigo"
40-
accent = "green"
41-
toggle.icon = "lucide/sun"
60+
primary = "black"
61+
accent = "light blue"
62+
toggle.icon = "material/toggle-switch"
4263
toggle.name = "Switch to system preference"
4364

44-
[project.theme.icon]
45-
repo = "fontawesome/brands/github"
65+
[project.plugins.meta]
66+
67+
[project.plugins.search]
4668

4769
[project.markdown_extensions.toc]
48-
permalink = true
70+
permalink = "#"
4971

5072
[project.markdown_extensions.attr_list]
73+
74+
[project.markdown_extensions.abbr]
75+
5176
[project.markdown_extensions.admonition]
77+
78+
[project.markdown_extensions.def_list]
79+
80+
[project.markdown_extensions.footnotes]
81+
5282
[project.markdown_extensions.md_in_html]
83+
84+
[project.markdown_extensions.tables]
85+
5386
[project.markdown_extensions.pymdownx.details]
87+
5488
[project.markdown_extensions.pymdownx.superfences]
89+
custom_fences = [
90+
{ name = "mermaid", class = "mermaid", format = "pymdownx.superfences.fence_code_format" },
91+
]
92+
93+
[project.markdown_extensions.pymdownx.tasklist]
94+
custom_checkbox = true
5595

5696
[[project.extra.social]]
5797
icon = "fontawesome/brands/discord"
58-
link = "https://discord.gg/jedJWCPAhD"
98+
link = "https://discord.psmodule.io"
5999
name = "-{{ REPO_OWNER }}- on Discord"
60100

61101
[[project.extra.social]]
62102
icon = "fontawesome/brands/github"
63103
link = "https://github.com/-{{ REPO_OWNER }}-/"
64104
name = "-{{ REPO_OWNER }}- on GitHub"
65-
66-
[project.extra.consent]
67-
title = "Cookie consent"
68-
description = "We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better."
69-
actions = ["accept", "reject"]

‎docs/overrides/assets/javascripts/tablesort.js‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,5 +12,18 @@ document$.subscribe(function () {
1212
}
1313
}
1414
new Tablesort(table);
15+
16+
// Tablesort makes header cells focusable (tabindex=0) and sorts on click,
17+
// but does not handle keyboard activation. Let Enter/Space sort too, so the
18+
// sortable headers are usable without a mouse. Cover both th and td header
19+
// cells, since a thead synthesized from the first row may hold td cells.
20+
table.querySelectorAll("thead th, thead td").forEach(function (header) {
21+
header.addEventListener("keydown", function (event) {
22+
if (event.key === "Enter" || event.key === " ") {
23+
event.preventDefault();
24+
header.click();
25+
}
26+
});
27+
});
1528
});
1629
});

‎docs/overrides/assets/javascripts/tablesort.min.js‎

Lines changed: 6 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎docs/zensical.toml‎

Lines changed: 2 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -8,58 +8,15 @@ docs_dir = "content"
88
repo_name = "PSModule/Process-PSModule"
99
repo_url = "https://github.com/PSModule/Process-PSModule"
1010
edit_uri = "edit/main/docs/content/"
11-
copyright = "Copyright &copy; 2023 - 2025 PSModule"
11+
copyright = "Copyright &copy; 2023 - 2026 PSModule"
1212
extra_javascript = [
13-
"https://unpkg.com/tablesort@5.3.0/dist/tablesort.min.js",
13+
"assets/javascripts/tablesort.min.js",
1414
"assets/javascripts/tablesort.js",
1515
]
1616
extra_css = [
1717
"assets/stylesheets/navigation.css",
1818
]
1919
watch = ["includes"]
20-
nav = [
21-
"index.md",
22-
{"Get started" = [
23-
"get-started/index.md",
24-
{"Repository setup" = "get-started/repository-setup.md"},
25-
{"Your first release" = "get-started/your-first-release.md"},
26-
{"Module bootstrap" = "get-started/module-bootstrap.md"},
27-
]},
28-
{"Guides" = [
29-
{"Calling the workflow" = "guides/calling-the-workflow.md"},
30-
{"Configuring the pipeline" = "guides/configuring-the-pipeline.md"},
31-
{"Structuring your module" = "guides/structuring-your-module.md"},
32-
{"Writing module tests" = "guides/writing-module-tests.md"},
33-
{"Skipping framework tests" = "guides/skipping-framework-tests.md"},
34-
{"Versioning and releases" = "guides/versioning-and-releases.md"},
35-
{"Validating before review" = "guides/validating-before-review.md"},
36-
]},
37-
{"Reference" = [
38-
{"Module development foundations" = "reference/module-development-foundations.md"},
39-
{"Repository Standard" = "reference/repository-standard.md"},
40-
{"PowerShell module standard" = "reference/powershell-module-standard.md"},
41-
{"Module types" = "reference/module-types.md"},
42-
{"Test Specification" = "reference/test-specification.md"},
43-
{"Versioning" = "reference/versioning.md"},
44-
{"Settings" = "reference/settings.md"},
45-
{"Workflow inputs" = "reference/workflow-inputs.md"},
46-
{"Pipeline stages" = "reference/pipeline-stages.md"},
47-
{"Scenario matrix" = "reference/scenario-matrix.md"},
48-
{"Framework test IDs" = "reference/framework-test-ids.md"},
49-
{"Dependencies" = "reference/dependencies.md"},
50-
{"PowerShell guidance scripts" = "reference/guidance-scripts.md"},
51-
]},
52-
{"Specification" = [
53-
"specification/index.md",
54-
{"Spec" = "specification/spec.md"},
55-
{"Design" = "specification/design.md"},
56-
{"Principles and practices" = "specification/principles-and-practices.md"},
57-
]},
58-
{"Modules" = "Modules/index.md"},
59-
{"Dictionary" = [
60-
"Dictionary/index.md",
61-
]},
62-
]
6320

6421
[project.theme]
6522
language = "en"

0 commit comments

Comments
 (0)