jekyll-theme-zer0 0.10.6 → 0.15.2

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.
Files changed (65) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +428 -0
  3. data/README.md +79 -31
  4. data/_data/README.md +419 -17
  5. data/_data/generate_statistics.rb +216 -9
  6. data/_data/generate_statistics.sh +106 -0
  7. data/_data/github-actions-example.yml +210 -0
  8. data/_data/navigation/about.yml +39 -11
  9. data/_data/navigation/docs.yml +53 -23
  10. data/_data/navigation/home.yml +27 -9
  11. data/_data/navigation/main.yml +27 -8
  12. data/_data/navigation/posts.yml +22 -6
  13. data/_data/navigation/quickstart.yml +19 -6
  14. data/_data/posts_organization.yml +153 -0
  15. data/_data/prerequisites.yml +112 -0
  16. data/_data/statistics_config.yml +203 -0
  17. data/_data/ui-text.yml +321 -0
  18. data/_data/update_statistics.sh +126 -0
  19. data/_includes/README.md +2 -0
  20. data/_includes/components/js-cdn.html +4 -1
  21. data/_includes/components/post-card.html +2 -11
  22. data/_includes/components/preview-image.html +32 -0
  23. data/_includes/content/intro.html +9 -10
  24. data/_includes/core/header.html +14 -0
  25. data/_includes/navigation/sidebar-categories.html +20 -9
  26. data/_includes/navigation/sidebar-folders.html +8 -7
  27. data/_includes/navigation/sidebar-right.html +16 -10
  28. data/_layouts/blog.html +15 -45
  29. data/_layouts/category.html +4 -24
  30. data/_layouts/collection.html +2 -12
  31. data/_layouts/default.html +1 -1
  32. data/_layouts/journals.html +2 -12
  33. data/_layouts/notebook.html +296 -0
  34. data/_sass/core/_docs.scss +1 -1
  35. data/_sass/custom.scss +54 -17
  36. data/_sass/notebooks.scss +458 -0
  37. data/assets/images/notebooks/test-notebook_files/test-notebook_4_0.png +0 -0
  38. data/assets/js/sidebar.js +511 -0
  39. data/scripts/README.md +131 -105
  40. data/scripts/analyze-commits.sh +9 -311
  41. data/scripts/bin/build +22 -22
  42. data/scripts/build +7 -111
  43. data/scripts/convert-notebooks.sh +415 -0
  44. data/scripts/features/validate_preview_urls.py +500 -0
  45. data/scripts/fix-markdown-format.sh +8 -262
  46. data/scripts/generate-preview-images.sh +7 -787
  47. data/scripts/install-preview-generator.sh +8 -528
  48. data/scripts/lib/README.md +5 -5
  49. data/scripts/lib/changelog.sh +89 -57
  50. data/scripts/lib/gem.sh +19 -7
  51. data/scripts/release +7 -236
  52. data/scripts/setup.sh +9 -153
  53. data/scripts/test/lib/run_tests.sh +1 -2
  54. data/scripts/test-auto-version.sh +7 -256
  55. data/scripts/test-mermaid.sh +7 -287
  56. data/scripts/test.sh +9 -154
  57. metadata +16 -10
  58. data/scripts/features/preview_generator.py +0 -646
  59. data/scripts/lib/test/run_tests.sh +0 -140
  60. data/scripts/lib/test/test_changelog.sh +0 -87
  61. data/scripts/lib/test/test_gem.sh +0 -68
  62. data/scripts/lib/test/test_git.sh +0 -82
  63. data/scripts/lib/test/test_validation.sh +0 -72
  64. data/scripts/lib/test/test_version.sh +0 -96
  65. data/scripts/version.sh +0 -178
@@ -1,14 +1,42 @@
1
+ # About Navigation Configuration
2
+ # Used by: About section sidebar and related pages
3
+ # Purpose: Navigation for about pages, features, settings, and site info
4
+
1
5
  - title: About
2
- sublinks:
3
- - title: Home
4
- url: /about
5
- - title: License
6
- url: /about/license
7
- - title: Terms & Privacy Policy
8
- url: /terms
9
- - title: Sitemap
10
- url: /about/sitemap
11
- - title: Stats
12
- url: /stats
6
+ icon: bi-info-circle
13
7
  url: /about/
