jekyll-theme-zer0 1.25.0 → 1.26.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.
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: 1.25.0
4
+ version: 1.26.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amr Abdel
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2026-07-04 00:00:00.000000000 Z
11
+ date: 2026-07-07 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: jekyll
@@ -83,6 +83,7 @@ files:
83
83
  - _data/backlog.yml
84
84
  - _data/content_statistics.yml
85
85
  - _data/features.yml
86
+ - _data/feedback_types.yml
86
87
  - _data/generate_statistics.rb
87
88
  - _data/generate_statistics.sh
88
89
  - _data/github-actions-example.yml
@@ -98,7 +99,6 @@ files:
98
99
  - _data/navigation/quickstart.yml
99
100
  - _data/posts_organization.yml
100
101
  - _data/prerequisites.yml
101
- - _data/prompts.yml
102
102
  - _data/roadmap.yml
103
103
  - _data/roadmap_plan.yml
104
104
  - _data/routing.yml
@@ -144,6 +144,7 @@ files:
144
144
  - _includes/components/nav-editor.html
145
145
  - _includes/components/nav-export.html
146
146
  - _includes/components/nav-overview.html
147
+ - _includes/components/page-feedback.html
147
148
  - _includes/components/post-card.html
148
149
  - _includes/components/post-type-badge.html
149
150
  - _includes/components/powered-by.html
@@ -174,6 +175,7 @@ files:
174
175
  - _includes/content/transclude.html
175
176
  - _includes/core/branding.html
176
177
  - _includes/core/color-mode-init.html
178
+ - _includes/core/console-capture.html
177
179
  - _includes/core/footer-fabs.html
178
180
  - _includes/core/footer.html
179
181
  - _includes/core/head.html
@@ -245,6 +247,7 @@ files:
245
247
  - _sass/components/_footer.scss
246
248
  - _sass/components/_notes-index.scss
247
249
  - _sass/components/_notes.scss
250
+ - _sass/components/_page-feedback.scss
248
251
  - _sass/components/_post-navigation.scss
249
252
  - _sass/components/_search-modal.scss
250
253
  - _sass/components/_skeleton.scss
@@ -325,6 +328,7 @@ files:
325
328
  - assets/js/obsidian-graph.js
326
329
  - assets/js/obsidian-local-graph.js
327
330
  - assets/js/obsidian-wiki-links.js
331
+ - assets/js/page-feedback.js
328
332
  - assets/js/palette-generator.js
329
333
  - assets/js/particles-source.js
330
334
  - assets/js/particles.js
