jekyll-theme-zer0 0.20.2 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19c84811dcc56b5cb437c118f6a66ce6895db10702f4011be545003bc9d6f134
-  data.tar.gz: 61f3707a93a6ac230276cb64fb007c7e2531fa23e940f9039db05fab061b99ee
+  metadata.gz: 6efa1fb4e9fdc23aa63e90c94762e62c2f568a379133ca8674f78b6c2ed19046
+  data.tar.gz: c9eba9e9cff455d23cdeebdbc92facbafc0a6ec6063c366cfeb7819a044a3cc6
 SHA512:
-  metadata.gz: 87b0384c193e4f0ae8c75268e7a784f3c0bb90e99fdfdb4113edee8425682eb59cb9888ad8d1c28d77e4ec62c6d00e81e1f3f01d9a0e1dce278011f48cd6dfbb
-  data.tar.gz: f5bff135bbf740f16cbc0eb487568d633bffe37e5cdd5b23e33626cba98f091784c10036eababf6428f516c2618ee3956b677d8b9fde944b608d1d91947a3123
+  metadata.gz: e9a4fa8676d4589896c9feaa8fd9e440e6bb1c76e686c5b5860d3a9112e873ac2cb4f98543391495456236e689bce451a1de36285de122c6793210914baa62c9
+  data.tar.gz: da070bafa01bfd3a7507da4160a31f396b94c1163299c788cab1aeaa011291f1e6955ddf29128c4045425821feea34a83bf62290f7c75183fd411e48099deece

data/CHANGELOG.md

@@ -1,5 +1,86 @@
 # Changelog
 
+## [0.21.0] - 2026-02-01
+
+### Added
+- **Environment Switcher**: New settings modal tab with dev/prod URL shortcuts and copy actions
+- **Navigation Assets**: Extracted navigation styles and scripts into `_sass/core/_navbar.scss` and `assets/js/navigation.js`
+
+### Changed
+- **Settings Modal**: Redesigned info section with tabbed layout and compact theme info
+- **Navigation UI**: Refined header utility controls, navbar labels/icons, and loaded navigation JS via js-cdn include
+- **Dev Shortcuts**: Updated source shortcuts layout and labeling for clarity
+- **Theme Branding**: Updated default title icon and subtitle in `_config.yml`
+
+## [0.20.8] - 2026-02-02
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- d71a42a feat(docker): add local Docker publishing capability
+
+
+## [0.20.7] - 2026-02-01
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 969ce94 refactor(ci): abstract hardcoded values to GitHub variables and secrets
+
+
+## [0.20.6] - 2026-02-01
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- af25fc8 fix(ci): improve Docker compose compatibility for CI environments
+
+
+## [0.20.5] - 2026-02-01
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 7a2eeaf fix(docker): add PAGES_REPO_NWO environment variable for Jekyll builds
+
+
+## [0.20.4] - 2026-02-01
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- a71e7a3 fix(ci): add PAGES_REPO_NWO env var and skip-remote for Jekyll builds
+- 74e0929 fix(ci): ensure Gemfile.lock is updated during version bumps
+- e06520e docs(prompts): enhance release pipeline documentation with best practices
+
+
+## [0.20.3] - 2026-02-01
+
+### Added
+- **Notes Collection**: 5 new developer reference notes
+  - `bash-shortcuts.md` - Essential terminal keyboard shortcuts
+  - `docker-commands.md` - Docker and Docker Compose command reference
+  - `git-cheatsheet.md` - Git commands quick reference
+  - `jekyll-front-matter.md` - Jekyll front matter variables guide
+  - `markdown-tips.md` - Advanced Markdown formatting tricks
+- **Python Statistics Notebook**: New `python-statistics.ipynb` Jupyter notebook with scipy, pandas, and statistical analysis examples
+- **Enhanced Notes page**: Added tag filtering and improved card-based layout
+- **Enhanced Notebooks page**: Added difficulty filtering and improved card-based layout with download links
+
+### Changed
+- **Layout Standardization**: Updated all posts from `layout: journals` to `layout: article` for consistency
+- **Section Index Pages**: Updated category index pages to use `layout: section` with proper section_style settings
+- **News URL Structure**: Changed permalinks from `/posts/` to `/news/` across all news sections
+- **Removed**: Deleted unused `pages/blog.md` page
+
+### Fixed
+- **Layout consistency**: Standardized layouts across Business, Development, Science, Technology, Tutorial, and World news sections
+
 ## [0.20.2] - 2026-01-30
 
 ### Added

