summaryrefslogtreecommitdiffstats
path: root/public/help/cs/wiki_syntax_detailed.html
blob: 0196c9194fd9cd9369ae0d681cca1a90ebd31d8b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>Formátování Wiki v Redminu</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<style type="text/css">
    body { font:80% Verdana,Tahoma,Arial,sans-serif; }
    h1, h2, h3, h4 {  font-family: Trebuchet MS,Georgia,"Times New Roman",serif; }
    pre, code { font-size:120%; }
    pre code { font-size:100%; }
    pre {
        margin: 1em 1em 1em 1.6em;
        padding: 2px;
        background-color: #fafafa;
        border: 1px solid #dadada;
        width:95%;
        overflow-x: auto;
    }
    a.new { color: #b73535; }

    .syntaxhl .line-numbers { padding: 2px 4px 2px 4px; background-color: #eee; margin:0 }
    .syntaxhl .comment  { color:#666; }

    .syntaxhl .class { color:#B06; font-weight:bold }
    .syntaxhl .delimiter { color:black }
    .syntaxhl .function { color:#06B; font-weight:bold }

    .syntaxhl .inline { background: #eee }
    .syntaxhl .inline .inline-delimiter { font-weight: bold; color: #888 }

    .syntaxhl .instance-variable { color:#33B }
    .syntaxhl .reserved { color:#080; font-weight:bold }

    .syntaxhl .string { background-color:#fff0f0; color: #D20; }
    .syntaxhl .string .delimiter { color:#710 }

</style>
</head>

<body>
<h1><a name="1" class="wiki-page"></a>Formátování Wiki</h1>

    <h2><a name="2" class="wiki-page"></a>Odkazy</h2>

        <h3><a name="3" class="wiki-page"></a>Odkazy Redmine</h3>

        <p>Redmine umožňuje hypertextové odkazy mezi jednotlivými zdroji (úkoly, revize, wiki stránky...) kdekoli, kde je použito Wiki formátování.</p>
        <ul>
            <li>Odkaz na úkol: <strong>#124</strong> (zobrazí <del><a href="#" class="issue" title="Hromadná změna nezmění kategorii úkolů (Uzavřeno)">#124</a></del>, odkaz je přeškrtnutý, jestliže je úkol uzavřen)</li>
            <li>Odkaz na poznámku k úkolu: <strong>#124-6</strong>, nebo <strong>#124#note-6</strong></li>
        </ul>

        <p>Odkazy Wiki:</p>

        <ul>
            <li><strong>[[Příručka]]</strong> zobrazí odkaz na stránku nazvanou "Příručka": <a href="#" class="wiki-page">Příručka</a>.</li>
            <li><strong>[[Příručka#čtěte-více]]</strong> Vás přenese ke kotvě "čtěte-více". Nadpisy mají automaticky přiřazené kotvy, na které se můžete odkazovat: <a href="#" class="wiki-page">Příručka</a>.</li>
            <li><strong>[[Příručka|Uživatelský manuál]]</strong> zobrazí odkaz na tu samou stránku, ale s jiným textem: <a href="#" class="wiki-page">Uživatelský manuál</a>.</li>
        </ul>

        <p>Můžete se také odkazovat na Wiki stránky jiného projektu:</p>

        <ul>
            <li><strong>[[projekt_test:Nějaká stránka]]</strong> zobrazí odkaz na stránku s názvem "Nějaká stránka" na Wiki projektu projekt_test.</li>
            <li><strong>[[projekt_test:]]</strong> zobrazí odkaz na hlavní Wiki stránku projektu projekt_test.</li>
        </ul>

        <p>Odkazy na Wiki stránky jsou zobrazeny červeně v případě, že odkazovaná stránka dosud neexistuje, např.: <a href="#" class="wiki-page new">Neexistující stránka</a>.</p>

        <p>Odkazy na další zdroje:</p>

        <ul>
            <li>Dokumenty:
                <ul>
                    <li><strong>document#17</strong> (odkaz na dokument s ID 17)</li>
                    <li><strong>document:Úvod</strong> (odkaz na dokument s názvem "Úvod")</li>
                    <li><strong>document:"Nějaký dokument"</strong> (Uvozovky se mohou použít v případě, že název obsahuje mezery.)</li>
                    <li><strong>projekt_test:document:"Nějaký dokument"</strong> (odkaz na dokument s názvem "Nějaký dokument" v jiném projektu "projekt_test")</li>
                </ul></li>
        </ul>

        <ul>
            <li>Verze:
                <ul>
                    <li><strong>version#3</strong> (odkaz na verzi s ID 3)</li>
                    <li><strong>version:1.0.0</strong> odkaz na verzi s názvem "1.0.0")</li>
                    <li><strong>version:"1.0 beta 2"</strong></li>
                    <li><strong>projekt_test:version:1.0.0</strong> (odkaz na verzi "1.0.0" jiného projektu "projekt_test")</li>
                </ul></li>
        </ul>

        <ul>
            <li>Přílohy:
                <ul>
                    <li><strong>attachment:soubor.zip</strong> (odkaz na přílohu aktuálního objektu s názvem soubor.zip)</li>
                    <li>Aktuálně mohou být odkazovány pouze přílohy aktuálního objektu (u úkolu mohou být odkazy pouze na přílohy danného úkolu).</li>
                </ul></li>
        </ul>

        <ul>
            <li>Revize:
                <ul>
                    <li><strong>r758</strong>                       (odkaz na revizi)</li>
                    <li><strong>commit:c6f4d0fd</strong>            (odkaz na revizi s nečíselným označním revize)</li>
                    <li><strong>svn1|r758</strong>                  (odkaz na revizi určitého repozitáře, pro projekty s více repozitáři)</li>
                    <li><strong>commit:hg|c6f4d0fd</strong>         (odkaz na revizi  s nečíselným označním revize určitého repozitáře, pro projekty s více repozitáři)</li>
                    <li><strong>projekt_test:r758</strong>               (odkaz na revizi jiného projektu)</li>
                    <li><strong>projekt_test:commit:c6f4d0fd</strong>    (odkaz na revizi  s nečíselným označním revize jiného projektu)</li>
                </ul></li>
        </ul>

        <ul>
             <li>Soubory repositáře:
                <ul>
                    <li><strong>source:some/file</strong>           (odkaz na soubor umístěný v /some/file respozitáře projektu)</li>
                    <li><strong>source:some/file@52</strong>        (odkaz na revizi souboru č. 52)</li>
                    <li><strong>source:some/file#L120</strong>      (odkaz na 120. řádek souboru)</li>
                    <li><strong>source:some/file@52#L120</strong>   (odkaz na 120. řádek revize souboru č. 52)</li>
                    <li><strong>source:"some file@52#L120"</strong> (použijte uvozovky, když URL obsahuje mezery)</li>
                    <li><strong>export:some/file</strong>           (vynutit stažení souboru)</li>
                    <li><strong>source:svn1|some/file</strong>      (odkaz na soubor určitého repozitáře, pro projekty s více repositáři)</li>
                    <li><strong>projekt_test:source:some/file</strong>   (odkaz na soubor umístěný v /some/file repositáře projektu "projekt_test")</li>
                    <li><strong>projekt_test:export:some/file</strong>   (vynutit stažení souboru umístěného v /some/file repositáře projektu "projekt_test")</li>
                </ul></li>
        </ul>

        <ul>
            <li>Příspěvky diskuzního fóra:
                <ul>
                    <li><strong>message#1218</strong> (odkaz na příspěvek s ID 1218)</li>
                </ul></li>
        </ul>

        <ul>
            <li>Projekty:
                <ul>
                    <li><strong>project#3</strong> (odkaz na projekt s ID 3)</li>
                    <li><strong>project:projekt_test</strong> (odkaz na projekt pojmenovaný "projekt_test")</li>
                </ul></li>
        </ul>


        <p>Escaping:</p>

        <ul>
            <li>Zabránit parsování Redmine odkazů, lze vložením vykřičníku před odkaz: !</li>
        </ul>


        <h3><a name="4" class="wiki-page"></a>Externí odkazy</h3>

        <p>URL odkazy a emaily jsou automaticky zobrazeny jako klikací odkaz:</p>

<pre>
http://www.redmine.org, someone@foo.bar
</pre>

        <p>zobrazí: <a class="external" href="http://www.redmine.org">http://www.redmine.org</a>, <a href="mailto:someone@foo.bar" class="email">someone@foo.bar</a></p>

        <p>Jestliže chcete zobrazit určitý text místo URL, můžete použít standardní syntaxi textile:</p>

<pre>
"Webová stránka Redmine":http://www.redmine.org
</pre>

        <p>zobrazí: <a href="http://www.redmine.org" class="external">Webová stránka Redmine</a></p>


    <h2><a name="5" class="wiki-page"></a>Formátování textu</h2>


    <p>Pro nadpisy, tučný text, tabulky a seznamy, Redmine podporuje syntaxi Textile.  Podívejte se na <a class="external" href="http://en.wikipedia.org/wiki/Textile_%28markup_language%29">http://en.wikipedia.org/wiki/Textile_(markup_language)</a> pro informace o využití těchto vlastností. Několik příkladů je uvedeno níže, ale Textile toho dokáže mnohem víc.</p>

        <h3><a name="6" class="wiki-page"></a>Styly písma</h3>

<pre>
* *tučný*
* _kurzíva_
* _*tučná kurzíva*_
* +podtržený+
* -přeškrtnutý-
</pre>

        <p>Zobrazí:</p>

        <ul>
            <li><strong>tučný</strong></li>
            <li><em>kurzíva</em></li>
            <li><em><strong>tučná kurzíva</strong></em></li>
            <li><ins>podtržený</ins></li>
            <li><del>přeškrtnutý</del></li>
        </ul>

        <h3><a name="7" class="wiki-page"></a>Vložené obrázky</h3>

        <ul>
            <li><strong>!image_url!</strong> zobrazí obrázek z odkazu (syntaxe textile)</li>
            <li><strong>!>image_url!</strong> obrázek zarovnaný napravo</li>
            <li>Jestliže máte obrázek přiložený k Wiki stránce, může být zobrazen jako vložený obrázek pomocí jeho jména: <strong>!prilozeny_obrazek.png!</strong></li>
        </ul>

        <h3><a name="8" class="wiki-page"></a>Nadpisy</h3>

<pre>
h1. Nadpis 1. úrovně
h2. Nadpis 2. úrovně
h3. Nadpis 3. úrovně
</pre>

        <p>Redmine přiřadí kotvu ke každému nadpisu, takže se na ně lze odkazovat pomocí "#Nadpis", "#Podnadpis" atd.</p>


        <h3><a name="9" class="wiki-page"></a>Odstavce</h3>

<pre>
p>. zarovnaný doprava
p=. zarovnaný na střed
</pre>

        <p style="text-align:center;">Toto je odstavec zarovnaný na střed.</p>


        <h3><a name="10" class="wiki-page"></a>Citace</h3>

        <p>Začněte odstavec s <strong>bq.</strong></p>

<pre>
bq. Rails je framework pro vývoj webových aplikací podle modelu Model-View-Control.
Vše, co je potřeba, je databázový a webový server.
</pre>

        <p>Zobrazí:</p>

        <blockquote>
                <p>Rails je framework pro vývoj webových aplikací podle modelu Model-View-Control.<br />Vše, co je potřeba, je databázový a webový server.</p>
        </blockquote>


        <h3><a name="11" class="wiki-page"></a>Obsah</h3>

<pre>
{{toc}} => obsah zarovnaný doleva
{{>toc}} => obsah zarovnaný doprava
</pre>

        <h3><a name="14" class="wiki-page"></a>Vodorovná čára</h3>

<pre>
---
</pre>

    <h2><a name="12" class="wiki-page"></a>Makra</h2>

    <p>Redmine obsahuje následující vestavěná makra:</p>

    <p><dl><dt><code>hello_world</code></dt><dd><p>Jednoduché makro.</p></dd><dt><code>include</code></dt><dd><p>Vloží Wiki stránku. Např.:</p>

    <pre><code>{{include(Foo)}}</code></pre></dd><dt><code>macro_list</code></dt><dd><p>Zobrazí seznam všech dostupných maker, včetně jejich popisu, existuje-li.</p></dd></dl></p>


    <h2><a name="13" class="wiki-page"></a>Zvýrazňování kódu</h2>

    <p>Výchozí zvýrazňování kódu zavisí na <a href="http://coderay.rubychan.de/" class="external">CodeRay</a>, což je rychlá zvýrazňovací knihovna napsaná v Ruby. Aktuálně podporuje jazyky C/C++, CSS, Delphi, Groovy, HTML, Java, Javascript, JSON, PHP, Python, RHTML, Ruby, Scheme, SQL, XML a YAML.</p>

    <p>Kód můžete na stránce zvýraznit pomocí následující syntaxe:</p>

<pre>
&lt;pre&gt;&lt;code class="ruby"&gt;
  Váš kód vložte zde.
&lt;/code&gt;&lt;/pre&gt;
</pre>

    <p>Např.:</p>

<pre><code class="ruby syntaxhl"><span class="line-numbers"> 1</span> <span class="comment"># The Greeter class</span>
<span class="line-numbers"> 2</span> <span class="reserved">class</span> <span class="class">Greeter</span>
<span class="line-numbers"> 3</span>   <span class="reserved">def</span> <span class="function">initialize</span>(name)
<span class="line-numbers"> 4</span>     <span class="instance-variable">@name</span> = name.capitalize
<span class="line-numbers"> 5</span>   <span class="reserved">end</span>
<span class="line-numbers"> 6</span>
<span class="line-numbers"> 7</span>   <span class="reserved">def</span> <span class="function">salute</span>
<span class="line-numbers"> 8</span>     puts <span class="string"><span class="delimiter">"</span><span class="content">Hello </span><span class="inline"><span class="inline-delimiter">#{</span><span class="instance-variable">@name</span><span class="inline-delimiter">}</span></span><span class="content">!</span><span class="delimiter">"</span></span>
<span class="line-numbers"> 9</span>   <span class="reserved">end</span>
<span class="line-numbers"><strong>10</strong></span> <span class="reserved">end</span></code>
</pre>
</body>
</html>