Add initial Zensical configuration and create index documentation

Author: MariusStorhaug

.github/workflows/Pages.yml

@@ -0,0 +1,53 @@
+name: Publish Site
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+    paths:
+      - docs/**
+      - zensical.toml
+      - .github/workflows/Pages.yml
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build and deploy site
+    runs-on: ubuntu-24.04
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    steps:
+      - uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5.0.0
+
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: 3.x
+
+      - name: Install Zensical
+        run: pip install zensical
+
+      - name: Build Zensical project
+        run: zensical build --clean
+
+      - uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0
+        with:
+          path: site
+
+      - uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5.0.0
+        id: deployment

docs/index.md

@@ -0,0 +1,47 @@
+---
+hide:
+  - navigation
+  - toc
+---
+
+# A GitHub & PowerShell development framework
+
+We empower PowerShell-savvy developers to effortlessly transform their ideas into impactful solutions.
+Our approach centres around a development framework that lets developers focus on delivering value through their code —
+by leveraging GitHub and PowerShell to automate repetitive tasks, so you can concentrate on what matters most.
+
+<div class="grid cards" markdown>
+
+- :material-book-open-outline: **Documentation**
+
+    ---
+
+    Guides, standards, and ways of working for building with PSModule.
+
+    [:octicons-arrow-right-24: Read the docs](https://psmodule.io/docs/)
+
+- :material-package-variant: **PowerShell Gallery**
+
+    ---
+
+    Browse and install all published PSModule packages.
+
+    [:octicons-arrow-right-24: Open PowerShell Gallery](https://www.powershellgallery.com/profiles/PSModule.io)
+
+- :fontawesome-brands-github: **GitHub**
+
+    ---
+
+    Explore the source code and contribute to the framework.
+
+    [:octicons-arrow-right-24: Visit GitHub](https://github.com/PSModule)
+
+- :fontawesome-brands-discord: **Community**
+
+    ---
+
+    Join the conversation and get help from the community.
+
+    [:octicons-arrow-right-24: Join Discord](https://discord.gg/jedJWCPAhD)
+
+</div>

zensical.toml

@@ -0,0 +1,62 @@
+# Zensical configuration
+# https://zensical.org/docs/setup/basics/
+
+[project]
+site_name = "PSModule"
+site_url = "https://psmodule.io/"
+docs_dir = "docs"
+repo_name = "PSModule"
+repo_url = "https://github.com/PSModule"
+copyright = "Copyright © 2023 - 2025 PSModule"
+
+[project.theme]
+language = "en"
+font.text = "Mona Sans"
+font.code = "Source Code Pro"
+features = [
+  "navigation.instant",
+  "navigation.instant.progress",
+  "navigation.top",
+]
+
+[project.theme.icon]
+repo = "material/github"
+
+# Palette toggle for dark mode
+[[project.theme.palette]]
+media = "(prefers-color-scheme: dark)"
+scheme = "slate"
+primary = "black"
+accent = "light blue"
+toggle.icon = "material/toggle-switch-off-outline"
+toggle.name = "Switch to light mode"
+
+# Palette toggle for light mode
+[[project.theme.palette]]
+media = "(prefers-color-scheme: light)"
+scheme = "default"
+primary = "black"
+accent = "light blue"
+toggle.icon = "material/toggle-switch"
+toggle.name = "Switch to system preference"
+
+[project.plugins.search]
+
+[project.markdown_extensions.attr_list]
+
+[project.markdown_extensions.md_in_html]
+
+[[project.extra.social]]
+icon = "fontawesome/brands/discord"
+link = "https://discord.gg/jedJWCPAhD"
+name = "PSModule on Discord"
+
+[[project.extra.social]]
+icon = "material/powershell"
+link = "https://www.powershellgallery.com/profiles/PSModule.io"
+name = "PSModule on the PowerShell Gallery"
+
+[[project.extra.social]]
+icon = "fontawesome/brands/github"
+link = "https://github.com/PSModule/"
+name = "PSModule on GitHub"