Commit Graph
24 Commits
Author SHA1 Message Date
Abdessamad Derraz f0e7d87def fix: settle the round 3 site packages together 2026-10-23 11:12:12 +02:00
Abdessamad Derraz b1cbadc335 feat: round 3 navigation and search 2026-10-23 11:02:28 +02:00
Abdessamad Derraz a152b6d5d9 feat: round 3 components 2026-10-23 11:02:27 +02:00
Abdessamad Derraz b239be4984 feat: hash verdict, built filters, unbroken flags
Tables of four columns stack on a phone, and a long table's filter box is written at build time, which ends the layout shift on gaps-files-to-source. Find a file names its counts, its emulators and accepts md5=, crc32= and sha256=, hashes a chosen file on the device and points an unknown hash to contributing. A hash typed in the search folds the pages that only mention it. Words holding a hyphen in command blocks no longer break across lines.
2026-10-23 10:47:05 +02:00
Abdessamad Derraz e19c3f86c4 fix: title logo plate and footer licence
The title mark sits on the tiles' white 40 px square with its width written, so a black logo stays visible in the dark theme. A setup with no logo shows its initials. The level label is dropped on a tab's own page. The footer licence line now matches LICENSE.
2026-10-23 10:47:05 +02:00
Abdessamad Derraz fc33779c6f feat: crumb to the parent and read forward
A part page's parent is its last crumb and is marked in the sidebar.
A Next steps link pointing back in the reading run gives way to the run
order, so Start here reads every page once.
2026-10-23 10:36:09 +02:00
Abdessamad Derraz d8c4eb1570 fix: theme command wrap, sidebar, tabs, badges
Commands no longer allow a cut anywhere inside a word on phones. Sidebar top-level links match their children at 14 px. OS tabs keep one row and scroll. Badge links in file cards keep a 24 px target. Card hashes are 13 px at every width. Get your files tables share their column widths, part links stay on one line. Short hash cells and the Reason column get their styles.
2026-10-23 10:35:03 +02:00
Abdessamad Derraz 462d1abb05 fix: name one emulator's kind in the singular
A row of the emulators index and of the cross-reference tables named
one core's class in the plural (Official ports). The upstream table's
headers no longer break inside a word.
2026-10-23 07:36:49 +02:00
Abdessamad Derraz 4c31935b7c fix: quiet heading ids and fit the upstream table
The system id a platform writes beside a heading is now small, muted
and set as code. The upstream table on the cross-reference page shares
the column width from 50rem: its rule never matched, a paragraph sits
between heading and table, and at 1440 px it ran 98 px past the edge.
2026-10-23 07:26:30 +02:00
Abdessamad Derraz a9181f9d04 feat: platform logos and emulator letter sections
The decoration pass now forwards the logo front matter, pointed at the
local copy. The emulators index lists every profile under the initial
the sidebar draws, so each letter link lands on its section.
2026-10-23 07:02:40 +02:00
Abdessamad Derraz b47a4f6bbc fix: style device tiles, size the header logo 2026-10-23 02:39:17 +02:00
Abdessamad Derraz e5871a6f21 feat: stack tables and add section tabs
# Conflicts:
#	wiki/testing-guide.md
2026-10-23 02:27:45 +02:00
Abdessamad Derraz 9e274f0469 feat: tidy title, footer and file picker 2026-10-23 02:27:09 +02:00
Abdessamad Derraz 60de1284d1 feat: give a hash lookup a verdict 2026-10-23 02:27:09 +02:00
Abdessamad Derraz 2c71f0d3da feat: stack tables at build, add section tabs 2026-10-23 02:27:09 +02:00
Abdessamad Derraz 4edebc56bc feat: quiet the site theme
# Conflicts:
#	wiki/testing-guide.md
2026-10-23 02:26:08 +02:00
Abdessamad Derraz d94347ba18 fix: quiet theme chrome, link-coloured focus 2026-10-23 02:25:30 +02:00
Abdessamad Derraz 8aa1e1cea1 feat: name each sidebar group by its overview
The 404 page opens on Start here instead of tabs numbered 0 to 4. A group label is a group, or in Explore one link to its overview, never a link to its first page, and a crumb names the section that introduces the page. Emulators sit one level deep by initial. Previous and next run within a tab (Start here into Your setup) and skip system, emulator and platform pages, and follow a page's Next steps list. Reference pages group under Checking files and Data, a wiki page joining by its group: front matter. redirects.json maps alternative core names to their profile.
2026-10-23 02:18:27 +02:00
Abdessamad Derraz de5b517579 fix: name systems and keep the picker filter 2026-10-22 19:16:36 +02:00
Abdessamad Derraz 123d698e43 feat: build the site with Astro Starlight
generate_site.py writes the Starlight project in website/ and nothing
else: mkdocs.yml, the MkDocs hooks, theme overrides and stylesheet go,
and the wiki is written in Starlight's syntax. Both workflows set up
Node with the official actions/setup-node pinned by commit, run npm ci
from the committed lockfile, build with the strict link validator and
check the result with validate_site.py.

The search weighs a page by what it answers: Start here pages first,
a system page's cards and file names before a guide citing them, deep
guides, launchers, aliases and frozen copies after. Status badges,
hash blocks and the export change lists leave the index. The ranking
sits at the centre of a range where the 13 queries of search_gate.py
all answer, in the search box itself.

839 pages, every URL and 45,611 ids match the MkDocs build. The tests
read the Starlight content and syntax.
2026-10-22 18:47:22 +02:00
Abdessamad Derraz abe240073c feat: pass the Starlight gate on dense pages
Pages of cards under one or two headings drop the table of contents,
whose script watched every block of a 400-card page: 2 x 430 ms of
main thread on a throttled phone. Tables are measured once the page is
idle, skipping those in closed blocks, so a scrolling table is a tab
stop anywhere on the page. The 12 heaviest pages score 97 to 100 in
Lighthouse mobile, axe reports nothing on 16 pages in both themes, and
the search answers the ten gate queries.
2026-10-22 17:21:14 +02:00
Abdessamad Derraz 5f3534bdf2 feat: tune search weights and heavy page loads
Status badges and hash-listing blocks leave the search index, card titles
weigh as page titles, and Pagefind ranking is set inside a range where
the ten gate queries all answer (search_gate.py: 10/10). Tables are set
up and measured when they near the screen, which relaid out a 3,800-row
page after its first paint, and console icons hold their box.
2026-10-22 16:49:27 +02:00
Abdessamad Derraz 294942afd0 feat: port the site ports and picker checks
Tables with a download link stack on phones, the browser check covers
the lookup, a hash typed in the search, breadcrumbs, previous and next
across tabs, glossary terms and the 404 hint. validate_site budgets the
Pagefind index pieces and takes the base path without mkdocs.yml. A
test holds the picker to install.narrow() on 180 selections.
2026-10-22 15:46:36 +02:00
Abdessamad Derraz 342d0f7271 feat: write the site for Starlight behind a flag
generate_site.py --engine starlight writes the pages, navigation and
data files of an Astro Starlight project in website/. Links resolve to
site addresses, every heading keeps its MkDocs id, and pages split by
size are measured in the MkDocs Markdown so both builds cut the same
files. The 839 pages and their 45,613 ids match the MkDocs build.
2026-10-22 15:41:39 +02:00