Skip to content

Docs/zensical site#6

Merged
jaschadub merged 3 commits into
mainfrom
docs/zensical-site
May 15, 2026
Merged

Docs/zensical site#6
jaschadub merged 3 commits into
mainfrom
docs/zensical-site

Conversation

@jaschadub
Copy link
Copy Markdown
Contributor

No description provided.

jaschadub added 3 commits May 14, 2026 22:47
Placed at docs/CNAME so it travels with the documentation source.
GitHub Pages serving directly from /docs on main picks it up natively;
any workflow that builds Zensical output into a separate publish branch
should copy docs/CNAME to the publish root.
Builds the Zensical site from docs/ + zensical.toml on every push to
main that touches the docs sources, copies docs/CNAME into the build
output (site/), and deploys to GitHub Pages via the native pages
actions (no gh-pages branch).

Manual triggers via workflow_dispatch are enabled so the site can be
rebuilt without a docs commit.

After this lands, configure the repository:
  Settings -> Pages -> Source: GitHub Actions
  Settings -> Pages -> Custom domain: docs.vectorpin.org
  Settings -> Pages -> Enforce HTTPS: on (after DNS resolves)

And add the DNS record:
  docs.vectorpin.org CNAME thirdkeyai.github.io
- configure-pages step first (enables Pages programmatically)
- Single-job deploy instead of split build/deploy
- zensical build --clean for reproducible output
- actions/upload-pages-artifact@v4 and actions/checkout@v5 to match the
  versions AgentPin runs in production
- Floating python-version: 3.x

Kept relative to AgentPin's workflow:
- workflow_dispatch for manual rebuilds
- concurrency group: pages (cancel-in-progress: false) so a doc bump
  during deploy queues instead of cancelling
- cp docs/CNAME -> site/CNAME instead of echo (docs/CNAME stays the
  single source of truth in the repo)
@jaschadub jaschadub merged commit 225d142 into main May 15, 2026
5 checks passed
@jaschadub jaschadub deleted the docs/zensical-site branch May 15, 2026 05:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant