Repository navigation
Releases
Releases · amirhs1/eyvan
v2.1.1
Added
- The template identity check,
scripts/check-template-placeholders.rb, warns
whileindex.html,projects.html,about.html,contact.html, or
search.htmlstill carries the template's own title, SEO title, or
description, which would otherwise put "Eyvan" in your site's<title>,
og:title, and meta description (#188). Like its other warnings, it never
fails the deploy.
Fixed
- The Contact page's "Email me" button now has an accessible name that starts
with its visible text, "Email me, Your Name", so speech-input users can
activate it by what they see (#186). The site-level axe tests now also scan
the About, Contact, Projects, tag archive, and 404 pages. - The Google Scholar icon no longer repeats one
idon every page it appears
on (#186). - The share block is now a group named "Share this post", and two
divs on
the About page no longer carry names their role cannot have (#186). - The theme toggle reports its state once: its name stays "Dark theme" and
aria-pressedistruewhile the dark theme applies, instead of a label
that also changed with the theme (#186). - Printing or saving as PDF with the dark theme on now uses the light-theme
colours, instead of near-white text on white paper (#191). - The navigation marks the current page with
aria-currentwhether a URL in
_data/navigation.ymlends with a slash or not (#189). It no longer calls a
filter Liquid does not have, which also stopped builds that set
strict_filters. - With no
imagein_data/hero.yml, the hero shows the shipped
hero-placeholder.webp, instead of requesting a.jpgthat does not exist
(#189). - The author avatar in post metadata reserves its space with
widthand
height, and has an emptyaltwhile the author's name is shown beside it
(#189). - The About portrait reserves its space too:
about.htmlreads
image_widthandimage_heightfrom its front matter, set to the shipped
avatar's 300 × 300 (#193). Update both if you replace the portrait. - Post titles, descriptions, and tag names render as the same text on cards,
in post navigation, and in tag links as on the post page, even when they
contain&,<, or"(#183)._includes/section-heading.htmlnow escapes
itstitle,eyebrow, anddescriptiontoo (#189); pass HTML through
description_htmlinstead. - A local build no longer copies
AGENTS.local.mdorCLAUDE.local.mdinto
_site, andscripts/check-built-output.rbfails a build that contains
either (#183). - The
font-smoothingSass mixin compiles: it read its settings from the
wrong module, so the first@includebroke the build (#184).
_sass/3-base/_base.scssnow uses it, with the same compiled CSS. - The README's "Configuration" list and Setting Up Eyvan now cover
_data/about.yml, which holds the About page's text (#188). - The Iceland field-notes demo post no longer loads MathJax, since it has no
math (#188).
Changed
- CI and the deploy workflow's search-index step run on Node.js 24, read from
the new.nvmrc, instead of Node.js 20, which reached end of life on
2026-04-30 (#185). Each SHA-pinned Action's comment now names its exact
release. - The theme toggle is icon-only everywhere:
_includes/theme-toggle.htmlno
longer takeshide_label, and the visible.c-theme-toggle__labelis gone
(#192). The parameter never took effect, so sites see no change; drop
hide_label=…from any of your own calls to the include.
Security
- The X, LinkedIn, and Pinterest share popups open with
noopener, so the
opened page no longer gets awindow.openerreference to your post (#183).
Assisted-by: Claude Code, claude-opus-5-5 (transcription)
Checks-run: diff of notes against CHANGELOG.md 2.1.1 section — identical
v2.1.0
Added
- A
read_time_overridefront matter field that replaces the estimated minutes
in a post's "N min read" text with a whole number you set (#148). It changes
only the number:read_time: falsestill hides reading time. If your fork
has its own copy of_includes/entry-meta.html, copy the new
override_minuteslines into it. - Optional full-text search of posts with Pagefind,
off by default (#153). Setsearch: truein_config.ymlto add a
/search/page, a search link at the right end of the desktop header, and
a search field at the top of the mobile menu. Pagefind 1.5.2 is a new
development dependency. When the build contains/search/, the deploy
workflow sets up Node.js and builds the index; see "Search" inREADME.md
to preview it locally. scripts/check-built-output.rbfails a build that ships any search page,
script, index, or markup whilesearchis off, and takes the config path
as an optional second argument (#153).- When
google_analyticsis set, a banner asks visitors whether to allow
Google Analytics, and an "Analytics preferences" button in the footer lets
them change their choice later (#152). The banner's text is in
_data/analytics.yml. - A weekly workflow,
.github/workflows/link-check.yml, that builds your site
and reports dead links to other sites, such as citations and references in
posts, in its job summary (#146). A broken link turns that run red; it never
blocks a merge or a deploy. It useslycheeverse/lychee-action2.9.0, and
its settings are in.lychee.toml. GitHub disables scheduled workflows in
forks by default: to turn the check on, open the Actions tab, choose
Check External Links, and choose Enable workflow. See "External Link
Check" inREADME.mdto run it on demand or turn it off.
Fixed
- In a crowded desktop header, such as one with five navigation links or a
search link, the navigation no longer shrinks under the theme toggle; the
brand text shortens with an ellipsis instead (#153). - Pages that use
layout: pageand have a date or author no longer show
"N min read" (#151). The layout passesshow_read_time=falseto
_includes/entry-meta.html, which turned it back intotrue; any layout of
yours that passes it now hides the read time too. If your fork has its own
copy of_includes/entry-meta.html, copy the newshow_read_timelines into
it. - The "Setting Up Eyvan" post and the first comment in
_data/footer.ymlno
longer say the footer takes links, such as a privacy policy; the file holds
only the footer's tagline and copyright text (#154).
Changed
- For sites that set
google_analytics: the Google tag now loads only
after the visitor accepts, so nothing is requested from Google before then,
and visitors who decline or never choose are not counted (#152). Declining
deletes the_gaand_ga_*cookies. If your site already asks for consent
another way, setgoogle_analytics_consent: falsein_config.ymlto load
the tag on every page as before. - The desktop theme toggle moved from before Home to the right end of the
header, after the social links and, whensearchis on, after the search
link (#158). Tab now reaches it last in the header. If your fork has its own
copy of_includes/header.html, move itso-site-header__themeblock to the
end ofo-site-header__actionsto match.
Security
joi18.2.9 → 18.3.1, a development dependency reached throughwait-on,
which clears the high-severity advisory GHSA-4528-x5fx-h6hg reported against
18.0.0 to 18.3.0 (#157).
Assisted-by: Claude Code, claude-opus-5-5 (transcription)
Checks-run: diff of notes against CHANGELOG.md 2.1.0 section — identical
v2.0.0
Breaking changes
Each item below can break a site built on Eyvan. Follow its migration step
when you merge this release into your fork.
- The
.animatemotion class is now.u-animate(#26). If your content,
overrides, or CSS useanimate, rename it tou-animate. - Breaking for forks that customize the post layout: the post page's
content grid moved from_sass/5-components/_post.scssto a new
_sass/6-layouts/_post.scss, and its classes were renamed from
c-post-layout*tol-post*(l-post,l-post__col,
l-post__col--left,l-post__col--main,l-post__col--right,
l-post__prose,l-post__aside) (#125). If your site overrides
_layouts/post.htmlor_includes/post-toc-desktop.html, or adds CSS
for.c-post-layout*, rename those classes. Rendering is unchanged. - The Sass variables
$anim-speedand$anim-easingare removed, so Sass
that uses them no longer compiles (#129). Use$transition-basefrom
_sass/0-settings/_config.scssinstead. - The Sass variables
$static-stack-xxs,$static-stack-xs, and
$static-stack-smare removed (#129). Use the equal$space-stack-xxs,
$space-stack-xs, and$space-stack-smfrom
_sass/0-settings/_spacing.scssinstead. - The
.c-theme-toggle--mobile,.c-nav--mobile, and
.c-social-links--mobilemodifiers now carry the mobile menu's look
wherever they are used, and the Contents toolbar's compact share styles
now need the newc-post-share--collapsedclass (#127). If you style
these modifiers outside the menu, check them; if your fork has its own
copy of_includes/post-share.html, addc-post-share--collapsedto its
root whencollapseis set, as the template's copy now does. - The About portrait caption and the contact page's "Also reachable on"
label now take their type from component classes, and
.l-about__portrait-captionis removed (#123). If you have customized
about.htmlorcontact.html, give the portraitfigcaptionthe class
c-prose-captionand the labelc-labelalongside
l-contact__social-label. - CI now runs
bundle exec bundle-audit check --updateas a blocking step
(#137). A known advisory against yourGemfile.lockfails the build until
you update the gem or record a waiver in.bundler-audit.yml. @axe-core/playwright4.14.0 turns on thelabel-content-name-mismatch
rule (#69). A link whosearia-labeldoes not contain its visible text
now failsnpm run test:a11y; remove the label or make it include the
visible text.- New CI checks can fail on a fork's own changes:
- The component gallery scan checks its page list against
/tests/
(#97). If you delete gallery fixture pages, updategalleryPagesin
tests/component-gallery.spec.js. npm run test:sitecounts characters per line in running text (#116).
With a different body font, the failure message names the
$text-measure-widevalue that averages about 66 characters.scripts/check-color-contract.rbfails when a post or a root Markdown
file names a--color-*property that the base layer does not emit
(#28). Rename or remove the property in that file.scripts/check-color-contract.rbchecks the post-navigation text at the
far edge of its gradient (#131). A palette change that lowers that
contrast below WCAG 2.1 AA now fails CI.
- The component gallery scan checks its page list against
Added
- A
mq-downSass mixin that ends just below a breakpoint, besidemq-up
(#114). - A
.c-labelcomponent for small uppercase labels (#123). - Sass tokens for control sizes, icon sizes, and the hover and press offsets
($control-size-sm/md/lg,$icon-size,$icon-size-lg,
$control-lift-hover,$control-press-offset,$control-press-scale)
(#133). - An axe scan of every component gallery page in CI, in light and dark, at
1280 × 720 and 390 × 844, run withnpm run test:gallery(#97, #111). - A "Component Gallery" section in the README, and documentation of
.is-shrunkas an opt-in hook for your own shrink-on-scroll (#27). - A "Using the palette in your own components" section in the Theming
Eyvan post (#28).
Fixed
- The "Add a new component" example in the architecture post now uses tokens
that exist, so copying it gives a styled component (#28). - Cross-reference numbers count only captioned figures, video, and audio,
so they match the visible labels; a reference to an uncaptioned figure now
shows its id (#103). - The mobile menu and the mobile Contents panel close, and release the page,
when the window widens past the layout breakpoint (#104). - Tag links use jekyll-tagging's
tag_urlfilter, so tags such asC++or
Caféno longer link to a missing page (#105). - Share links encode titles that contain
#,&, or+(#106). - The template identity check in the deploy workflow no longer fails on a
date in_config.ymlor_data/(#107). - Prose tables that overflow their column can be reached and scrolled with
the keyboard (#110). - Task-list items no longer turn inline code into small scroll boxes on
narrow screens (#112). - Native controls, such as task-list checkboxes, follow the chosen theme
instead of the operating system's (#113). - At exactly 480, 768, and 1024px, pages no longer show the mobile and
desktop layouts at once (#114). - The Contents rail stays readable just above the layout breakpoint (#116).
- On the About page below 1024px, the portrait caption no longer runs past
the photo (#123). - CI no longer passes
ruby/setup-rubytheruby-version-fileinput, which
it does not accept, so the Setup Ruby step stops logging an "Unexpected
input" warning; Ruby is still read from.ruby-version(#142).
Changed
- The post and About reading measure is now about 66 characters per line
($text-measure-widefrom75chto50ch) (#116). - The brand link is named by its visible name and role; the
aria-label="Go to homepage"is removed (#94). - Transitions use one easing curve,
cubic-bezier(0.4, 0, 0.2, 1), with
their durations unchanged, and.u-animateuses it too (#129, #133). - In the dark theme, the Contents and share rails are one step lighter than
the page (--color-surface-container-low) (#131). - A bare
hroutside post prose has 2rem of space below it, as above it;
posts are unchanged (#121). - Links use the shared focus-ring mixin, so re-theming
--color-focus-ring-colornow reaches links too; no visual change (#25). - CI runs on
ubuntu-24.04(#49), waits for the server through
npm run test:wait(#64), and skips its Playwright steps on pull requests
intodevelopthat change only documentation (#136). - Build dependencies:
sass-embedded1.101.0 → 1.106.1 (#38, #67) and
jekyll-feed0.17.0 → 0.18.0 (#41). - CI actions:
ruby/setup-ruby1.313.0 → 1.335.0 (#39, #68, #135),
actions/checkout6.0.3 → 7.0.1 (#40),actions/setup-node6.4.0 →
7.1.0 (#43, #57),actions/deploy-pages5.0.0 → 5.0.1 (#45), and
actions/upload-artifact7.0.1 → 7.0.2 (#56). - Test tools:
@playwright/test1.60.0 → 1.64.1 (#42, #58, #66),
@axe-core/playwright4.11.3 → 4.14.0 (#46, #69),wait-on9.0.10 →
9.5.1 (#44),axios1.17.0 → 1.20.0 (#47), andjoi18.2.1 → 18.2.9
(#48). - Contributor and agent tooling: agent rules and skills,
AI-POLICY.md, a
commit-message hook, pull request and issue templates, and Dependabot
pull requests aimed atdevelop(#30, #32, #34, #36, #55, #59, #61, #81,
#87, #88, #89, #92, #99, #100). THIRD_PARTY_NOTICES.mdrecords the source and terms of four shipped
images: the portrait and hero placeholder (Pexels License), the default
Open Graph image (MIT), and the quantum entanglement post cover
(CC BY-SA 4.0) (#141).
Security
addressable2.9.0 → 2.9.2, which clears seven advisories reported
against 2.9.0 (#137).follow-redirects1.16.1 → 1.16.2, a development dependency, which clears
the high-severity advisory GHSA-mrwp-f3q8-3g9p reported against 1.16.0
and 1.16.1 (#139).
Assisted-by: Claude Code, claude-opus-5-5 (transcription)
Checks-run: diff of notes against CHANGELOG.md 2.0.0 section — identical
Eyvan v1.1.0
Added
- A "Multi-image figure grids" walkthrough in the Front Matter Field
Reference demo post, documenting theimages="…"parameter, its
pipe-delimitedpath | alt | WxH | srcset | sizesrow format, and the
colsoption — the onefigure.htmlsurface that previously had no
step-by-step guide outside the include's own comment header. - A step-by-step custom-domain /
CNAMEsection in the README, covering the
CNAMEfile, GitHub Pages settings, the apex/subdomain DNS records, and the
baseurl: ""adjustment a root-served custom domain requires. - Development-only test layout, navigation data, and component harnesses that
exercise the visual system without publishing test pages or helper CSS in
production builds. - Documentation for the
og_imagefront matter override and its precedence
over visible post covers and the site-wide social fallback.
Removed
- The
pa11y-cidevelopment dependency and itsa11y/a11y:sitemapnpm
scripts. The accessibility gate is Playwright + axe (npm run test:a11y),
whichpa11y-ciduplicated without being wired into any CI workflow;
removing it also clears the high-severityundiciadvisory it pulled in
transitively throughcheerio, and reconciles the tooling with the
project's documented "Playwright + axe" accessibility policy. The README
contributor-QA note and thedependabot.ymlnpm comment were updated to
match. - The unused Barlow Condensed 900 (Black) weight: its
@font-faceblock, the
$font-weight-blacktoken, the shippedBarlow-Condensed-normal-900-latin.woff2
subset, and its entry in the bundled font-license map. No component
referenced the weight (headings use Bold/700, the hero uses Semi-Bold/600),
so dropping it trims the shipped font payload with no visual change. - Obsolete Sass selectors and rules, including the unused page title/subtitle
selector API and stale state, animation, and print styles superseded by the
canonical components and utilities.
Fixed
- The
404.htmlerror-code line no longer relies on a presentational<br>
for spacing, and finally renders in the intended muted color. It used a
u-text-mutedclass that was never defined anywhere in the Sass, so the
text was not actually muted; a new_sass/5-components/_404.scssgives the
404 component its missing home, spacing the.c-404__codeline and coloring
it with the existing--color-on-surface-varianttoken. - Generic pages now fill the same container width as the homepage, projects,
about, and contact pages; long-form posts retain their intentionally narrower
prose measure. - The entry-meta component now emits the valid
flex-wrap: nowrapvalue instead
of the invalidunwrapdeclaration. - The climate demo enables cross-reference resolution, so its numbered table
reference renders a reader-facing label instead of the raw element id. - Development harness fixtures now use valid assets, unique landmarks, and
accessible component states exposed by the expanded test crawl.
Changed
post-card.htmlnow accepts an optionaleagerparameter. The homepage
project grid sets it on the first card so the likely above-the-fold LCP
cover loads eagerly withfetchpriority="high", while every other card
keepsloading="lazy". Behavior is unchanged for all existing callers,
which omit the parameter and stay lazy.- Sass architecture now uses consolidated semantic tokens, corrected BEM names,
normalized component filenames and headers, and clearer boundaries between
settings data, layout objects, components, and development-only test styles. - The setup, theming, architecture, README, and contributor guidance now match
the shipped navigation split, optional-image behavior, image loading policy,
deployment choices, Playwright/axe QA workflow, and repository rulesets.
Eyvan v1.0.0
First public release of the Eyvan Jekyll template.
See CHANGELOG.md for the full list of changes.