Project

General

Profile

RusRedmineTextFormatting » History » Version 36

Lucy Yevseyeva, 2014-06-21 17:22

1 5 Lucy Yevseyeva
p(breadcrumb). [[RusGuide|Руководство]] » [[RusUser_Guide|Руководство пользователя]]
2
3 7 Lucy Yevseyeva
Оригинал: [[RedmineTextFormatting|Wiki formatting v.101]] - дополнено и переработано.
4 4 Lucy Yevseyeva
5 3 Lucy Yevseyeva
h1. Оформление текстов
6 1 Ruslan Khasanov
7 3 Lucy Yevseyeva
{{>TOC}}
8 1 Ruslan Khasanov
9 31 Lucy Yevseyeva
Для таких вещей как заголовки, выделение текста, таблицы, списки и т.п. Redmine поддерживает[0] парсер "Textile":http://textile.thresholdstate.com.
10 1 Ruslan Khasanov
11 35 Lucy Yevseyeva
fn0. Синтаксис Textile поддерживается в Redmine не полностью. В частности, не преобразуются спецсимволы, например, (с) в ©, -- в — и т.п.
12 24 Lucy Yevseyeva
13
p.  
14
15 3 Lucy Yevseyeva
h2. Строчные элементы
16 1 Ruslan Khasanov
17 3 Lucy Yevseyeva
h3. Внешние ссылки
18 1 Ruslan Khasanov
19 3 Lucy Yevseyeva
Адреса http(s), ftp и mail автоматически преобразуются в "кликабельные" ссылки:
20 1 Ruslan Khasanov
21 3 Lucy Yevseyeva
p(. *http://www.redmine.org*:  http://www.redmine.org
22 1 Ruslan Khasanov
23 3 Lucy Yevseyeva
Для размещения в ссылке произвольного текста используйте следующую разметку:
24 1 Ruslan Khasanov
25
p(. *"Главная страница проекта Redmine":http://www.redmine.org*: "Главная страница проекта Redmine":http://www.redmine.org.
26
27 7 Lucy Yevseyeva
h3. E-mail ссылки
28
29
p(. *someone@foo.bar*: someone@foo.bar.
30
31
В ссылке на e-mail адрес можно указать тему, текст письма и адреса для отправки копий.
32
33
p(. *"Email webmaster and admin":mailto:webmaster@foo.bar?cc=admin@foo.bar*: "Email webmaster and admin":mailto:webmaster@foo.bar?cc=admin@foo.bar -- указание адреса для отправки копии.
34
35
p(. *"Email someone for help":mailto:someone@foo.bar?subject=Website%20Help*: "Email someone for help":mailto:someone@foo.bar?subject=Website%20Help -- указание темы письма.
36
37
p(. *"Email someone for help":mailto:someone@foo.bar?subject=Website%20Help&body=My%20problem%20is%20*: "Email someone for help":mailto:someone@foo.bar?subject=Website%20Help&body=My%20problem%20is%20 -- указание текста письма.
38
39
p(. _*Важно_:* вместо пробелов в ссылку следует вставлять код %20.
40 8 Lucy Yevseyeva
41 3 Lucy Yevseyeva
h3. Акронимы
42 1 Ruslan Khasanov
43 28 Lucy Yevseyeva
Ненавязчиво пояснить аббревиатуры в тексте можно следующим образом:
44 1 Ruslan Khasanov
45
p(. *JPL(Jean-Philippe Lang)*: JPL(Jean-Philippe Lang).
46 28 Lucy Yevseyeva
47
К сожалению, не работает для кириллицы: ИС(Информационные Системы)
48 1 Ruslan Khasanov
49 3 Lucy Yevseyeva
h3. Стили шрифтов
50 1 Ruslan Khasanov
51 3 Lucy Yevseyeva
p(. *_italic_*: _курсив_
52 1 Ruslan Khasanov
53 3 Lucy Yevseyeva
p(. **_bold italic_**: *_жирный курсив_*
54 1 Ruslan Khasanov
55 3 Lucy Yevseyeva
p(. *+underline+*: +подчеркнутый+
56 1 Ruslan Khasanov
57 3 Lucy Yevseyeva
p(. *-strike-through-*: -перечеркнутый-
58 1 Ruslan Khasanov
59 3 Lucy Yevseyeva
p(. *Plain ^superscript^*: ^Верхний^ индекс
60 1 Ruslan Khasanov
61 3 Lucy Yevseyeva
p(. *Plain ~subscript~*: ~Нижний~ индекс
62 1 Ruslan Khasanov
63 3 Lucy Yevseyeva
p(. *inline @monospace@*: @моноширинный@ шрифт
64 1 Ruslan Khasanov
65 3 Lucy Yevseyeva
p(. *??cite??*: ??цитата??
66 1 Ruslan Khasanov
67 3 Lucy Yevseyeva
h3. Изображения
68 1 Ruslan Khasanov
69 11 Lucy Yevseyeva
+Внешние:+
70 1 Ruslan Khasanov
71 10 Lucy Yevseyeva
p(. *!image_url!* — встраивает в текст изображение, находящееся по внешнему адресу image_url.
72 1 Ruslan Khasanov
73 10 Lucy Yevseyeva
p(. *!image_url(Image title)!* — изображение будет снабжено заголовком.
74 1 Ruslan Khasanov
75 11 Lucy Yevseyeva
* встроенное изображение, причем текст будет продолжен после изображения !i0003.gif(Индеец)! вот так, а при наведении курсора на изображение появится текст. Этот текст также появится,если изображение по какой-либо причине недоступно — !i0004.gif(Индеец)! (отображение зависит от браузера)
76
77 1 Ruslan Khasanov
p(. *!>image_url!* — изображение выровнено по правому краю, текст обтекает изображение по левому краю.
78
79 11 Lucy Yevseyeva
* изображение отображается справа от текста !>i0003.gif!
80 1 Ruslan Khasanov
пример изображения справа от текста
81
опять справа от текста
82
еще справа от текста
83
и тут картинка справа от текста
84
а тут текст слева от картинки
85 11 Lucy Yevseyeva
86
+Прикрепленные:+
87
88
p(. *!attached_image.png!* — встраивает в текст изображение attached_image.png, прикрепленное к странице.
89
90
p(. *!{width:50%}attached_image.png!* — задаёт ширину изображения относительно блока, в который его встроили
91
92
* !{width:50%}http://www.redmine.org/screenshots/scm_diff.png!
93
94
*_Важно:_* ссылки на прикрепленные изображения действуют только на той странице, к которой они прикреплены.
95 1 Ruslan Khasanov
96 3 Lucy Yevseyeva
h2. Блочные элементы
97 1 Ruslan Khasanov
98 3 Lucy Yevseyeva
Для корректной обработки textile-разметки рекомендуется помещать блочные элементы (p, h, bq, fn) в самое начало строки и отделять их от остального текста пустыми строками.
99 1 Ruslan Khasanov
100 3 Lucy Yevseyeva
h3. Заголовки
101 1 Ruslan Khasanov
102 3 Lucy Yevseyeva
p(. *hn.* Заголовок n-ного уровня, где _n_ принимает значение от 1 до 6.
103 1 Ruslan Khasanov
104 13 Lucy Yevseyeva
<pre>
105
h1. Заголовок 1
106
107 25 Lucy Yevseyeva
h2=. Заголовок 2 // = выравнивание по центру
108 13 Lucy Yevseyeva
109 25 Lucy Yevseyeva
h3>. Заголовок 3 // > выравнивание по правому краю
110 13 Lucy Yevseyeva
</pre>
111
112 14 Lucy Yevseyeva
Заголовки снабжаются якорями, на которые можно будет давать ссылки (см. раздел [[RusRedmineTextFormatting#Wiki-страницы|Wiki-страницы]]).
113
114 15 Lucy Yevseyeva
Расставленные в тексте заголовки формируют блок "содержания" страницы, который можно встроить на страницу с помощью специального [[RusRedmineTextFormatting#Содержание|макроса]].
115 13 Lucy Yevseyeva
116 3 Lucy Yevseyeva
h3. Абзацы
117 1 Ruslan Khasanov
118 3 Lucy Yevseyeva
p. *p.* Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
119 1 Ruslan Khasanov
120 3 Lucy Yevseyeva
p(. *p(.* Отступ слева в 1em. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
121 1 Ruslan Khasanov
122 3 Lucy Yevseyeva
p((. *p((.* Отступ слева в 2em. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
123
Отступ сохраняется для всех следующих без пробела строк.
124 1 Ruslan Khasanov
125 3 Lucy Yevseyeva
p>. *p>.* Выравнивание по правому краю. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
126 1 Ruslan Khasanov
127 3 Lucy Yevseyeva
p<. *p<.* Выравнивание по левому краю (по умолчанию).
128 1 Ruslan Khasanov
129 3 Lucy Yevseyeva
p)))>. *p)))>.* Выравнивание по правому краю с отступом справа в 3em. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
130
_Выравнивание и отступ также сохраняется для всего следующего через перенос строки (@<br>@)
131
 текста._
132 1 Ruslan Khasanov
133 3 Lucy Yevseyeva
_Выравнивание сбрасывается с введением пустой строки между выровненным блочным элементом и остальным текстом._
134 1 Ruslan Khasanov
135 3 Lucy Yevseyeva
p=. *p=.* Выравнивание по центру. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
136 1 Ruslan Khasanov
137 3 Lucy Yevseyeva
p<>. *p<>.* Выравнивание по левому и правому краю. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
138 1 Ruslan Khasanov
139 16 Lucy Yevseyeva
h3. Горизонтальный разделитель
140
141
<pre>
142
---
143
144 17 Lucy Yevseyeva
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor 
145
incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud
146
 exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute 
147
irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla 
148
pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia
149
 deserunt mollit anim id est laborum.
150 16 Lucy Yevseyeva
151
---
152
</pre>
153
154
---
155
156
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
157
158
---
159
160 3 Lucy Yevseyeva
h3. Pre-форматирование
161 1 Ruslan Khasanov
162 3 Lucy Yevseyeva
> Внутри выделенного *тэгами* блока текст не будет преобразован [[RedmineTextFormattingRus#Разметка Textile|Парсером]].
163 1 Ruslan Khasanov
164 3 Lucy Yevseyeva
Чтобы избежать преобразования textile-разметки в html-код используйте тэги @&#60;pre>&#60;/pre>@.
165 1 Ruslan Khasanov
166 3 Lucy Yevseyeva
<pre><pre>Внутри выделенного *тэгами* блока текст не будет преобразован [[RedmineTextFormattingRus#Разметка Textile|Парсером]].</pre></pre>
167 1 Ruslan Khasanov
168
h3. Цитаты
169
170 18 Lucy Yevseyeva
<pre>
171
> "Ruby on Rails" — программный каркас, написанный на языке программирования 
172
Ruby. Ruby on Rails предоставляет архитектурный образец Model-View-Controller 
173
(модель-представление-контроллер) для веб-приложений, а также обеспечивает их 
174
интеграцию с веб-сервером и сервером базы данных.
175
</pre>
176
177
> "Ruby on Rails" — программный каркас, написанный на языке программирования Ruby. Ruby on Rails предоставляет архитектурный образец Model-View-Controller (модель-представление-контроллер) для веб-приложений, а также обеспечивает их интеграцию с веб-сервером и сервером базы данных.
178 1 Ruslan Khasanov
 или
179
180 18 Lucy Yevseyeva
<pre>
181
bq.:http://ru.wikipedia.org/wiki/Ruby_on_Rails "Ruby on Rails" — программный 
182
каркас, написанный на языке программирования Ruby. Ruby on Rails предоставляет 
183
архитектурный образец Model-View-Controller (модель-представление-контроллер) для
184
 веб-приложений, а также обеспечивает их интеграцию с веб-сервером и сервером 
185
базы данных.
186
</pre>
187 1 Ruslan Khasanov
188 18 Lucy Yevseyeva
bq.:http://ru.wikipedia.org/wiki/Ruby_on_Rails "Ruby on Rails" — программный каркас, написанный на языке программирования Ruby. Ruby on Rails предоставляет архитектурный образец Model-View-Controller (модель-представление-контроллер) для веб-приложений, а также обеспечивает их интеграцию с веб-сервером и сервером базы данных.
189
190
<pre>
191 19 Lucy Yevseyeva
>> Вдруг кому пригодится.
192
> Синтаксис textile-ссылки @:http://ru.wikipedia.org/wiki/Ruby_on_Rails@ 
193
преобразуется в html-атрибут @cite="http://ru.wikipedia.org/wiki/Ruby_on_Rails"@.
194 18 Lucy Yevseyeva
</pre>
195
196 19 Lucy Yevseyeva
>> Вдруг кому пригодится.
197
> Синтаксис textile-ссылки @:http://ru.wikipedia.org/wiki/Ruby_on_Rails@ преобразуется в html-атрибут @cite="http://ru.wikipedia.org/wiki/Ruby_on_Rails"@.
198 1 Ruslan Khasanov
199 3 Lucy Yevseyeva
h3. Списки
200 1 Ruslan Khasanov
201 3 Lucy Yevseyeva
Разметка для ненумерованного списка
202
<pre>* Item 1
203
* Item 2
204
** Item 2.1
205
206
 ** Item 2.1.1
207
*** Item 2.1.2
208
** Item 2.2
209
* Item 3
210
211 1 Ruslan Khasanov
** Item 0
212 3 Lucy Yevseyeva
</pre>
213 1 Ruslan Khasanov
отображается как:
214 20 Lucy Yevseyeva
215 3 Lucy Yevseyeva
* Item 1
216
* Item 2
217
** Item 2.1
218 1 Ruslan Khasanov
219 3 Lucy Yevseyeva
 ** Item 2.1.1
220
*** Item 2.1.2
221
** Item 2.2
222
* Item 3
223 1 Ruslan Khasanov
224 3 Lucy Yevseyeva
** Item 0
225 1 Ruslan Khasanov
226 3 Lucy Yevseyeva
Разметка для нумерованного списка
227
<pre># Item 1
228
# Item 2
229 1 Ruslan Khasanov
230 3 Lucy Yevseyeva
 ## Item 2.1
231
232
  ## Item 2.1.1
233
## Item 2.2
234
# Item 3
235
236 1 Ruslan Khasanov
# Item 0
237 3 Lucy Yevseyeva
</pre>
238 1 Ruslan Khasanov
отображается как:
239 20 Lucy Yevseyeva
240 3 Lucy Yevseyeva
# Item 1
241
# Item 2
242 1 Ruslan Khasanov
243 3 Lucy Yevseyeva
 ## Item 2.1
244 1 Ruslan Khasanov
245 3 Lucy Yevseyeva
  ## Item 2.1.1
246
## Item 2.2
247 1 Ruslan Khasanov
# Item 3
248
249
# Item 0
250 20 Lucy Yevseyeva
251
Под элемент списка можно встроить текст, не нарушив нумерации, если поместить его через перенос строки и пробел:
252
253
<pre>* Item 1
254
 some text
255
 some text
256
* Item 2
257
 some text
258
** Item 2.1
259
 some text
260
* Item 3
261
</pre>
262
263
# Item 1
264
 some text
265
 some text
266
# Item 2
267
 some text
268
## Item 2.1
269
 some text
270
# Item 3
271
 some text
272 3 Lucy Yevseyeva
273 1 Ruslan Khasanov
h3. Таблицы
274
275 3 Lucy Yevseyeva
Любое количество пустых символов будет заменено одним пробелом, поэтому для удобства разметки можно использовать текстовый редактор и табуляцию.
276
277 1 Ruslan Khasanov
<pre>
278 3 Lucy Yevseyeva
|_.UserID|_.Name|_.Group|_. attribute list |
279
|\3=.IT               |<. align left|
280
|1|Artur Pirozhkov |/2.Users |>. align right|
281
|2|Vasya Rogov        |=. center |
282
|3|John Smith |Admin
283
               (root)|^. valign top |
284
|4|-          |Nobody
285
               (anonymous)|~. valign bottom|
286
287 1 Ruslan Khasanov
</pre>
288
289 3 Lucy Yevseyeva
Отображается как:
290
|_.UserID|_.Name|_.Group|_. attribute list |
291
|\3=.IT               |<. align left|
292
|1|Artur Pirozhkov |/2.Users |>. align right|
293
|2|Vasya Rogov        |=. center |
294 30 Lucy Yevseyeva
|3|John Smith |Admin
295 3 Lucy Yevseyeva
(root)|^. valign top |
296
|4|-          |Nobody
297
               (anonymous)|~. valign bottom|
298 1 Ruslan Khasanov
299 21 Lucy Yevseyeva
Чтобы парсер не обрабатывал символ | как разметку таблицы, символ следует поместить в экранирующие тэги:
300
|_.Input |_. Output|
301
|*<notextile><notextile>|</notextile></notextile>*|<notextile>|</notextile>|
302
303 3 Lucy Yevseyeva
h3. Сноски
304 1 Ruslan Khasanov
305 26 Lucy Yevseyeva
<pre>Поясняемый текст[21]
306 3 Lucy Yevseyeva
307 26 Lucy Yevseyeva
fn21. Поясняющий текст.
308 1 Ruslan Khasanov
309 26 Lucy Yevseyeva
</pre>
310 3 Lucy Yevseyeva
311 26 Lucy Yevseyeva
Поясняемый текст[21]
312
313
fn21. Поясняющий текст.
314 3 Lucy Yevseyeva
315 32 Lucy Yevseyeva
316
Ссылка не обрабатывается парсером, если отделяется от поясняемой фразы: например [4] или "другой пример"[4].
317
318 36 Lucy Yevseyeva
h2. CSS
319 3 Lucy Yevseyeva
320
h3. Идентификаторы
321
322
p(. *p(#id).* -- присваивает абзацу идентификатор id.
323
324
Пример: 
325
326 33 Lucy Yevseyeva
p((#id). Данный абзац имеет идентификатор id (якорь), что может быть использовано, например, для создания [[RedmineTextFormattingRus#id|ссылки]] на него без использования заголовков.
327 3 Lucy Yevseyeva
328 36 Lucy Yevseyeva
h3. Классы
329 3 Lucy Yevseyeva
330 33 Lucy Yevseyeva
p(. *p(class_name).* -- присваивает абзацу класс.
331 1 Ruslan Khasanov
332 33 Lucy Yevseyeva
Примеры:
333 3 Lucy Yevseyeva
334 33 Lucy Yevseyeva
p((breadcrumb). Хлебные крошки [[Guide|Руководство »]] [[User Guide|Руководство пользователя »]]
335 1 Ruslan Khasanov
336
p(wiki_page-21-watcher icon icon-fav). Избранное
337 36 Lucy Yevseyeva
338
h3. Стили
339
340
*<notextile>%</notextile>{background:lightgreen}Зеленый фон%* — %{background:lightgreen}Зеленый фон%
341
342
*<notextile>%</notextile>{text-decoration:blink}"Надчеркивание"%* — %{text-decoration:overline}"Надчеркивание"%
343
344
Допустимо и всевозможное сочетание:
345
346
*<notextile>%</notextile>{background:silver;color:black;border-style:outset;padding:5px}Отмена%* — *%{background:silver;color:black;border-style:outset;padding:5px}Отмена%*
347 3 Lucy Yevseyeva
348
h2. Ссылки на объекты
349
350
Чтобы предотвратить преобразование redmine-разметки в ссылку поставьте перед ней восклицательный знак.
351
352
h3. Задачи
353
354
p(. *!#124*: #124 -- ссылка перечеркнута, если задача закрыта.
355
356
h3. Редакции
357
358
p(. *!r758*: r758
359
360
h3. Коммиты 
361
362
p(. *commit:c6f4d0fd*: commit:c6f4d0fd
363
364
h3. Wiki-страницы
365
366
Ссылка отображается красной, если страницы не существует: [[Nonexistent page]].
367
368
p(. *&#91;&#91;Guide&#93;&#93;*: [[Guide]]
369
370
p(. *&#91;&#91;Guide&#124;User manual&#93;&#93;*: [[Guide|User manual]] -- ссылка с произвольным текстом.
371
372
p(. *&#91;&#91;Guide#User-guide&#124;User guide&#93;&#93;*: [[Guide#User-guide|User guide]] -- ссылка на определенный заголовок страницы.
373
_После символа # в названии заголовка ставятся дефисы вместо пробелов._
374
375
p(. *&#91;&#91;someproject:some-page&#93;&#93;* -- ссылка на wiki-страницу из другого проекта.
376
377
p(. *&#91;&#91;someproject:&#93;&#93;* -- ссылка на главную страницу Wiki другого проекта.
378
379
h3. Документы
380
381
p(. *!document#17* -- ссылка на документ по идентификатору.
382
383
p(. *!document:somedocument* -- ссылка на документ по названию.
384
385
p(. *!document:"Some document"* -- название заключается в двойные кавычки, если в нем есть пробелы.
386
387
p(. *!document:some_project:"Some document"* -- ссылка по названию на доукумент в другом проекте.
388
389
h3. Версии
390
391
p(. *!version#3* -- ссылка на версию по идентификатору.
392
393
p(. *!version:1.0.0* -- ссылка на версию по названию.
394
395
p(. *!version:"1.0 beta 2"* -- название заключается в двойные кавычки, если в нем есть пробелы.
396
397
h3. Проекты
398
399
p(. *project#4* или *!project:someid* -- ссылка на проект по числовому или символьному идентификатору.
400
401
p(. *!project:someproject* - ссылка на проект по названию.
402
403
p(. *!project:"Some project"* - название заключается в двойные кавычки, если в нем есть пробелы.
404
405
h3. Вложения
406
  
407
p(. *!attachment:i0003.gif*: attachment:i0003.gif -- ссылка на файл, прикрепленный к данной странице.
408
409
p((#attach). _*Важно*_: ссылки на прикрепленные файлы действуют только на той странице, к которой они прикреплены.
410
411
h3. Репозиторий
412
413
p(. *!source:some/file* -- ссылка на файл репозитория.
414
415
p(. *!source:some/file@52* -- ссылка на редакцию файла репозитория.
416
417
p(. *!source:some/file#L120* -- ссылка на строку файла репозитория.
418
419
p(. *!source:some/file@52#L120* -- комбинация разметки.
420
421
p(. *!source:"some file@52#L120"* -- двойные кавычки используются, если в URL присутствуют пробелы.
422
423
p(. *!export:some/file* -- ссылка на скачивание файла.
424
425
h2. Макросы
426
427
Список доступных макросов и их описание (по-английски) вызывается макросом *&#123;{macro_list}}*.
428
429
{{>TOC}}
430
431 1 Ruslan Khasanov
h3. Содержание
432
433 3 Lucy Yevseyeva
*&#123;{TOC}}* -- отображает содержание страницы, которое формируется автоматически на основе [[RedmineTextFormattingRus#Заголовки|заголовков]].
434
*&#123;{>TOC}}* -- выравнивание блока содержания по правому краю:
435 1 Ruslan Khasanov
436 3 Lucy Yevseyeva
h3. Дочерние страницы
437 1 Ruslan Khasanov
438 3 Lucy Yevseyeva
*&#123;{child_pages}}* -- выводит список ссылок на все "дочерние страницы":http://www.redmine.org/projects/redmine/wiki/RedmineWikis#Creating-sub-pages-parentchild-relationships (англ.) данной страницы.
439
*&#123;{child_pages(Foo)}}* -- выводит список ссылок для указанной в скобках wiki-страницы [[Foo]].
440
*&#123;{child_pages(Foo, parent=1)}}* -- начинает список со ссылки на родительскую страницу.
441 1 Ruslan Khasanov
442 3 Lucy Yevseyeva
Пример последнего макроса для страницы [[Teams]]:
443
{{child_pages(Teams, parent=1)}}
444 1 Ruslan Khasanov
445 3 Lucy Yevseyeva
h3. Включение текста
446 1 Ruslan Khasanov
447 3 Lucy Yevseyeva
*&#123;{include(Foo)}}* -- включает в данном месте текста содержимое страницы [[Foo]] без каких-либо специальных обозначений.
448 1 Ruslan Khasanov
449 3 Lucy Yevseyeva
Пример:
450 1 Ruslan Khasanov
451 3 Lucy Yevseyeva
{{include(Foo)}}
452
Если включаемой страницы не существует или у пользователя нет к ней доступа, будет выведено сообщение об ошибке.
453
454
h2. Подсветка кода
455
456
Подсветка кода реализована на "CodeRay":http://coderay.rubychan.de/ - скоростной библиотеке, написанной на Ruby. Она поддерживает синтаксис C, C++, CSS, Delphi, Diff, Groovy, HTML, Java, Javascript, JSON, Nitro-XHTML, PHP, Python, RHTML, Ruby, Scheme, SQL, XML и YAML.
457
458
Чтобы подсветить код, используйте следующую разметку:
459
460 1 Ruslan Khasanov
<pre><code><pre><code class="ruby">
461 3 Lucy Yevseyeva
  Place your code here.
462 1 Ruslan Khasanov
</code></pre>
463
</code></pre>
464
465
Пример:
466
467
<pre><code class="ruby">
468
# The Greeter class
469 2 Denis Savitskiy
class Greeter
470 1 Ruslan Khasanov
  def initialize(name)
471
    @name = name.capitalize
472
  end
473
 
474
  def salute
475
    puts "Hello #{@name}!"
476
  end
477
end
478
</code></pre>
479 3 Lucy Yevseyeva
480
h2. Заключение
481
482
Простейшие возможности разметки доступны через кнопки над полем ввода, однако, все варианты оформления применимы к любому тексту в Redmine: задаче, новости, комментарию и т.п.
483
Историю изменений wiki-страницы можно посмотреть, нажав ссылку "История " вверху справа.
484
В качестве примера всех перечисленных вариантов разметки можно рассмотреть исходный код данной статьи.