Add shared card schemas layouts and renderer

2026-07-15 08:41:20 +02:00
commit 65299458ed
19 changed files with 7786 additions and 0 deletions
@@ -0,0 +1,36 @@
+# demo-01 / pierwszy krok
+
+Karta `01/02` demonstracyjnej serii `demo`. Pokazuje minimalny kontrakt
+generatora: jedno wymaganie edukacyjne, efekty ogólne i zawodowe na
+marginesach, kryterium weryfikacji oraz kroki obecne w TeX i HTML.
+
+## Cel
+
+Uczeń uruchamia generator, rozpoznaje pliki źródłowe oraz potrafi wskazać,
+który krok realizuje dane wymaganie i kryterium.
+
+## Kroki
+
+1. Sprawdź `json/card_source.json`.
+2. Wygeneruj TeX i HTML.
+3. Potwierdź obecność marginesów `TECH` i `OG`.
+4. Zapisz dowód wykonania polecenia kontrolnego.
+
+## Generowanie
+
+Z katalogu głównego repozytorium `card-layouts`:
+
+```bash
+make render-example
+make pdf-example
+```
+
+## Warunek PASS
+
+- generator kończy pracę kodem `0`;
+- istnieją `build/tex/main.tex`, `build/html/index.html` i `style.css`;
+- oba wyjścia zawierają tytuł karty i identyfikatory drzewek;
+- PDF składa się bez błędu.
+
+Źródłem prawdy jest `json/card_source.json`. Plików w `build/` nie edytujemy
+ręcznie.