jekyll-theme-zer0 1.3.0 → 1.4.1

data/_layouts/default.html

@@ -1,100 +1,104 @@
----
-layout: root
----
-<!--
-  ===================================================================
-  DEFAULT LAYOUT - Standard content layout with sidebars
-  ===================================================================
-  
-  File: default.html
-  Path: _layouts/default.html
-  Inherits: root.html
-  Purpose: Primary content layout with sidebar navigation and table of contents
-  
-  Template Logic:
-  - Creates a responsive three-column layout using Bootstrap grid
-  - Left sidebar: Site navigation and content outline (collapsible on mobile)
-  - Center: Main content area with page title and body content
-  - Right sidebar: Table of contents and page shortcuts (hidden on mobile)
-  - Implements scroll spy for navigation highlighting
-  - Responsive design that stacks vertically on mobile devices
-  
-  Layout Structure:
-  1. Container wrapper with Bootstrap responsive classes
-  2. Left sidebar (bd-sidebar) - Navigation and outline
-  3. Main content area (bd-main) with:
-     - Intro section (page title, metadata)
-     - Right sidebar (bd-toc) - Table of contents
-     - Content area (bd-content) - Main page content
-  
-  Dependencies:
-  - sidebar-left.html: Site navigation and content outline
-  - intro.html: Page title, breadcrumbs, and metadata
-  - sidebar-right.html: Table of contents and page shortcuts
-  
-  Bootstrap Classes Used:
-  - container-xxl: Extra large responsive container
-  - bd-gutter: Custom Bootstrap spacing
-  - bd-layout: Custom layout utility class
-  - bd-sidebar: Custom sidebar styling
-  - bd-main: Main content area
-  - bd-toc: Table of contents styling
-  - bd-content: Content area styling
-  ===================================================================
--->
-
-<!-- ================================================ -->
-<!-- MAIN LAYOUT CONTAINER                           -->
-<!-- Bootstrap responsive container with custom grid -->
-<!-- ================================================ -->
-<div class="container-xxl bd-gutter mt-3 my-md-4 bd-layout">
-
-    <!-- ================================ -->
-    <!-- LEFT SIDEBAR - Navigation       -->
-    <!-- ================================ -->
-    <!-- Site navigation, content outline, and offcanvas menu for mobile -->
-    <!-- Sidebar visibility controlled by page.sidebar front matter -->
-    {% unless page.sidebar == false %}
-    <aside class="bd-sidebar">
-        {% include navigation/sidebar-left.html %}
-    </aside>
-    {% endunless %}
-    
-    <!-- ================================ -->
-    <!-- MAIN CONTENT AREA               -->
-    <!-- ================================ -->
-    <!-- Primary content section with scroll spy for table of contents navigation -->
-    <main class="bd-main order-1" data-bs-spy="scroll" data-bs-target="#TableOfContents" data-bs-offset="100" data-bs-smooth-scroll="true">
-
-        <!-- Page introduction: title, breadcrumbs, metadata -->
-        {% include content/intro.html %}
-
-        <!-- =============================== -->
-        <!-- RIGHT SIDEBAR - Table of Contents -->
-        <!-- =============================== -->
-        <!-- Page outline, shortcuts, and related links (hidden on mobile) -->
-        <!-- Right sidebar visibility also controlled by page.sidebar -->
-        {% unless page.sidebar == false %}
-        <div class="bd-toc text-body-secondary">
-            {% include navigation/sidebar-right.html %}
-        </div>
-        {% endunless %}
-        
-        <!-- =============================== -->
-        <!-- MAIN CONTENT BODY              -->
-        <!-- =============================== -->
-        <!-- Where the actual page content is rendered -->
-        <div class="bd-content ps-lg-2">
-            {{ content }}
-
-            {%- comment -%}
-              Optional Obsidian-style backlinks panel. Opt-in for the generic
-              default layout via `backlinks: true` in front matter (the `note`
-              layout enables it by default).
-            {%- endcomment -%}
-            {% if page.backlinks == true %}
-              {% include content/backlinks.html %}
-            {% endif %}
-        </div>
-    </main>
-</div>
+---
+layout: root
+---
+<!--
+  ===================================================================
+  DEFAULT LAYOUT - Standard content layout with sidebars
+  ===================================================================
+
+  File: default.html
+  Path: _layouts/default.html
+  Inherits: root.html
+  Purpose: Primary content layout with sidebar navigation and table of contents
+
+  Template Logic:
+  - Creates a responsive three-column layout using Bootstrap grid
+  - Left sidebar: Site navigation and content outline (collapsible on mobile)
+  - Local graph: Independent Obsidian side panel with its own collapsible control
+  - Center: Main content area with page title and body content
+  - Right sidebar: Table of contents and page shortcuts (hidden on mobile)
+  - Implements scroll spy for navigation highlighting
+  - Responsive design that stacks vertically on mobile devices
+
+  Layout Structure:
+  1. Container wrapper with Bootstrap responsive classes
+  2. Left sidebar (bd-sidebar) - Navigation and outline
+  3. Main content area (bd-main) with:
+     - Intro section (page title, metadata)
+     - Right sidebar (bd-toc) - Table of contents
+     - Content area (bd-content) - Main page content
+
+  Dependencies:
+  - sidebar-left.html: Site navigation and content outline
+  - intro.html: Page title, breadcrumbs, and metadata
+  - sidebar-right.html: Table of contents and page shortcuts
+
+  Bootstrap Classes Used:
+  - container-xxl: Extra large responsive container
+  - bd-gutter: Custom Bootstrap spacing
+  - bd-layout: Custom layout utility class
+  - bd-sidebar: Custom sidebar styling
+  - bd-main: Main content area
+  - bd-toc: Table of contents styling
+  - bd-content: Content area styling
+  ===================================================================
+-->
+
+<!-- ================================================ -->
+<!-- MAIN LAYOUT CONTAINER                           -->
+<!-- Bootstrap responsive container with custom grid -->
+<!-- ================================================ -->
+<div class="container-xxl bd-gutter mt-3 my-md-4 bd-layout">
+
+    <!-- ================================ -->
+    <!-- LEFT SIDEBAR - Navigation       -->
+    <!-- ================================ -->
+    <!-- Site navigation, content outline, and offcanvas menu for mobile -->
+    <!-- Sidebar visibility controlled by page.sidebar front matter -->
+    {% unless page.sidebar == false %}
+    <aside class="bd-sidebar">
+        {% include navigation/sidebar-left.html %}
+    </aside>
+
+    <!-- Separate Obsidian local graph panel; intentionally outside bdSidebar. -->
+    {% include navigation/local-graph.html %}
+    {% endunless %}
+
+    <!-- ================================ -->
+    <!-- MAIN CONTENT AREA               -->
+    <!-- ================================ -->
+    <!-- Primary content section with scroll spy for table of contents navigation -->
+    <main class="bd-main order-1" data-bs-spy="scroll" data-bs-target="#TableOfContents" data-bs-offset="100" data-bs-smooth-scroll="true">
+
+        <!-- Page introduction: title, breadcrumbs, metadata -->
+        {% include content/intro.html %}
+
+        <!-- =============================== -->
+        <!-- RIGHT SIDEBAR - Table of Contents -->
+        <!-- =============================== -->
+        <!-- Page outline, shortcuts, and related links (hidden on mobile) -->
+        <!-- Right sidebar visibility also controlled by page.sidebar -->
+        {% unless page.sidebar == false %}
+        <div class="bd-toc text-body-secondary">
+            {% include navigation/sidebar-right.html %}
+        </div>
+        {% endunless %}
+
+        <!-- =============================== -->
+        <!-- MAIN CONTENT BODY              -->
+        <!-- =============================== -->
+        <!-- Where the actual page content is rendered -->
+        <div class="bd-content ps-lg-2">
+            {{ content }}
+
+            {%- comment -%}
+              Optional Obsidian-style backlinks panel. Opt-in for the generic
+              default layout via `backlinks: true` in front matter (the `note`
+              layout enables it by default).
+            {%- endcomment -%}
+            {% if page.backlinks == true %}
+              {% include content/backlinks.html %}
+            {% endif %}
+        </div>
+      </main>
+    </div>

