Jak zadávat data na web

Checklist, podle kterého lze postupovat při zadávání dat na web. Obsahuje 5 sekcí, překlady, projektová data, obrázky, nasazení a dodatečné poznámky.

Běžná překladová data

Pro úpravu textu na webu je nutné: 

1. Otevřít AirTable pro web a tabulku Translations

2. Nalézt text podle klíče. Lze si pomoci hledáním přes samotný text. Např. klíč pages.homepage.sections.numbers.first.value reprezentuje první hodnotu v sekci čísel na homepage. 

3. Nahradit českou a anglickou hodnotu v cs a en 
4. Nasadit web (vize níže)

Jedná se o texty, které se nevztahují k projektům. 

Projektová data

Nutná příprava

Před vložením nového projektu potřebuji mít připravený: 

• Název (cs a en)

• Tagline (cs a en)

• Popis (cs a en)

• Slug pro url (cs a en, bude v URL projektu, např. dame-rousky a giving-masks bude jako cesko.digital/projekty/dame-rousky a cesko.digital/en/projects/giving-masks)

• Logo (512x512px)

• Cover obrázek nebo fotka (1200x627px)

• Stav projektu v procentech

• Text pro zapojení se do projektu nebo děkovný text v případě dokončeného projektu (cs a en)

• Hlavní URL projektu (může být web nebo třeba GitHub repozitář v případě rozpracovaného projektu)

• Seznam dobrovolníků (jméno, e-mail, role, případně profilové foto 512x512px)

• Project lead (jméno, email, společnost)

a následující volitelné:

• Odkaz na GitHub repozitář
• Odkaz na Trello
• Odkaz a jméno Slack kanálu projektu
• Tagy (jméno a slug, cs a en)

Zadání dat

Projekt je doporučeno vložit pomocí těchto kroků: 

1. Nahrát veškeré obrázky a získat jejich URL adresy (viz níže)
2. Otevřít AirTable pro web a tabulku Projects
3. Zadat všechna data zmíněná výše kromě dobrovolníků, project leada a tagů (obrázky vkládat jako URL)
4. Přepnout na tabulku ProjectRoles a vložit jednotlivé dobrovolníky (v sloupci volunteer lze vyhledat, zda dobrovolník už existuje a lze využít existující záznam)
5. Pokud project lead není součástí dobrovolníků, přepnout na tabulku Volunteers a založit mu záznam
6. Přepnout na tabulku Projects a vyplnit project lead
7. Nasadit web (viz níže)

Obrázky

Obrázky jsou zatím nejvíce složitá část (plánujeme zlepšení), proto lze poprosit Tomáš Znamenáček nebo horm (Unlicensed) o asistenci. Všechny obrázky na webu jsou hostovány na data.cesko.digital a jejich v kládání/aktualizace probíhá přes tento repozitář. Po jejich nahrání mám k dispozici adresu, kterou lze vložit do AirTable. Např. data.cesko.digital/people/generic.png je univerzální profilový obrázek, který lze využít u dobrovolníka, u kterého nemáme fotografii. 

Nasazení

Nasazení probíhá přes Vercel. Buď v jeho administraci nebo přes speciální odkaz, který si lze vyžádat u jednoho z tech leadů. Před samotným nasazením je nutné mít jistotu, že všechna data jsou kompletní. 

Dodatečné poznámky

• Nezapomenout na nezlomitelné mezery. Ty lze do textu v AirTable vložit pomocí jako tento speciální znak.