8
+ sublinks:
9
+ - title: Overview
10
+ url: /about/
11
+ - title: Features
12
+ url: /about/features/
13
+ - title: AI Development Guide
14
+ url: /about/features/ai-development-guide/
15
+
16
+ - title: Site Info
17
+ icon: bi-bar-chart
18
+ url: /about/stats/
19
+ sublinks:
20
+ - title: Statistics
21
+ url: /about/stats/
22
+ - title: Site Map
23
+ url: /sitemap/
24
+ - title: Contact
25
+ url: /contact/
26
+
27
+ - title: Settings
28
+ icon: bi-gear
29
+ url: /about/config/
30
+ sublinks:
31
+ - title: Configuration
32
+ url: /about/config/
33
+
34
+ - title: Legal
35
+ icon: bi-file-text
36
+ url: /terms-of-service/
37
+ sublinks:
38
+ - title: Terms of Service
39
+ url: /terms-of-service/
40
+ - title: Privacy Policy
41
+ url: /privacy-policy/
14
42
 
@@ -1,27 +1,57 @@
1
- - title: Setup
1
+ # Documentation Navigation Configuration
2
+ # Used by: Docs sidebar and documentation pages
3
+ # Purpose: Organize documentation by topic area
4
+
5
+ - title: Jekyll
6
+ icon: bi-journal-code
7
+ url: /docs/jekyll/
2
8
  sublinks:
3
- - title: Configuration
4
- url: /docs/configuration
5
- - title: Overriding Theme Defaults
6
- url: /docs/overriding-theme-defaults
7
- - title: Programming
9
+ - title: Jekyll Guide
10
+ url: /docs/jekyll/
11
+ - title: Mermaid Diagrams
12
+ url: /docs/jekyll/mermaid-native-markdown/
13
+ - title: Math with MathJax
14
+ url: /docs/jekyll/jekyll-math-symbols-with-mathjax/
15
+ - title: Liquid Templating
16
+ url: /docs/jekyll/jekyll-liquid/
17
+ - title: Frontmatter CMS
18
+ url: /docs/jekyll/jekyll-frontmatter-cms/
19
+ - title: Syntax Highlighting
20
+ url: /docs/jekyll/jekyll-highlighting/
21
+
22
+ - title: Features
23
+ icon: bi-stars
24
+ url: /about/features/
8
25
  sublinks:
9
- - title: Liquid
10
- url: /
11
- source: null
12
- - title: Headless CMS
26
+ - title: All Features
27
+ url: /about/features/
28
+ - title: Preview Image Generator
29
+ url: /docs/features/preview-image-generator/
30
+ - title: Statistics Dashboard
31
+ url: /about/features/statistics-dashboard/
32
+ - title: AI Development Guide
33
+ url: /about/features/ai-development-guide/
34
+
35
+ - title: Deployment
36
+ icon: bi-cloud-upload
37
+ url: /quickstart/github-setup/
13
38
  sublinks:
14
- - title: Working with Posts
15
- url: /docs/posts
16
- - title: Working with Collections
17
- url: /docs/collections
18
- - title: Helpers
19
- url: /docs/helpers
20
- - title: Utility Classes
21
- url: /docs/utility-classes
22
- - title: Design
39
+ - title: GitHub Pages
40
+ url: /quickstart/github-setup/
41
+ - title: Netlify
42
+ url: /docs/jekyll/deploying-jekyll-website-to-netlify/
43
+ - title: Custom Domain
44
+ url: /docs/jekyll/deploying-personal-website-with-custom-domain/
45
+
46
+ - title: Configuration
47
+ icon: bi-gear
48
+ url: /about/config/
23
49
  sublinks:
24
- - title: Stylesheets
25
- url: /docs/stylesheets
26
- - title: JavaScript
27
- url: /docs/javascript
50
+ - title: Site Config
51
+ url: /about/config/
52
+ - title: Jekyll Config
53
+ url: /docs/jekyll/jekyll-config/
54
+ - title: Performance
55
+ url: /docs/jekyll/jekyll-performance-optimization/
56
+ - title: Security
57
+ url: /docs/jekyll/jekyll-security/
@@ -1,15 +1,33 @@
1
+ # Home Navigation Configuration
2
+ # Used by: Header navigation and homepage quick links
3
+ # Purpose: Quick access links for the home/landing area
4
+
1
5
  - title: Home
2
6
  icon: bi-house
3
- url: /home
7
+ url: /
4
8
  sublinks:
5
- - title: Style
6
- url: /home/style/
7
- - title: Map
8
- icon: bi-map
9
+ - title: Blog
10
+ url: /blog/
11
+ - title: Quick Start
12
+ url: /quickstart/
13
+
14
+ - title: Discover
15
+ icon: bi-compass
9
16
  url: /sitemap/
10
17
  sublinks:
