at main
4 folders
3 files
feat(site): unified APA references, accessible video embeds and build optimization (#223)
* feat(site): unified per-page references from typed frontmatter
Pages can now declare their bibliography as a typed references list in
the frontmatter (docsSchema extension: standard, book, article, web and
report entries with DOI/URL fields). A MarkdownContent override renders
one localized APA-7 References section at the end of the article,
alphabetized, with the title carrying the link and the DOI rendered as
its own descriptive link, and the route middleware appends the matching
On this page entry. Custom UI strings ride Starlight's i18n collection
(EN/ES).
* feat(site): accessible video embed with a download link
Video.astro wraps the Tier-1 animation convention (preload none, poster,
reserved width/height, EN/ES x light/dark WebM variants resolved from
the clip basename and the page language) and adds the accessibility
layer: required accessible name and textual description (aria-label +
aria-describedby), a visible localized download link per theme variant,
an in-element textual fallback, an optional visible caption and no
autoplay. The theme switch now also covers the wrapping figure.
* fix(site): keep the programme-loudness page titles within 70 characters
html-validate's long-title rule caps document titles at 70 characters
and the page suffix pushed both languages over the limit. The ITU-R/UIT-R
qualifier moves out of the title (the description and body keep the full
designations).
* docs: pilot migration to frontmatter references and the video embed
Loudness, aircraft noise and psychoacoustic annoyance (EN and ES) move
their References and Standards prose into the typed frontmatter
bibliography, with verified publisher links for every entry (ISO/IEC and
Ecma catalogues, ICAO store, SAE, ECAC, doi.org). Loudness and surface
scattering become MDX and embed their animations through the Video
component. The pa11y audit gains the six migrated URLs.
* perf(site): recompress served raster images and parallelize page rendering
A postbuild step palette-quantizes PNGs and re-encodes JPEGs in dist/
(sources untouched, rewritten only when smaller): the social card drops
from 663 KiB to 337 KiB. Page rendering moves to four concurrent pages.
The build profile documents the ceiling: the content-sync phase cannot
be cached while starlight-links-validator is enabled, since the plugin
clears the content-layer cache so its link map sees every page.
* docs: changelog for the site references, video embed and build optimization
* fix(site): review pass over the references and video infrastructure
References: nothing rendered after a DOI (APA-7), the annotation moves
to its own line and auto-links bare URLs keeping trailing sentence
punctuation out of the link (restoring the IEC 61265:2018 and ECAC
documents-page links in the aircraft-noise notes and the ICA 2016 venue
gloss in the annoyance notes), the Spanish pages join the last author
with "y" instead of the ampersand per the Spanish adaptation of APA-7,
the injected heading gets the same hover anchor as authored headings,
journal volumes italicize with <i> instead of <cite>, undated entries
sort first and the unreachable author fallback now fails loudly.
Video: figcaption kept as the last figure child (valid HTML) and an id
override for repeated embeds. Image recompression: per-file failures
skip with the file named instead of failing the build, and
already-indexed PNGs are skipped so a manual postbuild re-run cannot
re-quantize. Stale autoplay wording removed from the theme CSS comment;
leftover double blank lines collapsed.
feat(site): unified APA references, accessible video embeds and build optimization (#223)
* feat(site): unified per-page references from typed frontmatter
Pages can now declare their bibliography as a typed references list in
the frontmatter (docsSchema extension: standard, book, article, web and
report entries with DOI/URL fields). A MarkdownContent override renders
one localized APA-7 References section at the end of the article,
alphabetized, with the title carrying the link and the DOI rendered as
its own descriptive link, and the route middleware appends the matching
On this page entry. Custom UI strings ride Starlight's i18n collection
(EN/ES).
* feat(site): accessible video embed with a download link
Video.astro wraps the Tier-1 animation convention (preload none, poster,
reserved width/height, EN/ES x light/dark WebM variants resolved from
the clip basename and the page language) and adds the accessibility
layer: required accessible name and textual description (aria-label +
aria-describedby), a visible localized download link per theme variant,
an in-element textual fallback, an optional visible caption and no
autoplay. The theme switch now also covers the wrapping figure.
* fix(site): keep the programme-loudness page titles within 70 characters
html-validate's long-title rule caps document titles at 70 characters
and the page suffix pushed both languages over the limit. The ITU-R/UIT-R
qualifier moves out of the title (the description and body keep the full
designations).
* docs: pilot migration to frontmatter references and the video embed
Loudness, aircraft noise and psychoacoustic annoyance (EN and ES) move
their References and Standards prose into the typed frontmatter
bibliography, with verified publisher links for every entry (ISO/IEC and
Ecma catalogues, ICAO store, SAE, ECAC, doi.org). Loudness and surface
scattering become MDX and embed their animations through the Video
component. The pa11y audit gains the six migrated URLs.
* perf(site): recompress served raster images and parallelize page rendering
A postbuild step palette-quantizes PNGs and re-encodes JPEGs in dist/
(sources untouched, rewritten only when smaller): the social card drops
from 663 KiB to 337 KiB. Page rendering moves to four concurrent pages.
The build profile documents the ceiling: the content-sync phase cannot
be cached while starlight-links-validator is enabled, since the plugin
clears the content-layer cache so its link map sees every page.
* docs: changelog for the site references, video embed and build optimization
* fix(site): review pass over the references and video infrastructure
References: nothing rendered after a DOI (APA-7), the annotation moves
to its own line and auto-links bare URLs keeping trailing sentence
punctuation out of the link (restoring the IEC 61265:2018 and ECAC
documents-page links in the aircraft-noise notes and the ICA 2016 venue
gloss in the annoyance notes), the Spanish pages join the last author
with "y" instead of the ampersand per the Spanish adaptation of APA-7,
the injected heading gets the same hover anchor as authored headings,
journal volumes italicize with <i> instead of <cite>, undated entries
sort first and the unreachable author fallback now fails loudly.
Video: figcaption kept as the last figure child (valid HTML) and an id
override for repeated embeds. Image recompression: per-file failures
skip with the file named instead of failing the build, and
already-indexed PNGs are skipped so a manual postbuild re-run cannot
re-quantize. Stale autoplay wording removed from the theme CSS comment;
leftover double blank lines collapsed.