Home page

[pbartosova]

https://api-dev.aiscr.cz/ https://api-test.aiscr.cz/ https://api-tr.aiscr.cz/ https://api.aiscr.cz/

Jednoduchá statická stránka s informacemi pro uživatele a odkazem na uživatelskou příručku s příklady užití.

[motyc]

Asi jsem to zapomněl zmínit, pro amcr-tr není třeba API implementovat. Vzhledem k tomu, že jde o pasivní přístup, tak si to kdokoli může zkoušet přímo na ostrých datech. Samozřejmě jádro AMČR bude všude stejné, nemusí se ale nasazovat zbytek nad jeho rámec.

[RadkaKittova]

Dobrý deň prajem Davide, pripravila som jednoduchý mock-up statickej stránky. Je to naozaj prvý návrh ale bola by som veľmi rada za Váš názor, pripomienky a komentáre. Sme naozaj na začiatku, takže akékoľvek zmeny viem ľahko vykonať, prípadne upraviť. Prajem pekný zvyšok dňa. R.

[motyc]

Dobré časné odpoledne, Radko,

děkuji a zde přidávám komentář:

1) Vzhledem k celkovému posunu bych to nevztahoval přímo k Digitálnímu archivu, ale buď k AMČR (odtamtud jdou data), nebo k AIS CR (celková sjednocující identita). Logo bych tam tedy použil z AIS CR (AISCR_CZ_H_CMYK_Pozitiv.zip) a nadpis bych dal "Vítejte na stránkách API Archeologického informačního sytému ČR"

2) Text bych pak poupravil takto:

"API v současné době nabízí službu Data Provider AMČR, která poskytuje metadatové záznamy z databáze Archeologická mapa ČR [href=http://archeologickamapa.cz/], a to..."

"Implementace OAI-PMH podporuje reprezentaci metadat v:

• Dublin Core - poskytuje část datasetu týkající se dokumentů a jejich popisu (denní aktualizace dat)
• CIDOC-CRM - nabízí archivovaná, volně přístupná data z AMČR ve formátu RDF v syntaxi odpovídající ontologii CIDOC-CRM [href=http://www.cidoc-crm.org/] (týdenní aktualizace dat)
• AMČR XML - nativní formát, který umožňuje plné vytěžování databáze př zohlednění přístupových práv (denní aktualizace dat)"

"Archeologové či uživatelé s vyšším oprávnění mohou využít svůj registrovaný účet Archeologické mapy ČR pro přístup k nearchivovaným či jinak chráněným záznamům."

"Podrobný návod..."

3) Doplnil bych patičku totožnou jako je na Digitálním archivu, s vypuštěním loga Ariadne a aktualizací data copyrightu (2019).

4) Barevné vyznačení i font jsou dobré. Místo modré, která symbolizuje Digiarchiv, bych ale využil poslední dosud nevyužitou barvu z loga AIS CR, a to RGB(231, 48, 42). Tu bychom v nových implementacích používali pro back-end, adminitrátorské a techničtěji zaměřené části systému.

5) Do podrobného návodu se Vám myslím bude hodit mít E-R model databáze, zde je k dispozici: http://www.archeologickamapa.cz/downloads/AMCR_diagram_cs.jpg (záměrně v něm chybí některé pomocné či matoucí entity)

zdravím DN

[RadkaKittova]

Dobrý deň Davide ešte raz, Ďakujem pekne za pripomienky. Zapracovala som ich do návrhu. Grafický návrh som trošku zmenila kedže farba čierna s 231 48 42 tvorila dost velký kontrast takže som to trošku zjemnila v pozadí farebnými prúžkami. Ak by bol aj tak ten kontast veľký, mohla by som použiť namiesto čiernej tamvo šedú, ktorá by to opticky zjemnila, ale na to by som potrebovala logo AIS CR vo vektoroch... Každopádne ale myslím, že ako stránka k dokumentácií na API to bude takto v poriadku, čo si o tom myslíte?

Ďakujem R.

[motyc]

Radko, děkuji za další návrh. Myslím, že je to dobré.

1) Kdyby se hodilo, logo ve vektorech je zde: logo_AIS_CR.ZIP

2) Je tam drobný překlep "...databáze př zohlednění..." -> "...databáze při zohlednění..."

3) Změňte prosím "...v syntaxi odpovídající ontologii..." na "...v syntaxi odpovídající této ontologii..."

4) Ten poslední řádek z odkazem bych odsadil více doprava a dolů, takto se to myslím trošku tluče s textem nad ním.

