Project

General

Profile

RusRedmineTextFormatting » History » Version 39

Lucy Yevseyeva, 2014-06-21 17:24

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