Polish zensical docs migration

Author: tobiasraabe

CHANGELOG.md

@@ -11,6 +11,8 @@ releases are available on [PyPI](https://pypi.org/project/pytask) and
   lockfile as the primary state backend with a portable format and documentation. When
   no lockfile exists, pytask reads the legacy SQLite state and writes `pytask.lock`;
   `pytask build` continues updating the legacy database for downgrade compatibility.
+- [#789](https://github.com/pytask-dev/pytask/pull/789) switches the documentation
+  site to [Zensical](https://zensical.org/).
 - [#787](https://github.com/pytask-dev/pytask/pull/787) makes the `attributes` field mandatory on `PNode` and
   `PProvisionalNode`, and preserves existing node attributes when loading entries from
   the data catalog.

docs/source/_static/css/custom.css

@@ -51,6 +51,16 @@
     color: inherit !important;
 }
 
+body[data-md-color-scheme="default"] .md-typeset a.home-tile,
+body[data-md-color-scheme="default"] .md-typeset a.home-tile:hover,
+body[data-md-color-scheme="default"] .md-typeset a.home-tile:focus,
+body[data-md-color-scheme="default"] .md-typeset a.home-tile:focus-visible,
+body[data-md-color-scheme="default"] .md-typeset a.home-tile:active,
+body[data-md-color-scheme="default"] .md-typeset a.home-tile:visited {
+    background: #ffffff !important;
+    background-color: #ffffff !important;
+}
+
 .md-typeset a.home-tile *,
 .md-typeset a.home-tile:hover *,
 .md-typeset a.home-tile:focus *,
@@ -69,7 +79,7 @@
 
 .home-tile p {
     margin: 0;
-    color: #4b5563;
+    color: inherit;
     line-height: 1.45;
 }
 
@@ -90,94 +100,19 @@ li pre {
     padding-left: 0;
 }
 
-.page-hint-nav {
-    display: flex;
-    justify-content: space-between;
-    gap: 1rem;
-    margin-top: 2rem;
-    padding-top: 1rem;
-    border-top: 1px solid rgba(15, 23, 42, 0.13);
-}
-
-.page-hint {
-    display: flex;
-    flex-direction: column;
-    position: relative;
-    gap: 0.02rem;
-    text-decoration: none !important;
-    box-shadow: none !important;
-    border-bottom: 0 !important;
-}
-
-.page-hint,
-.page-hint:hover,
-.page-hint:focus,
-.page-hint:focus-visible,
-.page-hint * {
-    text-decoration: none !important;
-    box-shadow: none !important;
-    border-bottom: 0 !important;
-}
-
-.page-hint--next {
-    text-align: right;
-    margin-left: auto;
-    padding-right: 1rem;
-}
-
-.page-hint--prev {
-    padding-left: 1rem;
-}
-
-.page-hint__label {
-    color: #8c96a6;
-    font-size: 0.62rem;
-    font-weight: 500;
-    letter-spacing: 0.01em;
-    line-height: 1.2;
-}
-
-.page-hint__title {
-    color: #1d4ed8;
-    font-size: 0.68rem;
-    font-weight: 500;
-    line-height: 1.2;
+body[data-md-color-scheme="slate"] .home-tile {
+    border-color: rgba(203, 213, 225, 0.24);
+    background: rgba(15, 23, 42, 0.38);
+    box-shadow: 0 4px 12px rgba(2, 6, 23, 0.38);
 }
 
-.page-hint__caret {
-    position: absolute;
-    top: 50%;
-    transform: translateY(-50%);
-    color: #9ca3af;
-    font-size: 1.35rem;
-    line-height: 1;
-    pointer-events: none;
+body[data-md-color-scheme="slate"] .home-tile:hover {
+    border-color: rgba(147, 197, 253, 0.55);
+    box-shadow: 0 12px 26px rgba(2, 6, 23, 0.46);
 }
 
-.page-hint--next .page-hint__caret {
-    right: 0;
-}
-
-.page-hint--prev .page-hint__caret {
-    left: 0;
-}
-
-@media (max-width: 760px) {
-    .page-hint-nav {
-        flex-direction: column;
-    }
-
-    .page-hint--next {
-        margin-left: 0;
-        text-align: left;
-        padding-right: 0;
-        padding-left: 1rem;
-    }
-
-    .page-hint--next .page-hint__caret {
-        right: auto;
-        left: 0;
-    }
+body[data-md-color-scheme="slate"] .home-tile p {
+    color: inherit;
 }
 
 @media (prefers-color-scheme: dark) {
@@ -191,28 +126,4 @@ li pre {
         border-color: rgba(147, 197, 253, 0.55);
         box-shadow: 0 12px 26px rgba(2, 6, 23, 0.46);
     }
-
-    .home-tile p {
-        color: #cbd5e1;
-    }
-
-    .home-tile img {
-        filter: brightness(1.2) invert(0.9);
-    }
-
-    .page-hint-nav {
-        border-top-color: rgba(203, 213, 225, 0.24);
-    }
-
-    .page-hint__label {
-        color: #94a3b8;
-    }
-
-    .page-hint__title {
-        color: #93c5fd;
-    }
-
-    .page-hint__caret {
-        color: #94a3b8;
-    }
 }

docs/source/_static/images/book.svg

@@ -172,69 +172,3 @@ document.addEventListener("keydown", event => {
         window.location.href = link.href;
     }
 });
-
-function getTitleForUrl(url) {
-    const targetPath = new URL(url, window.location.href).pathname;
-    const navLinks = document.querySelectorAll(".md-nav a[href], .md-tabs a[href]");
-
-    for (const link of navLinks) {
-        const linkPath = new URL(link.href, window.location.href).pathname;
-        if (linkPath === targetPath) {
-            return link.textContent.trim().replace(/\s+/g, " ");
-        }
-    }
-
-    const fileName = targetPath.split("/").pop() || "";
-    return fileName.replace(".html", "").replace(/[-_]/g, " ");
-}
-
-function createPageHintNav() {
-    const prev = document.querySelector('link[rel="prev"]');
-    const next = document.querySelector('link[rel="next"]');
-
-    if (!prev && !next) {
-        return;
-    }
-
-    const article = document.querySelector("article.md-content__inner");
-    if (!article) {
-        return;
-    }
-
-    const nav = document.createElement("nav");
-    nav.className = "page-hint-nav";
-    nav.setAttribute("aria-label", "Page navigation");
-
-    function buildLink(rel, href) {
-        const direction = rel === "next" ? "next" : "prev";
-        const anchor = document.createElement("a");
-        anchor.className = `page-hint page-hint--${direction}`;
-        anchor.href = href;
-
-        const label = document.createElement("span");
-        label.className = "page-hint__label";
-        label.textContent = direction === "next" ? "Next" : "Previous";
-
-        const title = document.createElement("span");
-        title.className = "page-hint__title";
-        title.textContent = getTitleForUrl(href);
-
-        const caret = document.createElement("span");
-        caret.className = "page-hint__caret";
-        caret.textContent = direction === "next" ? "›" : "‹";
-
-        anchor.append(label, title, caret);
-        return anchor;
-    }
-
-    if (prev?.href) {
-        nav.appendChild(buildLink("prev", prev.href));
-    }
-    if (next?.href) {
-        nav.appendChild(buildLink("next", next.href));
-    }
-
-    article.appendChild(nav);
-}
-
-createPageHintNav();

docs/source/_static/images/books.svg

@@ -1,14 +1,14 @@
-# The Lock File
+# The Lockfile
 
 `pytask.lock` is the default state backend. It stores task state in a portable,
 git-friendly format so runs can be resumed or shared across machines.
 
-```{note}
-SQLite is the legacy format. When no lockfile exists, pytask reads the legacy database
-state and writes `pytask.lock`. The lockfile remains the primary backend for skip
-decisions, and `pytask build` also keeps the legacy database updated for downgrade
-compatibility.
-```
+!!! note
+
+    SQLite is the legacy format. When no lockfile exists, pytask reads the legacy database
+    state and writes `pytask.lock`. The lockfile remains the primary backend for skip
+    decisions, and `pytask build` also keeps the legacy database updated for downgrade
+    compatibility.
 
 ## Example