- privacy (effective 2026-10-24): bug reports live in a private repository (they now do — the site files them in poli0981/site-reports); widget thumbnails and game icons are served by the site itself, so nothing reaches YouTube or Steam before you press play; Workers Logs (7-day retention) and expiring IP blocks are disclosed; the service worker's offline cache is listed with the other local storage. - ai-usage: §3 says what is true — changes still reach the site only through PRs that pass CI, and the AI agent merges/deploys them only when explicitly told to; Claude Opus 5.5 added to the model table. - third-party: the libraries and every infrastructure service the site uses (R2, Images, Access, Workers Logs, Discord). - README: gallery-photos/ and now/, and how publishing works from the admin. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.0 KiB
poli0981/content
Content for poli0981.dev — blog posts, stories, project pages, Q&A entries, gallery album metadata, and the legal texts.
This repository is consumed as a git submodule mounted at src/content/ in
poli0981/poli0981-dev. The site's Astro
content collections read directly from these paths, so the directory names here are load-bearing:
| Directory | Collection | Notes |
|---|---|---|
blog/ |
blog |
.md / .mdx, one file per locale (lang: vi | en, paired by translationKey) |
stories/ |
stories |
<series>/<chapter>.md — the folder name is the series route segment |
projects/ |
projects |
standalone schema (name, tagline, stack, repo, year…) |
faq/ |
faq |
q, lang, group (channel / dev / personal), order |
gallery/ |
gallery |
album metadata only; photos are local files in the site repo (src/assets/gallery/<album>/) and/or R2 uploads listed in gallery-photos/<album>.json |
gallery-photos/ |
— | per-album R2 photo lists ({ photos: [{ id, w, h, caption: { vi, en } }] }), written by the admin |
legal/ |
legal |
bilingual within one file (## English then ## Tiếng Việt); both locale routes render the same document |
now/ |
now |
the /now page, one file per locale (updated is required) |
Editing
Frontmatter is validated by Zod at build time in the site repo
(src/content.config.ts) — a missing or misspelled field fails the build rather than
rendering something broken. Notable rules:
descriptionmax 200 chars,titlemax 120langmust bevioren; pair translations with a sharedtranslationKeydraft: truehides an entry from production builds but keeps it visible innpm run dev- gallery albums need a
captions.jsonin the site repo with bothviandenfor every image, or the build fails
blog/lan-dau-viet-truyen.mdx imports @/components/Callout.astro. That alias resolves
into the site repo, which works because the submodule is mounted inside its src/.
MDX files can only use components that exist there.
Publishing a change
Most edits happen in the admin (admin.poli0981.dev), which commits straight to main here.
Its Publish button then runs the site repo's content-bump workflow: a PR that points the
submodule at this repo's main, merged automatically once CI passes when only .md/.json
changed (MDX runs code at build time, so it waits for a review).
Editing by hand works the same way: commit here, then bump the submodule pointer in the site repo — the site builds from the commit that repo has pinned, so a commit here alone does not deploy anything.
License
Code in the site repo is GPL-3.0-only. The content in this repository is not.
See CONTENT-LICENSE.md: © Kokone (SkullMute), all rights reserved,
and explicitly not licensed for machine-learning training.