jekyll-theme-zer0 0.2.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d3fd790a2d2dae62a4f192d6d7c5f83b63fe18196a5799e3feafe5de7add9256
4
- data.tar.gz: 823b0d8f597bdde5333b2abfa40a93fb524a68a44ef4d0c1dd8b74a16f02cbba
3
+ metadata.gz: 838600963804f732b859c697438cccd774d612f404097fb2c6b0c47e9e77a565
4
+ data.tar.gz: eb5be13266ba1956069689b5907ff6d8f78e01b4e3cce6a2f7f26ad788328a1e
5
5
  SHA512:
6
- metadata.gz: 62f9564650a8d6f8d43cae9945fc6e617e7f18de851ecbd7a361fa5c627e3ff1e08fe1725c9c72f13df1d8bb2931264f85b7802a13e565141b723a2406a4b640
7
- data.tar.gz: c99393717b7180983fc6a07656871a535b34a2bc17e4bf8eff322ed042c9b074820bafbf5a7d536867904c4102c06817015d132a8daf7816240b179a6b8288dc
6
+ metadata.gz: f323ebceccc8ba86d554d819a377d5ca10fe39fa4f4c6a5c93de6ecf2c3180ed39e63c20ba1880aa798c129fe9e565f22998d12f44661651d0bca7c7e0fa5dad
7
+ data.tar.gz: a30d36dee46ec8e56f9b4b269144f5c27f12cb7cf19bd9390e113e12035f5d00b746ce525f7c2cefd06720e3c5f11c0152675742660a1a0e2937ef8c91b45ef4
data/CHANGELOG.md CHANGED
@@ -1,3 +1,43 @@
1
+ ## [0.4.0] - 2025-10-10
2
+
3
+ ### Added
4
+ - **📊 Comprehensive Site Statistics Dashboard**: Complete analytics system for content insights
5
+ - Dynamic statistics generation from site content using Ruby script
6
+ - Real-time analytics showing 61 content pieces, 19 categories, 47 tags, 43,601 words
7
+ - Interactive Bootstrap 5-based dashboard with responsive design
8
+ - Modular component architecture with 6 specialized statistics components
9
+ - Intelligent activity level calculations based on actual data distribution
10
+ - Professional tag cloud visualization with dynamic sizing
11
+ - Mobile-optimized layout with smooth animations and transitions
12
+ - **🔧 Advanced Data Processing Engine**: Automated content analysis and metric generation
13
+ - Ruby-based statistics generator script analyzing posts, pages, and collections
14
+ - YAML data file generation with comprehensive site metrics
15
+ - Smart categorization and tagging analysis with usage frequency tracking
16
+ - Monthly content distribution analysis and trend identification
17
+ - **🎨 Enhanced User Experience Components**: Professional dashboard interface
18
+ - Bootstrap 5-first design approach with minimal custom CSS
19
+ - Card-based layout for metric organization and visual hierarchy
20
+ - Interactive tooltips and progress indicators for enhanced usability
21
+ - Print-friendly styling and accessibility compliance (ARIA support)
22
+ - Smooth scroll navigation and fade-in animations for modern UX
23
+
24
+ ### Changed
25
+ - **📈 Activity Level Intelligence**: Dynamic threshold calculation replacing static values
26
+ - Categories: High activity (≥70% of max), Medium (≥40% of max), Low (remainder)
27
+ - Tags: Frequently used (≥60% of max), Moderately used (≥20% of max), Occasionally used (remainder)
28
+ - Real-time adaptation to content distribution patterns
29
+ - **🏗️ Template Architecture**: Modular include system for maintainable code
30
+ - Separated concerns across 6 specialized components
31
+ - Clean Liquid template syntax with proper error handling
32
+ - Optimized data processing without complex sorting operations
33
+
34
+ ### Fixed
35
+ - **🐛 Data Display Issues**: Resolved template rendering and data access problems
36
+ - Fixed Liquid template syntax errors causing empty displays
37
+ - Corrected data structure references across all components
38
+ - Eliminated type conversion errors in sorting operations
39
+ - Proper handling of nested array data structures
40
+
1
41
  ## [0.2.1] - 2025-09-30
2
42
 
3
43
  ### Added
data/README.md CHANGED
@@ -149,6 +149,18 @@ docker-compose up
149
149
 
150
150
  > 📖 **Learn more**: [Automated Version System Documentation](AUTOMATED_VERSION_SYSTEM.md)
151
151
 
152
+ ### 📊 **Mermaid Diagram Integration** *(New in v0.3.0)*
153
+
154
+ - **Complete Diagram Support** - Flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, Gantt charts, pie charts, git graphs, journey diagrams, and mindmaps
155
+ - **GitHub Pages Compatible** - Works seamlessly with both local development and GitHub Pages deployment
156
+ - **Conditional Loading** - Only loads Mermaid when needed, optimizing performance
157
+ - **Responsive Design** - Diagrams automatically scale across all devices
158
+ - **Dark Mode Support** - Forest theme optimized for dark mode compatibility
159
+ - **Comprehensive Documentation** - Complete user guide with live examples and troubleshooting
160
+ - **Automated Testing** - 16 automated tests covering all aspects of functionality
161
+
162
+ > 📖 **Learn more**: [Mermaid Documentation](/docs/jekyll/mermaid/) • [Integration Tutorial](/docs/jekyll/jekyll-diagram-with-mermaid/) • [Test Suite](/docs/jekyll/mermaid-test-suite/)
163
+
152
164
  ## 📋 Prerequisites
153
165
 
154
166
  Before you begin, ensure you have:
@@ -8,5 +8,7 @@
8
8
  url: /terms
9
9
  - title: Sitemap
10
10
  url: /about/sitemap
11
+ - title: Stats
12
+ url: /stats
11
13
  url: /about/
12
14
 
@@ -14,6 +14,8 @@
14
14
  sublinks:
15
15
  - title: All Posts
16
16
  url: /posts/
17
+ - title: Stats
18
+ url: /stats/
17
19
  - title: Docs
18
20
  url: /docs/
19
21
  sublinks:
@@ -0,0 +1,101 @@
1
+ <!--
2
+ ===================================================================
3
+ MERMAID DIAGRAM INTEGRATION
4
+ ===================================================================
5
+
6
+ File: mermaid.html
7
+ Path: _includes/components/mermaid.html
8
+ Purpose: Load and initialize Mermaid.js for diagram rendering
9
+
10
+ Usage:
11
+ - Set 'mermaid: true' in page front matter
12
+ - Use <div class="mermaid">...</div> syntax in content
13
+ - Supports all Mermaid diagram types (flowcharts, sequence, gantt, etc.)
14
+
15
+ Configuration:
16
+ - Latest stable version via CDN
17
+ - Forest theme for dark mode compatibility
18
+ - Initialized on document ready
19
+
20
+ Documentation:
21
+ - https://mermaid.js.org/
22
+ - https://github.com/mermaid-js/mermaid
23
+ ===================================================================
24
+ -->
25
+
26
+ <!-- Load Mermaid.js from CDN (latest stable version) -->
27
+ <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js"></script>
28
+
29
+ <!-- Initialize Mermaid with custom configuration -->
30
+ <script>
31
+ document.addEventListener('DOMContentLoaded', function() {
32
+ mermaid.initialize({
33
+ startOnLoad: true,
34
+ theme: 'forest', // Options: default, forest, dark, neutral, base
35
+ themeVariables: {
36
+ primaryColor: '#007bff',
37
+ primaryTextColor: '#fff',
38
+ primaryBorderColor: '#0056b3',
39
+ lineColor: '#6c757d',
40
+ secondaryColor: '#6c757d',
41
+ tertiaryColor: '#f8f9fa'
42
+ },
43
+ flowchart: {
44
+ useMaxWidth: true,
45
+ htmlLabels: true,
46
+ curve: 'basis'
47
+ },
48
+ sequence: {
49
+ diagramMarginX: 50,
50
+ diagramMarginY: 10,
51
+ actorMargin: 50,
52
+ width: 150,
53
+ height: 65,
54
+ boxMargin: 10,
55
+ boxTextMargin: 5,
56
+ noteMargin: 10,
57
+ messageMargin: 35,
58
+ mirrorActors: true,
59
+ bottomMarginAdj: 1,
60
+ useMaxWidth: true
61
+ },
62
+ gantt: {
63
+ titleTopMargin: 25,
64
+ barHeight: 20,
65
+ barGap: 4,
66
+ topPadding: 50,
67
+ leftPadding: 75,
68
+ gridLineStartPadding: 35,
69
+ fontSize: 11,
70
+ numberSectionStyles: 4,
71
+ axisFormat: '%Y-%m-%d'
72
+ }
73
+ });
74
+ console.log('Mermaid.js initialized successfully');
75
+ });
76
+ </script>
77
+
78
+ <!-- FontAwesome for Mermaid icon support (optional) -->
79
+ <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css" crossorigin="anonymous">
80
+
81
+ <!-- Custom CSS for Mermaid diagrams -->
82
+ <style>
83
+ .mermaid {
84
+ text-align: center;
85
+ margin: 2rem auto;
86
+ background-color: transparent;
87
+ }
88
+
89
+ /* Ensure diagrams are responsive */
90
+ .mermaid svg {
91
+ max-width: 100%;
92
+ height: auto;
93
+ }
94
+
95
+ /* Dark mode compatibility */
96
+ @media (prefers-color-scheme: dark) {
97
+ .mermaid {
98
+ filter: brightness(0.9);
99
+ }
100
+ }
101
+ </style>
@@ -47,10 +47,10 @@
47
47
  <!-- THIRD PARTY INTEGRATIONS -->