data/_plugins/obsidian_links.rb

@@ -416,10 +416,15 @@ module Jekyll
 
       def rewrite_document(doc)
         return unless index
+        return unless needs_rewrite?(doc.content)
 
         converter = Converter.new(nil, index, config)
         doc.content = converter.convert(doc.content, current_url: doc.url)
       end
+
+      def needs_rewrite?(content)
+        content.include?('[[') || content.include?('> [!') || content.match?(Converter::INLINE_TAG_RE)
+      end
     end
   end
 end

data/_plugins/preview_image_generator.rb

@@ -47,6 +47,9 @@ module Jekyll
 
     # Check if a document has a preview image defined
     def self.has_preview?(doc)
+      cached = cached_preview_entry(doc)
+      return cached['has_preview'] unless cached.nil?
+
       preview = doc.data['preview']
       return false if preview.nil? || preview.to_s.strip.empty?
       
@@ -95,6 +98,9 @@ module Jekyll
 
     # Get the preview image path for a document
     def self.preview_path(doc)
+      cached = cached_preview_entry(doc)
+      return cached['path'] unless cached.nil?
+
       preview = doc.data['preview']
       return nil if preview.nil? || preview.to_s.strip.empty?
       
@@ -113,36 +119,86 @@ module Jekyll
 
     # Get list of documents missing preview images
     def self.missing_previews(site)
