xonecas.io
8356
Wx

www-xonecas-io / files

www-xonecas-io / tickets / 1007-build-the-project-page-readme-file-tree-tags.md

2.9 KB
1---
2id: 1007
3title: "Build the project page: README, file tree, tags and sources"
4type: feature
5status: done
6priority: p1
7area: site
8created: 2026-11-07T19:30:00Z
9updated: 2026-11-08T03:58:05Z
10source: agent
11moves: 2026-11-07T19:30:00Z inbox todo agent; 2026-11-08T01:09:32Z todo doing drag; 2026-11-08T01:37:58Z doing review agent; 2026-11-08T03:58:05Z review done drag
12---
13
14xonecas.io/projects/<name> is the landing page of one repo: rendered README, root file tree, tags, languages, dates, commit count, source links, and how to clone.
15
16Handle the awkward cases: 14 of your projects have no README, and 2011-era markdown may render oddly (not surveyed). README relative links and images must resolve against the repo.
17
18Done when: mini-coder, ffmpeg-node and a no-README project all render correctly locally.
19
20## Notes
21
22- 2026-11-08 01:37Z (agent): Done: every shown project has a page at /projects/<name>/ (81 pages). Each has the big tile, description, tags, dates, commit count, files and stars, the root file tree with each entry's last commit, the rendered README, languages, sources and a clone command. mini-coder, ffmpeg-node and orc-code (no README) are attached, plus phone and dark shots.
23  
24  - The build now reads git for these pages, so 'make build' needs repos/ (from 'make import'). A full build takes about 4s.
25  - Markdown goes through goldmark with GitHub extensions. The 7 READMEs with no extension render as plain text. Raw HTML is kept, because 6 READMEs use it to centre logos (Zoea-Nova, symb, mini-coder and others). That is safe enough because it is your own content on a static site with no cookies, but say if you want it stripped.
26  - Relative links and images resolve against the repo. Images are copied to /projects/<name>/raw/<path> (9 across all READMEs, none missing). Links to files go to /projects/<name>/blob/<path>/ and links to folders to /projects/<name>/tree/<path>/. The root file tree links the same way. Those blob and tree pages are 1008's, so they 404 until 1008 lands.
27  - 2011-era Markdown: ffmpeg-node's '#FFMPEG-NODE' needs a space after the #, which old GitHub didn't require. I add it outside code fences. I didn't find other oddities, but I only looked closely at mini-coder, ffmpeg-node, Zoea-Nova, cel-tui and rotator.
28  - Clone uses the canonical source URL (the one with the most commits), because the site doesn't serve git yet. When it does (1011's hand-off), this is one line to change.
29  - No README: 'No README. The files above are all there is.' Edit the copy if you like.
30  
31  CHECKED: go test, using a test repo with an old-style heading, an image, and links to a folder, a file with an anchor and an external URL. Also: no relative src or href left unresolved in any README, every raw/ image exists, and screenshots at desktop, 390px phone and dark. I measured overflow at 390px on cel-tui (tables), rotator and mini-coder: none.
32  NOT CHECKED: all 67 READMEs by eye, Chrome and Safari.