Skip to content

Latest commit

 

History

History
27 lines (21 loc) · 2.85 KB

README.md

File metadata and controls

27 lines (21 loc) · 2.85 KB

Minimalistický lokální katalog otevřených dat

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.

Záznamy datových sad

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.

IRI 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.

IRI katalogu

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

GitHub Pages

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.