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.01.2021 21:51

Na verzi < 143.1 >

změnil(a) David Brazda
k 28.12.2020 17:19

< >

Popis verze: Nahrát novou přílohu 1608737590817-217.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,4
          +1,4 @@
--Tato stránka popisuje kompletní dostupné funkcionality.
++Tato stránka popisuje kompletní funkcionality PGWIKI.
  {{toc/}}
@@ -10,26
          +10,28 @@
  == Inline komentáře (anotace) ==
--Volitelně lze také okomentovat konkrétní část textu na stránce. Takový komentář je zobrazen v sekci komentáře a nebo může být zobrazen i přímo v dokumentu u relevantní části textu (zvýrazněné žlutě)
++Volitelně lze také okomentovat konkrétní část textu na stránce.
--=== **Vytvoření inline komentáře** ===
++{{success}}
++Text na stránce stačí označit a klávesovou zkratkou **Ctrl + M** nebo **CMD + M **vyvolat vytvoření inline komentáře.
++{{/success}}
--označit myší text a zkratku **Cmd + M **nebo **Ctrl + M**
++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"]]
--Okomentovaný text je zvýrazněn žlutě. Proklikem na žlutý čtverec lze komentář(e) zobrazit, odpovědět a po zapracování/vysvětlení smazat.
++Okokmentovaný text je poté na stránce zvýrazněn žlutě. Proklikem na žlutý čtverec lze komentář(e) zobrazit, odpovědět a po zapracování/vysvětlení smazat.
++(% style="text-align:center" %)
  [[image:1606523504989-261.png]]
--=== **Zobrazení inline komentářů** ===
++Tyto komentáře jsou také zobrazeny mezi ostatními komentáři.
--Zobrazení inline komentářů v textu lze  zapnout/vypnout zkratkou **Opt + A **nebo **Alt + A **(windows)
++{{success}}
++TIP: Zvýraznění textů s navázanými komentáři lze vypnout pomocí** Alt+A (Option-A).**
++{{/success}}
--Po zapnutí jsou inline komentáře zobrazeny v textu - žlutým zvýrazněním.
--
--Navíc jsou komentáře vždy také v tabu komentáře.
--
  == Odkaz na konkrétní komentář ==
  V psaném textu (na stránce/v jiném komentáři) 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.
@@ -36,7
          +36,7 @@
  [[image:1606834701031-136.png]]
--Takový odkaz poté odkazuje na stránku se zvýrazněným komentářem:
++Takový odkaz poté odkazuje na stránku s takto výrazněným komentářem:
  [[image:1606834906235-704.png||queryString="width=617&height=157" height="157" width="617"]]
@@ -46,20
          +46,19 @@
  //Předpoklad: Právo editor.//
--Stránku lze vytvořit buď ručně nebo kliknutím na [[prázdný odkaz>>{{velocity}}$xcontext.getUserReference().getWikiReference().getName(){{/velocity}}:prázdný odkaz.WebHome]].
++Stránku lze vytvořit buď ručně nebo kliknutím na [[prázdný odkaz>>prázdný odkaz]].
--
  === Ručně ===
--1. V navigačním menu vybrat podsekci, kam nová stránka patří
++1. V navigačním menu vybrat podsekci, kam nová stránka patří (dle fáze letu)
 . 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" height="45" width="86"]]
--1. V následující obrazovce zadat název nové stránky, upravit případné umístění v menu a vybrat šablonu (např. **PGWiki stránka)** nebo **Prázdnou stránku**. Šablona má navíc automaticky generovaný obsah a úvodní strukturu. U krátkých dokumentů nemá obsah smysl, proto je lepší vytvořit prázdnou stránku.
++1. V následující obrazovce zadat název nové stránky, upravit případné umístění v menu a vybrat šablonu **PGWiki stránka** nebo **Prázdná stránka**. PGWiki stránka má navíc automaticky generovaný obsah a úvodní strukturu. U krátkých dokumentů nemá obsah smysl, proto je lepší vytvořit prázdnou stránku.
  [[image:1608736123772-371.png]]
  === Kliknutím na neexistující stránku ===
