Přeskočit na obsah

Tato stránka byla automaticky přeložena z angličtiny, jediného jazyka, ve kterém se tento web píše. Číst originál.

Jak je tento web odvozen

Web je projekce repozitáře, postavená tak, jak nástroj žádá projekty, aby stavěly své vlastní instrukce.

Vlastnictví

vrstvavlastnížije v
pravda o produktuschéma politiky, profily, instrukce pro workery, CLIshare/skeleton/**, bin/, lib/
veřejný příběhco to je, proč, jak, co to odmítáREADME.md, docs/**
tvrzeníkaždá schopnost se stavem, zdrojem, implementací a testemdocs/CLAIMS.yaml
marketingový texttitulek, úvody, popisky tlačítek; žádná tvrzení, žádná čísla, rozpočet řádkůsite/data/marketing.toml
ručně psaná nastavenímanifest, pořadí a rozpočty domovské stránky, navigace, stránka výzvy, dlaždice důkazů, způsob publikace každého druhu; slova, pořadí a nastavení, nikdy početsite/data/*.toml
ručně psané stránkydlouhé články a stránky jako tato; číslo, které uvádějí, se cituje z site/data/figures.toml a scripts/site-check odmítne číslo napsané ručně vedle počítaného podstatného jménasite/content-src/**
citované hodnotykaždé číslo, které smí uvádět ručně psaná próza: jeho název, generovaný soubor, z něhož se při buildu čte, a co počításite/data/figures.toml
odvozená datastabilní JSON, který šablony čtousite/data/generated/** (commitnuto, zkontrolováno)
odvozený obsahkanonický Markdown s generovanou front mattersite/content/docs/** (v gitignore, znovu sestaveno)
prezentacešablony Zola, komponenty Flowbite, utility Tailwind, vylepšení Alpinesite/templates/**, site/tailwind.css
výstupstatický website/public/**

Pipeline

Pipeline je nakreslena na konci této stránky, ne napsána zde. Vykresluje se z site/data/generated/diagrams.json, které generátor zapisuje ze vstupů, jež skutečně přečetl, takže kanonický soubor přidaný do odvození se v obrázku objeví, aniž by ho někdo překresloval. Blok, který tu dříve býval, byl druhou, ručně udržovanou kopií téhož diagramu a oba už pojmenovávaly různé věci.

Záruka synchronizace

scripts/generate-site-data --check se přegeneruje do dočasného adresáře a porovná (diff) s commitnutým site/data/generated/. Rozdíl shodí sestavení. Hash vstupu v source.json pokrývá každý kanonický soubor, který generátor čte; objevuje se v patičce každé stránky. Regresní test změní v pracovní kopii jednu kanonickou hodnotu a ověří, že se změní i odvozená data, takže odvození je prokázáno, ne předpokládáno.

Co se nikdy neupravuje ručně

site/data/generated/**, site/content/docs/**, site/static/app.css, site/static/js/**, site/public/**. Změňte kanonický soubor; sestavte znovu.

Jak je tento web odvozenze vstupů generate-site-data
flowchart LR
    subgraph canonical
        A[share/skeleton]
        B[docs + README]
        C[docs/CLAIMS.yaml]
    end
    G[scripts/generate-site-data]
    D[(site/data/generated)]
    Z[Zola]
    F[Tailwind + Flowbite + Alpine]
    P[GitHub Pages]
    A --> G
    B --> G
    C --> G
    G --> D --> Z --> F --> P
Politika do instrukčních souborůz projekcí share/skeleton/policy.yaml
flowchart TD
    P[.ai/repo/policy.yaml]
    U[majordomus update]
    P --> U
    U --> T0["AGENTS.md<br/><small>agents</small>"]
    U --> T1["CLAUDE.md<br/><small>claude-code</small>"]
    U --> T2["GEMINI.md<br/><small>gemini</small>"]
    T0 -.->|stamp| D[majordomus doctor]
Odkazováno z tohoto diagramu (2)

Tato stránka je o webu. Program, o kterém web je — každý modul CLI a každý soubor, který čte a zapisuje, zjištěný při každém buildu ze shellových zdrojů — najdete v mapě programu.

Prohledává názvy a popisy všech stránek, které tento web publikuje.