Files
blog/README.md
Gabriel Vidal aacec8703e chore: drop the dead GitHub Pages workflow, add CLAUDE.md
`.github/workflows/main.yml` triggered on the `new-main` branch, which has not
been the publishing branch for a long time — the site is built and rsynced to
zipgo on raspy2 by `npm run deploy`. It was dead weight pointing at the wrong
deploy story, so remove it; there is no CI now.

Add a project CLAUDE.md. Its main rule: any post generated by Claude MUST carry
the AI-disclosure callout at the top of the body, with the exact block to paste;
plus the frontmatter/asset conventions, the tailwind-scans-markdown and
postbuild-search-index gotchas, and the verify-before-deploy steps.

Fix two stale README claims while here: posts live in src/content/blog (not
src/pages/blog) and drafts in src/drafts.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-06 13:16:33 +02:00

42 lines
1.4 KiB
Markdown

# Blog
My personal website / blog — live at **[blog.dev.gabvdl.xyz](https://blog.dev.gabvdl.xyz)**.
Built with [Astro](https://astro.build/) (based on the *astro-ink* theme): MDX posts,
client-side search (Lunr), tags, RSS and a sitemap.
## Develop
```sh
yarn
yarn dev # astro dev
yarn build # static build → dist/ (+ postbuild search index)
yarn preview
```
Posts live under `src/content/blog/` (`src/pages/blog/` holds the routes that
render them); drafts under `src/drafts/`. The public URL
and canonical/sitemap origin are set via `site` in [`astro.config.mjs`](astro.config.mjs).
## Deploy
```sh
npm run deploy # build + rsync dist/ to zipgo on raspy2
```
[`scripts/deploy.sh`](scripts/deploy.sh) uses the `zipgo deploy` CLI to mirror
`dist/` into `domains/gabvdl.xyz/dev./blog.` on the remote, which serves
`https://blog.dev.gabvdl.xyz` over Let's Encrypt HTTPS. The host → folder map also
lives in `package.json` under `zipgo.deploy`.
There is no CI. The old GitHub Pages workflow was deleted — it triggered on a
long-dead branch and had not been publishing this site for a long time.
## Remotes
`origin` is the self-hosted Gitea at
[`git.gabvdl.xyz/gabrielvidal/blog`](https://git.gabvdl.xyz/gabrielvidal/blog) —
that is the canonical repo. `github` remains as a secondary mirror of the old
`GabrielVidal1/gabrielvidal1.github.io` repository; push there too if you want it
kept in sync, but nothing depends on it.