Hare/Decodal
1
0
Fork 0
Code Issues Pull Requests Packages Releases Activity

Add SEO and agent-readable documentation

Browse Source
This commit is contained in:
Hare
2026-08-14 21:10:52 +09:00
parent cda32cc260
commit e5c73c647d
26 changed files with 576 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/develop/README.md
+12
View File
@@ -40,6 +40,18 @@ npm --prefix site/decodal-site run build
Use `npm --prefix site/decodal-site run build:wasm` when Rust bindings or formatter behavior changed.
## Documentation site delivery
The canonical site origin is `https://decodal.hareworks.net`, configured through Astro's `site` option. A normal site build generates the sitemap, robots policy, social metadata, structured data, 404 page, and source-backed Markdown endpoints. `/llms.txt` indexes the individual English and Japanese Markdown pages; `/llms-full.txt` and `/ja/llms-full.txt` provide complete manuals. These resources are built directly from `doc/manual/source` and do not use Cloudflare's HTML-to-Markdown conversion.
Deploy the already prepared site with:
```sh
npm --prefix site/decodal-site run deploy
```
Cloudflare Pages `_redirects` handles legacy paths within the site, but not hostname redirects. In the Cloudflare account, configure a Bulk Redirect from `https://decodal-site.pages.dev/` to `https://decodal.hareworks.net/` with status `301`, subpath matching, path-suffix preservation, and query-string preservation enabled. This prevents the Pages project hostname from becoming a second public origin.
## Syntax changes
When syntax changes: