jekyll-theme-zer0 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 557e14c1256d2eb630827e7136486ff6ecbcd99f77f96b1ca2ae0909c8cbd818
-  data.tar.gz: 9d3dc46191a9085f004b5790110aa9ef24b030b8c830fcc6adc06ed0f3317367
+  metadata.gz: 492ac103c8adea1b4edaf2cf925f5a5e02d661e522907dec95cbf08ec0ab0ef6
+  data.tar.gz: 5efc803b2288fb9036165becc816e2b1f78cfa2e5aa62368049463e4eb7891c4
 SHA512:
-  metadata.gz: 9df47e33dbcd2696507527b20a907e081f55f94aa6ad9f1f7dfd517c80549fc87dc96ad0d10d7fa761b1a02b71507465e4c8b130ceb556db54736f1e982449aa
-  data.tar.gz: '039d73f1c388b0c0c1f66f212dcd6abf83a73916690baaecc1127a3c0911da5cb529f841998f68c55a0a280b8468da65bfee6e2d6ac0352d3b97def42ab15e64'
+  metadata.gz: 015f1f284b8129ae2788be7be74386818bdcd965b84d24aa4ba600fde13a91e4de2c211c068a28a69a959d30b18946b39cd4677fc21b1e8b2a44f59adf061edb
+  data.tar.gz: 06525dbbc0bea7d545293865e69b7c2f95352e213b3eee20db2a966f81f217d2ad88b02587f15f48b8e3d6f7a0adafb57978c5455638fd1a29fe79b980ca15ce

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [1.2.1] - 2026-04-22
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 5c04e62 fix(footer,welcome,info): eliminate broken links on bare-minimum sites
+
+
 ## [1.2.0] - 2026-04-22
 
 ### Changed
@@ -37,6 +46,37 @@
   `Your Site Title`, `My Awesome Site`, `Welcome`, `Untitled`, or empty).
 
 ### Fixed
+- **Footer Quick Links no longer 404 on bare-minimum sites.**
+  `_includes/core/footer.html` previously hard-coded links to
+  `/about/`, `/services/`, `/news/`, `/contact/`, `/privacy-policy`, and
+  `/terms-of-service` — none of which exist in a 3-file remote-theme
+  consumer. Quick Links are now resolved in this order:
+  1. `site.footer_quick_links` (array of `{label, url}`) — explicit override
+  2. Auto-detection: each candidate link only renders if the target page
+     exists in `site.html_pages`
+  3. Fallback to `Home` + `Sitemap (XML)` only.
+  Privacy Policy / Terms of Service links use the same existence check and
+  optionally read from `site.privacy_policy_url` / `site.terms_of_service_url`.
+- **Welcome layout external links now point to existing README anchors.**
+  The "Next steps" cards in `_layouts/welcome.html` linked to
+  `#content-creation` and `#customisation`, which don't exist in the theme
+  README. They now point to `README.md#-quick-start` and
+  `README.md#-key-features` respectively.
+- **Theme info admin links are conditional.**
+  `_includes/components/info-section.html` previously rendered Admin
+  Dashboard links to `/about/config/`, `/about/settings/theme/`,
+  `/about/settings/navigation/`, and `/about/settings/environment/`
+  unconditionally — guaranteed 404s on bare-minimum sites. The links and
+  surrounding section now only render when the corresponding page exists.
+- **Source Code shortcuts skip GitHub buttons when repository is unknown.**
+  `_includes/components/dev-shortcuts.html` rendered `https://github.com//blob//`
+  URLs when `site.repository` and `site.branch` were empty (typical on bare
+  consumer sites). It now hides the GitHub-based buttons and shows a hint
+  to set `repository: USER/REPO` in `_config.yml`.
+- **Cookie-consent privacy link is conditional.** The "Learn more in our
+  Privacy Policy" anchor in `_includes/components/cookie-consent.html` only
+  renders if a `/privacy-policy/` page exists or `site.privacy_policy_url` is
+  configured.
 - **Setup banner link.** `_includes/components/setup-banner.html` no longer
   points at the non-existent `/404.html`; it now links to
   `/#setup-wizard`, which is provided by the new welcome layout.

