Zulip, uživatelská příručka Piráta

Toto je uživatelská příručka pro Pirátskou instanci Zulip na adrese: https://zulip.pirati.cz/

Pokud nechceš, nemusíš číst příručku celou, ale jednoduše přeskoč na téma, které tě zajímá.

„A čo si, Kefalín, predstavujetě pod hen takým slovom Zulip?” zeptal by se nejspíš major Haluška, kdyby od velení dostal rozkaz používat tuto aplikaci a možná se stejně ptáš i ty a je to dobrá otázka.

Zulip je chatovací aplikace, podobně jako Messenger, nebo dříve u nás dobře známé ICQ, ale na rozdíl od těchto aplikací se soustředí na týmovou spolupráci, takže některé věci mohou fungovat jinak, než bys čekal(a) a při prvním nakouknutí se ti může zdát trošku nepřehledný - ale neboj se, všechno důležité si povíme a zjistíš, že je to docela snadné.

Hlavní rozdíl mezi Instant Messagingem (IM), tedy rychlým zasíláním zpráv mezi dvěma, nebo dnes už i více uživateli a Collaboration Chatem (CC), tedy komunikace pro spolupráci, je v zaměření nikoliv na uživatele, ale spíše na témata.

Zatímco třeba u Messengeru vidíš v aplikaci seznam svým kontaktů, kterým můžeš o něčem napsat, u Zulipu vidíš seznam kanálů (jsou uvozeny znakem „#”).

Kanál může být třeba nějaký projekt nebo například organizační jednotka, jako zde kanál našeho MSK Technického odboru:

<TODO Add zulip03.png>

Do samotného kanálu nejde psát zprávy, jedná se spíše o jakýsi kontejner, který sdružuje jednotlivá témata. která se k danému kanálu váží.

Kanály mají také další důležité funkce, které najdeš níže.

V Zulipu existují tři druhy kanálu:

• Veřejný - do tohoto kanálu se může připojit každý uživatel a může vidět celou historii komunikace v tématech tohoto kanálu. Je oznažen ikonou „#”
• Soukromý se sdílenou historií - tento kanál vidí jen uživatelé, kteří byli do kanálu pozváni (a samozřejmě administrátoři Zulipu). I nově pozvaní uživatelé mohou vidět celou historii komunikace v tématech tohoto kanálu. Je označen ikonou zámku.
• Soukromý s chráněnou historií - prakticky stejný jako předchozí varianta, jen nový uživatel neuvidí historii komunikace. Je také označen ikonou zámku.

Do každého kanálu můžeš pozvat uživatele, se kterými chceš spolupracovat na daných tématech. Pamatuj, že uživatel kanálu může vidět všechna obsažená témata.

Pokud se jedná o veřejný kanál, může se kterýkoliv uživatel ke kanálu přidat sám.

Pokud se jedná o soukromý kanál, musí být uživatel pozván, protože soukromé kanály nejsou jinak vidět.

Na každém kanálu lze nastavit jinou sadu pravidel, jak se chceš dovídat o nových zprávách (pokud chceš mít všude stejná pravidla, nastav si je ve svém profilu a na kanálech pak už nemusíš nic nastavovat). To zahrnuje vizuální a zvuková oznámení, mobilní oznámení a oznámení emailem.

Pokud už nechceš v kanálu diskutovat, můžeš jednoduše zrušit odběr, nebo pokud jen nechceš dostávat notifikace o nových zprávách, můžeš je ztlumit, takže uvidíš, nové zprávy, když budeš chtít, ale nebudou tě obtěžovat upozornění na ně. Ztlumení lze samozřejmě kdykoliv zrušit.

<TODO Add zulip12.png>

Téma je prostor k diskuzi k danému tématu. Pokud by existoval třeba kanál Babiš, mohla by se pod ním nacházet témata jako - Kostelecké uzeniny bez masa, Čapí hnízdo, nebo Agentem STB snadno a rychle. Všechna tato témata se váží ke stejné osobě/kanálu, ale jsou diametrálně odlišná. Pokud během diskuze vyplyne nové téma, mělo by se založit, místo jeho diskuze ve vláknu jiného tématu. Již založená témata však nelze smazat (jdou pouze ztlumit), takže nevytvářej nová témata pro marginální věci.

Pokud potřebuješ oslovit jiného kolegu v nějaké osobní záležitosti, mimo téma atd., tak nezakládej nové téma, ani nerozjížděj off-topic diskuzi, ale kontaktuj jej pomocí Soukromé zprávy.

Do nové zprávy v tématu lze vkládat smajlíky (emoji), soubory a odkazy na videohovory pomocí Jitsy. Formátovat text lze pomocí značkovacího jazyka Markdown - je to snadné a Zulip ti poskytne nápovědu.

Pokud chceš v tématu oslovit konkrétního kolegu nebo kolegy, použij v textu řetězec '@uživatelské_jméno'. Přesné uživatelské jméno si nemusíš pamatovat po napsání znaku '@' ti Zulip napoví.

Své příspěvky v tématu můžeš upravovat, ale jen po určitou dobu po odeslání příspěvku, tuto dobu nastavuje administrátor a na našem Zulipu je to 60 minut.

K příspěvkům můžeš přidávat emoji, případně si je označit hvězdičkou. Zprávy označené hvězdičkou pak nalezneš v menu „Zprávy s hvězdičkou”.

Také lze zkopírovat text příspěvku, případně zkopírovat odkaz na příspěvek. Pokud tě dané téma nezajímá, můžeš jej ztlumit.

<TODO Add zulip12.png>

Zulip lze používat přímo z webového prohlížeče na adrese https://zulip.pirati.cz, nebo si lze nainstalovat klient pro Windows, Linux, OS X, nebo mobilní klient pro Android a iOS odsud.

Přihlášení se liší podle toho, zda jsi členem strany, nebo příznivce, případně spolupracovník:

• Člen strany se přihlašuje pomocí Pirátské identity, pro webový klient na této adrese.

<TODO Add zulip01.png>

<TODO Add zulip02.png>

• Příznivci a spolupracovníci musí obdržet pozvánku od člena, který již na Zulipu je.

<TODO Add zulip04.png>

Pravidla pro zasílání pozvánek pro nečleny jsou:

• Nastavit oprávnění „Hosté”.
• Nastavit konkrétní kanály, kam je nezbytný přístup.

<TODO Add zulip05.png>

Menu „Nastavení” se objeví po stisknutí klávesy 'g' nebo kliknutím myší na ozubené kolo v pravém horním rohu okna - viz obrázek.

<TODO Add zulip06.png>

Najdeš tam tyto položky:

• Spravovat kanály - Umožní ti nastavit, které kanály chceš vidět v seznamu kanálů.
• Nastavení - Nastavení tvého účtu. K detailům se vrátíme níže.
• Nastavení organizace - Do tohoto menu se dostaneš i z položky „Nastavení”, ale úpravy zde mohou dělat jen správci organizace.
• Centrum nápovědy - Odkáže na webovou nápovědu (v angličtině) na této adrese: https://zulip.pirati.cz/help/
• Klávesové zkratky - Velmi užitečný seznam klávesových zkratek pro ovládání Zulipu.
• Formátování zprávy - Seznam Markdown tagů pro formátování textu zprávy. Je to snadné a užitečné i jinde, než jen na Zulipu
• Operátory pro vyhledávání - Vyhledávání zpráv v Zulipu je velmi mocné a v tomto menu je návod, jak na to.
• Desktopové a mobilní aplikace - Odkaz na web, kde je možné stáhnout desktopového nebo mobilního klienta.
• Integrace - Odkaz na web se seznamem aplikací, které nějak integrují Zulip.
• Dokumentace k API - Seznam na web, který bude zajímat hlavně programátory.
• Statistiky - Různé statistiky o využívání Zulipu.
• Pozvat uživatele - Umožňuje pozvat uživatele, kteří nejsou členy strany, nebo jsou, ale o Zulipu ještě nevědí.
• Ohlásit se - Tohle nepotřebuješ, protože už nikdy nebudeš chtít odejít

Menu „Nastavení” se dělí na několik sekcí:

<TODO Add zulip06.png>

• Váš účet - V tomto menu můžeš nastavit svůj profil, nahrát si profilový obrázek, nebo použít obrázek ze služby Gravatar atd.
• Zobrazit nastavení - Zde najdeš nastavení jazyku klienta, je možné zde nastavit zda se má použít noční režim, který přepne klienta do černé barvy, rozhraní klienta, formát času, zobrazování emoji atd.
• Oznámení - Velmi důležité menu, které ti umožní velmi detailně nastavit notifikace. Věnuj tomuto nastavení dostatek času a nastavit si notifikace tak, aby jsi vždy věděl o všem důležitém na Zulipu a zároveň, aby tě notifikace zbytečně neobtěžovaly
• Vaši roboti - Tohle je vyšší dívčí. Pokud jsi programátor, tak na to přijdeš sám a pokud ne, tak rovnou přeskoč na další pokožku v menu
• Sledovaná slova - Zde můžeš nastavit klíčová slova a pokud je někdo použije ve zprávě, dostaneš upozornění.
• Nahrané soubory - Velmi užitečné menu, najdeš zde všechny soubory, které jsi nahrál na Zulip. Můžeš je zde smazat nebo si je znovu stáhnout.
• Ztlumená témata - Opět velmi užitečné menu, najdeš zde všechna témata která jsi „Ztlumil”, tedy zakázal jsi u nich aby tě upozorňovaly na nové zprávy. Je možné jde zde opět odblokovat.

Zulip může na první pohled vypadat trochu zmateně, ale po letmém osahání zjistíš, že je to vlastně velmi jednoduchý a zároveň velmi mocný nástroj. Pojďme se s ním seznámit trochu blíž.

<TODO Add zulip03.png>

Nahoře najdeš seznam připojených serverů, určitě tam bude náš pirátský Zulip, ale pokud znáš více organizací, které Zulip používají, nebo máš dokonce vlastní Zulip server, všechny je můžeš připojit do jediného klienta a mít je pěkně pohromadě.

V dolní části z hora najdeš tyto položky:

• Zvonek - Zapínání / Vypínání režimu nerušit.
• Reload - Zulip, včetně klienta pro desktop nebo pro mobil je postavený na webových technologiích a občas se může stát, že neuvidíš novou zprávu, nebo naopak nezmizí upozornění na již přečtenou. Toto tlačítko funguje podobně, jako to ve tvém webovém prohlížeči a po stisknutí znovu načte stránku v klientu.
• Šipka zpět - Vrátí tě na předchozí kanál nebo téma.
• Nastavení aplikace - Zde lze přidat další organizaci ('+' v levém vertikálním menu) a nastavit chování Zulip klienta - zobrazování ikony v systémovém menu, zobrazování notifikací, natavení upgradů aplikace (General), nastavení proxy (Network), odpojení od organizace (Organizations) a je zde také seznam klávesových zkratek (Shortcuts).

Zleva jsou tyto položky:

• Název Kanálu ve kterém se nacházíš.
• Název Tématu ve kterém se nacházíš.
• Vyhledávací pole.
• Menu.
• Menu se seznamem uživatelů (pokud je okno klienta dostatečně roztažené, zobrazí se rovnou seznam uživatelů).

Zleva jsou tyto položky:

• Koncepty - Seznam rozepsaných a neodeslaných zpráv. Zde můžeš pokračovat v jejich editaci nebo je smazat. Koncepty starší než 30 dní se automaticky mažou.
• Nové téma - Umožňuje napsat novou zprávu. Do pole _Kanál_ začni psát název požadovaného kanálu, do pole _Téma_ napiš existující téma, nebo tak můžeš vytvořit téma nové. Pak už jen stačí napsat zprávu (k tomu se dostaneme v kapitole o formátování textu). Když opustíš rozepsanou zprávu, uloží se do „Konceptů” a později v ní můžeš pokračovat. Pokud chceš koncept zprávy zrušit, zmáčkni křížek v pravém horním rohu editačního okna.
• Nová soukromá zpráva - Funguje analogicky jako položka „Nové téma” jen umožňuje napsat soukromou zprávu. Do horního pole zadej jméno nebo jména požadovaných příjemců.
• Odpovědět - Po stisknutí tohoto tlačítka se v editačním okně automaticky předvyplní „Téma” a „Kanál” podle pozice kurzoru v okně s konverzacemi. Toho lze dosáhnout i kliknutím myši na požadovanou konverzaci.