summaryrefslogtreecommitdiff
path: root/docs/MANAGE.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/MANAGE.md')
-rw-r--r--docs/MANAGE.md42
1 files changed, 42 insertions, 0 deletions
diff --git a/docs/MANAGE.md b/docs/MANAGE.md
new file mode 100644
index 0000000..e061837
--- /dev/null
+++ b/docs/MANAGE.md
@@ -0,0 +1,42 @@
+# Site Management (No Generator)
+
+This site is intentionally hand-edited HTML/CSS.
+
+## Shared assets
+
+- Global CSS: `/assets/css/site.css`
+- Shared JS (menu + language + blog list): `/assets/js/site.js`
+
+## Optional includes (header/footer)
+
+If you want to stop copy/pasting the header/footer without using a static site generator:
+
+1) Add include placeholders:
+
+```html
+<div data-include="header"></div>
+...
+<div data-include="footer"></div>
+```
+
+2) Add this script:
+
+```html
+<script defer src="/assets/js/includes.js"></script>
+```
+
+3) Header/footer live here:
+
+- `/partials/header.html`
+- `/partials/footer.html`
+
+Notes:
+
+- This is a "no build" approach.
+- It requires JavaScript to render header/footer.
+- If includes fail (offline, blocked fetch), the page still loads (just without injected header/footer).
+
+## SEO / crawl basics
+
+- `robots.txt` points to `sitemap.xml`.
+- Update `sitemap.xml` when you add/remove top-level pages.