Změny dokumentu 20 Uživatelská příručka

Naposledy upravil David Brazda 15.02.2021 16:06

Z verze

změnil(a) David Brazda
k 21.12.2020 14:13

Na verzi < 124.1 >

změnil(a) David Brazda
k 21.12.2020 14:51

< >

Popis verze: Nahrát novou přílohu 1608556357510-165.png

Rozpis
Vizuál

Přehled

Na stránce změněno: (1 změněno, 0 přidáno, 0 odstraněno)

Rozpis

Na stránce změněno:

Obsah

@@ -1,113
          +1,142 @@
++Tato stránka popisuje dostupné funkcionality.
++
  {{toc/}}
--= Úvod =
++= Komentáře =
--Stránky lze používat buď jako
++== Standardní komentáře ==
--* anonymní uživatel - přístup pouze pro čtení
--* registrovaný uživatel - po [[registraci>>https://www.pgwiki.cz/xwiki/bin/register/XWiki/XWikiRegister]] lze přidávat komentáře, notifikace o komentářích chodí na email.
--* registrovaný uživatel s právem editor - lze upravovat a vytvářet nové stránky
++== Inline komentáře (anotace) ==
--= Registrace =
++Kromě standardních komentářů pod stránkou lze také navázat komentář přímo k určité části textu pro lepší cílení komentářů.
--Registrace je dostupná [[zde>>https://www.pgwiki.cz/xwiki/bin/register/XWiki/XWikiRegister]]
++{{success}}
++Text na stránce stačí označit a klávesovou zkratkou **Ctrl + M** nebo **CMD + M **vyvolat vytvoření inline komentáře.
++{{/success}}
--Po registraci lze přidávat komentáře a jsou zapnuty notifikace.
++Alternativní zkratka je  Ctrl + I nebo CMD + I
--Při přidávání komentáře lze také označit určitého uživatele v textu zadánín "@" a výběrem jména uživatele.
++(% style="text-align:center" %)
++[[image:1606294034475-348.png||queryString="width=598&height=352" height="352" width="598"]]
--== Defaultní nastavení notifikací ==
++Text s navázaným komentářem je poté na stránce zvýrazněn žlutě a proklikem na žlutý čtverec lze komentář(e) zobrazit, odpovědět a po zapracování/vysvětlení smazat.
--Defaultně jsou nastaveny notifikace tak, že
++(% style="text-align:center" %)
++[[image:1606523504989-261.png]]
--* na email chodí notifikace o přidaných komentářích nebo odpovědi na komentář nebo při označení uživatele
--* ostatní změny jako přidané a upravené stránky chodí pouze do ikonky zvonku [[image:1608556357510-165.png||height="33" width="31"]]
++Inline komentáře jsou také zobrazeny v **tabu Comments**.
++TIP: Zvýraznění textů s navázanými komentáři lze vypnout pomocí Alt+A (option-A).
--Stránky jsou uloženy v adresářové struktuře vlevo.
++== Odkaz na konkrétní komentář ==
--Lze je prohlížet jako anonymní uživatel a nebo se registrovat, což umožní další funkcionality jako komentáře nebo sledování změn (watch - pod ikonkou zvonku). Dají se používat i zmínky(@Jmeno) a dané osobě pak přijde notifikace.
++V psaném textu lze také odkazovat na konkrétní komentář uložený u libovolné stránky. Link na konkrétní komentář se získá kliknutím na datum u konkrétních komentáře.
--Stránky lze také vytvářet nebo upravovat kliknutím na tlačítko Edit (vyžaduje právo Editor). Pro editaci se používá jednoduchý editor, podporující vkládání obrázků a embed videa.
++[[image:1606834701031-136.png]]
--Všechny změny stránky jsou uložené jako revize a lze se k nim kdykoliv vrátit.
++Link lze pak [[použít>>https://www.pgdenik.cz/xwiki/bin/view/99%20Rozpracovan%C3%A9/20%20Jak%20pracovat%20s%20XWiki/?viewer=comments#xwikicomment_0]] kdekoliv v textu. Kliknutím na link je zobrazena stránka s výrazněným komentářem.
--= Uživatelská práva =
++[[image:1606834906235-704.png||queryString="width=617&height=157" height="157" width="617"]]
--Aktuálně jsou nastaveny tyto úrovně přístupu
++= Editace stránek =
--* **anonym** - zobrazí veřejné stránky, může se registrovat
--* **nově registrovaný uživatel** (dostává automaticky právo **Reader**) - umožní navíc
--** komentáře
--** sledování stránek(W//atch this page// pod ikonou zvonku)
--** mentions - možnost zmínit v textu ostatní uživatele
--* **uživatel editor** (administrátor musí uživateli přiřadit právo **Editor**) - editace, mazání
--* admin (právo **Admin**) - delete, admin
--= Práce s obsahem =
++== Vytvoření stránky ==
--* komentáře
--* notifikace
--* odkazování na jiné stránky v rámci platformy
--* úprava existujících stránek [[image:1606223725498-311.png||queryString="width=88&height=51" height="39" width="67"]]
--* vytváření nové stránky[[image:1606223741104-877.png||queryString="width=85&height=45" height="46" width="87"]]
--* přejmenování/přesunutí stránky
++//Předpoklad: Právo editor.//
--== Komentáře ==
++Stránku lze vytvořit buď ručně nebo kliknutím na prázdnou stránku.
--Kromě standardních komentářů pod stránkou, lze také používat **inline komentáře** - tzn. navázat komentář přímo k určité části textu pro lepší cílení komentářů.
++=== Ručně ===
--{{success}}
--Text na stránce stačí označit a klávesovou zkratkou **Ctrl + M** nebo **CMD + M **vyvolat vytvoření inline komentáře.
--{{/success}}
++1. V Menu vybrat sekci, kam nová stránka patří
++1. Kliknout na [[image:https://www.xwiki.org/xwiki/bin/download/Documentation/UserGuide/GettingStarted/CreatingAPage/create-icon.png?width=100&rev=1.2||alt="create-icon.png"]]
++1. V následující obrazovce zadat název nové stránky, upravit případné umístění v menu a vybrat nejlépe některou z šablon (**[[Šablony>>xwiki:20 Jak pracovat s XWiki.Šablony.WebHome]] **jsou aktuálně pro **Analýzy letů a Články**) a nebo vybrat prázdnout stránku. V šabloně jsou vyplněny věci jako obsah a návrh struktury, což ušetří práci.
--Alternativní zkratka je  Ctrl + I nebo CMD + I
--
  (% style="text-align:center" %)
--[[image:1606294034475-348.png||queryString="width=598&height=352" height="352" width="598"]]
++[[image:https://www.xwiki.org/xwiki/bin/download/Documentation/UserGuide/GettingStarted/CreatingAPage/create-formular.png?width=650&rev=1.4||alt="create-formular.png"]]
--Text s navázaným komentářem je poté na stránce zvýrazněn žlutě a proklikem na žlutý čtverec lze komentář(e) zobrazit, odpovědět a po zapracování/vysvětlení smazat.
++=== Kliknutím na prázdnou stránku ===
++Během editace si můžu vytvořit [[odkaz na neexistující stránku>>xwiki:20 Jak pracovat s XWiki.Nová stránka.WebHome]] jednoduše výběrem textu a označením jako link (u odkazu se pak objeví otazník). Když na tuto stránku někdo klikne automaticky se otevře wizard na její vytvoření. To se hodí při úpravě textu při identifikaci oblastí, které bude potřeba v budoucnu pokrýt.
++
++== Editace stránky - práce s editorem ==
++
++//Předpoklad: Právo editor.//
++
++**Editaci lze zahájit**
++
++* na dané stránce pomocí tlačítka [[image:https://www.pgdenik.cz/xwiki/bin/download/99%20Rozpracovan%C3%A9/20%20Jak%20pracovat%20s%20XWiki/WebHome/1606223725498-311.png?width=88&height=51&rev=1.1||alt="1606223725498-311.png" height="51" width="88"]]
++* případně na úrovni odstavce pomoci ikonky  [[image:1606823274931-438.png]]
++
++**Pravidla**
++
++* strukturovat text pomocí nadpisů(((
  (% style="text-align:center" %)
--[[image:1606523504989-261.png]]
++[[image:1606220336280-721.png]]
++)))
--Inline komentáře jsou také zobrazeny v **tabu Comments**.
++=== Obrázky ===
--TIP: Zvýraznění textů s navázanými komentáři lze vypnout pomocí Alt+A (option-A).
++Obrázky lze do textu kopírovat přímo ze schránky (nejrychlejší) a nebo uploadnout soubor pomoci Ikony obrázku [[image:1606219730209-955.png]]
--== Odkaz na konkrétní komentář ==
++Přípdně lze přidat obrázek(jakýkoliv obsah) s nadpisem pomocí tagu Figure (TBD přidat jako ikonu do editoru)
--V psaném textu lze také odkazovat na konkrétní komentář uložený u libovolné stránky. Link na konkrétní komentář se získá kliknutím na datum u konkrétních komentáře.
++{{figure}}
++[[image:1607590441627-905.png||alt="Macaque in the trees" data-widget="image" height="314" width="588"]][[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Klepněte a táhněte pro přesunutí" width="15"]]
--[[image:1606834701031-136.png]]
++[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Klepněte a táhněte pro přesunutí" width="15"]]
++{{/figure}}
--Link lze pak [[použít>>https://www.pgdenik.cz/xwiki/bin/view/99%20Rozpracovan%C3%A9/20%20Jak%20pracovat%20s%20XWiki/?viewer=comments#xwikicomment_0]] kdekoliv v textu. Kliknutím na link je zobrazena stránka s výrazněným komentářem.
++=== Další funkce ===
--[[image:1606834906235-704.png||queryString="width=617&height=157" height="157" width="617"]]
++* odkaz na jinou stránku na pgdeniku - hranatá závorka plus začít psát název stránky viz (((
++(% style="text-align:center" %)
++[[image:1606219999849-696.png]]
++)))
--== Notifikace/Upozornění ==
++* důležitý text lze zvýraznit pomocí info boxu (((
++(% style="text-align:center" %)
++[[image:1606220195696-569.png]]
++)))
--Oblasti, které mě zajimají můžu sledovat - budu upozorněn na změny.
++{{warning}}
++Info box lze použít pro zvýraznění důležitého textu, např. pravidla.
++{{/warning}}
--Nastavení je pod ikonkou zvonku([[image:1606827296491-344.png]]) - jsou následující tři přepínače. Nastavením přepínače lze nastavit jaké stránky budou sledovány.
++* ve stejném menu lze do stránky přidat **Table of Contents(obsah)**
++* (% id="cke_bm_402S" style="display:none" %) (%%)zmínka uživatele v textu (pomocí @ a jméno uživatele {{mention reference="XWiki.DavidBrazda" style="FULL_NAME" anchor="XWiki-DavidBrazda-p8ozkb"/}}) uživateli přijde notifikace
--[[image:1606827099654-659.png||queryString="width=268&height=162" height="162" width="268"]]
++=== Embedování videa ===
--Nové úpravy jsou pak zobrazeny v seznamu pod ikonkou zvonku [[image:1606827919991-280.png]]
++**Embedovat youtube video** lze pomoci **makra**. Přidání makra je pomocí ikony [[image:1606222063158-249.png]]kde se zvolí macro **Video**
--[[image:1606827956197-827.png||queryString="width=237&height=392" height="392" width="237"]]
++(% style="text-align:center" %)
++[[image:1606222021692-690.png||queryString="width=347&height=305" height="305" width="347"]]
++{{video url="https://www.youtube.com/watch?v=YtoUSJLr1Lg?start=21"/}}
--Emailové notifikace, četnost odesílání a úroveň detailu lze také nastavit v profilu uživatele (ikonka uživatele [[image:1606827255550-611.png]]) v sekci Notifications.
--[[image:1606828373969-488.png||queryString="width=594&height=212" height="212" width="594"]]
++Další možnosti embedování a to včetně je pomocí iframe (TBD popsat detailněji) - zde lze embedovat videa i s aktuálním časem(např. toto začíná v 5:27)
++{{velocity}}{{html clean="false"}}
++## Chrome's XSS Auditor blocks the preview action if:
++## * the submitted content has an iframe with an external URL
++## * the preview action displays the submitted iframe
++## The workaround is to make sure the submitted content (the macro markers) don't match the preview HTML.
++## See XWIKI-14818: Preview triggers ERR_BLOCKED_BY_XSS_AUDITOR in Chrome
++#set ($iframe = 'iframe')
++<iframe width="560" height="315" src="https://www.youtube.com/embed/39BSTcz2v7g?start=327" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
++{{/html}}{{/velocity}}
--== Link na jinou stránku ==
--Odkaz na jinou stránku v rámci platformy lze jednoduše vytvořit napsáním "[" a pokračování textu názvu. Našeptávač zobrazí odpovídající názvy stránek a enter vytvoří link. Např. link na [[10 Jak na kravatu>>xwiki:Tipy a triky.Jak na kravatu]]. Intuitivní odkazování snížuje redundanci textu.
++Další detaily zde [[https:~~/~~/extensions.xwiki.org/xwiki/bin/view/Extension/CKEditor%20Integration/Features/>>https://extensions.xwiki.org/xwiki/bin/view/Extension/CKEditor%20Integration/Features/]]
--[[image:1606822958834-728.png||queryString="width=265&height=173" height="173" width="265"]]
++=== Klávesové zkratky v editoru ===
++Ctrl+K vytvoří link
++
++Ctrl+B **bold**
++
  == Vytvoření stránky ==
  //Předpoklad: Právo editor.//
@@ -150,11
          +150,9 @@
  Přípdně lze přidat obrázek(jakýkoliv obsah) s nadpisem pomocí tagu Figure (TBD přidat jako ikonu do editoru)
  {{figure}}
--[[image:1607590441627-905.png||alt="Macaque in the trees" height="314" width="588"]]
++[[image:1607590441627-905.png||alt="Macaque in the trees" data-widget="image" height="314" width="588"]][[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Klepněte a táhněte pro přesunutí" width="15"]]
--{{figureCaption}}
--Obrazek lva, Lower Kintaganban River, Borneo. Original by [[Richard Clark>>http://www.flickr.com/photos/rclark/]]
--{{/figureCaption}}
++[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Klepněte a táhněte pro přesunutí" width="15"]]
  {{/figure}}
  === Další funkce ===
@@ -206,19
          +206,38 @@
  Ctrl+B **bold**
++== Link na jinou stránku ==
++
++Odkaz na jinou stránku v rámci platformy lze jednoduše vytvořit napsáním "[" a pokračování textu názvu. Našeptávač zobrazí odpovídající názvy stránek a enter vytvoří link. Např. link na [[10 Jak na kravatu>>xwiki:Tipy a triky.Jak na kravatu]]. Intuitivní odkazování snížuje redundanci textu.
++
++[[image:1606822958834-728.png||queryString="width=265&height=173" height="173" width="265"]]
++
++==   ==
++
  == Přejmenování/přesunutí stránky ==
  [[Přesunutí/Přejmenování stránky a změna pořádí stránek v menu>>xwiki:99 Rozpracované.20 Uživatelská příručka.PřesunutíPřejmenování stránky.WebHome]]
--= Profil uživatele =
++= (% id="cke_bm_2611S" style="display:none" %) (%%)Notifikace - nastavení upozornění =
--Dostupný kliknutím na ikonu uživatele [[image:1606308649263-188.png||queryString="width=146&height=32" height="32" width="146"]]
++Oblasti, které mě zajimají můžu sledovat - budu upozorněn na změny.
--Umožňuje změnit zejména Notifikační preference, nastavit posílání notifikací do emailu, změnit heslo atp.
++Nastavení je pod ikonkou zvonku([[image:1606827296491-344.png]]) - jsou následující tři přepínače. Nastavením přepínače lze nastavit jaké stránky budou sledovány.
--= Dashboard =
++[[image:1606827099654-659.png||queryString="width=268&height=162" height="162" width="268"]]
--Dashboard je uživatelský přehled zobrazující poslední změny na stránce.
++Nové úpravy jsou pak zobrazeny v seznamu pod ikonkou zvonku [[image:1606827919991-280.png]]
--(% class="wikigeneratedid" %)
--[[https:~~/~~/www.pgdenik.cz/xwiki/bin/view/Dashboard/>>https://www.pgdenik.cz/xwiki/bin/view/Dashboard/]]
++[[image:1606827956197-827.png||queryString="width=237&height=392" height="392" width="237"]]
++
++
++Emailové notifikace, četnost odesílání a úroveň detailu lze také nastavit v profilu uživatele (ikonka uživatele [[image:1606827255550-611.png]]) v sekci Notifications.
++
++[[image:1606828373969-488.png||queryString="width=594&height=212" height="212" width="594"]]
++
++
++= Profil uživatele =
++
++Dostupný kliknutím na ikonu uživatele [[image:1606308649263-188.png||queryString="width=146&height=32" height="32" width="146"]]
++
++Umožňuje změnit zejména Notifikační preference, nastavit posílání notifikací do emailu, změnit heslo atp.

Změny dokumentu 20 Uživatelská příručka

Přehled

Rozpis

Navigace