1
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
2
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="sq">
|
3
|
<head>
|
4
|
<title>RedmineWikiFormatting (Markdown)</title>
|
5
|
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
6
|
<link rel="stylesheet" type="text/css" href="../wiki_syntax_detailed.css" />
|
7
|
</head>
|
8
|
|
9
|
<body>
|
10
|
<h1><a name="1" class="wiki-page"></a>Formatim Wiki (Markdown)</h1>
|
11
|
|
12
|
<ul class='toc'>
|
13
|
<li><a href='#2'>Lidhje</a></li>
|
14
|
<ul>
|
15
|
<li><a href='#3'>Lidhje Redmine</a></li>
|
16
|
<li><a href='#4'>Lidhje të Jashtme</a></li>
|
17
|
</ul>
|
18
|
<li><a href='#5'>Formatim teksti</a></li>
|
19
|
<ul>
|
20
|
<li><a href='#6'>Stil shkronjash</a></li>
|
21
|
<li><a href='#7'>Figura brendazi</a></li>
|
22
|
<li><a href='#8'>Tituj</a></li>
|
23
|
<li><a href='#10'>Blloqe citimesh</a></li>
|
24
|
<li><a href='#11'>Tryezë e lëndës</a></li>
|
25
|
<li><a href='#14'>Vizore Horizontale</a></li>
|
26
|
</ul>
|
27
|
<li><a href='#12'>Makro</a></li>
|
28
|
<li><a href='#13'>Theksim kodi</a></li>
|
29
|
</ul>
|
30
|
|
31
|
<h2><a name="2" class="wiki-page"></a>Lidhje</h2>
|
32
|
|
33
|
<h3><a name="3" class="wiki-page"></a>Lidhje Redmine</h3>
|
34
|
|
35
|
<p>Redmine lejon krijim lidhjesh mes burimesh (çështje, grupe ndryshimesh, faqe wiki…) prej ngado ku përdoret formatim wiki.</p>
|
36
|
<ul>
|
37
|
<li>Lidhje për te një çështje: <strong>#124</strong> (shfaq <del><a href="#" class="issue" title="bulk edit doesn't change the category or fixed version properties (Closed)">#124</a></del>, lidhja është me vijë përsipër, nëse çështja është mbyllur)</li>
|
38
|
<li>Lidhje për te një çështje, përfshi emër dhe subjekt ndjekësi: <strong>##124</strong> (shfaq <a href="#" class="issue" title="bulk edit doesn't change the category or fixed version properties (New)">të Metën #124</a>: bulk edit doesn't change the category or fixed version properties)</li>
|
39
|
<li>Lidhje për te një shënim çështjeje: <strong>#124-6</strong>, ose <strong>#124#note-6</strong></li>
|
40
|
<li>Lidhje për te një shënim çështjeje brenda të njëjtës çështje: <strong>#note-6</strong></li>
|
41
|
</ul>
|
42
|
|
43
|
<p>Lidhje Wiki:</p>
|
44
|
|
45
|
<ul>
|
46
|
<li><strong>[[Udhërrëfyes]]</strong> shfaq një lidhje për te faqja e quajtur 'Udhërrëfyes': <a href="#" class="wiki-page">Udhërrëfyes</a></li>
|
47
|
<li><strong>[[Guide#lexim-më-tej]]</strong> ju shpie te spiranca "lexim-më-tej". Kryet përfitojnë spiranca të caktuara automatikisht, që të mund t’ju referoheni: <a href="#" class="wiki-page">Udhërrëfyes</a></li>
|
48
|
<li><strong>[[#lexim-më-tej]]</strong> lidhet te spiranca "lexim-më-tej" i faqes së tanishme: <a href="#" class="wiki-page">#lexim-më-tej</a></li>
|
49
|
<li><strong>[[Udhërrëfyes|Doracak përdoruesi]]</strong> shfaq një lidhje te po ajo faqe, por me një tekst tjetër: <a href="#" class="wiki-page">Doracak përdoruesi</a></li>
|
50
|
</ul>
|
51
|
|
52
|
<p>Mund të krijoni lidhje edhe te faqe prej një projekti tjetër wiki:</p>
|
53
|
|
54
|
<ul>
|
55
|
<li><strong>[[bankëprovë:njëfarë faqeje]]</strong> shfaq një lidhje për te faqja e quajtur 'Njëfarë faqeje' e wiki-it Bankëprovë</li>
|
56
|
<li><strong>[[bankëprovë:]]</strong> shfaq një lidhje për te faqja kryesore wiki Bankëprovë</li>
|
57
|
</ul>
|
58
|
|
59
|
<p>Lidhjet Wiki shfaqen të kuqe, nëse faqja s’ekziston ende, p.sh.,: <a href="#" class="wiki-page new">Faqe që s’ekziston</a>.</p>
|
60
|
|
61
|
<p>Lidhje te burime të tjera:</p>
|
62
|
|
63
|
<ul>
|
64
|
<li>Dokumente:
|
65
|
<ul>
|
66
|
<li><strong>document#17</strong> (lidhje te dokumenti me id-në 17)</li>
|
67
|
<li><strong>document:Përshëndetje</strong> (lidhje te dokumenti me titull "Përshëndetje")</li>
|
68
|
<li><strong>document:"Njëfarë dokumenti"</strong> (thonjëzat dyshe mund të përdoren kur titulli i dokumentit përmban hapësira)</li>
|
69
|
<li><strong>bankëprovë:document:"Njëfarë dokumenti"</strong> (lidhje për te një dokument me titull "Njëfarë dokumenti" në një projekt tjetër "bankëprovë")</li>
|
70
|
</ul>
|
71
|
</li>
|
72
|
</ul>
|
73
|
|
74
|
<ul>
|
75
|
<li>Versione:
|
76
|
<ul>
|
77
|
<li><strong>version#3</strong> (lidhje për te versioni me id 3)</li>
|
78
|
<li><strong>version:1.0.0</strong> (lidhje për te versioni i quajtur "1.0.0")</li>
|
79
|
<li><strong>version:"1.0 beta 2"</strong></li>
|
80
|
<li><strong>bankëprovë:version:1.0.0</strong> (lidhje për te versioni "1.0.0" te projekti "bankëprovë")</li>
|
81
|
</ul>
|
82
|
</li>
|
83
|
</ul>
|
84
|
|
85
|
<ul>
|
86
|
<li>Bashkëngjitje:
|
87
|
<ul>
|
88
|
<li><strong>attachment:kartelë.zip</strong> (lidhje për te bashkëngjitja e objektit të tanishëm të quajtur kartelë.zip)</li>
|
89
|
<li>Hëpërhë, mund të referencohen vetëm bashkëngjitjet e objektit të tanishëm (nëse gjendeni në një çështje, është e mundur të referencohen bashkëngjitje të kësaj çështjeje vetëm)</li>
|
90
|
</ul>
|
91
|
</li>
|
92
|
</ul>
|
93
|
|
94
|
<ul>
|
95
|
<li>Grupe ndryshimesh:
|
96
|
<ul>
|
97
|
<li><strong>r758</strong> (lidhje te një grup ndryshimesh)</li>
|
98
|
<li><strong>commit:c6f4d0fd</strong> (lidhje te një grup ndryshimesh me një hash jo numerik)</li>
|
99
|
<li><strong>svn1|r758</strong> (lidhje te një grup ndryshimesh të një depoje specifike, për projekte me shumë depo)</li>
|
100
|
<li><strong>commit:hg|c6f4d0fd</strong> (lidhje te një grup ndryshimesh me një hash jo numerik të një depoje specifike)</li>
|
101
|
<li><strong>bankëprovë:r758</strong> (lidhje te një grup ndryshimesh të një projekti tjetër)</li>
|
102
|
<li><strong>bankëprovë:commit:c6f4d0fd</strong> (lidhje te një grup ndryshimesh me një hash jo numerik të një projekti tjetër)</li>
|
103
|
</ul>
|
104
|
</li>
|
105
|
</ul>
|
106
|
|
107
|
<ul>
|
108
|
<li>Kartela depoje:
|
109
|
<ul>
|
110
|
<li><strong>source:njëfarë/kartele</strong> (lidhje te kartela e gjendur te /njëfarë/kartele në depon e projektit)</li>
|
111
|
<li><strong>source:njëfarë/kartele@52</strong> (lidhje te rishikimi 53 i kartelës)</li>
|
112
|
<li><strong>source:njëfarë/kartele#L120</strong> (lidhje te rreshti 120 i kartelës)</li>
|
113
|
<li><strong>source:njëfarë/kartele@52#L120</strong> (lidhje te rreshti 120 i rishikimit 52 të kartelës)</li>
|
114
|
<li><strong>source:"njëfarë/kartele@52#L120"</strong> (kur URL-ja përmban hapësira, përdorni thonjëza dyshe</li>
|
115
|
<li><strong>export:njëfarë/kartele</strong> (detyro shkarkimin e kartelës)</li>
|
116
|
<li><strong>source:svn1|njëfarë/kartele</strong> (lidhje te një kartelë e një depoje specifike, për projekte me shumë depo)</li>
|
117
|
<li><strong>bankëprovë:source:njëfarë/kartele</strong> (lidhje te kartela e gjendur te /njëfarë/kartele në depon e projektit "bankëprovë")</li>
|
118
|
<li><strong>bankëprovë:export:njëfarë/kartele</strong> (detyro shkarkimin e kartelës)</li>
|
119
|
</ul>
|
120
|
</li>
|
121
|
</ul>
|
122
|
|
123
|
<ul>
|
124
|
<li>Forume:
|
125
|
<ul>
|
126
|
<li><strong>forum#1</strong> (lidhje për te forumi me id 1</li>
|
127
|
<li><strong>forum:Asistencë</strong> (lidhje për te forumi i quajtur Asistencë)</li>
|
128
|
<li><strong>forum:"Asistencë Teknike"</strong> (përdorni thonjëza dyshe, nëse emri i forumit përmban hapësira)</li>
|
129
|
</ul>
|
130
|
</li>
|
131
|
</ul>
|
132
|
|
133
|
<ul>
|
134
|
<li>Mesazhe forumi:
|
135
|
<ul>
|
136
|
<li><strong>message#1218</strong> (lidhje te mesazhi me id 1218)</li>
|
137
|
</ul>
|
138
|
</li>
|
139
|
</ul>
|
140
|
|
141
|
<ul>
|
142
|
<li>Projekte:
|
143
|
<ul>
|
144
|
<li><strong>project#3</strong> (lidhje te projekti me id 3)</li>
|
145
|
<li><strong>project:njëfarë-projekti</strong> (lidhje te projekti me emrin ose identifikusin "njëfarë-projekti")</li>
|
146
|
<li><strong>project:Njëfarë Projekti"</strong> (për emra projektesh që përmbajnë hapësira përdorni thonjëza dyshe)</li>
|
147
|
</ul>
|
148
|
</li>
|
149
|
</ul>
|
150
|
|
151
|
<ul>
|
152
|
<li>Lajm:
|
153
|
<ul>
|
154
|
<li><strong>news#2</strong> (lidhje te artikull lajmesh me id 2)</li>
|
155
|
<li><strong>news:Përshëndetje</strong> (lidhje te artikull lajmesh të quajtur "Përshëndetje")</li>
|
156
|
<li><strong>news:"Hedhja e Parë Në Qarkullim"</strong> (për emra artikujsh lajmesh që përmbajnë hapësira përdorni thonjëza)</li>
|
157
|
</ul>
|
158
|
</li>
|
159
|
</ul>
|
160
|
|
161
|
<ul>
|
162
|
<li>Përdorues:
|
163
|
<ul>
|
164
|
<li><strong>user#2</strong> (lidhje te përdoruesi me id id 2)</li>
|
165
|
<li><strong>user:kaqoli</strong> (Lidhje te përdoruesi me emër përdoruesi kaqoli)</li>
|
166
|
<li><strong>@kaqoli</strong> (Lidhje te përdoruesi me emër përdoruesi kaqoli)</li>
|
167
|
</ul>
|
168
|
</li>
|
169
|
</ul>
|
170
|
|
171
|
<p><em>Escaping</em>:</p>
|
172
|
|
173
|
<ul>
|
174
|
<li>Mund të pengoni përtypjen e lidhjeve Redmine duke i paraprirë ato me një pikëçuditje: !</li>
|
175
|
</ul>
|
176
|
|
177
|
|
178
|
<h3><a name="4" class="wiki-page"></a>Lidhje të jashtme</h3>
|
179
|
|
180
|
<p>URL-ra (ç’fillon me: www, http, https, ftp, ftps, sftp dhe sftps) dhe adresa email shndërrohen vetvetiu në lidhje të klikueshme:</p>
|
181
|
|
182
|
<pre>
|
183
|
http://www.redmine.org, dikush@foo.bar
|
184
|
</pre>
|
185
|
|
186
|
<p>shfaq: <a class="external" href="http://www.redmine.org">http://www.redmine.org</a>, <a href="mailto:someone@foo.bar" class="email">dikush@foo.bar</a></p>
|
187
|
|
188
|
<p>Nëse doni të shfaqni një tekst të caktuar, në vend se URL-në, mund të përdorni sintaksën standarde <em>Markdown</em>:</p>
|
189
|
|
190
|
<pre>
|
191
|
[Sajti Redmine](http://www.redmine.org)
|
192
|
</pre>
|
193
|
|
194
|
<p>shfaq: <a href="http://www.redmine.org" class="external">Sajti Redmine</a></p>
|
195
|
|
196
|
|
197
|
<h2><a name="5" class="wiki-page"></a>Formatim teksti</h2>
|
198
|
|
199
|
|
200
|
<p>Për gjëra të tilla si kryetituj, të trasha, tabela, lista, Redmine mbulon sintaksën Markdown. Për të dhëna mbi përdorimin e cilësdo prej këtyre veçorive, shihni <a class="external" href="http://daringfireball.net/projects/markdown/syntax">http://daringfireball.net/projects/markdown/syntax</a>. Një dorë shembujsh jepen më poshtë, por mekanizmi është i aftë për shumë më tepër se kaq.</p>
|
201
|
|
202
|
<h3><a name="6" class="wiki-page"></a>Stil shkronjash</h3>
|
203
|
|
204
|
<pre>
|
205
|
* **të trasha**
|
206
|
* *Të pjerrëta*
|
207
|
* ***të trasha të pjerrëta***
|
208
|
* _të nënvizuara_
|
209
|
* ~~hequrvije~~
|
210
|
</pre>
|
211
|
|
212
|
<p>shfaq:</p>
|
213
|
|
214
|
<ul>
|
215
|
<li><strong>të trasha</strong></li>
|
216
|
<li><em>të pjerrëta</em></li>
|
217
|
<li><em><strong>të trasha të pjerrëta</strong></em></li>
|
218
|
<li><u>të nënvizuara</u></li>
|
219
|
<li><del>hequrvije</del></li>
|
220
|
</ul>
|
221
|
|
222
|
<h3><a name="7" class="wiki-page"></a>Figura brendazi</h3>
|
223
|
|
224
|
<ul>
|
225
|
<li><strong>![](image_url)</strong> shfaq një figurë të gjendur te image_url (sintaksë Markdown)</li>
|
226
|
<li>Nëse keni një figurë të bashkëngjitur te faqja juaj wiki, mund të shfaqet brendazi duke përdorur emrin e kartelës për të: <strong>![](figura_bashkëngjitur)</strong></li>
|
227
|
<li>Figura në të papastrën e kompjuterit tuaj mund të ngjiten drejtpërsëdrejti duke përdorur Ctrl-v ose Command-v (mbani parasysh që kjo nuk mbulohet nën Internet Explorer).</li>
|
228
|
<li>Kartela figurash mund të tërhiqen te fusha e teksteve që të mund të ngarkohen dhe trupëzohen.</li>
|
229
|
</ul>
|
230
|
|
231
|
<h3><a name="8" class="wiki-page"></a>Tituj</h3>
|
232
|
|
233
|
<pre>
|
234
|
# Titull
|
235
|
## Nëntitull
|
236
|
### Nënnëntitull
|
237
|
</pre>
|
238
|
|
239
|
<p>Redmine u cakton një spirancë secilit prej këtyre titujve, kështu që mund t’i lidhni me "#Titull", "#Nëntitull" e me radhë.</p>
|
240
|
|
241
|
|
242
|
<h3><a name="10" class="wiki-page"></a>Blloqe citimesh</h3>
|
243
|
|
244
|
<p>Niseni paragrafin me <strong>></strong></p>
|
245
|
|
246
|
<pre>
|
247
|
> Rails është një platformë e plotë për zhvillim aplikacionesh web ngritur mbi bazë të dhënash sipas rregullsisë Model-Parje-Kontrol.
|
248
|
Për të shfaqur sajtin, krejt ç’ju duhet është një bazë të dhënash dhe një shërbyes.
|
249
|
</pre>
|
250
|
|
251
|
<p>Shfaq:</p>
|
252
|
|
253
|
<blockquote>
|
254
|
<p>Rails është një platformë e plotë për zhvillim aplikacionesh web ngritur mbi bazë të dhënash sipas rregullsisë Model-Parje-Kontrol. Për të shfaqur sajtin, krejt ç’ju duhet është një bazë të dhënash dhe një shërbyes.</p>
|
255
|
</blockquote>
|
256
|
|
257
|
|
258
|
<h3><a name="11" class="wiki-page"></a>Tryezë lënde</h3>
|
259
|
|
260
|
<pre>
|
261
|
{{toc}} => tl e vendosur majtas
|
262
|
{{>toc}} => tl e vendosur djathtas
|
263
|
</pre>
|
264
|
|
265
|
<h3><a name="14" class="wiki-page"></a>Vizore Horizontale</h3>
|
266
|
|
267
|
<pre>
|
268
|
---
|
269
|
</pre>
|
270
|
|
271
|
<h2><a name="12" class="wiki-page"></a>Makro</h2>
|
272
|
|
273
|
<p>Redmine përmban makrot e brendshme vijuese:</p>
|
274
|
|
275
|
<p>
|
276
|
<dl>
|
277
|
<dt><code>hello_world</code></dt>
|
278
|
<dd><p>Shembull makroje.</p></dd>
|
279
|
|
280
|
<dt><code>macro_list</code></dt>
|
281
|
<dd><p>Shfaq një listë të krejt makrove të gatshme, përfshi përshkrimet përkatëse, në pastë.</p></dd>
|
282
|
|
283
|
<dt><code>child_pages</code></dt>
|
284
|
<dd><p>Shfaq një listë të faqeve pjella. Pa ndonjë argument, shfaq faqet pjella të faqes së tanishme wiki. Shembuj:</p>
|
285
|
<pre><code>{{child_pages}} -- mund të përdoren vetëm që prej një faqeje wiki
|
286
|
{{child_pages(depth=2)}} -- shfaq vetëm 2 shkallë të folezëzimit</code></pre></dd>
|
287
|
|
288
|
<dt><code>include</code></dt>
|
289
|
<dd><p>Përfshini një faqe wiki. Shembull:</p>
|
290
|
<pre><code>{{include(Foo)}}</code></pre>
|
291
|
<p>ose, për të përfshirë një faqe të një projekti specifik:</p>
|
292
|
<pre><code>{{include(projectname:Foo)}}</code></pre></dd>
|
293
|
|
294
|
<dt><code>collapse</code></dt>
|
295
|
<dd><p>Fut bllok teksti të tkurrur. Shembull:</p>
|
296
|
<pre><code>{{collapse(Shihni hollësitë…)
|
297
|
Ky është një bllok teksti që, si parazgjedhje, është tkurrur.
|
298
|
Mund të zgjerohet duke klikuar mbi një lidhje.
|
299
|
}}</code></pre></dd>
|
300
|
|
301
|
<dt><code>thumbnail</code></dt>
|
302
|
<dd><p>Shfaq një miniaturë të klikueshme të një figure të bashkëngjitur. Shembull:</p>
|
303
|
<pre>{{thumbnail(image.png)}}
|
304
|
{{thumbnail(image.png, size=300, title=Thumbnail)}}</pre></dd>
|
305
|
|
306
|
<dt><code>issue</code></dt>
|
307
|
<dd><p>Fut një lidhje te një çështje, me një tekst të zhdërvjellët. Shembuj:</p>
|
308
|
<pre>{{issue(123)}} -- Çështja #123: Thellim aftësish makrosh
|
309
|
{{issue(123, project=true)}} -- Andromeda - Çështja #123:Thellim aftësish makrosh
|
310
|
{{issue(123, tracker=false)}} -- #123: Thellim aftësish makrosh
|
311
|
{{issue(123, subject=false, project=true)}} -- Andromeda - Çështja #123</pre></dd>
|
312
|
</dl>
|
313
|
</p>
|
314
|
|
315
|
<h2><a name="13" class="wiki-page"></a>Theksim kodi</h2>
|
316
|
|
317
|
<p>Theksimi parazgjedhje i kodit bazohet në <a href="http://rouge.jneen.net/" class="external">Rouge</a>, një librari theksimi sintakse, shkruar 100% në Ruby. Mbulon mjaft nga gjuhët e përdorura rëndom, të tilla si <strong>c</strong>, <strong>cpp</strong> (c++), <strong>csharp</strong> (c#, cs), <strong>css</strong>, <strong>diff</strong> (patch, udiff), <strong>go</strong> (golang), <strong>groovy</strong>, <strong>html</strong>, <strong>java</strong>, <strong>javascript</strong> (js), <strong>kotlin</strong>, <strong>objective_c</strong> (objc), <strong>perl</strong> (pl), <strong>php</strong>, <strong>python</strong> (py), <strong>r</strong>, <strong>ruby</strong> (rb), <strong>sass</strong>, <strong>scala</strong>, <strong>shell</strong> (bash, zsh, ksh, sh), <strong>sql</strong>, <strong>swift</strong>, gjuhë <strong>xml</strong> dhe <strong>yaml</strong> (yml), ku emrat brenda kllapash janë aliase. Për listën e plotë të gjuhëve të mbuluara, ju lutemi, referojuni <a href="https://www.redmine.org/projects/redmine/wiki/RedmineCodeHighlightingLanguages" class="external">https://www.redmine.org/projects/redmine/wiki/RedmineCodeHighlightingLanguages</a>.</p>
|
318
|
|
319
|
<p>Mund të theksoni kod në çfarëdo vendi që mbulon formatim wiki duke përdorur këtë sintaksë (kini parasysh që emri ose aliasi për gjuhën s’varet nga shkrimi me të madhe apo të vogël):</p>
|
320
|
|
321
|
<pre>
|
322
|
``` ruby
|
323
|
Vendosni këtu kodin tuaj.
|
324
|
```
|
325
|
</pre>
|
326
|
|
327
|
<p>Shembull:</p>
|
328
|
|
329
|
<pre><code class="ruby syntaxhl"><span class="c1"># The Greeter class</span>
|
330
|
<span class="k">class</span> <span class="nc">Greeter</span>
|
331
|
<span class="k">def</span> <span class="nf">initialize</span><span class="p">(</span><span class="nb">name</span><span class="p">)</span>
|
332
|
<span class="vi">@name</span> <span class="o">=</span> <span class="nb">name</span><span class="p">.</span><span class="nf">capitalize</span>
|
333
|
<span class="k">end</span>
|
334
|
|
335
|
<span class="k">def</span> <span class="nf">salute</span>
|
336
|
<span class="nb">puts</span> <span class="s2">"Hello </span><span class="si">#{</span><span class="vi">@name</span><span class="si">}</span><span class="s2">!"</span>
|
337
|
<span class="k">end</span>
|
338
|
<span class="k">end</span>
|
339
|
</code></pre>
|
340
|
</body>
|
341
|
</html>
|