Project

General

Profile

RusRedmineTextFormatting » History » Version 52

Lucy Yevseyeva, 2014-06-21 17:54

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