data/_data/navigation/main.yml

@@ -14,17 +14,49 @@
     - title: GitHub Setup
       url: /quickstart/github-setup/
 
-- title: Blog
-  icon: bi-journal-text
-  url: /blog/
+- title: News
+  icon: bi-newspaper
+  url: /news/
   children:
-    - title: All Posts
-      url: /posts/
+    - title: All News
+      url: /news/
     - title: Categories
       url: /categories/
     - title: Tags
       url: /tags/
 
+- title: Notes
+  icon: bi-journal-text
+  url: /notes/
+  children:
+    - title: All Notes
+      url: /notes/
+    - title: Git Cheatsheet
+      url: /notes/git-cheatsheet/
+    - title: Docker Commands
+      url: /notes/docker-commands/
+    - title: Jekyll Front Matter
+      url: /notes/jekyll-front-matter/
+    - title: Markdown Tips
+      url: /notes/markdown-tips/
+    - title: Bash Shortcuts
+      url: /notes/bash-shortcuts/
+
+- title: Notebooks
+  icon: bi-journal-code
+  url: /notebooks/
+  children:
+    - title: All Notebooks
+      url: /notebooks/
+    - title: Pandas Data Analysis
+      url: /notebooks/pandas-data-analysis/
+    - title: Matplotlib Visualization
+      url: /notebooks/matplotlib-visualization/
+    - title: Python Statistics
+      url: /notebooks/python-statistics/
+    - title: API Requests
+      url: /notebooks/api-requests/
+
 - title: Docs
   icon: bi-journal-bookmark
   url: /docs/

data/_data/navigation/posts.yml

@@ -1,34 +1,34 @@
-# Posts/Blog Category Navigation Configuration
-# Used by: Blog layout, category pages, and post navigation
-# Purpose: Category-based navigation for blog posts
-# Note: Categories match folders in pages/_posts/
+# News Section Navigation Configuration
+# Used by: News layout, section pages, and article navigation
+# Purpose: Section-based navigation for news content
+# Note: Sections match folders in pages/_posts/
 
 - title: Development
   icon: bi-code-slash
-  url: /posts/development/
+  url: /news/development/
   description: "Software development, coding practices, and programming tutorials"
 
 - title: Technology
   icon: bi-cpu
-  url: /posts/technology/
+  url: /news/technology/
   description: "Tech news, tools, and emerging technologies"
 
 - title: Tutorial
   icon: bi-journal-code
-  url: /posts/tutorial/
+  url: /news/tutorial/
   description: "Step-by-step guides and how-to articles"
 
 - title: World
   icon: bi-globe
-  url: /posts/world/
+  url: /news/world/
   description: "Global trends, remote work, and industry insights"
 
 - title: Business
   icon: bi-briefcase
-  url: /posts/business/
+  url: /news/business/
   description: "Business strategies, startups, and entrepreneurship"
 
 - title: Science
   icon: bi-mortarboard
-  url: /posts/science/
+  url: /news/science/
   description: "Scientific discoveries, research, and innovation"

data/_includes/components/dev-shortcuts.html

@@ -1,57 +1,104 @@
 <!--
-    Title: Dev Shortcuts
-    Description: This file contains the dev shortcuts for the site.
-    file: dev-shortcuts.html
-    variables: 
-        - site.repository
-        - site.default_icon
-        - site.collections_dir
-        - site.repository_name
-        - site.nav-file
-        - site.local_git_pc
-        - site.local_git_mac
-        - page.collection
-        - page_dir
-        - testvar
-    references:
-        - https://shopify.github.io/liquid/tags/variable/#capture
-        - https://getbootstrap.com/docs/5.3/components/collapse/
-    tutorial: 
-        - https://jekyllcodex.org/without-plugin/hidden-settings/
-        - https://jekyllcodex.org/without-plugin/hidden-settings/#collapse-feature
- -->
+  ===================================================================
+  DEV SHORTCUTS - Source Code Quick Access Links
+  ===================================================================
+  
+  File: dev-shortcuts.html
+  Path: _includes/components/dev-shortcuts.html
+  Purpose: Provide quick access to source code editing in various IDEs
+  
+  Dependencies:
+  - site.repository, site.branch, site.collections_dir
+  - page.collection, page.path
+  ===================================================================
+-->
 
- <!-- TODO: Article about the collapse feature in Bootstrap https://getbootstrap.com/docs/5.3/components/collapse/--> 
- <!-- TODO: Write tutorial on creating this hidden settings feature -->
+{% comment %} Determine page directory for collections {% endcomment %}
+{% if page.collection %}
+  {% capture page_dir %}{{ site.collections_dir }}{% endcapture %}
+{% else %}
+  {% assign page_dir = "" %}
+{% endif %}
 