11
- - title: Search
12
- url: /search/
13
- - title: Roadmap
14
- url: /roadmap/
18
+ - title: Site Map
19
+ url: /sitemap/
20
+ - title: Categories
21
+ url: /categories/
22
+ - title: Tags
23
+ url: /tags/
24
+
25
+ - title: Connect
26
+ icon: bi-envelope
27
+ url: /contact/
28
+ sublinks:
29
+ - title: Contact
30
+ url: /contact/
31
+ - title: About
32
+ url: /about/
15
33
 
@@ -1,30 +1,49 @@
1
+ # Main Navigation Configuration
2
+ # Used by: _includes/navigation/navbar.html
3
+ # Purpose: Primary site navigation with dropdown sublinks
4
+
1
5
  - title: Quick Start
6
+ icon: bi-rocket-takeoff
2
7
  url: /quickstart/
3
8
  sublinks:
4
- - title: zer0
5
- url: /zer0/
6
9
  - title: Machine Setup
7
10
  url: /quickstart/machine-setup/
8
- - title: "Jekyll Setup"
11
+ - title: Jekyll Setup
9
12
  url: /quickstart/jekyll-setup/
10
- - title: "GitHub Setup"
13
+ - title: GitHub Setup
11
14
  url: /quickstart/github-setup/
15
+
12
16
  - title: Blog
17
+ icon: bi-journal-text
13
18
  url: /blog/
14
19
  sublinks:
15
20
  - title: All Posts
16
21
  url: /posts/
22
+ - title: Categories
23
+ url: /categories/
24
+ - title: Tags
25
+ url: /tags/
26
+
17
27
  - title: Docs
28
+ icon: bi-journal-bookmark
18
29
  url: /docs/
19
30
  sublinks:
20
- - title: Jekyll
31
+ - title: Jekyll Guide
21
32
  url: /docs/jekyll/
33
+ - title: Features
34
+ url: /about/features/
35
+
22
36
  - title: About
37
+ icon: bi-info-circle
23
38
  url: /about/
24
39
  sublinks:
40
+ - title: Features
41
+ url: /about/features/
42
+ - title: Statistics
43
+ url: /about/stats/
25
44
  - title: Config
26
45
  url: /about/config/
27
- - title: Theme
28
- url: /about/theme/
29
46
  - title: Site Map
30
- url: /sitemap/
47
+ url: /sitemap/
48
+ - title: Contact
49
+ url: /contact/
@@ -1,18 +1,34 @@
1
+ # Posts/Blog Category Navigation Configuration
2
+ # Used by: Blog layout, category pages, and post navigation
3
+ # Purpose: Category-based navigation for blog posts
4
+ # Note: Categories match folders in pages/_posts/
5
+
1
6
  - title: Development
2
- icon: code-slash
7
+ icon: bi-code-slash
3
8
  url: /posts/development/
9
+ description: "Software development, coding practices, and programming tutorials"
10
+
4
11
  - title: Technology
5
- icon: cpu
12
+ icon: bi-cpu
6
13
  url: /posts/technology/
14
+ description: "Tech news, tools, and emerging technologies"
15
+
7
16
  - title: Tutorial
8
- icon: journal-code
17
+ icon: bi-journal-code
9
18
  url: /posts/tutorial/
19
+ description: "Step-by-step guides and how-to articles"
20
+
10
21
  - title: World
11
- icon: globe
22
+ icon: bi-globe
12
23
  url: /posts/world/
24
+ description: "Global trends, remote work, and industry insights"
25
+
13
26
  - title: Business
14
- icon: briefcase
27
+ icon: bi-briefcase
15
28
  url: /posts/business/
29
+ description: "Business strategies, startups, and entrepreneurship"
30
+
16
31
  - title: Science
17
- icon: mortarboard
32
+ icon: bi-mortarboard
18
33
  url: /posts/science/
34
+ description: "Scientific discoveries, research, and innovation"
@@ -1,12 +1,25 @@
1
+ # Quick Start Navigation Configuration
2
+ # Used by: Quick Start sidebar and related pages
3
+ # Purpose: Step-by-step guide navigation for new users
4
+ # Order: Overview → Machine → Jekyll → GitHub → Personalization
5
+
1
6
  - title: "Quick Start"
7
+ icon: bi-flag
2
8
  url: /quickstart/
3
9
  sublinks:
4
- - title: "Machine Setup"
10
+ - title: "1. Machine Setup"
5
11
  url: /quickstart/machine-setup/
