# NÁVODY K SYSTÉMŮM STRANY Tento sdílený dokument slouží k sestavení jednotného přehledu systémů a uživatelských návodů k nim. Dále by měl sloužit k finálnímu převzetí příslušným odborem a tím k jejich zoficiálnění. Tento dokument je **pracovní** verzí, která by měla být průběžně upravována a doplňována. ## Co všechno se u nás najde (přidávejte co vám chybí) ### Přehled [TOC] ## S čím neumím a potřeboval bych návod **Zde se nachází prostor pro vaše návrhy na co by se vám hodil návod** Webové stránky (Jekyll). Obsluha z pohledu "redaktora", schéma uspořádání souborů, lokální úpravy vzhledu (písma, pozadí, obrázky) ## Šikovné fígle pro práci s počítačem ### pro Windows * screenshot části obrazovky, klávesová zkratka WIN+SHIFT+S ### ## Návody: * * * * **Odkazy na wiki:** https://wiki.pirati.cz/navody/start - seznam všech návodů na wiki https://wiki.pirati.cz/navody/navod - návod jak psát návody na wiki * * * ### Asset-server - úložiště médií pro vkládání na web #### Úvod *Asset-server* slouží k publikování dříve uložených obrázků na webu. Vhodným formátováním odkazu dokáže obrázek upravit na požadovanou velikost, případně oříznout. Díky *Asset-serveru* navíc získáte přímý odkaz na daný obrázek. #### Jak to funguje? Jednoduše! Obrázky nahrajete do složky na [mraku](https://mrak.pirati.cz) a *asset-server* se postará o zbytek. Do úložiště (*asset-storage*) je doporučováno nahrávat následující typy souborů: *.jpg *.png *.svg *.pdf. Před nahráním jiných souborů nebo při souborech větší velikosti (>100 MB) se poraďte s TO #### Struktura 1. Na mraku si vytvoříte složku pro *asset-storage*. Vzhledem k možnosti nastavení oprávnění je vhodné takto vytvořit podsložku ve skupinové složce. 2. Pro projekt si zvolíte vlastní *zkratku* (pro web např. praha.pirati.cz, pro odbor např. to, mo) 3. Do [podatelny TO](https://redmine.pirati.cz/projects/to/issues/new) podáte žádost o vytvoření nové adresy. Do žádosti uvedete následující: 3.1. Popis složky na mraku (přesná specifikace - název group folder nebo uživatelské jméno v případě soukromé složky a název složky) 3.2. zvolená *zkratka* 4. Po zpracování žádosti technickým odborem naleznete obsah celé vaší složky (synchronizace jednou za 5 minut) na adrese https://a.pirati.cz/zkratka Cokoliv se nahraje do složky se překopíruje na server. Tyto soubory nelze smazat, ale můžete je 'přepsat' souborem se stejným jménem a odkazem. Velmi dobře zvažujte názvy souborů, aby byly dobře zapamatovatelné a napsatelné. Název obrázku bude součástí url, vyhněte se proto mezerám, háčkům velkým písmenům, dlouhým číslům nebo názvům. Příklady dobrých názvů souborů: * povolebni-strategie-msk.pdf * barton-opreny-o-strom.jpg * logotyp-pirati-a-stan.svg #### Syntaxe Jako příklad použijeme obrázek uložený v media storage TO * **odkaz do složky na asset-serveru** https://a.pirati.cz/to/img/ * **odkaz přímo na obrázek** (plná velikost) https://a.pirati.cz/to/img/it.jpg * **úprava obrázku** * **změna velikosti** - provádí se přidáním **resize/WxH** do odkazu na obrázek, kdy W je šířka obrázku v pixelech a H výška. Při změně velikosti se nemění poměr stran. * šířka 200 px - https://a.pirati.cz/resize/200x-/to/img/it.jpg * výška 200 px - https://a.pirati.cz/resize/-x200/to/img/it.jpg * pokus o šířka 400 px a výška 200 px - https://a.pirati.cz/resize/400x200/to/img/it.jpg - disproporční šířka je ignorována (výsledek je 168x200 px) * **ořezávání** - provádí se přidáním **crop/WxH** do odkazu * ořez na 400x200 px - https://a.pirati.cz/crop/400x200/to/img/it.jpg Asset-server lze nastavit od jekyll-theme-pirati verze 7.7.0 a používaji ho i některé dalši weby. Můžete jen používat i pro přímé odkazování. 🔝 [Zpět](#Přehled) * * * ### CodiMD - systém pro spolupráci na textech 🌏 codimd.pirati.cz #### Úvod CodiMD slouží k editaci textu v jazyku markdown. Výhoda CodiMD spočívá v okamžitém náhledu zformátovaného textu a také spolupráce v reálném čase více lidí na jednom projektu. :::info Definice markdown z wikipedie: Markdown je odlehčený značkovací jazyk, který slouží pro úpravu prostého textu a jeho následný převod na formátovaný text publikovatelný na webu, zejména ve formátu HTML. Umožňuje pomocí jednoduchých formátovacích značek vyznačit v textu nadpisy a seznamy, doplnit odkazy, obrázky atd. Cílem jazyka je, aby byl text dobře čitelný a publikovatelný i v původním formátu prostého textu ::: #### Základy * Na úvodní stránce na adrese codimd.pirati.cz můžete vytvořit nový dokument jako host (guest) nebo se přihlásit pomocí [Pirátské identity](auth.pirati.cz)  * Po přihlášení se nový dokument vytváří pomocí tlačítka  * (nový dokument můžete vytvořit i zadáním názvu za lomítko v adrese - výhodou je snadno zapamatovatelný název, např. codimd.pirati.cz/návody) * Nyní k jednotlivým prvkům v horní liště  *  - Režim prohlížení formátovaného textu *  - Režim dvou oken - levé okno pro formátování textu, pravý sloupec pro náhled formátovaného textu *  - Režim pouze editačního okna pro formátování textu *  - Noční režim - přepíná náhledové okno na černé/bílé pozadí *  - Otevře plovoucí okno s nápovědou k formátování textu (zjednodušený přepis je níže) *  - nahrání obrázku přímo do dokumentu * Pravá část lišty  *  - Nová poznámka *  - Otevře nové okno v režimu náhledu s novou URL a bez možnosti editace *  - Zobrazí seznam lidí online *  *  - Zobrazí seznam editací s možností obnovení starší verze *  - Režim prezentace *  - Import dokumentu z Gist nebo schránky *  - Stažení dokumentu v příslušném formátu #### Formátování textu a jiné úpravy. Ne všechny příklady se v tabulce zobrazují korektně, proto jsou jejich příklady uvedeny pod tabulkou. | Syntaxe | Příklad | Poznámka | | ------------------------- | ---------------------------------------------------------------- | ---------------------------------------------- | | # Nadpis | # Nadpis | přidáním # se vytvoří další úroveň nadpisu | | * list | * seznam | nečíslovaný seznam (odrážky) | | 1. list | 1. list | číslovaný seznam | | - [ ] checklist | - [ ] checklist | mezi hranatými závorkami je mezera | | > citace/zvýraznění | > citace/zvýraznění | | | `**tučně**` | **tučně** | mezi symbolem a textem není mezera | | `*kurzíva**` | *kurzíva* | mezi symbolem a textem není mezera | | `~~přeškrtnuto~~` | ~~přeškrtnuto~~ | mezi symbolem a textem není mezera | | `^horní_index^` | ^horní_index^ | horní index pro text mezi ^^ (bez mezer) | | `~dolní_index~` | ~dolní_index~ | dolní index pro text mezi ^^ (bez mezer) | | `++podtržený text++` | ++podtržený text++ | | | `==zvýrazněný text==` | ==zvýrazněný text== | | | `[popis odkazu](odkaz )` | [popis odkazu](https://pirati.cz) | | | `` |  | | | `:smile:` | :smile: | klasicky emoji pomocí dvojteček | Příklady, které se nezobrazovaly v tabulce #### nadpis 4. úrovně (4 # ) * odrážka 1. číslovaná odrážka - [ ] check list > citace/zvýraznění `[TOC]` - vytvoří automatický seznam nadpisů do úrovně ### 🔝 [Zpět](#Přehled) * * * ### Evidence - evidence kontaktů a schůzek 🌏 evidence.pirati.cz 🔝 [Zpět](#Přehled) * * * ### Fórum - tak víme, ne * Stávající návod na wiki wiki.pirati.cz/ao/navody/forum * Obrázkový návod v PDF wiki.pirati.cz/_media/po/vzdelavani/navodnovacek_v2.pdf 🌏 forum.pirati.cz 🔝 [Zpět](#Přehled) * * * ### Gravatar - profilový obrázek 🌏 gravatar.com 🔝 [Zpět](#Přehled) * * * ### Helios - hlasování * Stávající návod na wiki wiki.pirati.cz/ao/navody/helios 🌏 helios.pirati.cz 🔝 [Zpět](#Přehled) * * * ### Jitsi - videokonference 🌏 jitsi.pirati.cz #### Úvod Jitsi slouží pro jednoduchou videokonferenci prostřednictvím webového prohlížeče. Mimoto existují aplikace na mobilní telefon (Android, iOS) nebo počítač. #### Webové rozhraní :::danger Některé prohlížeče mohou mít problémy se správným fungováním. Je proto dobré před důležitým jednáním ozkoušet kombinaci prolížečů u všech účastníků. ::: Úvodní obrazovka se nachází na adrese jitsi.pirati.cz (alternativně lze použít i meet.jit.si) Pokud zakládáte novou místnost, napíšete do pole *Začít nový videohovor* vhodný název podle účelu (RP, schuzeKSpraha, jednaniRV, apod.). Adresa takto vzniklé místnosti bude jitsi.pirati.cz/ *"název místnosti"* V případě, že jste pozváni do otevřené místnosti, zadáte její název. #### Desktopová aplikace (Windows) Pro počítače lze použít desktopovou aplikace, která je ke stažení na https://github.com/jitsi/jitsi-meet-electron/releases/latest/ pro windows stáhněte soubor `jitsi-meet.exe` #### Profilová obrázek Pokud chcete využít v jitsi vlastní profilový obrázek, načte se díky službě **Gravatar** na základě vylněné e-mailové adresy. 🔝 [Zpět](#Přehled) * * * ### Lidé - ověření identity, kontakty, profily 🌏 lide.pirati.cz 🔝 [Zpět](#Přehled) * * * ### Mumble - Audiokecálek (něco jako Skype) * Stávající návod na wiki wiki.pirati.cz/to/navody/mumble 🔝 [Zpět](#Přehled) * * * ### Mrak - nejen úložiště * Rozpracovaný návod na wiki wiki.pirati.cz/regiony/moravskoslezsko/nextcloud_guide 🌏 mrak.pirati.cz 🔝 [Zpět](#Přehled) * * * ### Nalodění - vstupní stránka pro nováčky, nastavování newsletterů 🌏 nalodeni.pirati.cz 🔝 [Zpět](#Přehled) * * * ### Pirátská identita - jednotné přihlášení, nastavení hesla do fóra 🌏 auth.pirati.cz 🔝 [Zpět](#Přehled) * * * ### Piroplácení - proplácení účtů 🌏 piroplaceni.pirati.cz 🔝 [Zpět](#Přehled) * * * ### Redmine - podatelna a úkolovník 🌏 redmine.pirati.cz 🔝 [Zpět](#Přehled) * * * ### Webové stránky * Stávající návod na github github.com/pirati-web/pirati.cz/blob/gh-pages/navod.md 🌏github.com/pirati-web 🔝 [Zpět](#Přehled) * * * ### Zulip - instant messenger * Stávající návod na wiki wiki.pirati.cz/to/navody/zulip 🌏 Zulip.pirati.cz 🔝 [Zpět](#Přehled) * * *