--Během editace si můžu předem vytvořit [[odkaz na neexistující stránku>>{{velocity}}$xcontext.getUserReference().getWikiReference().getName(){{/velocity}}: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.
++Během editace si můžu předem 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 ==
@@ -73,6
          +73,7 @@
  **Pravidla**
  * strukturovat text pomocí nadpisů(((
++(% style="text-align:center" %)
  [[image:1606220336280-721.png]]
  )))
@@ -87,12
          +87,12 @@
  **Rychlý odkaz **na jinou stránku na pgwiki - hranatá závorka "[" plus začít psát název stránky viz
  (((
++(% style="text-align:center" %)
  [[image:1606219999849-696.png]]
  )))
++Našeptávač zobrazí odpovídající názvy stránek a enter vytvoří link. Např. link [[50 Přistání>>50 Přistání.WebHome]]
--Našeptávač zobrazí odpovídající názvy stránek a enter vytvoří link.
--
  **Odkaz lze vytvořit i skrz dialogové okno** (označením textu a) kliknutím na [[image:1608734301328-465.png||queryString="width=28&height=22" height="22" width="28"]] nebo zkratkou CMD+K **(Ctrl+K)**
  [[image:1608734975961-539.png||queryString="width=279&height=308" height="308" width="279"]]
@@ -99,64
          +99,32 @@
  V poli Page lze zadat link nebo začít psát - našeptávač nabídne stránky v PGWIKI.
--== {{id name="OdkazovanaSekce"/}}Odkaz na konkrétní místo v dokumentu ==
++V sekci **Options **je také pole Anchor - pomocí kterého lze odkazovat na** konkrétní část dokumentu. **Je třeba vyplnit konkrétní nadpis ve formátu **#HNazevNadpisuBezMezer**
--Odkazovat lze na libovolné místo v dokumentu. A to buď na libovolný nadpis nebo na odkazované místo vložit makro "ID" do kterého jako parametr vložit zvolený identifikátor dané sekce (např. OdkazovanaSekce)
--
--ID Macro lze přidat zkratkou Opt + I (Alt + I)
--
--[[image:1609255725804-590.png||queryString="width=331&height=295" height="295" width="331"]]
--
--[[image:1609256155107-248.png||queryString="width=408&height=268" height="268" width="408"]]
--
--Případně buttonem ID v toolbaru editoru [[[[image:1611181202916-832.png||queryString="width=122&height=40" height="40" width="122"]]>>attach:1611181202916-832.png]]
--
--V daném místě je přítomnost makra indikována takto [[image:1609256567290-338.png]]
--
--Na danou část dokumentu se lze z libovolné stránky odkazovat. V(% style="font-family:-apple-system,BlinkMacSystemFont,~"Segoe UI~",Roboto,~"Noto Sans~",Ubuntu,~"Droid Sans~",~"Helvetica Neue~",sans-serif" %) dialogovém okně na vytvoření linku(Cmd+L) rozkliknout sekci **Options** a do** **pole Anchor zadat **odkazované ID.**
--
--* na nadpis lze odkazovat ve formátu  **#H**NazevNadpisuBezMezer
--* případně vložit ID identifikované macrem např. OdkazovanaSekce
--
--[[image:1609255893394-474.png]]
--
--(% class="wikigeneratedid" %)
--Výsledek pak funguje takto [[Odkaz na misto identifikovane id "OdkazanaSekce">>||anchor="OdkazovanaSekce"]]
--
  == Embedování videa ==
  **Embedovat youtube video** lze pomoci **makra**. Přidání makra je pomocí ikony [[image:1606222063158-249.png]]kde se zvolí macro **Video**
--Nebo použít zkratku **Opt + V** (Alt + V)
--
++(% style="text-align:center" %)
  [[image:1606222021692-690.png||queryString="width=347&height=305" height="305" width="347"]]
--Do URL zkopírovat adresu YT videa.TIP: Pro začátek v daném čase přidat do URL ?start=21
--
--[[image:1609248373182-593.png||queryString="width=332&height=402" height="402" width="332"]]
--
--Výsledek:
--
  {{video url="https://www.youtube.com/watch?v=YtoUSJLr1Lg?start=21"/}}
++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}}
--== Macro ==
--
--Při editaci stránky lze používat doplňkové funkcionality, tzv. macra. Používají se např. na embedování videa, zobrazení podstránek nebo identifikace části dokumentu na který se pak chci odkazovat.
--
--Seznam dostupných maker je pomocí ikonky [[image:1609256877745-577.png]]v editoru nebo pomocí zkratky Opt + M (Alt + M)
--
--[[image:1609257030373-477.png||queryString="width=371&height=331" height="331" width="371"]]
--
--Výběr daného macra vyvolá jeho nastavení (pokud jej dané macro má) a následně se macro vloží na aktuální pozici v dokumentu.
--
--Macro je ohraničeno žlutě a identifikováno textem macro.
--
--Pokud již mám v dokumentu makro vložené, můžu na něj klepnout (označí se modře) a pak buď enterem nebo ikonkou výše lze otevřít nastavení daného makra.
--
  == Další funkce ==
  * **zvýrazněný text **- důležitý text lze zvýraznit pomocí info boxu (((
++(% style="text-align:center" %)
  [[image:1606220195696-569.png]]
  )))
