Skip to main content

Operations

Regenerate the graph​

python compile-graph.py

Produces data/linux-genealogy/linux-genealogy-graph.json and the JS data bundle consumed by the D3 visualization in linux-genealogy.html.

Data pipeline scripts​

Per the analyzer's evidence, the toolkit includes scripts to:

  • Flatten hierarchical JSON to JSONL (linux-genealogy-expanded.jsonl)
  • Rebuild the reference catalog (linux-distros-reference.md) from the current dataset
  • Verify graph integrity and layout metrics
  • Append and curate individual distro entries

Additional working scripts live under scratch/.

Serving the page​

linux-genealogy.html is a static page — no server-side runtime is required to view it, though the exact current build/deploy pipeline connecting it to aptlantis.net/linux-genealogy wasn't confirmed during this pass (see Roadmap: "Identify and record the current site generator/runtime").

Repository layout​

linux-genealogy/
├── linux-genealogy.html                  # published page, D3 viz + JSON-LD
├── compile-graph.py                       # scrape data → graph JSON
├── data/linux-genealogy/linux-genealogy-graph.json
├── linux-genealogy-expanded.jsonl         # flattened export
├── linux-distros-reference.md             # generated reference catalog
├── List of Linux distributions - Wikipedia - *.md   # raw scraped source
├── Wikidata List of Linux distributions - *.md      # raw scraped source
└── scratch/                                # working scripts