refactor(theme): split content-actions, breadcrumbs, source-file partials

Break three sizable regions out of main.html into overridable partials so
sites can restyle them without copying the whole layout:
- partials/content-actions.html (Edit / View-source buttons)
- partials/breadcrumbs.html (navigation.path trail)
- partials/source-file.html (Last updated / Created line)

Documented each in reference/theme.md. Verified edit/view buttons still
render and breadcrumbs render when navigation.path is enabled.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: Netdocs

docs-site/docs/reference/theme.md

@@ -166,6 +166,9 @@ your `customDir` and it wins over the bundled version.
 | `partials/search.html` | Search box + results overlay markup. |
 | `partials/nav.html` | Sidebar navigation drawer. |
 | `partials/tabs.html` | Header tabs bar (only when `navigation.tabs` is off and you want a second row). |
+| `partials/content-actions.html` | Floating Edit / View-source buttons at the top-right of the article (`content.action.edit` / `content.action.view`). |
+| `partials/breadcrumbs.html` | Breadcrumb trail above the page title (`navigation.path`, driven by `breadcrumbs`). |
+| `partials/source-file.html` | "Last updated / Created" line under the article body (`show_source_meta`, non-post pages). |
 | `partials/toc.html` | Right-hand table of contents. |
 | `partials/footer.html` | Site footer: prev/next nav, copyright, social links. |
 | `partials/post-meta.html` | Blog-post byline: author avatar/name, date, reading time, categories. |

src/Netdocs.Theme.Material/templates/main.html

@@ -129,42 +129,13 @@
           {{~ end ~}}
           <div class="md-content" data-md-component="content">
             <article class="md-content__inner md-typeset">
-{{~ if (features | array.contains "content.action.edit") && edit_url ~}}
-<a href="{{ edit_url }}" title="Edit this page" class="md-content__button md-icon" rel="noopener" target="_blank">
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75z"/></svg>
-</a>
-{{~ end ~}}
-{{~ if (features | array.contains "content.action.view") && view_url ~}}
-<a href="{{ view_url }}" title="View source of this page" class="md-content__button md-icon" rel="noopener" target="_blank">
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 9a3 3 0 0 1 3 3 3 3 0 0 1-3 3 3 3 0 0 1-3-3 3 3 0 0 1 3-3m0-4.5c5 0 9.27 3.11 11 7.5-1.73 4.39-6 7.5-11 7.5S2.73 16.39 1 12c1.73-4.39 6-7.5 11-7.5M3.18 12a9.821 9.821 0 0 0 17.64 0 9.821 9.821 0 0 0-17.64 0"/></svg>
-</a>
-{{~ end ~}}
-{{~ if (features | array.contains "navigation.path") && breadcrumbs && (array.size breadcrumbs) > 0 ~}}
-<nav class="md-path" aria-label="Breadcrumb">
-  <ul class="md-path__list">
-    {{~ for crumb in breadcrumbs ~}}
-    <li class="md-path__item">
-      {{~ if crumb.url ~}}<a href="{{ base_url }}{{ crumb.url }}" class="md-path__link">{{ crumb.title }}</a>
-      {{~ else ~}}<span class="md-path__link">{{ crumb.title }}</span>{{~ end ~}}
-    </li>
-    {{~ end ~}}
-  </ul>
-</nav>
-{{~ end ~}}
+{{ include "partials/content-actions.html" }}
+{{ include "partials/breadcrumbs.html" }}
 {{~ if page.meta.is_post && page.meta.post_tags && (array.size page.meta.post_tags) > 0 ~}}
 <nav class="md-tags">{{~ for tag in page.meta.post_tags ~}}<a href="{{ base_url }}pages/tags/" class="md-tag">{{ tag }}</a> {{~ end ~}}</nav>
 {{~ end ~}}
 {{ content }}
