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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +30 -0
- data/README.md +1 -1
- data/_data/backlog.yml +26 -1
- data/_data/features.yml +38 -45
- data/_data/feedback_types.yml +148 -0
- data/_data/navigation/README.md +1 -1
- data/_includes/components/README.md +1 -0
- data/_includes/components/page-feedback.html +252 -0
- data/_includes/content/intro.html +20 -62
- data/_includes/core/console-capture.html +89 -0
- data/_includes/core/head.html +4 -0
- data/_layouts/root.html +3 -0
- data/_sass/components/_page-feedback.scss +276 -0
- data/_sass/core/_docs-layout.scss +2 -78
- data/_sass/tokens/_layers.scss +4 -0
- data/assets/css/main.scss +1 -0
- data/assets/js/page-feedback.js +660 -0
- metadata +7 -3
- data/_data/prompts.yml +0 -302
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.
|
|
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-
|
|
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
|