+      build_index(site)['missing']
+    end
+
+    def self.build_index(site)
+      cached = site.data['preview_image_index']
+      return cached if cached
+
       config = self.config(site)
+      index = {}
       missing = []
-      
-      config['collections'].each do |collection_name|
+
+      preview_documents(site, config).each do |doc, collection_name|
+        key = preview_cache_key(doc)
+        next if index.key?(key)
+
+        preview = doc.data['preview']
+        normalized_path = nil
+        has_preview = false
+
+        if preview && !preview.to_s.strip.empty? && (preview.match?(/\.(png|jpe?g|gif|svg|webp)$/i) || preview.start_with?('http'))
+          normalized_path = preview.start_with?('http') ? preview : normalize_preview_path(preview, config)
+          has_preview = preview.start_with?('http') || preview_file_exists?(site, normalized_path, config)
+        end
+
+        index[key] = {
+          'has_preview' => has_preview,
+          'path' => normalized_path,
+          'collection' => collection_name
+        }
+
+        next if has_preview
+
+        missing << {
+          'path' => doc.relative_path,
+          'title' => doc.data['title'] || File.basename(doc.relative_path),
+          'collection' => collection_name
+        }
+      end
+
+      site.data['preview_image_index'] = {
+        'documents' => index,
+        'missing' => missing
+      }
+    end
+
+    def self.cached_preview_entry(doc)
+      return nil unless doc.respond_to?(:site) && doc.site && doc.site.data['preview_image_index']
+
+      doc.site.data['preview_image_index']['documents'][preview_cache_key(doc)]
+    end
+
+    def self.preview_documents(site, config)
+      docs = []
+      Array(config['collections']).each do |collection_name|
         collection = site.collections[collection_name]
         next unless collection
-        
-        collection.docs.each do |doc|
-          unless has_preview?(doc)
-            missing << {
-              'path' => doc.relative_path,
-              'title' => doc.data['title'] || File.basename(doc.relative_path),
-              'collection' => collection_name
-            }
-          end
-        end
+
+        collection.docs.each { |doc| docs << [doc, collection_name] }
       end
