Migrate to Zensical (#654)

* feat: migrate to Zensical

* feat: new gh build

* fix: workflow permissions

* feat: use our logo

* fix: replace mkdocs in requirement.txt with Zensical

* feat: use actual redirect

* misc: replace logo with small one

* Revert "misc: replace logo with small one"

This reverts commit d38932865b.

* Remove unused filter

---------

Co-authored-by: Aditya Garg <gargaditya08@live.com>
This commit is contained in:
Noa Himesaka
2025-11-07 14:50:29 +05:30
committed by GitHub
co-authored by Aditya Garg
parent e8fb11f58d
commit 84594e7c3a
8 changed files with 426 additions and 18 deletions
+17 -9
View File
@@ -3,6 +3,10 @@ on:
push:
branches:
- master
permissions:
contents: read
pages: write
id-token: write
jobs:
lint:
@@ -18,12 +22,16 @@ jobs:
name: Deploy docs
runs-on: ubuntu-latest
steps:
- name: Checkout master
uses: actions/checkout@v5
- name: Deploy docs
uses: mhausenblas/mkdocs-deploy-gh-pages@1.26
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
CUSTOM_DOMAIN: wiki.t2linux.org
EXTRA_PACKAGES: build-base
- uses: actions/configure-pages@v5
- uses: actions/checkout@v5
- uses: actions/setup-python@v5
with:
python-version: 3.x
- run: pip install zensical
- run: zensical build --clean
- run: bash -c "echo 'wiki.t2linux.org' > build/CNAME"
- run: bash -c "cp -r redirs/* build/guides"
- uses: actions/upload-pages-artifact@v4
with:
path: build
- uses: actions/deploy-pages@v4
+2 -1
View File
@@ -1,2 +1,3 @@
# mkdocs
build/
build/
.DS_Store
+21 -3
View File
@@ -1,13 +1,30 @@
# To build the documentation use `build.py`
# To build the documentation use Zensical
site_name: t2linux wiki
site_author: the t2linux.org contributors
site_url: https://t2linux.org/
copyright: "© 2021-2024 t2linux.org CC-BY-SA-4.0"
copyright: "© 2021-2025 t2linux.org CC-BY-SA-4.0"
theme:
palette:
scheme: slate
- media: "(prefers-color-scheme)"
toggle:
icon: material/brightness-auto
name: Switch to light mode
# Palette toggle for light mode
- media: "(prefers-color-scheme: light)"
scheme: default
toggle:
icon: material/brightness-7
name: Switch to dark mode
# Palette toggle for dark mode
- media: "(prefers-color-scheme: dark)"
scheme: slate
toggle:
icon: material/brightness-4
name: Switch to system preference
name: material
custom_dir: theme
font: false
@@ -18,6 +35,7 @@ theme:
- content.code.copy
- navigation.top
favicon: assets/images/icon.png
logo: assets/images/t2linux-logo-large.svg
docs_dir: docs
site_dir: build
+13
View File
@@ -0,0 +1,13 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Redirecting...</title>
<link rel="canonical" href="../postinstall/">
<script>var anchor=window.location.hash.substr(1);location.href="../postinstall/"+(anchor?"#"+anchor:"")</script>
<meta http-equiv="refresh" content="0; url=../postinstall/">
</head>
<body>
You're being redirected to a <a href="../postinstall/">new destination</a>.
</body>
</html>
+13
View File
@@ -0,0 +1,13 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Redirecting...</title>
<link rel="canonical" href="../wifi-bluetooth/">
<script>var anchor=window.location.hash.substr(1);location.href="../wifi-bluetooth/"+(anchor?"#"+anchor:"")</script>
<meta http-equiv="refresh" content="0; url=../wifi-bluetooth/">
</head>
<body>
You're being redirected to a <a href="../wifi-bluetooth/">new destination</a>.
</body>
</html>
+1 -3
View File
@@ -1,6 +1,4 @@
# This file contains the direct dependencies required for building the docs
# To install them all run 'pip install -r requirements.txt' in the same directory
mkdocs == 1.6.1
mkdocs-material == 9.6.23
mkdocs-redirects == 1.2.2
zensical == 0.0.4
File diff suppressed because one or more lines are too long

After

Width:  |  Height:  |  Size: 46 KiB

+7 -2
View File
@@ -1,5 +1,10 @@
{% extends "base.html" %}
{% block announce %}
Join our <a href="https://discord.com/invite/68MRhQu">Discord Server</a>
{% endblock %}
<style>
.announce-text {
color: var(--md-typeset-color);
}
</style>
<span class="announce-text">Join our <a href="https://discord.com/invite/68MRhQu">Discord Server</a></span>
{% endblock %}