RusRedmineTextFormatting » History » Version 72

Lucy Yevseyeva, 2014-06-21 20:04

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