48
48
  <!-- ================================ -->
49
49
 
50
- <!-- Mermaid Diagrams - Currently disabled for performance -->
51
- <!-- Enable for pages requiring diagram generation -->
52
- <!-- <script src="https://cdn.jsdelivr.net/npm/mermaid@8/dist/mermaid.min.js"></script>
53
- <script>mermaid.initialize({ startOnLoad: true });</script> -->
50
+ <!-- Mermaid Diagrams - Conditional loading based on page front matter -->
51
+ {% if page.mermaid %}
52
+ {% include components/mermaid.html %}
53
+ {% endif %}
54
54
 
55
55
  <!-- Nano Progress Bar - Visual loading indicator -->
56
56
  <script src="{{'/assets/js/nanobar.min.js' | relative_url }}"></script>
@@ -147,6 +147,11 @@
147
147
  <!-- Custom CSS overrides - Theme customizations and tweaks -->
148
148
  <link rel="stylesheet" href="{{'/assets/css/custom.css' | relative_url }}">
149
149
 
150
+ <!-- Statistics page specific styles -->
151
+ {% if page.layout == 'stats' %}
152
+ <link rel="stylesheet" href="{{ '/assets/css/stats.css' | relative_url }}">
153
+ {% endif %}
154
+
150
155
  <!-- ========================== -->
151
156
  <!-- EXPERIMENTAL FRAMEWORKS -->
152
157
  <!-- ========================== -->
data/_layouts/README.md CHANGED
@@ -15,6 +15,7 @@ root.html (base template)
15
15
  ├── home.html (homepage)
16
16
  ├── blog.html (blog homepage)
17
17
  ├── landing.html (landing pages)
18
+ ├── stats.html (statistics dashboard)
18
19
  └── index.html (search pages)
19
20
  ```
20
21
 
@@ -82,6 +83,13 @@ root.html (base template)
82
83
  - **Dependencies**: Search engine integration
83
84
  - **Usage**: Search results, site indexes
84
85
 
86
+ #### `stats.html`
87
+
88
+ - **Purpose**: Statistics and analytics dashboard
89
+ - **Features**: Full-width responsive layout, modular statistics components
90
+ - **Dependencies**: Bootstrap 5, Bootstrap Icons, Jekyll data files
91
+ - **Usage**: Site analytics, content metrics, performance dashboards
92
+
85
93
  #### `javascript.html`
86
94
 
87
95
  - **Purpose**: JavaScript demonstration pages
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: jekyll-theme-zer0
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.1
4
+ version: 0.4.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amr Abdel
8
- autorequire:
8
+ autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2025-10-01 00:00:00.000000000 Z
11
+ date: 2025-10-10 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: jekyll
@@ -91,6 +91,7 @@ files:
91
91
  - _includes/components/halfmoon.html
92
92
  - _includes/components/info-section.html
93
93
  - _includes/components/js-cdn.html
94
+ - _includes/components/mermaid.html
94
95
  - _includes/components/powered-by.html
95
96
  - _includes/components/quick-index.html
96
97
  - _includes/components/searchbar.html
@@ -164,7 +165,7 @@ metadata:
164
165
  changelog_uri: https://github.com/bamr87/zer0-mistakes/blob/main/CHANGELOG.md
165
166
  documentation_uri: https://github.com/bamr87/zer0-mistakes#readme
166
167
  allowed_push_host: https://rubygems.org
167
- post_install_message:
168
+ post_install_message:
168
169
  rdoc_options: []
169
170
  require_paths:
170
171
  - lib
@@ -172,15 +173,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
172
173
  requirements:
173
174
  - - ">="
174
175
  - !ruby/object:Gem::Version
175
- version: 2.6.0
176
+ version: 2.7.0
176
177
  required_rubygems_version: !ruby/object:Gem::Requirement
177
178
  requirements:
178
179
  - - ">="
179
180
  - !ruby/object:Gem::Version
180
181
  version: '0'
181
182
  requirements: []
182
- rubygems_version: 3.0.3.1
183
- signing_key:
183
+ rubygems_version: 3.3.25
184
+ signing_key:
184
185
  specification_version: 4
185
186
  summary: Jekyll theme based on bootstrap and compatible with github pages
186
187
  test_files: []