-              {{~ if show_source_meta && !page.meta.is_post ~}}
-              <hr>
-              <div class="md-source-file">
-                <span class="md-source-file__fact">
-                  <span class="md-icon"></span>
-                  Last updated: {{ updated_display }}
-                  {{~ if created_display ~}} &middot; Created: {{ created_display }}{{~ end ~}}
-                </span>
-              </div>
-              {{~ end ~}}
+{{ include "partials/source-file.html" }}
             </article>
           </div>
         </div>

src/Netdocs.Theme.Material/templates/partials/breadcrumbs.html

@@ -0,0 +1,20 @@
+{{~ #
+# partials/breadcrumbs.html — Breadcrumb trail above the page title.
+#
+# Data:  `breadcrumbs` — ordered list of { title, url } from the page's location in the nav.
+#        `features` — gate on "navigation.path"; `base_url` — site root prefix for links.
+#
+# Override: drop a file at `<custom_dir>/partials/breadcrumbs.html`. Return nothing to hide.
+~}}
+{{~ if (features | array.contains "navigation.path") && breadcrumbs && (array.size breadcrumbs) > 0 ~}}
+<nav class="md-path" aria-label="Breadcrumb">
+  <ul class="md-path__list">
+    {{~ for crumb in breadcrumbs ~}}
+    <li class="md-path__item">
+      {{~ if crumb.url ~}}<a href="{{ base_url }}{{ crumb.url }}" class="md-path__link">{{ crumb.title }}</a>
+      {{~ else ~}}<span class="md-path__link">{{ crumb.title }}</span>{{~ end ~}}
+    </li>
+    {{~ end ~}}
+  </ul>
+</nav>
+{{~ end ~}}

src/Netdocs.Theme.Material/templates/partials/content-actions.html

@@ -0,0 +1,19 @@
+{{~ #
+# partials/content-actions.html — Floating "Edit"/"View source" buttons at the top-right
+# of the article. Shown when the matching feature is enabled and the page has a source URL.
+#
+# Data:  `edit_url` / `view_url` — computed per page (empty for generated pages).
+#        `features` — theme.features list; gate on "content.action.edit" / "content.action.view".
+#
+# Override: drop a file at `<custom_dir>/partials/content-actions.html`. Return nothing to hide.
+~}}
+{{~ if (features | array.contains "content.action.edit") && edit_url ~}}
+<a href="{{ edit_url }}" title="Edit this page" class="md-content__button md-icon" rel="noopener" target="_blank">
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75z"/></svg>
+</a>
+{{~ end ~}}
+{{~ if (features | array.contains "content.action.view") && view_url ~}}
+<a href="{{ view_url }}" title="View source of this page" class="md-content__button md-icon" rel="noopener" target="_blank">
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 9a3 3 0 0 1 3 3 3 3 0 0 1-3 3 3 3 0 0 1-3-3 3 3 0 0 1 3-3m0-4.5c5 0 9.27 3.11 11 7.5-1.73 4.39-6 7.5-11 7.5S2.73 16.39 1 12c1.73-4.39 6-7.5 11-7.5M3.18 12a9.821 9.821 0 0 0 17.64 0 9.821 9.821 0 0 0-17.64 0"/></svg>
+</a>
+{{~ end ~}}

src/Netdocs.Theme.Material/templates/partials/source-file.html

@@ -0,0 +1,18 @@
+{{~ #
+# partials/source-file.html — "Last updated / Created" footer shown under the article body
+# for regular (non-post) pages when source metadata is available.
+#
+# Data:  `show_source_meta` (bool), `updated_display`, `created_display`, `page.meta.is_post`.
+#
+# Override: drop a file at `<custom_dir>/partials/source-file.html`. Return nothing to hide.
+~}}
+{{~ if show_source_meta && !page.meta.is_post ~}}
+<hr>
+<div class="md-source-file">
+  <span class="md-source-file__fact">
+    <span class="md-icon"></span>
+    Last updated: {{ updated_display }}
+    {{~ if created_display ~}} &middot; Created: {{ created_display }}{{~ end ~}}
+  </span>
+</div>
+{{~ end ~}}