From 8abed5ffb6e25c3ff229b65260525e4d003ffb20 Mon Sep 17 00:00:00 2001 From: Jameson Nyeholt Date: Mon, 8 Dec 2025 06:58:20 -0800 Subject: [PATCH] add copilot instructions --- .DS_Store | Bin 6148 -> 6148 bytes .github/copilot-instructions.md | 65 ++++++++++++++++++++++++++++++++ 2 files changed, 65 insertions(+) create mode 100644 .github/copilot-instructions.md diff --git a/.DS_Store b/.DS_Store index f427e6eecea9ec6e16977adeba3ad413786994c1..a6aeb425daf877883ef6bdecd46a5f3bb6bfb730 100644 GIT binary patch delta 31 ncmZoMXfc@J&nUbxU^g?P@MIpAqnm%T@Gwto(Avz-@s}R}q^JsE delta 56 zcmZoMXfc@J&nU7nU^g?P$YdUtqtdJl@eIWbnG7Wish&Cc$w@i+Nem1O0t^gH>6;I+ MNHcF{=lIJH0I~88(EtDd diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md new file mode 100644 index 000000000..f628be2b1 --- /dev/null +++ b/.github/copilot-instructions.md @@ -0,0 +1,65 @@ +# Copilot Instructions — Blog + +Personal weblog built with Jekyll 4 and the Minima theme, deployed via Netlify. + +## Stack + +- **Framework:** Jekyll ~4.0 (Ruby) +- **Theme:** Minima ~2.0 +- **Markdown:** kramdown with GFM input +- **Styles:** SASS (compressed), source in `_sass/` +- **Deploy:** Netlify (`netlify.toml`) + +## Commands + +| Task | Command | +|------|---------| +| Install deps | `bundle install` | +| Serve locally | `bundle exec jekyll serve` | +| Build | `bundle exec jekyll build` | + +## Project Structure + +``` +_config.yml # Site config, plugin list, permalink pattern +_layouts/ # Page layouts +_includes/ # Reusable partials +_sass/ # SASS stylesheets +_data/ # Data files +assets/ # Static assets (images, fonts) +collections/ # Content collections (software_development, miscellaneous, cascadia) +css/ # Compiled CSS output +js/ # JavaScript +``` + +## Content Conventions + +### Posts & Collections + +- Posts live in `collections/` under their collection name (e.g., `collections/_software_development/`) +- Collections defined in `_config.yml`: `software_development`, `miscellaneous`, `cascadia` +- Permalink pattern: `/weblog/:categories/:year/:month/:day/:title.html` +- Use `` as the excerpt separator + +### Front Matter + +Every post/page requires Jekyll front matter. Match existing patterns — typically `layout`, `title`, `date`, `tags`, and `categories`. + +### Archives + +Jekyll Archives plugin generates year, month, day, category, and tag archive pages automatically. Layouts: `year-archive`, `month-archive`, `day-archive`, `category-archive`, `tag-archive`. + +## Plugins + +- `jekyll-feed` — Atom feed generation +- `jekyll-archives` — Date/category/tag archives +- `jekyll_picture_tag` — Responsive images +- `jekyll-autoprefixer` — CSS vendor prefixes +- `jekyll-timeago` — Relative time formatting + +## Style Guidelines + +- Match existing SASS patterns in `_sass/` +- Do not add new CSS frameworks — the site uses Minima + custom SASS +- Preserve the existing permalink structure +- Keep page templates consistent with existing layouts