20 Uživatelská příručka

author	version	line-number	content
1	{{toc/}}
2
3	= Úvod =
4
5	Stránky jsou uloženy v adresářové struktuře vlevo.
6
7	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.
8
9	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.
10
11	Všechny změny stránky jsou uložené jako revize a lze se k nim kdykoliv vrátit.
12
13	= Uživatelská práva =
14
15	Aktuálně jsou nastaveny tyto úrovně přístupu
16
17	* anonym - zobrazí veřejné stránky, může se registrovat
18	* nově registrovaný uživatel (dostává automaticky právo Reader) - umožní navíc
19	** komentáře
20	** sledování stránek(W//atch this page// pod ikonou zvonku)
21	** mentions - možnost zmínit v textu ostatní uživatele
22	* uživatel editor (administrátor musí uživateli přiřadit právo Editor) - editace, mazání
23	* admin (právo Admin) - delete, admin
24
25	= Práce s obsahem =
26
27	* komentáře
28	* notifikace
29	* odkazování na jiné stránky v rámci platformy
30	* úprava existujících stránek [[image:1606223725498-311.png\|\|queryString="width=88&height=51" height="39" width="67"]]
31	* vytváření nové stránky[[image:1606223741104-877.png\|\|queryString="width=85&height=45" height="46" width="87"]]
32	* přejmenování/přesunutí stránky
33
34	== Komentáře ==
35
36	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ářů.
37
38	{{success}}
39	Text na stránce stačí označit a klávesovou zkratkou Ctrl + M nebo CMD + M vyvolat vytvoření inline komentáře.
40	{{/success}}
41
42	Alternativní zkratka je Ctrl + I nebo CMD + I
43
44	(% style="text-align:center" %)
45	[[image:1606294034475-348.png\|\|queryString="width=598&height=352" height="352" width="598"]]
46
47	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.
48
49	(% style="text-align:center" %)
50	[[image:1606523504989-261.png]]
51
52	Inline komentáře jsou také zobrazeny v tabu Comments.
53
54	TIP: Zvýraznění textů s navázanými komentáři lze vypnout pomocí Alt+A (option-A).
55
56	== Odkaz na konkrétní komentář ==
57
58	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.
59
60	[[image:1606834701031-136.png]]
61
62	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.
63
64	[[image:1606834906235-704.png\|\|queryString="width=617&height=157" height="157" width="617"]]
65
66	== Notifikace/Upozornění ==
67
68	Oblasti, které mě zajimají můžu sledovat - budu upozorněn na změny.
69
70	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.
71
72	[[image:1606827099654-659.png\|\|queryString="width=268&height=162" height="162" width="268"]]
73
74	Nové úpravy jsou pak zobrazeny v seznamu pod ikonkou zvonku [[image:1606827919991-280.png]]
75
76	[[image:1606827956197-827.png\|\|queryString="width=237&height=392" height="392" width="237"]]
77
78
79	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.
80
81	[[image:1606828373969-488.png\|\|queryString="width=594&height=212" height="212" width="594"]]
82
83	== Link na jinou stránku ==
84
85	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>>Tipy a triky.Jak na kravatu]]. Intuitivní odkazování snížuje redundanci textu.
86
87	[[image:1606822958834-728.png\|\|queryString="width=265&height=173" height="173" width="265"]]
88
89	== Vytvoření stránky ==
90
91	//Předpoklad: Právo editor.//
92
93	Stránku lze vytvořit buď ručně nebo kliknutím na prázdnou stránku.
94
95	=== Ručně ===
96
97	1. V Menu vybrat sekci, kam nová stránka patří
98	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"]]
99	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>>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.
100
101	(% style="text-align:center" %)
102	[[image:https://www.xwiki.org/xwiki/bin/download/Documentation/UserGuide/GettingStarted/CreatingAPage/create-formular.png?width=650&rev=1.4\|\|alt="create-formular.png"]]
103
104	=== Kliknutím na prázdnou stránku ===
105
106	Během editace si můžu vytvořit [[odkaz na neexistující stránku>>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.
107
108	== Editace stránky - práce s editorem ==
109
110	//Předpoklad: Právo editor.//
111
112	Editaci lze zahájit
113
114	* 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"]]
115	* případně na úrovni odstavce pomoci ikonky [[image:1606823274931-438.png]]
116
117	Pravidla
118
119	* strukturovat text pomocí nadpisů(((
120	(% style="text-align:center" %)
121	[[image:1606220336280-721.png]]
122	)))
123	* 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]]
124	* odkaz na jinou stránku na pgdeniku - hranatá závorka plus začít psát název stránky viz (((
125	(% style="text-align:center" %)
126	[[image:1606219999849-696.png]]
127	)))
128
129	* důležitý text lze zvýraznit pomocí info boxu (((
130	(% style="text-align:center" %)
131	[[image:1606220195696-569.png]]
132	)))
133
134	{{warning}}
135	Info box lze použít pro zvýraznění důležitého textu, např. pravidla.
136	{{/warning}}
137
138	* ve stejném menu lze do stránky přidat Table of Contents(obsah)
139	* (% 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
140
141	=== Embedování videa ===
142
143	Embedovat youtube video lze pomoci makra. Přidání makra je pomocí ikony [[image:1606222063158-249.png]]kde se zvolí macro Video
144
145	(% style="text-align:center" %)
146	[[image:1606222021692-690.png\|\|queryString="width=347&height=305" height="305" width="347"]]
147
148	{{video url="https://www.youtube.com/watch?v=YtoUSJLr1Lg?start=21"/}}
149
150	(% class="wikigeneratedid" %)
151	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
152
153	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
154
155	{{velocity}}
156	{{html clean="false"}}
157	## Chrome's XSS Auditor blocks the preview action if:
158	## * the submitted content has an iframe with an external URL
159	## * the preview action displays the submitted iframe
160	## The workaround is to make sure the submitted content (the macro markers) don't match the preview HTML.
161	## See XWIKI-14818: Preview triggers ERR_BLOCKED_BY_XSS_AUDITOR in Chrome
162	#set ($iframe = 'iframe')
163	<iframe width="560" height="315" src="https://www.youtube.com/embed/kE-R8yDjyas?start=21" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
164	{{/html}}
165	{{/velocity}}
166
167	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/]]
168
169	=== Klávesové zkratky v editoru ===
170
171	Ctrl+K vytvoří link
172
173	Ctrl+B bold
174
175	== Přejmenování/přesunutí stránky ==
176
177	[[Přesunutí/Přejmenování stránky a změna pořádí stránek v menu>>99 Rozpracované.20 Uživatelská příručka.PřesunutíPřejmenování stránky.WebHome]]
178
179	= Profil uživatele =
180
181	Dostupný kliknutím na ikonu uživatele [[image:1606308649263-188.png\|\|queryString="width=146&height=32" height="32" width="146"]]
182
183	Umožňuje změnit zejména Notifikační preference, nastavit posílání notifikací do emailu, změnit heslo atp.
184
185	= Dashboard =
186
187	Dashboard je uživatelský přehled zobrazující poslední změny na stránce.
188
189	(% class="wikigeneratedid" %)
190	[[https:~~/~~/www.pgdenik.cz/xwiki/bin/view/Dashboard/>>https://www.pgdenik.cz/xwiki/bin/view/Dashboard/]]

= Úvod =

Stránky jsou uloženy v adresářové struktuře vlevo.

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.

8

9

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.

10

11

Všechny změny stránky jsou uložené jako revize a lze se k nim kdykoliv vrátit.

12

13

= Uživatelská práva =

14

15

Aktuálně jsou nastaveny tyto úrovně přístupu

16

17

* **anonym** - zobrazí veřejné stránky, může se registrovat

18

* **nově registrovaný uživatel** (dostává automaticky právo **Reader**) - umožní navíc

19

** komentáře

20

** sledování stránek(W//atch this page// pod ikonou zvonku)

21

** mentions - možnost zmínit v textu ostatní uživatele

22

* **uživatel editor** (administrátor musí uživateli přiřadit právo **Editor**) - editace, mazání

23

* admin (právo **Admin**) - delete, admin

= Práce s obsahem =

* komentáře

* notifikace

* odkazování na jiné stránky v rámci platformy

30

* úprava existujících stránek [[image:1606223725498-311.png||queryString="width=88&height=51" height="39" width="67"]]

31

* vytváření nové stránky[[image:1606223741104-877.png||queryString="width=85&height=45" height="46" width="87"]]

32

* přejmenování/přesunutí stránky

== Komentáře ==

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ářů.

37

38

39

Text na stránce stačí označit a klávesovou zkratkou **Ctrl + M** nebo **CMD + M **vyvolat vytvoření inline komentáře.

40

41

42

Alternativní zkratka je Ctrl + I nebo CMD + I

43

44

(% style="text-align:center" %)

45

[[image:1606294034475-348.png||queryString="width=598&height=352" height="352" width="598"]]

46

47

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.

48

49

(% style="text-align:center" %)

50

[[image:1606523504989-261.png]]

51

52

Inline komentáře jsou také zobrazeny v **tabu Comments**.

53

54

TIP: Zvýraznění textů s navázanými komentáři lze vypnout pomocí Alt+A (option-A).

55

56

== Odkaz na konkrétní komentář ==

57

58

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.

59

60

[[image:1606834701031-136.png]]

61

62

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.

63

64

[[image:1606834906235-704.png||queryString="width=617&height=157" height="157" width="617"]]

65

66

== Notifikace/Upozornění ==

67

68

Oblasti, které mě zajimají můžu sledovat - budu upozorněn na změny.

69

70

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.

71

72

[[image:1606827099654-659.png||queryString="width=268&height=162" height="162" width="268"]]

73

74

Nové úpravy jsou pak zobrazeny v seznamu pod ikonkou zvonku [[image:1606827919991-280.png]]

75

76

[[image:1606827956197-827.png||queryString="width=237&height=392" height="392" width="237"]]

77

78

79

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.

80

81

[[image:1606828373969-488.png||queryString="width=594&height=212" height="212" width="594"]]

82

83

== Link na jinou stránku ==

84

85

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>>Tipy a triky.Jak na kravatu]]. Intuitivní odkazování snížuje redundanci textu.

86

87

[[image:1606822958834-728.png||queryString="width=265&height=173" height="173" width="265"]]

88

89

== Vytvoření stránky ==

90

91

//Předpoklad: Právo editor.//

92

93

Stránku lze vytvořit buď ručně nebo kliknutím na prázdnou stránku.

=== Ručně ===

1. V Menu vybrat sekci, kam nová stránka patří

98

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"]]

99

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

100

101

(% style="text-align:center" %)

102

[[image:https://www.xwiki.org/xwiki/bin/download/Documentation/UserGuide/GettingStarted/CreatingAPage/create-formular.png?width=650&rev=1.4||alt="create-formular.png"]]

103

104

=== Kliknutím na prázdnou stránku ===

105

106

Během editace si můžu vytvořit [[odkaz na neexistující stránku>>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.

107

108

== Editace stránky - práce s editorem ==

109

110

//Předpoklad: Právo editor.//

111

112

**Editaci lze zahájit**

113

114

* 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"]]

115

* případně na úrovni odstavce pomoci ikonky [[image:1606823274931-438.png]]

**Pravidla**

* strukturovat text pomocí nadpisů(((

120

(% style="text-align:center" %)

121

[[image:1606220336280-721.png]]

122

)))

123

* 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]]

124

* odkaz na jinou stránku na pgdeniku - hranatá závorka plus začít psát název stránky viz (((

125

(% style="text-align:center" %)

126

[[image:1606219999849-696.png]]

127

)))

128

129

* důležitý text lze zvýraznit pomocí info boxu (((

130

(% style="text-align:center" %)

131

[[image:1606220195696-569.png]]

)))

Info box lze použít pro zvýraznění důležitého textu, např. pravidla.

136

137

138

* ve stejném menu lze do stránky přidat **Table of Contents(obsah)**

139

* (% 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

140

141

=== Embedování videa ===

142

143

**Embedovat youtube video** lze pomoci **makra**. Přidání makra je pomocí ikony [[image:1606222063158-249.png]]kde se zvolí macro **Video**

144

145

(% style="text-align:center" %)

146

[[image:1606222021692-690.png||queryString="width=347&height=305" height="305" width="347"]]

147

148

{{video url="https://www.youtube.com/watch?v=YtoUSJLr1Lg?start=21"/}}

149

150

(% class="wikigeneratedid" %)

151

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

152

153

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

## Chrome's XSS Auditor blocks the preview action if:

158

## * the submitted content has an iframe with an external URL

159

## * the preview action displays the submitted iframe

160

## The workaround is to make sure the submitted content (the macro markers) don't match the preview HTML.

161

## See XWIKI-14818: Preview triggers ERR_BLOCKED_BY_XSS_AUDITOR in Chrome

162

#set ($iframe = 'iframe')

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/]]

168

169

=== Klávesové zkratky v editoru ===

Ctrl+K vytvoří link

Ctrl+B **bold**

== Přejmenování/přesunutí stránky ==