- <!-- Source Code Control Shortcuts - Page -->
- <div class="container text-center">
-
-    {% if page.collection %}
-        {% capture page_dir %}{{ site.collections_dir }}{% endcapture %}
-        {% assign testvar = "collection exists" %}
-    {% endif %}
+<div class="dev-shortcuts">
+  <div class="d-flex flex-column gap-2">
     
-    <!-- Source Code Control Shortcuts - Page -->
-        <a class="btn bg-primary" href="https://github.com/{{site.repository}}/blob/{{site.branch}}/{{ page_dir }}/{{page.path}}">
-            <i class="{{site.default_icon}} {{site.default_icon}}-github"></i>
-            <!-- https://icons.getbootstrap.com/icons/github/ -->
-        </a>
-        <a class="btn bg-primary" href="https://github.dev/{{site.repository}}/blob/{{site.branch}}/{{ page_dir }}/{{ page.path }}">
-            <i class="{{site.default_icon}} {{site.default_icon}}-cloud"></i>
-            <!-- https://icons.getbootstrap.com/icons/microsoft/ -->
-        </a>
+    <!-- Section Label -->
+    <small class="text-body-secondary fw-medium text-uppercase">
+      <i class="bi bi-code-slash me-1"></i>Source Code
+    </small>
     
-    <!-- Source Code Control Shortcuts - Site and Nav -->
+    <!-- Button Group -->
+    <div class="btn-group-vertical" role="group" aria-label="Source code shortcuts">
+      
+      <!-- View on GitHub -->
+      <a href="https://github.com/{{ site.repository }}/blob/{{ site.branch }}/{{ page_dir }}/{{ page.path }}" 
+         target="_blank"
+         rel="noopener"
+         class="btn btn-outline-secondary btn-sm d-flex align-items-center justify-content-between"
+         data-bs-toggle="tooltip"
+         data-bs-placement="left"
+         title="View source file on GitHub">
+        <span>
+          <i class="bi bi-github me-2"></i>
+          View on GitHub
+        </span>
+        <i class="bi bi-box-arrow-up-right text-body-secondary small"></i>
+      </a>
+      
+      <!-- Edit in GitHub.dev -->
+      <a href="https://github.dev/{{ site.repository }}/blob/{{ site.branch }}/{{ page_dir }}/{{ page.path }}" 
+         target="_blank"
+         rel="noopener"
+         class="btn btn-outline-secondary btn-sm d-flex align-items-center justify-content-between"
+         data-bs-toggle="tooltip"
+         data-bs-placement="left"
+         title="Open in browser-based VS Code editor">
+        <span>
+          <i class="bi bi-cloud me-2"></i>
+          Edit in GitHub.dev
+        </span>
+        <i class="bi bi-box-arrow-up-right text-body-secondary small"></i>
+      </a>
+      
+      <!-- Open in Local VS Code -->
+      <a href="vscode://file{{ site.local_git }}/{{ site.repository_name }}/{{ page_dir }}/{{ page.path }}"
+         class="btn btn-outline-secondary btn-sm d-flex align-items-center justify-content-between"
+         data-bs-toggle="tooltip"
+         data-bs-placement="left"
+         title="Open in local VS Code (requires local clone)">
+        <span>
+          <i class="bi bi-code-square me-2"></i>
+          Open in VS Code
+        </span>
+        <i class="bi bi-window text-body-secondary small"></i>
+      </a>
+      
+    </div>
     
-        <a class="btn bg-primary" href="vscode://file{{ site.local_git}}/{{ site.repository_name }}/{{ page_dir }}/{{ page.path }}">
-            <i class="{{site.default_icon}} {{site.default_icon}}-code"></i>
-        </a>
-
-        <!-- site config -->
-        <a class="btn bg-primary" href="https://github.com/{{site.repository}}/blob/{{site.branch}}/_config.yml">
-            <i class="bi bi-gear"></i>
-            <!-- https://icons.getbootstrap.com/icons/gear/ -->
-        </a>
-
+    <!-- Config Links -->
+    <small class="text-body-secondary fw-medium text-uppercase mt-2">
+      <i class="bi bi-sliders me-1"></i>Configuration
+    </small>
+    
+    <div class="btn-group-vertical" role="group" aria-label="Configuration shortcuts">
+      
+      <!-- Site Config -->
+      <a href="https://github.com/{{ site.repository }}/blob/{{ site.branch }}/_config.yml" 
+         target="_blank"
+         rel="noopener"
+         class="btn btn-outline-secondary btn-sm d-flex align-items-center justify-content-between"
+         data-bs-toggle="tooltip"
+         data-bs-placement="left"
+         title="View Jekyll site configuration">
+        <span>
+          <i class="bi bi-gear me-2"></i>
+          Site Config
+        </span>
+        <code class="small ms-2">_config.yml</code>
+      </a>
+      
+    </div>
+    
+  </div>
 </div>