data/_data/prompts.yml DELETED
@@ -1,302 +0,0 @@
1
- # _data/prompts.yml
2
- #
3
- # Prompt templates for the Copilot Agent issue button rendered by
4
- # `_includes/content/intro.html`. Each entry becomes a dropdown item that
5
- # opens a pre-filled GitHub issue assigned to @copilot.
6
- #
7
- # These templates are tuned for a Jekyll/CMS theme (zer0-mistakes) and focus
8
- # on FRONTEND and CONTENT (CMS) improvements. Two scopes are supported via
9
- # the `group` field:
10
- #
11
- # - "Page Improvements" – act on the page the button was clicked from.
12
- # The Page Context table injected by intro.html (title, URL, file path,
13
- # layout, collection, tags, etc.) is what every prompt should reference.
14
- #
15
- # - "Site Improvements" – act on theme-wide UI/UX, components, layouts,
16
- # navigation, performance, or new features. The page is included as the
17
- # example/entry point, not necessarily the only target.
18
- #
19
- # Schema:
20
- # - id: unique slug
21
- # label: short text shown in the dropdown
22
- # icon: Bootstrap Icons class (https://icons.getbootstrap.com/)
23
- # group: optional section header in the dropdown
24
- # description: optional one-line subtitle under the label
25
- # body: prompt instructions appended above the auto-generated
26
- # Page Context + Environment tables in the issue body.
27
-
28
- # ─────────────────────────────────────────────────────────────────────────────
29
- # Page Improvements — scoped to the current page
30
- # ─────────────────────────────────────────────────────────────────────────────
31
-
32
- - id: improve-page
33
- label: "Improve Page"
34
- icon: "bi-stars"
35
- group: "Page Improvements"
36
- description: "Polish content, structure, and presentation of this page"
37
- body: |
38
- Act as a Senior Content Editor and Frontend Designer for the
39
- zer0-mistakes Jekyll theme.
40
-
41
- Improve the page referenced in the **Page Context** table below. Make it
42
- clearer, more engaging, and visually consistent with the rest of the
43
- site — without changing its core message or breaking existing links.
44
-
45
- **Scope (this page only):**
46
- - Tighten copy: remove fluff, fix grammar, improve readability
47
- - Strengthen the opening hook and the closing call-to-action
48
- - Verify heading hierarchy (single H1, logical H2/H3 nesting)
49
- - Confirm front matter is complete: `title`, `description`, `date`,
50
- `lastmod`, `layout`, `categories`, `tags`, `permalink`, `preview`
51
- - Improve visual rhythm: paragraph length, lists, callouts, code blocks
52
- - Validate internal links and image paths (use `relative_url`)
53
- - Ensure Bootstrap 5 utility classes are used over custom CSS
54
-
55
- **Deliverables:**
56
- - A diff-style proposal of the edited Markdown (front matter + body)
57
- - A short "Why these changes" rationale (3–5 bullets)
58
- - A checklist of any follow-up items that are out of scope
59
-
60
- - id: expand-page
61
- label: "Expand Page"
62
- icon: "bi-arrows-angle-expand"
63
- group: "Page Improvements"
64
- description: "Add depth, examples, and missing sections to this page"
65
- body: |
66
- Act as a Subject Matter Expert and Technical Writer.
67
-
68
- Expand the page referenced in the **Page Context** table below by adding
69
- depth, real examples, and any sections that a reader would reasonably
70
- expect but are currently missing.
71
-
72
- **Expansion targets:**
73
- - Add concrete, copy-pasteable examples (code, configs, screenshots)
74
- - Add a "Prerequisites" and "Next steps" / "Related" section
75
- - Add a short FAQ or troubleshooting block when relevant
76
- - Cross-link to related posts, docs, or theme components in this repo
77
- - Add or update Mermaid diagrams where they clarify flow/architecture
78
- - Keep the existing tone, structure, and front matter intact
79
-
80
- **Deliverables:**
81
- - The new/expanded Markdown sections, ready to merge into the page
82
- - A list of any new assets needed (images, diagrams, data files)
83
- - Suggested updates to `tags`, `categories`, and `description`
84
-
85
- - id: update-page
86
- label: "Update Page"
87
- icon: "bi-arrow-clockwise"
88
- group: "Page Improvements"
89
- description: "Refresh outdated content, versions, links, and screenshots"
90
- body: |
91
- Act as a Documentation Maintainer responsible for keeping the
92
- zer0-mistakes site accurate and current.
93
-
94
- Audit and update the page referenced in the **Page Context** table below.
95
- Treat any version numbers, dates, screenshots, or external references as
96
- suspect and verify them against the current state of the repository and
97
- the wider ecosystem.
98
-
99
- **Update checklist:**
100
- - Bump version numbers, release names, and dependency references
101
- - Replace deprecated Jekyll/Bootstrap patterns with current equivalents
102
- - Refresh screenshots, GIFs, and embedded examples
103
- - Re-validate every external link; replace dead or moved URLs
104
- - Update `lastmod` in the front matter and add a brief "Updated" note
105
- - Reconcile content with related files in this repo (configs, layouts,
106
- includes) so instructions match what the codebase actually does
107
-
108
- **Deliverables:**
109
- - Updated Markdown for the page (front matter + body)
110
- - A short changelog summarising what was refreshed and why
111
- - Any follow-up issues to file for changes outside this page
112
-
113
- - id: fix-page
114
- label: "Fix Page Issue"
115
- icon: "bi-bug"
116
- group: "Page Improvements"
117
- description: "Report a typo, broken link, layout glitch, or content bug"
118
- body: |
119
- Act as a Frontend QA Engineer for the zer0-mistakes Jekyll theme.
120
-
121
- Investigate and fix the issue described below on the page referenced in
122
- the **Page Context** table. Reproduce it locally with `docker-compose up`
123
- before proposing a change.
124
-
125
- **Please describe (fill in before submitting):**
126
- - **What is wrong?** <!-- typo, broken link, image, layout, behaviour -->
127
- - **Where on the page?** <!-- section heading, line, screenshot region -->
128
- - **Expected:** <!-- what should appear / happen -->
129
- - **Actual:** <!-- what currently appears / happens -->
130
- - **Browser / device (if visual):** <!-- e.g. Chrome 124 desktop, iOS Safari -->
131
-
132
- **Deliverables:**
133
- - Root-cause analysis (content vs. layout vs. include vs. config)
134
- - Minimal, surgical fix (Markdown, Liquid, SCSS, or front matter)
135
- - Verification steps and a passing `bundle exec jekyll build`
136
-
137
- - id: seo-optimize
138
- label: "SEO Optimize"
139
- icon: "bi-graph-up-arrow"
140
- group: "Page Improvements"
141
- description: "Improve discoverability, metadata, and structured data"
142
- body: |
143
- Act as a Technical SEO Specialist.
144
-
145
- Optimise the page referenced in the **Page Context** table below for
146
- search engines and social sharing, without sacrificing readability.
147
-
148
- **Audit and improve:**
149
- - Front matter `title` (≤ 60 chars) and `description` (150–160 chars)
150
- - Primary keyword in H1, first paragraph, and at least one H2
151
- - `permalink` is short, lowercase, and hyphen-separated
152
- - `tags` and `categories` align with site taxonomy
153
- - `preview` image exists, has descriptive alt text, and good aspect ratio
154
- - Open Graph + Twitter Card metadata via existing includes
155
- - JSON-LD structured data (Article / BlogPosting) where applicable
156
- - Internal links to high-value related pages, with descriptive anchors
157
-
158
- **Deliverables:**
159
- - Updated front matter
160
- - Specific in-body edits (H1/H2/intro)
161
- - A keyword/intent map (primary + 3–5 secondary)
162
- - Any sitemap, robots, or `_config.yml` changes required
163
-
164
- - id: accessibility-audit
165
- label: "Accessibility Audit"
166
- icon: "bi-universal-access"
167
- group: "Page Improvements"
168
- description: "Audit this page for WCAG 2.1 AA compliance"
169
- body: |
170
- Act as an Accessibility (a11y) Engineer.
171
-
172
- Audit the page referenced in the **Page Context** table below against
173
- WCAG 2.1 AA and propose concrete fixes in Markdown, Liquid, or SCSS.
174
-
175
- **Audit areas:**
176
- - Semantic HTML and heading order
177
- - Alt text on every meaningful image; empty alt on decorative ones
178
- - Sufficient colour contrast (≥ 4.5:1 body, ≥ 3:1 large text/UI)
179
- - Keyboard navigability and visible focus states
180
- - ARIA attributes on Bootstrap components (modals, dropdowns, tabs)
181
- - Form labels, error messages, and `aria-describedby` associations
182
- - Skip links and landmark regions (`<main>`, `<nav>`, `<aside>`)
183
- - Reduced-motion and prefers-color-scheme respect
184
-
185
- **Deliverables:**
186
- - Findings table: issue, WCAG criterion, severity, fix
187
- - Patches for the page and any shared includes that need updating
188
- - A re-test plan (axe-core, Lighthouse, manual keyboard pass)
189
-
190
- # ─────────────────────────────────────────────────────────────────────────────
191
- # Site Improvements — theme-wide UI/UX, components, and features
192
- # ─────────────────────────────────────────────────────────────────────────────
193
-
194
- - id: ui-ux-improvement
195
- label: "UI/UX Improvement"
196
- icon: "bi-palette"
197
- group: "Site Improvements"
198
- description: "Propose a design or UX refinement for the theme"
199
- body: |
200
- Act as a Senior UI/UX Designer working in Bootstrap 5 and Jekyll.
201
-
202
- Propose a UI/UX improvement for the zer0-mistakes theme. Use the page
203
- referenced in the **Page Context** table below as the starting example;
204
- where the change applies site-wide, call that out explicitly.
205
-
206
- **Cover in your proposal:**
207
- - **Problem / opportunity** — what user pain or quality gap exists?
208
- - **Affected surfaces** — layouts, includes, components, or data files
209
- - **Design direction** — spacing, typography, colour, motion, hierarchy
210
- - **Bootstrap-first approach** — utilities and components over custom CSS
211
- - **Responsive behaviour** — xs / sm / md / lg / xl / xxl breakpoints
212
- - **Accessibility** — contrast, focus, ARIA, reduced-motion
213
- - **Dark mode / colour scheme** considerations
214
- - **Before/after sketch or description** of the change
215
-
216
- **Deliverables:**
217
- - A concrete change list mapped to files in `_layouts/`, `_includes/`,
218
- `_sass/`, and `assets/`
219
- - SCSS / Liquid / HTML snippets ready to drop in
220
- - A short test plan covering desktop + mobile + keyboard
221
-
222
- - id: new-feature
223
- label: "New Feature"
224
- icon: "bi-lightbulb"
225
- group: "Site Improvements"
226
- description: "Propose a new site-wide feature or capability"
227
- body: |
228
- Act as a Product Manager + Frontend Engineer for the zer0-mistakes
229
- Jekyll theme.
230
-
231
- Propose a new feature for the site or theme. Use the page referenced in
232
- the **Page Context** table below as the inspiration / first consumer of
233
- the feature where it makes sense.
234
-
235
- **Please describe:**
236
- - **User story** — As a [reader / author / theme adopter], I want…
237
- - **Problem solved** and the success metric
238
- - **Scope** — pages, layouts, includes, data files, configs touched
239
- - **Configuration** — what goes into `_config.yml` / `_data/*.yml`?
240
- - **Dependencies** — any new gems, JS libs, or vendor assets?
241
- - **Privacy / analytics** — does it need consent gating?
242
- - **Rollout plan** — feature flag, opt-in via front matter, default-on?
243
- - **Out of scope** items
244
-
245
- **Deliverables:**
246
- - A minimal, working implementation plan (file-by-file)
247
- - Sample Liquid / HTML / SCSS / JS scaffolding
248
- - Documentation stub for `docs/` or `pages/_docs/`
249
- - CHANGELOG entry following Keep a Changelog format
250
-
251
- - id: component-enhancement
252
- label: "Component Enhancement"
253
- icon: "bi-puzzle"
254
- group: "Site Improvements"
255
- description: "Improve a Jekyll layout, include, or shared component"
256
- body: |
257
- Act as a Senior Jekyll Theme Developer.
258
-
259
- Enhance a shared component used by the page referenced in the
260
- **Page Context** table below — a layout in `_layouts/`, an include in
261
- `_includes/`, or a partial in `_sass/`. Improvements should benefit every
262
- page that uses the component, not just this one.
263
-
264
- **Targets to consider:**
265
- - Cleaner Liquid: safe `default:` filters, fewer nested `if`s
266
- - Parameterise hard-coded values via `include.*` arguments
267
- - Consistent BEM-style class names and Bootstrap utility usage
268
- - Add the standard component header comment block
269
- - Improve mobile responsiveness and accessibility
270
- - Document parameters and usage in the file header
271
-
272
- **Deliverables:**
273
- - The enhanced file(s), preserving backward compatibility
274
- - A migration note if any include parameters changed
275
- - Before/after rendering notes for at least one page that uses it
276
- - A test plan: `docker-compose exec jekyll bundle exec jekyll build`
277
-
278
- - id: performance-optimization
279
- label: "Performance Optimization"
280
- icon: "bi-speedometer2"
281
- group: "Site Improvements"
282
- description: "Improve load time, Core Web Vitals, and asset delivery"
283
- body: |
284
- Act as a Web Performance Engineer.
285
-
286
- Profile and optimise the site, using the page referenced in the
287
- **Page Context** table below as a representative measurement target.
288
-
289
- **Investigate:**
290
- - Core Web Vitals: LCP (Largest Contentful Paint), CLS (Cumulative
291
- Layout Shift), and INP (Interaction to Next Paint) for this page
292
- - Render-blocking CSS/JS in `_includes/core/head.html` and `js-cdn.html`
293
- - Vendored Bootstrap and Bootstrap Icons under `assets/vendor/`
294
- - Image strategy: dimensions, `loading="lazy"`, modern formats
295
- - Liquid hot spots: nested loops, repeated `where` filters
296
- - Build output size in `_site/` and unused CSS
297
-
298
- **Deliverables:**
299
- - Lighthouse / WebPageTest results before and after
300
- - Specific patches to layouts, includes, SCSS, and config
301
- - Any new build steps or scripts (must be opt-in, GitHub Pages-safe)
302
- - A short report on tradeoffs and follow-ups