-      
-      # Also check posts (which are special in Jekyll)
-      site.posts.docs.each do |doc|
-        unless has_preview?(doc)
-          missing << {
-            'path' => doc.relative_path,
-            'title' => doc.data['title'] || File.basename(doc.relative_path),
-            'collection' => 'posts'
-          }
-        end
+
+      site.posts.docs.each { |doc| docs << [doc, 'posts'] } if site.respond_to?(:posts) && site.posts
+      docs
+    end
+
+    def self.preview_cache_key(doc)
+      doc.respond_to?(:relative_path) ? doc.relative_path : doc.path
+    end
+
+    def self.preview_file_exists?(site, normalized_preview, config)
+      candidates = []
+      if normalized_preview.start_with?('/')
+        candidates << File.join(site.source, normalized_preview.sub(/^\//, ''))
+        candidates << File.join(site.source, 'assets', normalized_preview.sub(/^\//, ''))
+      else
+        candidates << File.join(site.source, 'assets', normalized_preview)
+        candidates << File.join(site.source, normalized_preview)
+        candidates << File.join(site.source, config['output_dir'], normalized_preview)
       end
-      
-      missing.uniq { |m| m['path'] }
+
+      candidates.any? { |path| File.exist?(path) }
     end
 
     # Generate a preview image filename from document
@@ -264,7 +320,8 @@ module Jekyll
       return unless config['enabled']
       
       # Store missing previews in site data for access in templates
-      site.data['preview_images_missing'] = PreviewImageGenerator.missing_previews(site)
+      preview_index = PreviewImageGenerator.build_index(site)
+      site.data['preview_images_missing'] = preview_index['missing']
       site.data['preview_images_config'] = config
       
       # Log status

data/_sass/core/_obsidian.scss

@@ -152,18 +152,91 @@
 }
 
 // ----------------------------------------------------------------------------
-// Local graph widget (left sidebar) — small Obsidian-style local graph view.
+// Local graph side panel — Obsidian-style local graph view.
 // Rendered by _includes/navigation/local-graph.html via assets/js/obsidian-local-graph.js.
 // ----------------------------------------------------------------------------
+.obsidian-local-graph-fab {
+  position: fixed;
+  left: 1rem;
+  bottom: 1rem;
+  z-index: 1032;
+
+  &[hidden] {
+    display: none !important;
+  }
+}
+
+.obsidian-local-graph-toggle {
+  width: 3.25rem;
+  height: 3.25rem;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  transition: transform 0.2s ease, box-shadow 0.2s ease;
+
+  &:hover,
+  &:focus-visible {
+    transform: translateY(-1px);
+  }
+
+  &:active {
+    transform: translateY(0);
+  }
+}
+
+.obsidian-local-graph-panel {
+  --bs-offcanvas-width: min(28rem, calc(100vw - 1.5rem));
+
+  &[hidden] {
+    display: none !important;
+  }
+
+  .offcanvas-body {
+    display: flex;
+    flex-direction: column;
+    min-height: 0;
+  }
+}
+
 .obsidian-local-graph-widget {
+  display: flex;
+  flex: 1 1 auto;
+  flex-direction: column;
+  min-height: 0;
+
+  .obsidian-local-graph-meta {
+    flex: 0 0 auto;
+  }
+
   #obsidian-local-graph {
+    flex: 1 1 auto;
     width: 100%;
-    height: 220px;
-    min-height: 180px;
+    height: min(62vh, 34rem);
+    min-height: 22rem;
     border: 1px solid var(--bs-border-color, #dee2e6);
-    border-radius: var(--bs-border-radius, 0.375rem);
+    border-radius: var(--bs-border-radius-lg, 0.5rem);
     background: var(--bs-tertiary-bg, #f8f9fa);
     overflow: hidden;
     position: relative;
   }
+
+  .obsidian-local-graph-status {
+    min-height: 1.25rem;
+  }
+}
+
+@media (max-width: 575.98px) {
+  .obsidian-local-graph-fab {
+    left: 0.875rem;
+    bottom: 0.875rem;
+  }
+
+  .obsidian-local-graph-panel {
+    --bs-offcanvas-width: min(100vw, 24rem);
+  }
+
+  .obsidian-local-graph-widget #obsidian-local-graph {
+    height: 58vh;
+    min-height: 18rem;
+  }
 }

data/_sass/core/_offcanvas-panels.scss

@@ -4,13 +4,15 @@
 // =============================================================================
 
 #bdSidebar .offcanvas-header,
-#tocContents .offcanvas-header {
+#tocContents .offcanvas-header,
+#obsidianLocalGraphPanel .offcanvas-header {
   border-bottom: 2px solid var(--bs-border-color);
   padding: 1.25rem 1rem;
 }
 
 #bdSidebar .offcanvas-title,
-#tocContents .offcanvas-title {
+#tocContents .offcanvas-title,
+#obsidianLocalGraphPanel .offcanvas-title {
   font-size: 1.125rem;
   font-weight: 600;
   color: var(--bs-emphasis-color);
@@ -19,7 +21,8 @@
 
 @media (max-width: 991.98px) {
   #bdSidebar .offcanvas-header .btn-close,
-  #tocContents .offcanvas-header .btn-close {
+  #tocContents .offcanvas-header .btn-close,
+  #obsidianLocalGraphPanel .offcanvas-header .btn-close {
     width: 48px;
     height: 48px;
     padding: 0;
@@ -36,7 +39,8 @@
     }
   }
 
-  #tocContents .offcanvas-body {
+  #tocContents .offcanvas-body,
+  #obsidianLocalGraphPanel .offcanvas-body {
     padding: 1rem;
   }
 

data/assets/data/wiki-index.json

