Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -142,6 +142,11 @@ that is not one task (`taskgate`).
`llms-full.txt` (every page's Markdown) and a `.md` twin of each page, all from the same
content (`src/pages/`). The build fails on a twin that still carries MDX: a component, an
expression or a directive `src/lib/pages.ts` does not translate.
- **A link's preview** is the page's card: `src/pages/cards/` draws one for every page, the
generated ones included, from its topic in `nav.mjs`, its title and its description, in brand's
colours and IBM Plex (`src/lib/card.ts`, with satori), and `Head.astro` names it as the page's
`og:image`. Nobody draws one by hand; the landing page keeps `public/og.png`. A hundred cards add
some two seconds to the build.
- **The look** is spin-stack/brand's: its palette, checked there for contrast and perceptual
distance on real panels and through colour-vision deficiencies, and the organization's mark.
`task reference` copies them from brand at its pin (`BRAND=` to point elsewhere) into
Expand Down
3 changes: 1 addition & 2 deletions astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -41,8 +41,7 @@ export default defineConfig({
PageSidebar: './src/components/PageSidebar.astro',
},
head: [
// The link preview a chat shows: public/og.png, by its absolute address.
{ tag: 'meta', attrs: { property: 'og:image', content: `${site}${base.replace(/\/$/, '')}/og.png` } },
// The link preview a chat shows is the page's card, which Head.astro names.
{ tag: 'meta', attrs: { name: 'twitter:card', content: 'summary_large_image' } },
// The mark iOS puts on a home screen.
{ tag: 'link', attrs: { rel: 'apple-touch-icon', href: `${base.replace(/\/$/, '')}/apple-touch-icon.png` } },
Expand Down
1 change: 1 addition & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@
"@fontsource/ibm-plex-mono": "5.3.0",
"@fontsource/ibm-plex-sans": "5.3.0",
"astro": "^7.4.11",
"satori": "0.63.2",
"sharp": "^0.35.5",
"starlight-image-zoom": "0.16.2",
"starlight-sidebar-topics": "0.9.0",
Expand Down
Loading