Форматирование Wiki

Ссылки

Ссылки Redmine

Redmine допускает гиперссылки между ресурсами (задачи, версии, wiki-страницы) отовсюду в wiki-формате.

Wiki ссылки:

Также вы можете ссылаться на wiki:

Ссылки на wiki окрашены в красный, если страница ещё не создана, пример: Несуществующая страница.

ССылки на другие ресурсы:

Исключения:

Внешние ссылки

URLs (starting with: www, http, https, ftp, ftps, sftp and sftps) and email addresses are automatically turned into clickable links:

http://www.redmine.org, someone@foo.bar

выводится: http://www.redmine.org, someone@foo.bar

Если же вы хотите, чтобы отобразился текст вместо адреса URL, вы можете испольовать стандартный синтаксис форматирования текста:

"Сайт Redmine":http://www.redmine.org

выводится: Сайт Redmine

Форматирование текста

Для таких вещей, как заголовки, выделение, таблицы и списки, Redmine поддерживает синтакс Textile. Обратитесь за руководством к странице http://en.wikipedia.org/wiki/Textile_(markup_language) . Несколько примеров приведены ниже, Но сам текстовый процессор способен на гораздо большее.

Стиль шрифта

* *выделенный*
* _наклонный_
* _*выделенный наклонный*_
* +подчёркнутый+
* -зачёркнутый-

Выводится:

Вставка изображений

Заголовки

h1. Заголовок

h2. Подзаголовок

h3. Подзаголовок подзаголовка

Redmine присваивает якорь каждому заголовку, поэтому вы можете легко сослаться на любой, указав в тексте "#Заголовок", "#Подзаголовок" и т.д.

Параграфы

p>. выровненный по правому краю
p=. выровненный по центру

Это - выровненный по центру параграф.

Цитаты

Начните параграф с bq.

bq. Rails - это полноценный, многоуровневый фреймворк для построения веб-приложений, использующих базы данных,
    который основан на архитектуре Модель-Представление-Контроллер (Model-View-Controller, MVC).

Выводится:

Rails - это полноценный, многоуровневый фреймворк для построения веб-приложений, использующих базы данных, который основан на архитектуре Модель-Представление-Контроллер (Model-View-Controller, MVC).

Содержание

{{toc}} => содержание, выровненное по левому краю
{{>toc}} => содержание, выровненное по правому краю

Horizontal Rule

---

Макросы

В Redmine существуют следующие встроенные макросы:

hello_world

Некоторый макрос.

macro_list

Выводит список доступных макросов с описаниями, если они имеются.

child_pages

Вывод списка дочерних страниц. Без аргументов выводится список дочерних страниц для текущей wiki-страницы. Пример:

{{child_pages}} -- можно использователь только на wiki-странице
{{child_pages(depth=2)}} -- вывести только 2 уровня вложенности
include

Вставить wiki-страницу. Пример:

{{include(Foo)}}

или вставить сраницу wiki конкретного проекта:

{{include(projectname:Foo)}}
collapse

Вставить скрываемый текст. Пример:

{{collapse(Читать дальше...)
Этот блок текста по умолчанию скрыт.
Он расскроется, если нажать на ссылку.
}}
thumbnail

Отображет кликабельный эскиз приложенной картинки. Пример:

{{thumbnail(image.png)}}
{{thumbnail(image.png, size=300, title=Эскиз)}}

Подсветка кода

Default code highlightment relies on Rouge, a syntax highlighting library written in pure Ruby. It supports many commonly used languages such as c, cpp (c++), csharp (c#, cs), css, diff (patch, udiff), go (golang), groovy, html, java, javascript (js), kotlin, objective_c (objc), perl (pl), php, python (py), r, ruby (rb), sass, scala, shell (bash, zsh, ksh, sh), sql, swift, xml and yaml (yml) languages, where the names inside parentheses are aliases. Please refer to https://www.redmine.org/projects/redmine/wiki/RedmineCodeHighlightingLanguages for the full list of supported languages.

Вы можете подсветить код в любом месте, где поддерживается wiki-форматирование (название языка не зависит от регистра):

<pre><code class="ruby">
  Поместите свой код сюда.
</code></pre>

Пример:

# The Greeter class
class Greeter
  def initialize(name)
    @name = name.capitalize
  end

  def salute
    puts "Hello #{@name}!"
  end
end