@@ -164,11
          +164,18 @@
  Info box lze použít pro zvýraznění důležitého textu, např. pravidla.
  {{/warning}}
--* obsah - ve stejném menu lze do stránky přidat Table of Contents(obsah) - nebo pomocí zkratky** Opt+T **(Alt + T)
++* **obsah **- ve stejném menu lze do stránky přidat **Table of Contents(obsah)**
  * (% id="cke_bm_402S" style="display:none" %) (%%)**označení uživatele **- 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
--Všechny funkcionality popsány [[zde>>https://extensions.xwiki.org/xwiki/bin/view/Extension/CKEditor%20Integration/Features/]]
++Odkaz na detaily zde [[https:~~/~~/extensions.xwiki.org/xwiki/bin/view/Extension/CKEditor%20Integration/Features/>>https://extensions.xwiki.org/xwiki/bin/view/Extension/CKEditor%20Integration/Features/]]
++=== Klávesové zkratky v editoru ===
++
++Ctrl+K vytvoří link
++
++Ctrl+B **bold**
++
++
  = Move/Rename =
  Přejmenování nebo přesunutí stránky do jiné struktury je prováděno stejným způsobem. Na konkrétní stránce vybrat "Move/Rename" nebo klávesovou zkratku "F2".
@@ -186,163
          +186,34 @@
  * kliknout na ikonu struktury (obr viz. 2) a ve stromu vybrat nové umístění stránky
  * nechat zatržený checkbox UPDATE LINK a stisknout Rename
--[[image:1608559159770-136.png||queryString="width=465&height=298" height="298" width="465"]]
++[[image:1608559159770-136.png]]
  == Řazení stránek v menu ==
  Stránky jsou zanořené ve stromové struktuře. Aktuální struktura odpovídá fázi letu.
--Řazení stránek je zatím pouze automatické alfanumericky. Pro vynucení pořadí je možné číselným prefixem před název stránky např. 03 Název.
++Řazení stránek je zatím pouze automatické alfanumericky. Pro vynucení pořadí je možné číselným prefixem před název stránky např. 03 Zachycení.
--= {{id name="shortcuts"/}}Klávesové zkratky =
++= (% id="cke_bm_2611S" style="display:none" %) (%%)Notifikace - nastavení upozornění =
--{{success}}
--**Tip: pro windows **uživatele: CMD nahradit klávesou **Ctrl** a Opt klávesou **Alt**.
--{{/success}}
++Oblasti, které mě zajimají můžu sledovat - budu upozorněn na změny.
--(% border="2" cellpadding="0" style="width:696px" %)
--|(% style="width:193px" %)**Při zobrazení stránky**|(% style="width:169px" %)(((
--**Editovat stránku**
++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.
--E
--)))|(% style="width:176px" %)(((
--**Přejmenovat stránku**
++[[image:1606827099654-659.png||queryString="width=268&height=162" height="162" width="268"]]
--(((
--F2
--)))
--)))|(% style="width:149px" %) |(% style="width:149px" %)
--|(% style="width:193px" %) |(% style="width:169px" %)(((
--**Skok na tab komentářů**
++Nové úpravy jsou pak zobrazeny v seznamu pod ikonkou zvonku [[image:1606827919991-280.png]]
--C
--)))|(% style="width:176px" %)(((
--**Skok na tab historie**
++[[image:1606827956197-827.png||queryString="width=237&height=392" height="392" width="237"]]
--E
--)))|(% style="width:149px" %)(((
--**Skok na tab informací**
--I
--)))|(% style="width:149px" %)
--|(% style="width:193px" %) |(% style="width:169px" %)(((
--**Zobrazit/Skrýt inline komentáře v textu**
++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.
--Opt - A
--)))|(% style="width:176px" %)(((
--**Přidat inline komentář**
++[[image:1606828373969-488.png||queryString="width=594&height=212" height="212" width="594"]]
--Cmd - M
--)))|(% style="width:149px" %) |(% style="width:149px" %)
--|(% colspan="1" rowspan="5" style="width:193px" %)**Během editace**|(% style="width:169px" %)(((
--**Nadpis1**
--Cmd + 1
--)))|(% style="width:176px" %)(((
--**Nadpis 2**
--
--Cmd + 2
--)))|(% style="width:149px" %)(((
--**Nadpis 3**
--
--Cmd + 3
--)))|(% style="width:149px" %)(((
--**Normal**
--
--Cmd + J
--)))
--|(% style="width:169px" %)(((
--**Text tučně**
--
--Cmd + B
--)))|(% style="width:176px" %)(((
--**Text kurziva**
--
--Cmd + I
--)))|(% style="width:149px" %)(((
--**Vytvoření odkazu**
--
--Cmd + K
--)))|(% style="width:149px" %)(((
--**Odrážka**
--
--Cmd + L
--)))
--|(% style="width:169px" %)(((
--**Přeškrtnuté**
--
--Cmd + S
--)))|(% style="width:176px" %)(((
--**Kód**
--
--Ctrl + D
--)))|(% style="width:149px" %) |(% style="width:149px" %)
--|(% style="width:169px" %)(((
--**Vložit YT video**
--
--Opt + V
--)))|(% style="width:176px" %)(((
--**Vložit ID macro**
--
--Opt + I
--)))|(% style="width:149px" %)(((
--**Vložit libovolné macro**
--
--Opt + M
--)))|(% style="width:149px" %)(((
--**Přepnout zdroj**
--
--Opt + Z
--)))
--|(% style="width:169px" %)(((
--**Zrušení editace**
--
--Opt - C
--)))|(% style="width:176px" %)(((
--**Uložit & zobrazit**
--
--Opt - S
--)))|(% style="width:149px" %)(((
--**Uložit & editovat**
--
--Opt - Shift - S
--)))|(% style="width:149px" %)
--|(% style="width:193px" %)**Navigace**|(% style="width:169px" %)(((
--**jít na stránku**
--
--Cmd - G
--)))|(% style="width:176px" %)(((
--**admin section**
--
--Q
--)))|(% style="width:149px" %) |(% style="width:149px" %)
--
--=
--Notifikace - nastavení upozornění =
--
--== Základní nastavení ==
--
--Po registraci jsou notifikace nastaveny takto:
--
--* na email chodí upozornění na komentáře nebo při označení uživatele
--* ostatní změny (jako přidané a upravené stránky) přijdou jako upozornění do ikonky zvonku [[image:1606827919991-280.png||queryString="width=24&height=25" height="25" width="24"]] podobně jako např. na fb. Po rozkliknutí ikony jsou zobrazeny veškeré změny na stránce od poslední návštěvy:
--
--[[image:1606827956197-827.png||queryString="width=237&height=392" height="310" width="187"]]
--
--Kliknutím na danou změnu ji lze označit jako přečtenou, případně lze všechny upozornění vyčistit pomocí tlačítka Vyčistit upozornění (Clear All).
--
--Toto nastavení vystačí většině uživatelům.
--
--== Pokročilé nastavení ==
--
--Tato sekce popisuje pokročilé nastavení, nicméně většině uživatelům postačí základní nastavení výše.
--
--V profilu uživatele v sekci **Notifikace** lze nastavit četnost odesílání emailu, úroveň detailu posílaných změn a to které změny budou odesílány emailem a jaké jen do ikonky zvonku.
--
--[[image:1609251491260-700.png||queryString="width=535&height=368" height="368" width="535"]]
--
  = 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 měnit základní údaje, heslo, nastavit profilový obrázek a nebo nastavení notifikací.
++Umožňuje změnit zejména Notifikační preference, nastavit posílání notifikací do emailu, změnit heslo atp.