5) V patičce jsme si asi nerozuměli - dejte tam všechna loga s výjimkou ARIADNE (teď je to naopak). Chybí tam také informace o licenci a měla by tam být zachována ta možnost rozkliknutí kontaktů.

Pak už to bude vše.

[vbar]

Já bych měl ještě poznámku k "CIDOC-CRM - nabízí archivovaná, volně přístupná data z AMČR ve formátu RDF v syntaxi odpovídající ontologii CIDOC-CRM (týdenní aktualizace dat)": nová konverze do RDF není až tak pomalá (méně než půl hodiny), a z hlediska implementace Data Provideru je jednodušší mít všechny zdroje se stejným datem, takže bych se přimlouval za denní aktualizaci i RDF dat.

[motyc]

Pokud to tak je, pak s tím není problém a samozřejmě budu raději za denní aktualizaci.

V takovém případě bych úplně umazal ty závorky o periodicitě aktualizací a místo nich bych nakonec za "...chráněným záznamům." doplnil: "Aktualizace dat probíhá na denní bázi (vždy v [čas] SEČ)." Čas prosím doplňte podle plánovaného nastavení.

[motyc]

1) Informační webovou stránku bych dal přímo na base URL (https://api-test.aiscr.cz/ atd.), nikoli od podsložky dapro. I výhledově je to nevhodné (pokud bychom např. implementovali další API)...

2) S tím zápatím se stále nějak míjíme. Mělo by vypadat takto v základu:

a rozbalené takto:

Zkrátka víceméně stejně jako na https://digiarchiv.aiscr.cz/, jen bez loga ARIADNE a samozřejmě s úpravu textu "Created by INCAD" na "Created by SSC". I tu barvu pozadí bych zachoval kontrastní oproti zbytku. Loga mají být živá (s linky).

3) Všechny odkazy dávejte na novou stránku (about="_blank").

4) PDF s manuálem používá nějaké podivné písmo či kódování, nejde z něj nic kopírovat a nefungují odkazy.

[pbartosova]

ad 4) PDF by mělo být opravené. Místo PDF Creator jsem použila tool Microsoft Print to PDF.

[pbartosova]

ad 1) Base URL je v režii MK. Stejně tak http://www.aiscr.cz/, která je jen na produkci.

[motyc]

Ok, domluvím se s ním. Díky

[motyc]

@MichalKminek Michale, prosím, podívej se na to nastavení base URL, díky (viz můj včerejší příspěvek).

[RadkaKittova]

@motyc Dobrý den Davide, ospravedlnujem sa, to rozklikávatko som si naozaj nevšimla, dnes večer sa tomu povenujem a bude to vyzerat tak, ako ste písali :). Ďakujem. R.

[MichalKminek]

Informativni stranka bude ulozena v rootu kazdeho api.

[vbar]

Pokud má být https://api.aiscr.cz/ stejná jako https://api.aiscr.cz/dapro , bylo by ji na ni myslím nejlepší prostě přesměrovat - ať nemusíme každou změnu deployovat dvakrát...

[motyc]

Podle mne by na https://api.aiscr.cz/dapro nic být nemělo a měla by existovat jen homepage na https://api.aiscr.cz/

[MichalKminek]

Myslim, ze postaci informativni stranka jen v rootu https://api.aiscr.cz/, urcite bych nedaval zadne odkazy na jednotliva API, abychom zamezili skenovani ruznych robotu zkousejicich ruzne zranitelnosti.

[vbar]

OK, akorát v tom případě by HTML té stránky asi nemělo být v projektu dapro, když je pro všechny - bylo by možné založit pro ně pod https://github.com/ARUP-CAS/ nový projekt - aiscr-homepage, nebo tak nějak?

[motyc]

Vzhledem k tomu, že jde o statickou stránku - myslíte, že je nutné mít ji v samostatném repozitáři? Např. web AMČR či AIS CR držíme jen na filesystému a aktualizuji to přes FTP. Myslím, že pro takto jednoduché věci to bohatě stačí. Co vy na to?

[vbar]

No já bych i statické stránky udržoval verzované - když @RadkaKittova vytváří HTML, a já ho překládám do češtiny, musíme se nějak koordinovat... Ale nemusíme mít mít repozitář veřejný - můžeme ho udržovat interně...

[vbar]

OK, takže jsem zkopíroval HTML do tohoto repozitáře (napříště bude autoritativní verze tady) a nasadil na https://api.aiscr.cz (a https://api/test.aiscr.cz ).

[motyc]

Finální editaci stránky jsem provedl rovnou zde do html. Stačí tedy změny promítnout na server.

[vbar]

OK, nasazeno.