6
- description: "Platform-specific setup and Docker installation"
7
- - title: "Jekyll Setup"
12
+ icon: bi-laptop
13
+ description: "Install Docker, Git, and development tools"
14
+ - title: "2. Jekyll Setup"
8
15
  url: /quickstart/jekyll-setup/
9
- description: "Jekyll theme configuration and development environment"
10
- - title: "GitHub Setup"
16
+ icon: bi-code-square
17
+ description: "Configure Jekyll development environment"
18
+ - title: "3. GitHub Setup"
11
19
  url: /quickstart/github-setup/
12
- description: "Version control, GitHub integration, and deployment"
20
+ icon: bi-github
21
+ description: "Version control and deployment"
22
+ - title: "4. Personalization"
23
+ url: /quickstart/personalization/
24
+ icon: bi-palette
25
+ description: "Customize site identity and branding"
@@ -0,0 +1,153 @@
1
+ # Configuration for organizing posts by section
2
+ # Used by: Content organization scripts and category-based navigation
3
+ # Purpose: Define valid sections for blog posts and their directory/URL mappings
4
+
5
+ sections:
6
+ "Development":
7
+ directory: "development"
8
+ icon: "bi-code-slash"
9
+ color: "#28a745"
10
+ aliases:
11
+ - "coding"
12
+ - "programming"
13
+ - "software"
14
+
15
+ "Web Development":
16
+ directory: "web-development"
17
+ icon: "bi-globe"
18
+ color: "#17a2b8"
19
+ aliases:
20
+ - "web"
21
+ - "frontend"
22
+ - "backend"
23
+
24
+ "DevOps":
25
+ directory: "devops"
26
+ icon: "bi-gear"
27
+ color: "#fd7e14"
28
+ aliases:
29
+ - "deployment"
30
+ - "ci/cd"
31
+ - "infrastructure"
32
+
33
+ "AI & Machine Learning":
34
+ directory: "ai-ml"
35
+ icon: "bi-robot"
36
+ color: "#6f42c1"
37
+ aliases:
38
+ - "ai"
39
+ - "machine learning"
40
+ - "artificial intelligence"
41
+
42
+ "System Administration":
43
+ directory: "sysadmin"
44
+ icon: "bi-server"
45
+ color: "#20c997"
46
+ aliases:
47
+ - "sysadmin"
48
+ - "administration"
49
+ - "systems"
50
+
51
+ "Data & Analytics":
52
+ directory: "data-analytics"
53
+ icon: "bi-bar-chart"
54
+ color: "#e83e8c"
55
+ aliases:
56
+ - "data"
57
+ - "analytics"
58
+ - "analysis"
59
+
60
+ "Tools & Environment":
61
+ directory: "tools"
62
+ icon: "bi-tools"
63
+ color: "#6c757d"
64
+ aliases:
65
+ - "tools"
66
+ - "environment"
67
+ - "setup"
68
+
69
+ "Tutorials":
70
+ directory: "tutorials"
71
+ icon: "bi-book"
72
+ color: "#007bff"
73
+ aliases:
74
+ - "tutorial"
75
+ - "guide"
76
+ - "how-to"
77
+
78
+ "Documentation":
79
+ directory: "documentation"
80
+ icon: "bi-journal-text"
81
+ color: "#343a40"
82
+ aliases:
83
+ - "docs"
84
+ - "reference"
85
+ - "manual"
86
+
87
+ "News & Updates":
88
+ directory: "news"
89
+ icon: "bi-newspaper"
90
+ color: "#dc3545"
91
+ aliases:
92
+ - "news"
93
+ - "updates"
94
+ - "announcements"
95
+
96
+ "Features":
97
+ directory: "features"
98
+ icon: "bi-stars"
99
+ color: "#ffc107"
100
+ aliases:
101
+ - "feature"
102
+ - "showcase"
103
+ - "highlight"
104
+
105
+ "Jekyll":
106
+ directory: "jekyll"
107
+ icon: "bi-gem"
108
+ color: "#cc0000"
109
+ aliases:
110
+ - "jekyll-theme"
111
+ - "static-site"
112
+ - "ruby"
113
+
114
+ "Docker":
115
+ directory: "docker"
116
+ icon: "bi-box"
117
+ color: "#2496ed"
118
+ aliases:
119
+ - "container"
120
+ - "containerization"
121
+ - "docker-compose"
122
+
123
+ "Bootstrap":
124
+ directory: "bootstrap"
125
+ icon: "bi-bootstrap"
126
+ color: "#7952b3"
127
+ aliases:
128
+ - "css-framework"
129
+ - "responsive"
130
+ - "ui"
131
+
132
+ # Default section for posts without a clear section
133
+ default_section: "development"
134
+
135
+ # Fallback mapping for categories to sections
136
+ category_to_section:
137
+ "How-To": "Tutorials"
138
+ "Testing": "Development"
139
+ "Tutorial": "Tutorials"
140
+ "deployment": "DevOps"
141
+ "github": "DevOps"
142
+ "jekyll-theme": "Jekyll"
143
+ "bootstrap": "Bootstrap"
144
+ "Quick Start": "Tutorials"
145
+ "quickstart": "Tutorials"
146
+ "about": "Documentation"
147
+ "themes": "Jekyll"
148
+
149
+ # URL patterns for sections
150
+ url_patterns:
151
+ use_section_in_url: true
152
+ section_separator: "/"
153
+ date_format: "/:year/:month/:day"
@@ -0,0 +1,112 @@
1
+ # Prerequisites Data File
2
+ # Used by: Content that requires prerequisite knowledge checks
3
+ # Purpose: Define common prerequisites for tutorials, guides, and educational content
4
+
5
+ prerequisites:
6
+ - title: "Basic command-line interface knowledge"
7
+ description: "Comfortable using terminal/command prompt"
8
+ level: "foundation"
9
+ category: "systems"
10
+
11
+ - title: "Git version control basics"
12
+ description: "Understanding of git clone, add, commit, push"
13
+ level: "foundation"
14
+ category: "development"
15
+
16
+ - title: "Text editor or IDE familiarity"
17
+ description: "Comfortable editing code in preferred editor"
18
+ level: "foundation"
19
+ category: "tools"
20
+
21
+ - title: "Basic programming concepts"
22
+ description: "Variables, functions, loops, conditionals"
23
+ level: "foundation"
24
+ category: "programming"
25
+
26
+ - title: "Web development basics"
27
+ description: "Understanding of HTML, CSS, and HTTP"
28
+ level: "web-foundation"
29
+ category: "web"
30
+
31
+ - title: "JavaScript fundamentals"
32
+ description: "ES6+ syntax, async/await, DOM manipulation"
33
+ level: "frontend"
34
+ category: "web"
35
+
36
+ - title: "Ruby basics"
37
+ description: "Basic Ruby syntax, gems, and Bundler"
38
+ level: "backend"
39
+ category: "programming"
40
+
41
+ - title: "Jekyll fundamentals"
42
+ description: "Understanding Jekyll structure, Liquid templating"
43
+ level: "framework"
44
+ category: "web"
45
+
46
+ - title: "Docker containerization"
47
+ description: "Container concepts, Dockerfile, docker-compose"
48
+ level: "devops"
49
+ category: "infrastructure"
50
+
51
+ - title: "Linux/Unix command line"
52
+ description: "File navigation, permissions, process management"
53
+ level: "systems"
54
+ category: "infrastructure"
55
+
56
+ - title: "HTTP/REST API concepts"
57
+ description: "Request/response, status codes, JSON"
58
+ level: "api"
59
+ category: "web"
60
+
61
+ - title: "YAML syntax"
62
+ description: "Understanding YAML structure for configuration files"
63
+ level: "foundation"
64
+ category: "tools"
65
+
66
+ - title: "Markdown formatting"
67
+ description: "Writing content with Markdown syntax"
68
+ level: "foundation"
69
+ category: "content"
70
+
71
+ - title: "Bootstrap 5 basics"
72
+ description: "Understanding Bootstrap grid, components, utilities"
73
+ level: "frontend"
74
+ category: "web"
75
+
76
+ - title: "Sass/SCSS fundamentals"
77
+ description: "CSS preprocessing with variables, mixins, nesting"
78
+ level: "frontend"
79
+ category: "web"
80
+
81
+ - title: "GitHub Pages understanding"
82
+ description: "Static site hosting, custom domains, deployment"
83
+ level: "deployment"
84
+ category: "infrastructure"
85
+
86
+ - title: "Testing methodologies"
87
+ description: "Unit tests, integration tests, TDD concepts"
88
+ level: "quality"
89
+ category: "development"
90
+
91
+ # Prerequisite levels (ordered by complexity)
92
+ levels:
93
+ - foundation
94
+ - web-foundation
95
+ - frontend
96
+ - backend
97
+ - framework
98
+ - devops
99
+ - systems
100
+ - api
101
+ - deployment
102
+ - quality
103
+
104
+ # Prerequisite categories
105
+ categories:
106
+ - systems
107
+ - development
108
+ - tools
109
+ - programming
110
+ - web
111
+ - infrastructure
112
+ - content