Jak zadávat data na web

Owned by horm
Last updated: 26. March 2021

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