diff options
| author | sillylaird <sillylaird@fastmail.ca> | 2026-02-03 21:27:57 -0500 |
|---|---|---|
| committer | sillylaird <sillylaird@fastmail.ca> | 2026-02-03 21:27:57 -0500 |
| commit | 720d752748b793a2f5cf3cc14cb75ad86e8919c0 (patch) | |
| tree | 29120103307cb17e7d6c283cc198ec2484f934cd /docs/FUTURE_PROOF.md | |
First commit
Diffstat (limited to 'docs/FUTURE_PROOF.md')
| -rw-r--r-- | docs/FUTURE_PROOF.md | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/docs/FUTURE_PROOF.md b/docs/FUTURE_PROOF.md new file mode 100644 index 0000000..7325798 --- /dev/null +++ b/docs/FUTURE_PROOF.md @@ -0,0 +1,54 @@ +# Future Proofing (No Generator) + +This site is intentionally hand-edited HTML. The goal here is to keep the *style* the same while making the site easier to maintain and more resilient. + +## Principles + +- Navigation and core content should work without JavaScript. +- External embeds should always have a plain-link fallback. +- URLs should be stable; if something must move, leave a redirect page. +- Translations should follow a consistent naming rule. + +## What We Added + +### 1) A real sitemap and robots.txt + +- `robots.txt` points to `sitemap.xml` +- `sitemap.xml` is the public crawl map (update when adding new sections) + +### 2) A human-friendly site map page + +- `/map/` provides a clickable index for humans +- It also links to translated versions + +### 3) Translation naming convention + +- Default English: `index.html` (or any `page.html`) +- Simplified Chinese: `index_zh.html` (or `page_zh.html`) +- Japanese: `index_jp.html` (or `page_jp.html`) + +### 4) Redirect page pattern + +If you ever rename or move a page, keep an old file that points to the new place. + +Example: create `old-path/index.html`: + +```html +<!doctype html> +<meta charset="utf-8"> +<meta http-equiv="refresh" content="0; url=/new-path/"> +<link rel="canonical" href="/new-path/"> +<title>Moved</title> +<p>This page moved to <a href="/new-path/">/new-path/</a>.</p> +``` + +### 5) Backups + +Recommended: + +- Put the folder in git (local is enough) +- Mirror the repo remotely (GitHub/GitLab/SourceHut) even if you don’t deploy from it + +## Optional Next Step + +Add a simple link-check script (offline) to catch broken internal links. |