data/_includes/components/env-switcher.html

@@ -0,0 +1,212 @@
+<!--
+  ===================================================================
+  ENVIRONMENT SWITCHER - Dev/Prod URL Display and Toggle
+  ===================================================================
+  
+  File: env-switcher.html
+  Path: _includes/components/env-switcher.html
+  Purpose: Display current environment and provide URL switching
+  
+  Dependencies:
+  - jekyll.environment: Current build environment
+  - site.url: Production URL
+  - site.port: Development port (default 4000)
+  - Bootstrap 5 components
+  ===================================================================
+-->
+
+{% assign current_env = jekyll.environment | default: "development" %}
+{% assign is_production = current_env == "production" %}
+{% assign prod_url = site.url | append: site.baseurl %}
+{% assign dev_url = "http://localhost:" | append: site.port | default: 4000 | append: site.baseurl %}
+
+<!-- Environment Status Card -->
+<div class="card border-{{ is_production | if: 'success', 'warning' }} mb-3">
+  <div class="card-header d-flex align-items-center justify-content-between py-2 bg-{{ is_production | if: 'success', 'warning' }} bg-opacity-10">
+    <span class="fw-semibold">
+      <i class="bi bi-{{ is_production | if: 'cloud-check', 'pc-display' }} me-2"></i>
+      Current Environment
+    </span>
+    {% if is_production %}
+      <span class="badge bg-success">
+        <i class="bi bi-globe me-1"></i>Production
+      </span>
+    {% else %}
+      <span class="badge bg-warning text-dark">
+        <i class="bi bi-code-slash me-1"></i>Development
+      </span>
+    {% endif %}
+  </div>
+  <div class="card-body">
+    <!-- Active URL Display -->
+    <div class="mb-3">
+      <label class="form-label small text-body-secondary mb-1">
+        <i class="bi bi-link-45deg me-1"></i>Current Page URL
+      </label>
+      <div class="input-group input-group-sm">
+        <span class="input-group-text">
+          <i class="bi bi-{{ is_production | if: 'lock', 'unlock' }}"></i>
+        </span>
+        <input type="text" 
+               class="form-control font-monospace" 
+               value="{{ is_production | if: prod_url, dev_url }}{{ page.url }}" 
+               readonly 
+               id="currentUrlInput">
+        <button class="btn btn-outline-secondary" 
+                type="button" 
+                onclick="copyToClipboard('currentUrlInput', this)"
+                title="Copy to clipboard">
+          <i class="bi bi-clipboard"></i>
+        </button>
+      </div>
+    </div>
+
+    <!-- Build Info -->
+    <div class="row g-2 text-center mb-3">
+      <div class="col-6">
+        <div class="p-2 bg-body-tertiary rounded">
+          <small class="text-body-secondary d-block">Build Time</small>
+          <strong class="small">{{ site.time | date: "%b %d, %H:%M" }}</strong>
+        </div>
+      </div>
+      <div class="col-6">
+        <div class="p-2 bg-body-tertiary rounded">
+          <small class="text-body-secondary d-block">Jekyll</small>
+          <strong class="small">v{{ jekyll.version }}</strong>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+
+<!-- Quick URL Links -->
+<div class="card border-secondary">
+  <div class="card-header py-2 bg-body-tertiary">
+    <span class="fw-semibold small">
+      <i class="bi bi-signpost-2 me-2"></i>Quick Links
+    </span>
+  </div>
+  <ul class="list-group list-group-flush">
+    <!-- Production URL -->
+    <li class="list-group-item d-flex justify-content-between align-items-center">
+      <div class="d-flex align-items-center">
+        <span class="badge bg-success me-2">Prod</span>
+        <a href="{{ prod_url }}{{ page.url }}" 
+           target="_blank" 
+           rel="noopener" 
+           class="text-decoration-none font-monospace small text-truncate"
+           style="max-width: 180px;"
+           title="{{ prod_url }}{{ page.url }}">
+          {{ site.url | remove: "https://" | remove: "http://" | truncate: 25 }}{{ page.url | truncate: 15 }}
+        </a>
+      </div>
+      <div class="btn-group btn-group-sm">
+        <a href="{{ prod_url }}{{ page.url }}" 
+           target="_blank" 
+           rel="noopener" 
+           class="btn btn-outline-success" 
+           title="Open in new tab">
+          <i class="bi bi-box-arrow-up-right"></i>
+        </a>
+        <button class="btn btn-outline-secondary" 
+                type="button"
+                onclick="copyUrl('{{ prod_url }}{{ page.url }}', this)"
+                title="Copy URL">
+          <i class="bi bi-clipboard"></i>
+        </button>
+      </div>
+    </li>
+
+    <!-- Development URL -->
+    <li class="list-group-item d-flex justify-content-between align-items-center">
+      <div class="d-flex align-items-center">
+        <span class="badge bg-warning text-dark me-2">Dev</span>
+        <a href="{{ dev_url }}{{ page.url }}" 
+           target="_blank" 
+           rel="noopener" 
+           class="text-decoration-none font-monospace small text-truncate"
+           style="max-width: 180px;"
+           title="{{ dev_url }}{{ page.url }}">
+          localhost:{{ site.port | default: 4000 }}{{ page.url | truncate: 15 }}
+        </a>
+      </div>
+      <div class="btn-group btn-group-sm">
+        <a href="{{ dev_url }}{{ page.url }}" 
+           target="_blank" 
+           rel="noopener" 
+           class="btn btn-outline-warning" 
+           title="Open in new tab">
+          <i class="bi bi-box-arrow-up-right"></i>
+        </a>
+        <button class="btn btn-outline-secondary" 
+                type="button"
+                onclick="copyUrl('{{ dev_url }}{{ page.url }}', this)"
+                title="Copy URL">
+          <i class="bi bi-clipboard"></i>
+        </button>
+      </div>
+    </li>
+
+    {% if site.repository %}
+    <!-- GitHub Source -->
+    <li class="list-group-item d-flex justify-content-between align-items-center">
+      <div class="d-flex align-items-center">
+        <span class="badge bg-dark me-2">Source</span>
+        <span class="font-monospace small text-truncate" style="max-width: 180px;">
+          {{ page.path | split: "/" | last }}
+        </span>
+      </div>
+      <a href="https://github.com/{{ site.repository }}/blob/{{ site.branch | default: 'main' }}/{% if page.collection %}{{ site.collections_dir }}/{% endif %}{{ page.path }}" 
+         target="_blank" 
+         rel="noopener" 
+         class="btn btn-sm btn-outline-dark" 
+         title="View on GitHub">
+        <i class="bi bi-github"></i>
+      </a>
+    </li>
+    {% endif %}
+  </ul>
+</div>
+
+<!-- Environment Tip -->
+<div class="alert alert-{{ is_production | if: 'success', 'warning' }} alert-dismissible fade show mt-3 py-2 small" role="alert">
+  <i class="bi bi-info-circle me-1"></i>
+  {% if is_production %}
+    Viewing <strong>production</strong> build. Changes require deployment.
+  {% else %}
+    <strong>Development</strong> mode. Changes auto-reload on save.
+  {% endif %}
+  <button type="button" class="btn-close btn-close-sm" data-bs-dismiss="alert" aria-label="Close" style="padding: 0.5rem;"></button>
+</div>
+
+<script>
+function copyToClipboard(inputId, btn) {
+  const input = document.getElementById(inputId);
+  navigator.clipboard.writeText(input.value).then(() => {
+    showCopyFeedback(btn, true);
+  }).catch(() => {
+    showCopyFeedback(btn, false);
+  });
+}
+
+function copyUrl(url, btn) {
+  navigator.clipboard.writeText(url).then(() => {
+    showCopyFeedback(btn, true);
+  }).catch(() => {
+    showCopyFeedback(btn, false);
+  });
+}
+
+function showCopyFeedback(btn, success) {
+  const originalHtml = btn.innerHTML;
+  btn.innerHTML = success ? '<i class="bi bi-check2"></i>' : '<i class="bi bi-x"></i>';
+  btn.classList.add(success ? 'btn-success' : 'btn-danger');
+  btn.classList.remove('btn-outline-secondary');
+  
+  setTimeout(() => {
+    btn.innerHTML = originalHtml;
+    btn.classList.remove('btn-success', 'btn-danger');
+    btn.classList.add('btn-outline-secondary');
+  }, 1500);
+}
+</script>