SEO: custom share template (canonical, per-page OG, JSON-LD, robots), robots.txt, OG banner; generator sets shareOpenGraphURL; ignis module STEP example

README.md

@@ -38,6 +38,10 @@ no external dependencies (except `highlight.js`, vendored in `lib/`).
 - **Digital Garden**: `state` labels (Seed → Evergreen, Draft, Review) rendered as badges and
   colour-coded growth tables.
 - **Search** (client-side over a generated index), **RSS feed** and **sitemap.xml**.
+- **SEO**: per-page canonical + Open Graph (`og:url`, `og:image`, article/website type),
+  Twitter cards, JSON-LD structured data (WebSite / BlogPosting / CollectionPage),
+  `robots.txt` and `index,follow` meta. Provided by a custom share template
+  (`templates/share/page.ejs`).
 - **Widget rendering** for Mermaid, Excalidraw (canvas) and MindElixir (mind map) notes, with a
   collapsible, highlighted "Source" block and copy button.
 - **3D models**: `.step` / `.stp` / `.stl` files (as file notes or inline attachments) render
@@ -63,6 +67,8 @@ no external dependencies (except `highlight.js`, vendored in `lib/`).
 | `lib/hljs_line_numbers.js` | highlight.js line-numbers plugin | code |
 | `scripts/*.js` | frontend share snippets (content is pasted **verbatim** into a code note, including the `<script>`/`<style>` wrapper) | code |
 | `templates/blog_article.html` | article template with promoted labels | text |
+| `templates/share/*.ejs` | custom share template + partials (canonical, OG, JSON-LD, robots) | code, `application/x-ejs` |
+| `assets/og-banner.png` | default Open Graph image (1200×630, replace with your own) | file |
 | `docs/embed-3d-model.md` | how to embed STEP/STL in a note | – |
 | `examples/*` | sample category logo + menu icon script (ignis8) | code / SVG |
 | `generated/*` | reference output, **regenerated automatically** by `blog_generator.js` | code / xml |
@@ -139,6 +145,10 @@ Under **`.blog`** create one code note per file, using the file name as the note
 | `sitemap.xml` | `generated/sitemap.xml` | code (regenerated) |
 | `state_map` | `generated/state_map.js` | `text/html` (regenerated) |
 | `blog_data` | `generated/blog_data.js` | `text/html` (regenerated) |
+| `robots.txt` | `generated/robots.txt` | code (static) |
+| `share template` | `templates/share/page.ejs` | `application/x-ejs` |
+| `tree_item`, `prev_next`, `toc_item` (children of `share template`) | `templates/share/tree_item.ejs` etc. | `application/x-ejs` |
+| `og-banner` | `assets/og-banner.png` | image note |
 
 Also create, under the `Blog` book: `blog_generator` (from `blog_generator.js`,
 mime `application/javascript;env=backend`) and `blog_publish_manager` (from
@@ -159,6 +169,8 @@ mime `application/javascript;env=backend`) and `blog_publish_manager` (from
 | `iconClass` | `bx bx-edit-alt` | – |
 | `~shareCss` | → `blog_share_theme.css` | yes |
 | `~shareFavicon` | → `favicon` | yes |
+| `~shareTemplate` | → `share template` | yes |
+| `~shareOpenGraphImage` | → `og-banner` | – |
 | `~shareHtml` | → `table column hover`, `blog card click`, `garden row click`, `code note highlight`, `code copy & lines`, `state_map`, `title state badge`, `bmc button`, `logo share alias`, `blog_data`, `prev next`, `reading time`, `search header`, `ignis8 menu icon` (optional), `note fallback`, `menu date sort`, `3d model viewer` | yes |
 | `~shareHtml` | → `hide home title` | **no** (index only) |
 | `~runOnNoteContentChange`, `~runOnAttributeChange`, `~runOnNoteCreation`, `~runOnNoteTitleChange`, `~runOnAttributeCreation`, `~runOnBranchDeletion`, `~runOnChildNoteCreation` | → `blog_generator` | yes |
@@ -176,6 +188,7 @@ mime `application/javascript;env=backend`) and `blog_publish_manager` (from
 | `highlight.js` | `shareHiddenFromTree` |
 | `feed.xml` | `shareAlias=feed`, `shareRaw`, `shareHiddenFromTree` |
 | `sitemap.xml` | `shareAlias=sitemap.xml`, `shareRaw`, `shareHiddenFromTree` |
+| `robots.txt` | `shareAlias=robots.txt`, `shareRaw`, `shareHiddenFromTree` |
 | `.blog` (book) | `shareHiddenFromTree`, `viewType=list` |
 
 **On the Digital Garden category note** (and any other garden category), add: