{"id":47971903,"url":"https://github.com/frenchvandal/normco.re","last_synced_at":"2026-04-04T10:46:13.180Z","repository":{"id":342286070,"uuid":"1173503453","full_name":"frenchvandal/normco.re","owner":"frenchvandal","description":"The source code of my blog","archived":false,"fork":false,"pushed_at":"2026-04-03T17:02:19.000Z","size":156979,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-03T17:10:20.363Z","etag":null,"topics":["deno","lume","typescript"],"latest_commit_sha":null,"homepage":"https://normco.re","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frenchvandal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-05T12:46:13.000Z","updated_at":"2026-04-03T17:02:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/frenchvandal/normco.re","commit_stats":null,"previous_names":["frenchvandal/turbo-fiesta","frenchvandal/normco.re"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/frenchvandal/normco.re","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frenchvandal%2Fnormco.re","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frenchvandal%2Fnormco.re/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frenchvandal%2Fnormco.re/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frenchvandal%2Fnormco.re/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frenchvandal","download_url":"https://codeload.github.com/frenchvandal/normco.re/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frenchvandal%2Fnormco.re/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31397055,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deno","lume","typescript"],"created_at":"2026-04-04T10:46:13.090Z","updated_at":"2026-04-04T10:46:13.154Z","avatar_url":"https://github.com/frenchvandal.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# normco.re\n\nnormco.re is Phiphi's multilingual personal site. It is built with\n[Deno](https://deno.com/) and [Lume](https://lume.land/), rendered with TSX\ntemplates and Markdown content, styled with a local `--ph-*` token system plus\nroute-scoped Ant Design blog islands, and deployed as a static site to\n[normco.re](https://normco.re).\n\n## Overview\n\n- Pages, layouts, and shared UI components are authored in TypeScript, with the\n  rendered site shell and reusable UI expressed in TSX.\n- Editorial post bodies live in Markdown under `src/posts/\u003cslug\u003e/`.\n- Shared post metadata lives in `src/posts/\u003cslug\u003e/_data.yml`.\n- Build processors enrich each localized post with Git-derived created and\n  updated dates, plus a last-commit link, whenever full repository history is\n  available.\n- The site is localized in English, French, Simplified Chinese, and Traditional\n  Chinese.\n- The UI is built on a local `--ph-*` token layer in\n  `src/styles/antd/theme-tokens.css`.\n- The visual direction is Swiss editorial with restrained monochrome surfaces,\n  one blue accent family, generous whitespace, and Ant Design reserved for the\n  interactive blog surfaces.\n- The stylesheet entrypoint is `src/style.css`, which composes the site's five\n  cascade layers (`tokens`, `reset`, `base`, `layout`, `utilities`) while\n  importing the generated Ant Design bridge and component modules into that\n  ordered pipeline.\n- The writing archive is enhanced by a route-split Ant Design client with a\n  timeline and month navigator rather than duplicating the home page.\n- Search exposes inline loading, retry, and result feedback with accessible\n  status announcements, plus Pagefind-backed `tag` and `year` facets on post\n  detail pages.\n- Repository utilities standardize on Deno core APIs plus Deno std helpers for\n  CLI parsing, recursive filesystem traversal, XML validation, escaping, and\n  frontmatter parsing.\n- GitHub Actions builds the site and deploys it to Alibaba Cloud OSS and CDN by\n  way of OIDC.\n\n## Getting Started\n\n```sh\ngit clone https://github.com/frenchvandal/normco.re.git\ncd normco.re\n\n# Optional: install git hooks\ndeno task lefthook:install\n\n# Start the local development server\ndeno task serve\n```\n\nIf your environment requires system CA certificates, prefix commands with\n`DENO_TLS_CA_STORE=system`.\n\n## Daily Commands\n\n| Task             | Command                                     | Notes                                                                   |\n| ---------------- | ------------------------------------------- | ----------------------------------------------------------------------- |\n| Serve            | `deno task serve`                           | Starts the local site and LumeCMS                                       |\n| Check            | `deno task check`                           | Type-checks the codebase                                                |\n| Test             | `deno task test`                            | Runs unit and integration tests                                         |\n| Coverage         | `deno task test:coverage`                   | Collects coverage data under `.tmp/deno-coverage`                       |\n| Coverage summary | `deno task coverage:summary`                | Prints the latest coverage summary                                      |\n| Coverage HTML    | `deno task coverage:html`                   | Generates browsable HTML from the latest coverage run                   |\n| Doc tests        | `deno task test:doc`                        | Runs JSDoc examples as executable documentation tests                   |\n| Design guard     | `deno task design:guard`                    | Blocks normalized UI literals outside tokenized paths                   |\n| Typography guard | `deno task typography:guard`                | Fails on smart quotes/apostrophes in Markdown/comments                  |\n| Lint commit      | `deno task lint-commit .git/COMMIT_EDITMSG` | Validates a commit message with `@miscellaneous/commitlint`             |\n| Validate         | `deno task validate`                        | Runs both guards, check, test, and build                                |\n| Build            | `deno task build`                           | Builds `_site/` for production                                          |\n| Contracts        | `deno task validate-contracts`              | Validates feeds structurally and optional JSON outputs                  |\n| Android assets   | `deno task android:sync-contract-assets`    | Builds site contracts and mirrors Android bootstrap assets              |\n| Payload report   | `deno task payload:report`                  | Reports route-level JS and CSS from generated output                    |\n| Install hooks    | `deno task lefthook:install`                | Installs local Git hooks                                                |\n| Regenerate locks | `deno task locks:regen`                     | Rebuilds the root and frontend `deno.lock` files from the current graph |\n| Update deps      | `deno task update-deps`                     | Updates pinned dependencies, then normalizes both lockfiles via regen   |\n\nRecommended verification for a nontrivial change:\n\n```sh\ndeno fmt\ndeno task check\ndeno task test\ndeno task build\n```\n\n## Project Layout\n\n```text\n.\n├── _config.ts\n├── _config/\n├── _cms.ts\n├── apps/\n│   └── android/\n├── contracts/\n├── plugins/\n├── scripts/\n├── src/\n│   ├── _archetypes/\n│   ├── blog/client/\n│   ├── _components/\n│   ├── _includes/layouts/\n│   ├── posts/\n│   │   └── \u003cslug\u003e/\n│   │       ├── _data.yml\n│   │       ├── en.md\n│   │       ├── fr.md\n│   │       ├── zh-hans.md\n│   │       └── zh-hant.md\n│   ├── tags/\n│   ├── scripts/\n│   ├── styles/\n│   │   └── components/\n│   ├── utils/\n│   │   └── i18n/\n│   ├── 404.page.tsx\n│   ├── about.page.tsx\n│   ├── index.page.tsx\n│   ├── offline.page.tsx\n│   └── style.css\n├── AGENTS.md\n├── ARCHITECTURE.md\n├── deno.jsonc\n└── deno.lock\n```\n\n## Content Model\n\n### Posts\n\nEach post lives in its own slug directory:\n\n- `src/posts/\u003cslug\u003e/_data.yml` stores shared metadata such as the stable `id`,\n  `date`, `url`, and optional `tags`\n- `src/posts/\u003cslug\u003e/en.md`\n- `src/posts/\u003cslug\u003e/fr.md`\n- `src/posts/\u003cslug\u003e/zh-hans.md`\n- `src/posts/\u003cslug\u003e/zh-hant.md`\n\nEach language file contains frontmatter and a Markdown body. Shared defaults for\nall posts remain in [src/posts/_data.ts](./src/posts/_data.ts).\n\n### Pages and Taxonomies\n\nRoute-level pages are TypeScript entry modules under `src/` and render through\nTSX layouts:\n\n- `/`\n- `/about/`\n- `/posts/`\n- `/tags/\u003cslug\u003e/`\n- `/offline/`\n- `/404.html`\n\nLocalized routes follow the same structure under `/fr/`, `/zh-hans/`, and\n`/zh-hant/`.\n\nThe `/posts/` archive is rendered from TSX and enhanced by a small route-scoped\nAnt Design client bundle that adds the timeline and month navigation UI. Shared\narchive grouping and formatting logic lives in `src/blog/archive-common.ts` so\nthe SSR renderer and client views stay aligned.\n\n### Feeds\n\nThe site emits localized RSS, Atom, and JSON feeds:\n\n- `/rss.xml`, `/atom.xml`, and `/feed.json`\n- `/fr/rss.xml`, `/fr/atom.xml`, and `/fr/feed.json`\n- `/zh-hans/rss.xml`, `/zh-hans/atom.xml`, and `/zh-hans/feed.json`\n- `/zh-hant/rss.xml`, `/zh-hant/atom.xml`, and `/zh-hant/feed.json`\n\n`src/_includes/layouts/base.tsx` publishes the localized RSS, Atom, and JSON\nfeed endpoints via standard `rel=\"alternate\"` links in the document head.\n\n## Authoring Workflow\n\nCreate a new post with the Lume archetype:\n\n```sh\ndeno task lume new post \"My Post Title\" \"A short description.\" design writing\n```\n\nThat command scaffolds the shared metadata file and all four localized Markdown\nfiles.\n\nWhen editing an existing post:\n\n1. Update shared metadata in `_data.yml`.\n2. Edit each language body in its Markdown file.\n3. Keep public URLs stable unless a route change is intentional.\n\nIf a legacy post is still missing a shared `id`, run:\n\n```sh\ndeno task posts:fix-ids\n```\n\nThat task writes UUID v7 values into post `_data.yml` files that still lack an\nexplicit `id`.\n\nEditorial images should live alongside the post, for example:\n\n```text\nsrc/posts/my-post/images/hero.png\n```\n\nThen reference them from Markdown with relative paths.\n\n## Styling and UI\n\nThe site uses a local `--ph-*` token layer for the global shell and Ant Design\nfor the interactive blog client bundles.\n\n- Design-system authority: the local `--ph-*` token system and the site's core\n  layout layer\n- Local theme bridge: `src/styles/antd/theme-tokens.css`\n- Generated Ant Design bridge: `src/styles/generated/antd-components.css`\n- Component layout modules: `src/styles/components/*.css`\n- Shell layout implementation: `src/styles/layout.css`\n- Global stylesheet entrypoint: `src/style.css`\n- Frontend React/Ant Design config: `src/blog/client/deno.json`\n- Public i18n module: `src/utils/i18n.ts`, backed by `src/utils/i18n/`\n\nWhen a local token already exists, do not introduce new hard-coded spacing,\ncolor, or typography values in UI code. Prefer `var(--ph-*)`.\n\nDeno resolves npm packages for the repo from its global cache. The root and\nfrontend configs both use `nodeModulesDir: \"none\"`, so local `node_modules`\nfolders are not part of the normal workflow.\n\nIn production builds, Lume runs Lightning CSS before PurgeCSS. PurgeCSS is\nconfigured with an explicit safelist for ARIA/data-state selectors, Pagefind\nruntime classes, and the small set of site-specific state classes that are only\nvisible after hydration.\n\nInteractive UI is intentionally narrow and explicit:\n\n- Header icon actions expose tooltips for search, language, and theme.\n- Search keeps a dedicated status surface under project control, including\n  loading, empty, retry, and offline feedback.\n- Post pages expose declarative Pagefind metadata for `tag`, `year`, and\n  publish-date sorting without adding custom client-side search state.\n- The service worker caches `/pagefind/*` assets on first use so search can\n  recover cleanly while offline after the runtime has been loaded once.\n- Code blocks in posts remain editorial `pre \u003e code` blocks, enhanced only by a\n  lightweight copy action when JavaScript is available.\n- Shiki handles fenced-code highlighting with GitHub's default light and dark\n  themes. Ant Design is used for interactive blog surfaces, not syntax\n  highlighting.\n\n## Quality Gates\n\nThe production build runs several checks in sequence:\n\n- HTML validation\n- browser-safe import validation\n- broken-link validation against final output after asset fingerprinting\n\nFeed and JSON contract validation is also available separately through\n`deno task validate-contracts`. The RSS and Atom checks parse XML structurally\ninstead of relying on tag-matching regexes.\n\nGenerated quality artifacts live under `_quality/`, which is ignored by Git and\nkept separate from the Lume build cache. The key reports are:\n\n- `_quality/html-issues.json`\n- `_quality/broken-links.json`\n- `_quality/broken-links-pre-fingerprint.json` for production builds\n\n## Deployment\n\nThe `site` GitHub Actions workflow builds the site, assumes an Alibaba Cloud\nrole using GitHub OIDC, syncs `_site/` to OSS, and refreshes or preloads CDN\npaths. The workflow inherits the build-time quality gates, so a failing build or\nlink check blocks deployment. The checkout step intentionally keeps\n`fetch-depth: 0` so the build can resolve per-file Git creation dates, update\ntimestamps, and commit links in CI.\n\nThe deployment walkthrough in\n[src/posts/alibaba-cloud-oss-cdn-deployment/en.md](./src/posts/alibaba-cloud-oss-cdn-deployment/en.md)\ndocuments the infrastructure in more detail.\n\n## Additional Documentation\n\n- [ARCHITECTURE.md](./ARCHITECTURE.md)\n- [AGENTS.md](./AGENTS.md)\n- [CLAUDE.md](./CLAUDE.md)\n- [GEMINI.md](./GEMINI.md)\n- [docs/mobile-clients.md](./docs/mobile-clients.md)\n- [docs/mobile-content-api.md](./docs/mobile-content-api.md)\n- [docs/mobile-phase-0.md](./docs/mobile-phase-0.md)\n- [docs/android-roadmap.md](./docs/android-roadmap.md)\n- [plugins/README.md](./plugins/README.md)\n\n## License\n\nSee [LICENSE](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrenchvandal%2Fnormco.re","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrenchvandal%2Fnormco.re","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrenchvandal%2Fnormco.re/lists"}