data/README.md

@@ -2,7 +2,7 @@
 title: zer0-mistakes
 sub-title: AI-Native Jekyll Theme
 description: AI-native Jekyll theme for GitHub Pages — Docker-first development, AI-powered installation, multi-agent integration (Copilot, Codex, Cursor, Claude), AI preview-image generation, and AIEO content optimization with Bootstrap 5.3.
-version: 1.2.0
+version: 1.2.1
 layout: landing
 tags:
   - jekyll
@@ -20,7 +20,7 @@ categories:
   - bootstrap
   - ai-tooling
 created: 2024-02-10T23:51:11.480Z
-lastmod: 2026-04-22T02:41:59.000Z
+lastmod: 2026-04-22T03:05:26.000Z
 draft: false
 permalink: /
 slug: zer0
@@ -1114,7 +1114,7 @@ git push origin feature/awesome-feature
 
 | Metric | Value |
 |--------|-------|
-| **Current Version** | 1.2.0 ([RubyGems](https://rubygems.org/gems/jekyll-theme-zer0), [CHANGELOG](/CHANGELOG)) |
+| **Current Version** | 1.2.1 ([RubyGems](https://rubygems.org/gems/jekyll-theme-zer0), [CHANGELOG](/CHANGELOG)) |
 | **Documented Features** | 43 ([Feature Registry](https://github.com/bamr87/zer0-mistakes/blob/main/_data/features.yml)) |
 | **Setup Time** | 2-5 minutes ([install.sh benchmarks](https://github.com/bamr87/zer0-mistakes/blob/main/install.sh)) |
 | **Documentation Pages** | 70+ ([browse docs](/pages/)) |
@@ -1165,6 +1165,6 @@ And these AI partners that make zer0-mistakes truly AI-native:
 
 **Built with ❤️ — and a little help from our AI partners — for the Jekyll community**
 
-**v1.2.0** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md) • [AI Agent Guide](AGENTS.md)
+**v1.2.1** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md) • [AI Agent Guide](AGENTS.md)
 
 

data/_includes/components/cookie-consent.html

@@ -59,7 +59,11 @@ Configuration: Uses site.posthog settings from _config.yml
         </p>
         <p class="mb-2 mb-lg-0 small text-white-50">
           This website uses cookies and similar technologies to enhance your browsing experience, analyze traffic, and provide personalized content.
-          <a href="{{ '/privacy-policy/' | relative_url }}" class="text-white text-decoration-underline">Learn more in our Privacy Policy</a>.
+          {% assign _pp = site.html_pages | where: "url", "/privacy-policy/" | first %}
+          {% unless _pp %}{% assign _pp = site.html_pages | where: "url", "/privacy-policy" | first %}{% endunless %}
+          {% if _pp or site.privacy_policy_url %}
+            <a href="{{ site.privacy_policy_url | default: '/privacy-policy/' | relative_url }}" class="text-white text-decoration-underline">Learn more in our Privacy Policy</a>.
+          {% endif %}
         </p>
       </div>
       <div class="col-12 col-lg-4">

data/_includes/components/dev-shortcuts.html

@@ -33,6 +33,11 @@
 <div class="dev-shortcuts">
   <div class="d-flex flex-column gap-2">
 
+    {% comment %} Skip all GitHub-based shortcuts on bare/unconfigured sites where
+       site.repository or site.branch are empty (otherwise we render
+       https://github.com//blob//path → 404). {% endcomment %}
+    {% if site.repository and site.branch %}
+
     <!-- Button Group (section title is the parent h6 in info-section.html) -->
     <div class="btn-group-vertical" role="group" aria-label="Source code shortcuts">
 
@@ -109,5 +114,13 @@
 
     </div>
 
+    {% else %}
+      <p class="small text-body-secondary mb-0">
+        <i class="bi bi-info-circle me-1"></i>
+        Set <code>repository: USER/REPO</code> in your <code>_config.yml</code>
+        to enable source-code shortcuts.
+      </p>
+    {% endif %}
+
   </div>
 </div>

data/_includes/components/info-section.html

@@ -108,35 +108,51 @@
           </div>
         </div>
 
-        <!-- Admin Quick Links -->
+        <!-- Admin Quick Links — only render links to pages that actually exist
+             in the build (prevents 404s on bare-minimum / remote-theme sites
+             that haven't created the admin pages). -->
+        {% assign _cfg_page = site.html_pages | where: "url", "/about/config/" | first %}
+        {% assign _theme_page = site.html_pages | where: "url", "/about/settings/theme/" | first %}
+        {% assign _nav_page = site.html_pages | where: "url", "/about/settings/navigation/" | first %}
+        {% if _cfg_page or _theme_page or _nav_page %}
         <div class="mb-3">
           <h6 class="text-body-secondary small text-uppercase fw-semibold mb-2">
             <i class="bi bi-speedometer2 me-1"></i>Admin Dashboard
           </h6>
           <div class="list-group list-group-flush small">
+            {% if _cfg_page %}
             <a href="{{ '/about/config/' | relative_url }}" class="list-group-item list-group-item-action d-flex align-items-center px-0">
               <i class="bi bi-gear me-2 text-body-secondary"></i>Configuration
             </a>
+            {% endif %}
+            {% if _theme_page %}
             <a href="{{ '/about/settings/theme/' | relative_url }}" class="list-group-item list-group-item-action d-flex align-items-center px-0">
               <i class="bi bi-palette me-2 text-body-secondary"></i>Theme Customizer
             </a>
+            {% endif %}
+            {% if _nav_page %}
             <a href="{{ '/about/settings/navigation/' | relative_url }}" class="list-group-item list-group-item-action d-flex align-items-center px-0">
               <i class="bi bi-signpost-2 me-2 text-body-secondary"></i>Navigation Editor
             </a>
+            {% endif %}
           </div>
         </div>
+        {% endif %}
       </div>
       
       <!-- Environment Tab -->
       <div class="tab-pane fade" id="environment-pane" role="tabpanel" aria-labelledby="environment-tab" tabindex="0">
         {% include components/env-switcher.html %}
 
-        <!-- Admin Link -->
+        <!-- Admin Link — only when target page exists -->
+        {% assign _env_page = site.html_pages | where: "url", "/about/settings/environment/" | first %}
+        {% if _env_page %}
         <div class="mt-4 pt-3 border-top">
           <a href="{{ '/about/settings/environment/' | relative_url }}" class="btn btn-outline-secondary btn-sm w-100">
             <i class="bi bi-box-arrow-up-right me-1"></i>Full Environment &amp; Build Info
           </a>
         </div>
+        {% endif %}
       </div>
       
       <!-- Developer Tab -->

data/_includes/core/footer.html

@@ -80,16 +80,33 @@
             {% if site.email %}<p class="mb-0"><a href="mailto:{{ site.email }}" class="text-light text-decoration-none">{{ site.email }}</a></p>{% endif %}
           </div>
 
-          <!-- Quick Links -->
+          <!-- Quick Links
+               Resolution order:
+                 1. site.footer_quick_links  (array of {label, url}) — explicit override
+                 2. Auto-detection: only render links whose target pages
+                    actually exist in the build. Prevents 404s on bare-minimum
+                    sites that haven't created /about/, /services/, etc. -->
           <div class="col-12 col-md-6 col-lg-3 mb-3">
             <h5 class="text-uppercase mb-3">Quick Links</h5>
             <ul class="list-unstyled" aria-label="Footer quick links">
-              <li><a href="{{ '/' | relative_url }}" class="text-light text-decoration-none">Home</a></li>
-              <li><a href="{{ '/about/' | relative_url }}" class="text-light text-decoration-none">About</a></li>
-              <li><a href="{{ '/services/' | relative_url }}" class="text-light text-decoration-none">Services</a></li>
-              <li><a href="{{ '/news/' | relative_url }}" class="text-light text-decoration-none">News</a></li>
-              <li><a href="{{ '/contact/' | relative_url }}" class="text-light text-decoration-none">Contact</a></li>
-              <li><a href="{{ '/sitemap.xml' | relative_url }}" class="text-light text-decoration-none">Sitemap (XML)</a></li>
+              {% if site.footer_quick_links %}
+                {% for link in site.footer_quick_links %}
+                  <li><a href="{{ link.url | relative_url }}" class="text-light text-decoration-none">{{ link.label }}</a></li>
+                {% endfor %}
+              {% else %}
+                <li><a href="{{ '/' | relative_url }}" class="text-light text-decoration-none">Home</a></li>
+                {% assign _candidate_links = "About,/about/|Services,/services/|News,/news/|Contact,/contact/" | split: "|" %}
+                {% for entry in _candidate_links %}
+                  {% assign _parts = entry | split: "," %}
+                  {% assign _label = _parts[0] %}
+                  {% assign _url   = _parts[1] %}
+                  {% assign _page  = site.html_pages | where: "url", _url | first %}
+                  {% if _page %}
+                    <li><a href="{{ _url | relative_url }}" class="text-light text-decoration-none">{{ _label }}</a></li>
+                  {% endif %}
+                {% endfor %}
+                <li><a href="{{ '/sitemap.xml' | relative_url }}" class="text-light text-decoration-none">Sitemap (XML)</a></li>
+              {% endif %}
             </ul>
           </div>
 
@@ -151,8 +168,17 @@
           </div>
           <div class="col-md-4 text-md-end">
             <ul class="list-inline mb-0">
-              <li class="list-inline-item"><a href="{{ '/privacy-policy' | relative_url }}" class="text-light text-decoration-none">Privacy Policy</a></li>
-              <li class="list-inline-item"><a href="{{ '/terms-of-service' | relative_url }}" class="text-light text-decoration-none">Terms of Service</a></li>
+              {% comment %} Only render policy links whose pages exist (or that are explicitly configured). {% endcomment %}
+              {% assign _privacy = site.html_pages | where: "url", "/privacy-policy/" | first %}
+              {% unless _privacy %}{% assign _privacy = site.html_pages | where: "url", "/privacy-policy" | first %}{% endunless %}
+              {% if _privacy or site.privacy_policy_url %}
+                <li class="list-inline-item"><a href="{{ site.privacy_policy_url | default: '/privacy-policy' | relative_url }}" class="text-light text-decoration-none">Privacy Policy</a></li>
+              {% endif %}
+              {% assign _terms = site.html_pages | where: "url", "/terms-of-service/" | first %}
+              {% unless _terms %}{% assign _terms = site.html_pages | where: "url", "/terms-of-service" | first %}{% endunless %}
+              {% if _terms or site.terms_of_service_url %}
+                <li class="list-inline-item"><a href="{{ site.terms_of_service_url | default: '/terms-of-service' | relative_url }}" class="text-light text-decoration-none">Terms of Service</a></li>
+              {% endif %}
               <li class="list-inline-item">
                 <a href="#" class="text-light text-decoration-none" data-bs-toggle="modal" data-bs-target="#cookieSettingsModal">
                   Cookie Preferences

data/_layouts/welcome.html

@@ -272,7 +272,7 @@ is set in `_config.yml`.
               <code>_about/</code>. Enable them in <code>_config.yml</code>.
             </p>
             <a class="btn btn-sm btn-outline-primary"
-               href="https://github.com/bamr87/zer0-mistakes#content-creation"
+               href="https://github.com/bamr87/zer0-mistakes/blob/main/README.md#-quick-start"
                target="_blank" rel="noopener">
               Content guide <i class="bi bi-box-arrow-up-right"></i>
             </a>
@@ -290,7 +290,7 @@ is set in `_config.yml`.
               your repo to override theme styles without forking.
             </p>
             <a class="btn btn-sm btn-outline-success"
-               href="https://github.com/bamr87/zer0-mistakes#customisation"
+               href="https://github.com/bamr87/zer0-mistakes/blob/main/README.md#-key-features"
                target="_blank" rel="noopener">
               Customisation <i class="bi bi-box-arrow-up-right"></i>
             </a>

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-theme-zer0
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.1
 platform: ruby
 authors:
 - Amr Abdel