[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82235":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":37,"readmeContent":38,"aiSummary":39,"trendingCount":16,"starSnapshotCount":16,"syncStatus":40,"lastSyncTime":41,"discoverSource":42},82235,"specification.website","jdevalk\u002Fspecification.website","jdevalk","Website specification — HTML, accessibility, security, SEO, agent-readiness. Platform-agnostic, sourced, MIT.","https:\u002F\u002Fspecification.website",null,"TypeScript",636,41,5,1,0,17,127,493,73,8.87,"Other",false,"main",[26,27,28,29,30,31,32,33,34,35,36],"accessibility","agent-readiness","astro","cloudflare-pages","llms-txt","mcp","seo","specification","web-security","web-standards","well-known","2026-06-12 02:04:24","# The Website Specification\n\n[![CI](https:\u002F\u002Fgithub.com\u002Fjdevalk\u002Fspecification.website\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fjdevalk\u002Fspecification.website\u002Factions\u002Fworkflows\u002Fci.yml)\n[![Code licence: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcode-MIT-blue.svg)](LICENSE)\n[![Content licence: CC BY 4.0](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcontent-CC%20BY%204.0-blue.svg)](https:\u002F\u002Fcreativecommons.org\u002Flicenses\u002Fby\u002F4.0\u002F)\n[![Deployed on Cloudflare Pages](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdeploy-Cloudflare%20Pages-orange.svg)](https:\u002F\u002Fspecification.website)\n\nThe website specification — from `\u003Ctitle>` to `\u002F.well-known\u002Fsecurity.txt`, from WCAG contrast to `llms.txt`. Platform-agnostic, sourced on every page, written for humans and agents. MIT licensed, open for pull requests.\n\n**Live site:** \u003Chttps:\u002F\u002Fspecification.website>\n**MCP server:** \u003Chttps:\u002F\u002Fmcp.specification.website\u002Fmcp>\n\n## What this is\n\nThe web is a layer cake of standards: WHATWG defines HTML, W3C ratifies WCAG, the IETF publishes the RFCs behind security headers and `\u002F.well-known\u002F` URIs, IANA registers the namespaces, search engines publish their own rules, browsers add quirks. Almost nobody carries the whole picture.\n\nThis site collects the slices into one platform-agnostic specification — sources cited on every page.\n\nIt is *not* a framework. It is *not* a tutorial. It is a spec, in the same way the HTML Living Standard is a spec: outcomes, requirements, references.\n\n## What this is not\n\n- Not platform-specific. No \"use this Next.js plugin\" advice — the spec describes the outcome, you choose the implementation.\n- Not opinion. Where there is no settled standard, the spec says so.\n- Not a marketing site. No newsletter capture. No cookies. Aggregate Plausible analytics; that's it.\n\n## Categories\n\n- **Foundations** — HTML, head, document basics.\n- **SEO** — search visibility.\n- **Accessibility** — WCAG-aligned rules.\n- **Security** — headers, transport, policies.\n- **Well-Known URIs** — agreed paths under `\u002F.well-known\u002F`.\n- **Agent Readiness** — making a site legible to AI agents.\n- **Performance** — Core Web Vitals, caching, fonts.\n- **Privacy** — consent, signals, respecting choice.\n- **Resilience** — graceful failure.\n- **Internationalisation** — language, locale, direction.\n\n## Development\n\nRequirements: Node.js 22.12+, npm.\n\n```bash\nnpm install\nnpm run dev      # http:\u002F\u002Flocalhost:31337\nnpm run build    # static output in .\u002Fdist\nnpm run preview  # serve .\u002Fdist on port 31337\n```\n\nThe dev server runs on port `31337` by convention (because of course it does).\n\n## Adding or changing a spec page\n\n1. Find the right category under `src\u002Fcontent\u002Fspec\u002F\u003Ccategory>\u002F`.\n2. Copy an existing `.md` file — for example, `src\u002Fcontent\u002Fspec\u002Ffoundations\u002Ftitle.md`.\n3. Fill in the front matter (see schema in [`src\u002Fcontent.config.ts`](src\u002Fcontent.config.ts)). At minimum: `title`, `summary`, `category`, `status`, `order`, and `sources`.\n4. Write the body. Sections: `## What it is`, `## Why it matters`, `## How to implement`, `## Common mistakes`, `## Verification`.\n5. Open a PR.\n\nThe build will fail if the schema is invalid — that is intentional.\n\nEverything derived from the spec content updates automatically: `\u002Fspec\u002F`, `\u002Fchecklist\u002F`, `\u002Fllms.txt`, `\u002Fllms-full.txt`, `\u002Fsitemap-index.xml`, `\u002Frss.xml`, per-page `.md` endpoints, the Pagefind search index, and the MCP server's bundled data. Never hand-edit those; edit the source markdown.\n\n## Status levels\n\n- **Required** — the web platform contract breaks without it.\n- **Recommended** — modern sites should do it.\n- **Optional** — depends on context.\n- **Avoid** — outdated, harmful, or actively superseded.\n\n## Sources\n\nEvery page cites at least one source. The site draws on:\n\n- [WHATWG HTML Living Standard](https:\u002F\u002Fhtml.spec.whatwg.org\u002F)\n- [MDN Web Docs](https:\u002F\u002Fdeveloper.mozilla.org\u002F)\n- [WCAG 2.2](https:\u002F\u002Fwww.w3.org\u002FTR\u002FWCAG22\u002F) and the Understanding documents\n- [IETF RFCs](https:\u002F\u002Fwww.rfc-editor.org\u002F) for protocol-level items\n- [sitemaps.org](https:\u002F\u002Fwww.sitemaps.org\u002F), [schema.org](https:\u002F\u002Fschema.org\u002F), [llmstxt.org](https:\u002F\u002Fllmstxt.org\u002F)\n- [Google Search Central](https:\u002F\u002Fdevelopers.google.com\u002Fsearch), [web.dev](https:\u002F\u002Fweb.dev\u002F)\n- [Yoast Developer Portal](https:\u002F\u002Fdeveloper.yoast.com\u002F)\n- [Equalize Digital Accessibility Checker docs](https:\u002F\u002Fequalizedigital.com\u002Faccessibility-checker\u002Fdocumentation\u002F)\n- [WP Accessibility Knowledge Base](https:\u002F\u002Fwpaccessibility.org\u002F)\n- [Is It Agent Ready?](https:\u002F\u002Fisitagentready.com\u002F)\n- [Overlay Fact Sheet](https:\u002F\u002Foverlayfactsheet.com\u002F)\n\n## MCP server\n\nA separate Cloudflare Worker in [`mcp\u002F`](mcp\u002F) exposes the spec to MCP-aware agents. See [`mcp\u002FREADME.md`](mcp\u002FREADME.md) for tools, the connection config, and how to deploy.\n\n## Licence\n\nContent is licensed under [CC BY 4.0](https:\u002F\u002Fcreativecommons.org\u002Flicenses\u002Fby\u002F4.0\u002F). Code is licensed under [MIT](LICENSE). Use it, fork it, ship it.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md). Three rules: cite your sources, stay platform-agnostic, be honest about status.\n\n## Security\n\nSee [SECURITY.md](SECURITY.md) or [\u002F.well-known\u002Fsecurity.txt](https:\u002F\u002Fspecification.website\u002F.well-known\u002Fsecurity.txt).\n","该项目是一个网站规范指南，涵盖了从HTML基础到SEO、可访问性、安全性和代理就绪等多个方面。其核心功能在于提供了一个平台无关的、详尽的网站开发标准集合，每一页都引用了具体来源，旨在为开发者和自动化工具提供清晰的技术要求与参考。特别适合于需要构建符合现代Web标准、具有高度可访问性和安全性网站的场景。项目使用TypeScript编写，并且部署在Cloudflare Pages上，确保了良好的维护性和社区支持。",2,"2026-06-11 04:08:07","CREATED_QUERY"]