@@ -36,14 +36,38 @@ sitemap: false
   "entries": [
     {%- for doc in all_docs -%}
       {%- assign basename = doc.path | split: "/" | last | replace: ".md", "" | replace: ".markdown", "" | replace: ".html", "" -%}
-      {%- assign body = doc.content | default: "" | strip_html -%}
+      {%- assign body_source = doc.content | default: "" -%}
+      {%- assign body_without_fences = "" -%}
+      {%- assign fence_parts = body_source | split: "```" -%}
+      {%- for fence_part in fence_parts -%}
+        {%- assign fence_mod = forloop.index0 | modulo: 2 -%}
+        {%- if fence_mod == 0 -%}
+          {%- assign body_without_fences = body_without_fences | append: fence_part -%}
+        {%- endif -%}
+      {%- endfor -%}
+      {%- assign body_without_code = "" -%}
+      {%- assign inline_code_parts = body_without_fences | split: "`" -%}
+      {%- for inline_code_part in inline_code_parts -%}
+        {%- assign inline_code_mod = forloop.index0 | modulo: 2 -%}
+        {%- if inline_code_mod == 0 -%}
+          {%- assign body_without_code = body_without_code | append: inline_code_part -%}
+        {%- endif -%}
+      {%- endfor -%}
+      {%- assign body = body_without_code | strip_html -%}
       {%- assign body_excerpt = body | strip_newlines | truncate: 240 -%}
+      {%- assign aliases = "" | split: "," -%}
+      {%- if doc.aliases -%}
+        {%- assign aliases_blob = doc.aliases | join: "||" -%}
+        {%- assign aliases = aliases_blob | split: "||" -%}
+      {%- endif -%}
       {%- comment -%}
         Extract outgoing wiki-link targets so the graph view
         (assets/js/obsidian-graph.js) can render edges without re-parsing
-        every page client-side. We mask `![[…]]` embeds first so they don't
-        also get split as `[[…]]`, then split on `[[`, take everything
-        before `]]`, and strip the optional `|alias` and `#anchor` parts.
+        every page client-side. Fenced and inline code are removed first so
+        Bash `[[ ... ]]` tests and literal examples don't become graph edges.
+        We mask `![[…]]` embeds so they don't also get split as `[[…]]`, then
+        strip optional `|alias` and `#anchor` / `^block` parts. Operator-heavy
+        targets are discarded as table examples rather than Obsidian page names.
       {%- endcomment -%}
       {%- assign masked = body | replace: "![[", "@@OBSEMBED@@" -%}
       {%- assign chunks = masked | split: "[[" -%}
@@ -52,7 +76,21 @@ sitemap: false
         {%- assign target_raw = chunk | split: "]]" | first -%}
         {%- if target_raw and target_raw != "" -%}
           {%- assign target = target_raw | split: "|" | first | split: "#" | first | split: "^" | first | strip | downcase -%}
-          {%- if target != "" and target.size < 200 -%}
+          {%- assign target_is_code = false -%}
+          {%- assign first_char = target | slice: 0 -%}
+          {%- if target contains "$" or target contains "==" or target contains "!=" or target contains "=~" -%}
+            {%- assign target_is_code = true -%}
+          {%- endif -%}
+          {%- if target contains "&&" or target contains "||" or target contains "&amp;&amp;" or target contains "&lt;" or target contains "&gt;" -%}
+            {%- assign target_is_code = true -%}
+          {%- endif -%}
+          {%- if target contains " -eq " or target contains " -ne " or target contains " -lt " or target contains " -le " or target contains " -gt " or target contains " -ge " -%}
+            {%- assign target_is_code = true -%}
+          {%- endif -%}
+          {%- if first_char == "-" or target contains "{" or target contains "}" or target contains "(" or target contains ")" or target contains '"' or target contains "'" -%}
+            {%- assign target_is_code = true -%}
+          {%- endif -%}
+          {%- if target != "" and target.size < 200 and target_is_code == false -%}
             {%- assign outgoing = outgoing | push: target -%}
           {%- endif -%}
         {%- endif -%}
@@ -65,7 +103,7 @@ sitemap: false
         "collection": {{ doc.collection | default: nil | jsonify }},
         "tags": {{ doc.tags | default: empty | jsonify }},
         "categories": {{ doc.categories | default: empty | jsonify }},
-        "aliases": {{ doc.aliases | default: empty | jsonify }},
+        "aliases": {{ aliases | jsonify }},
         "outgoing": {{ outgoing | jsonify }},
         "excerpt": {{ body_excerpt | jsonify }}
       }{% unless forloop.last %},{% endunless %}

data/assets/js/obsidian-graph.js

@@ -184,7 +184,6 @@
     var cy = window.cytoscape({
       container: container,
       elements: elements,
-      wheelSensitivity: 0.2,
       minZoom: 0.1,
       maxZoom: 4,
       style: [