Toto je minimalistická verze lokálního katalogu otevřených dat, která celá běží na GitHubu, a tedy zdarma. Je kompatibilní s rozhraním DCAT-AP Dokumenty dle Otevřené formální normy Rozhraní katalogů otevřených dat: DCAT-AP-CZ. Pro její zprovoznění stačí tento repozitář forknout a upravit šablonu katalogu.
Pro přidání či editaci záznamu použijte formulář NKOD v režimu LKOD. Režim se přepíná ikonou ozubeného kolečka vedle tlačítka stažení vyplněného záznamu. Tam je také potřeba vyplnit IRI poskytovatele a IRI datové sady. Výsledný soubor uložte do repozitáře. Uložení automaticky spustí GitHub Action, která repozitář projde, a vytvoří soubor katalogu na základě šablony a nalezených datových sad.
Je třeba se ujistit, že IRI datové sady vyplněné v záznamu na tento záznam po jeho uložení do repozitáře povede.
V tomto repozitáři je vzorová datová sada, jejíž IRI je https://raw.githubusercontent.com/datagov-cz/lkod-min/main/datové-sady/datová-sada.jsonld
.
Toto IRI zjistíte po kliknutí na tlačítko Raw
při prohlížení souboru přes rozhraní GitHub.
Skládá se vždy z https://raw.githubusercontent.com/
, organizace/
, repozitář/
, jméno-větve/
, cesta k souboru v repozitáři
.
Tato IRI datových sad lze také použít pro opětovné načtení záznamu do formuláře NKOD pro jeho editaci. Ve formuláři staří v prvním kroku dole kliknout na "Načíst záznam z URL", a IRI datové sady tam vyplnit.
Při registraci lokálního katalogu do NKOD pak stačí zvolit jako Typ API lokálního katalogu DCAT-AP Dokumenty
a do URL LKOD API vyplnit URL souboru katalogu podobně, jako pro datové sady, tedy např. https://raw.githubusercontent.com/datagov-cz/lkod-min/main/katalog.jsonld
Pokud by takováto IRI datových sad nevyhovovala, lze tuto minimalistickou variantu LKOD rozšířit o GitHub Pages, které umožňují použít vlastní IRI katalogu a datových sad, dokonce i s vlastní doménou, např. https://data.organizace.cz/zdroj/datové-sady/1.jsonld
.
GitHub pages zároveň umožňují hostovat i webovou prezentaci, jejíž součástí pak LKOD může být.