Uzupełnienie dokumentacji

oz-oai/blog/2022-09-15-niezbedne-info-organizacja.md

@@ -0,0 +1,23 @@
+---
+slug: niezbędne-informacje
+title: Niezbędne informacje
+authors: admin
+ # title: Docusaurus Core Team
+tags: [mentorzy, organizacja]
+---
+
+Hackathon potrwa 5 dni, a w tym czasie wszyscy uczestnicy będą mieli do dyspozycji [mentorów](https://hackarthon.pl/pl/mentorzy/).
+
+Niezbędne zasoby
+
+<!--truncate-->
+
+* [MoSCoW - must-have or should-have, could-have or won\'t-have (wishes)](https://docs.google.com/document/d/1ut392VJllwiy2O3S8Y4PabuarJwo-ac8AONmufrXwPg/edit)
+* [O zasobach z kolekcji Zachety (ABOUT_RESOURCES)](https://docs.google.com/document/d/1Z2GCUnWMAg960x5Px6laLIziCFVR_5_flnOr0yUaJcw/edi)
+* [Ścieżki tematyczne (wybrane zasoby, gdrive)](https://drive.google.com/drive/folders/1Lo6LKiaG3CNC6P44Vcmc78RTum_Em6kN)
+* [Materiały dla uczestników (google-drive)](https://drive.google.com/drive/folders/1qjI6F6EbD_BWWXGGhfkcl5Bi_-SDJw08)
+* [Wytyczne WCAG](https://wcag.lepszyweb.pl/)
+* [Kryteria punktacji](https://docs.google.com/document/d/1Vg-h1JUzN4EydLFmGD0hVeKigqUKlqgV9SfL9DfrGq4/edit)
+* [Szablon prezentacji finałowej](https://docs.google.com/presentation/d/136SF2reXou75C-DFJs0KFrDDCe94j8k6/edit#slide=id.p1)
+* [Link do spotkań na ZOOM](https://us02web.zoom.us/meeting/register/tZcpf-2upzIpHNXKLvxBBCX-PLmYB5x7Rr_u)
+

oz-oai/docs/hackarthon/_category_.json

@@ -0,0 +1,8 @@
+{
+ "label": "Hackathon",
+ "position": 1,
+ "link": {
+ "type": "generated-index",
+ "description": "Ogólne i najważniejsze informacje o hackathonie."
+ }
+}

oz-oai/docs/hackarthon/dodatkowe-zasoby.md

@@ -0,0 +1,11 @@
+---
+sidebar_position: 2
+---
+
+# Dodatkowe zasoby
+
+API Europeana (https://pro.europeana.eu/page/apis#api-key-and-terms-of-use, 3000 organizacji z całej Europy)
+Wikimedia Commons (https://commons.wikimedia.org/w/api.php)
+Wikidata (https://developer.wikimedia.org/)
+
+[Kolekcja Otwarta Zachęta - zasoby udostępnione na hackathon](https://docs.google.com/document/d/1Z2GCUnWMAg960x5Px6laLIziCFVR_5_flnOr0yUaJcw/edit)

oz-oai/docs/hackarthon/info.md

@@ -0,0 +1,90 @@
+---
+sidebar_position: 1
+---
+
+# Cele hackathonu
+
+Hackathon rządzi się swoimi zasadami, a oto one.
+
+W hackathonie oceniane są:
+* Dopasowanie do potrzeb i możliwości odbiorców
+* Technologia i jej dobór
+* Wartość edukacyjna
+* Wykorzystanie zasobów cyfrowych API Zachęty bądź API Europeana czy Wikidata
+
+Cele hackathonu to:
+
+* zaproponowanie ciekawego rozwiązania w jednym z dwóch tematów
+* zaprojektowanie i wdrożenie projektu zgodnie z WCAG 2.1
+* stworzenie makiety
+* oraz prototypu, który może zostać wdrożony i realnie rozwiązuje wybrany problem
+
+Zespoły pracują w grupach.
+
+# Kody źródłowe
+
+Kody źródłowe najlepiej umieszczać na Github, Bitbucket lub Gitlab. (Po konkursie) zachęcamy do opublikowania projektu jako publiczny i umieszczenia słowa kluczowego zachęta w nazwie projektu.
+
+# Inspiracje
+
+Inspiracje i analizę rynku można znaleźć w dokumencie [Kolekcja Otwarta Zachęta - zasoby udostępnione na hackathon](https://docs.google.com/document/d/1Z2GCUnWMAg960x5Px6laLIziCFVR_5_flnOr0yUaJcw/edit)
+
+
+:::tip
+
+Poniżej znajdziesz linki do zasobów, które można znaleźć w dokumencie powyżej
+
+* https://pro.europeana.eu/page/apis#api-key-and-terms-of-use
+* https://commons.wikimedia.org/wiki/Main_Page
+* https://www.wikidata.org/wiki/Wikidata:Main_Page
+
+* https://www.assemblyai.com/blog/the-top-free-speech-to-text-apis-and-open-source-engines/
+Integracje z API
+* https://rapidapi.com/blog/make-tech-more-accessible-with-these-apis/
+* https://www.programmableweb.com/news/10-most-popular-open-source-apis-2021/brief/2021/11/27
+* https://www.programmableweb.com/news/10-popular-artificial-intelligence-apis-2022/brief/2019/09/2
+* https://becominghuman.ai/whats-so-trendy-about-open-source-social-media-apis-that-everyone-went-crazy-over-it-983d99201359
+AI:
+* https://www.spiceworks.com/tech/innovation/articles/top-open-source-artificial-intelligence-software/
+
+:::tip
+
+:::tip
+
+Sensory mobilne
+
+* https://www.geeksforgeeks.org/various-smartphone-sensors/
+
+Zamiana obrazu na dzwięk:
+* https://naukawpolsce.pl/aktualnosci/news%2C29134%2Cuslyszec-obraz-nowatorski-system-odczytywania-kolorow-przy-pomocy-dzwiekow
+
+:::tip
+:::tip
+
+Dalsze inspiracje (wdrożenia w obiektach kultury)
+
+* https://www.freud.org.uk/visit/virtual-tour/
+* https://www.artnews.com/art-in-america/features/online-museum-multiplayer-art-viewing-experience-igame-1202687851/
+* https://mnwr.pl/category/wystawy/puzzle/
+* https://play.google.com/store/apps/details?id=com.moiseum.dailyart2&hl=pl&gl=US
+* lub https://play.google.com/store/apps/details?id=ee.laboratorium.muselfie&hl=pl&gl=US
+
+* wtyczka firefox https://addons.mozilla.org/en-US/firefox/addon/met-art/
+
+* https://www.sfmoma.org/read/why-build-api-museum-collection/
+
+* alternatywna wizualizacja kolekcji https://www.sfmoma.org/read/why-build-api-museum-collection/
+
+Oraz inne wymieione w sekcji "Więcej informacji" w dokumencie "O zasobach z kolekcji Zachęty"
+
+:::tip
+
+:::tip
+Szerzej niż WCAG
+
+* https://zacheta.art.pl/pl/mediateka-i-publikacje/?sort=alfabetycznie&szukaj=encyklopedia <acronym title="polski język migowy">PJM</acronym>
+
+Przykłady kreatywnego wykorzystania
+* https://pro.europeana.eu/the-europeana-website/europeana-reuse-be-inspired
+* https://nimoz.pl/files//articles/277/Czym%20jest%20dost%C4%99pno%C5%9B%C4%87%20cyfrowa.pdf "Czym jest dostępność cyfrowa" Dotora Orzeszek
+:::tip

oz-oai/docs/hackarthon/quiz.md

@@ -0,0 +1,135 @@
+---
+sidebar_position: 3
+---
+
+# Quiz
+
+Sprawdź swoją wiedzę
+
+export const Init = ({children}) => {window.i=1; return <></>}
+
+export const Odp = ({children}) => <label><input type="radio" name={`pyt${window.i}`} value={children}/>{children}</label>;
+
+export const Form = ({children}) => (<form action="https://zochniak.pl/oaiz/save.php" method="POST"
+ onSubmit={ev => {
+ if(0) ev.preventDefault();
+ const form = ev.target || ev.target.closest('form')
+ if(0) fetch(form.action, {method: 'POST'}).then(r => {
+ debugger;
+ })
+ form.querySelector('.resp').innerHTML = 'Gratulacje, wygrałeś/-aś?';
+ }}
+ >
+ {children}
+ <div class='resp'></div>
+ <button type="submit">Wyślij</button>
+</form>);
+
+export const Pytanie = ({children}) => {
+ // i+=1;
+ return <div style={{marginTop: '30px', display: 'flex', flexDirection: 'column'}}>
+ Pytanie {window.i++}. {children}
+ </div>;
+}
+
+import BrowserOnly from '@docusaurus/BrowserOnly';
+
+<BrowserOnly>
+{() => <Form>
+<Init/>
+
+<Pytanie>
+<b>Zbiorów jakiego obiketu dotyczy Hackathon</b>
+<Odp>Zachęta Narodowa Galeria Sztuki</Odp>
+<Odp>Wikipedia</Odp>
+<Odp>British Museum</Odp>
+</Pytanie>
+
+<Pytanie>
+<b>Na kanale Youtube jakiej organizacji relacjonowany jest przebieg hackathonu?</b>
+<Odp>Centrum Cyfrowe</Odp>
+<Odp>Unia Europejska</Odp>
+<Odp>Towarzystwo Zachęty Sztuk Pięknych</Odp>
+</Pytanie>
+
+<Pytanie>
+ <b>Która ze ścieżek nie jest dostępna w trwającym hackathonie?</b>
+ <Odp>D jak Działanie</Odp>
+ <Odp>M jak Malarstwo</Odp>
+ <Odp>N jak Natura</Odp>
+ <Odp>S jak Słowo</Odp>
+</Pytanie>
+
+<Pytanie>
+ <b>Które zasoby nie są sugerowane przez gospodarzy hackathonu?</b>
+ <Odp>Katalog Narodowa Galeria Sztuki Zachęta</Odp>
+ <Odp>Wikipedia Data</Odp>
+ <Odp>Wikimedia Commons</Odp>
+ <Odp>Europeana</Odp>
+</Pytanie>
+
+<Pytanie>
+ <b>(łatwe) Która z wymienionych postaci widnieje w zbiorach</b>
+ <Odp>Adama Półtawskiego</Odp>
+ <Odp>Włodzimierz Sel</Odp>
+ <Odp>Anna Bielawska</Odp>
+ <Odp>Andrzej Heidrich</Odp>
+</Pytanie>
+
+<Pytanie>
+ <b>(trudne) Kto z wymienionych nie był związany z żadnym z wydarzeń w 2021r. w Zachęcie?</b>
+ <Odp>Magdalena Abakanowicz</Odp>
+ <Odp>Joanna Rajkowska</Odp>
+ {/* <Odp>Anna Olszewska</Odp> */}
+ <Odp>Maciej Salamon</Odp>
+ <Odp>Anna Bielawska</Odp>
+</Pytanie>
+{/* https://zacheta.art.pl/pl/kalendarz?date-from=2021-01-01&date-to=2021-12-31 */}
+{/* <Pytanie>
+ <b>Która z wymienionych postaci widnieje w zbiorach</b>
+ <Odp>Adama Półtawskiego</Odp>
+ <Odp>Włodzimierz Sel</Odp>
+ <Odp>Anna Bielawska</Odp>
+ <Odp>Andrzej Heidrich</Odp>
+</Pytanie> */}
+<br/>
+
+[API Katalogu artystów](./podstawy-api/05-katalog-artystow.md)
+
+<Pytanie>
+ <b>Jaki parametr pozwoli wyszukać artystów, którzy mają dziś urodziny?</b>
+ `https://apihackaton.zacheta.art.pl/api/v1/artworks?...`
+ <Odp>Artists[Birthday][$eq]=09-29</Odp>
+ <Odp>Artists[Birthday][$startsWith]=09-29</Odp>
+ <Odp>Artists[Birthday][$endsWith]=09-29</Odp>
+ <Odp>Artists[Birthday][$gt]=1997-05-01</Odp>
+</Pytanie>
+
+<Pytanie>
+ <b>Jak wyszukać artystów, którzy urodzili się w 1923r.?</b>
+ `https://apihackaton.zacheta.art.pl/api/v1/artists?...`
+ <Odp>Artists[Birthday][$eq]=1923</Odp>
+ <Odp>Artists[Birthday][$gt]=1923</Odp>
+ <Odp>Birthday[$endsWith][$startsWith]=1923</Odp>
+ <Odp>Birthday[$endsWith][$endsWith]=1923</Odp>
+</Pytanie>
+
+<Pytanie>
+ <b>Jak nazywa się artysta widniejący pod ID 24</b>
+ `https://apihackaton.zacheta.art.pl/api/v1/artists?...`
+ <Odp>Paweł Althamer</Odp>
+ <Odp>Jerzy Nowosielski</Odp>
+ <Odp>Jadwiga Sawicka</Odp>
+ <Odp>Krzysztof Wodiczko</Odp>
+</Pytanie>
+
+</Form>}
+</BrowserOnly>
+
+<!-- ```
+curl --request GET \
+ --url 'https://apihackaton.zacheta.art.pl/api/v1/artists/23' \
+ --header 'Accept: application/vnd.api+json' \
+ --header 'Authorization: Bearer {{token}}}}' \
+ --header 'Host: apihackathon.zacheta.art.pl'
+``` -->