Форматування вікі сторінок (Markdown)

Лінки(посилання)

Redmine лінки(посилання)

Redmine дозволяє гіперпосилання між ресурсами (завданнями, змінами, вікі-сторінками ...) з будь-якого місця, де використовується вікі-форматування.

Вікі посилання:

Ви також можете посилатися на сторінки з вікі іншого проекту:

Вікі посилання відображаються червоним кольором, якщо сторінка ще не існує: Неіснуюча сторінка.

Посилання на інші ресурси:

Запобігання перетворенню(escaping):

Зовнішні посилання

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, ви можете використовувати стандартний markdown синтаксис:

[Redmine web site](http://www.redmine.org)

відображається як: Redmine web site

Форматування тексту

Для таких речей як: заголовки, жирний текст, таблиці, списки, Redmine підтримує Markdown синтаксис. Перегляньте http://daringfireball.net/projects/markdown/syntax для отримання інформації як цим користуватись. Нижче наводиться декілька прикладів, але можливості Markdown набагато більщі ніж у наведених прикладах.

Стиль шрифту

* **Жирний**
* *Курсив*
* ***Жирний курсив***
* ~~Закреслений~~

Відображення:

Вбудовані(inline) зображення

Заголовоки

# Заголовок
## Підзаголовок
### Підзаголовок

Redmine призначає якір кожному з цих заголовків, таким чином, ви можете посилатись на них з "#Заголовок", "#Підзаголовок" і так далі.

Цитати

Почніть параграф з >

> Redmine — серверний веб-додаток з відкритим кодом для управління проектами та відстежування помилок. До системи входить календар-планувальник та діаграми Ганта
для візуального представлення ходу робіт за проектом та строків виконання.

Відображається:

Redmine — серверний веб-додаток з відкритим кодом для управління проектами та відстежування помилок. До системи входить календар-планувальник та діаграми Ганта
для візуального представлення ходу робіт за проектом та строків виконання.

Таблиці змісту сторінки

{{toc}} => left aligned toc
{{>toc}} => right aligned toc

Горизонтальна лінія

---

Макроси

Redmine має наступні вбудовані макроси:

hello_world

Приклад макросу.

macro_list

Відображає список всіх доступних макросів, в тому числі опис, якщо такий є.

child_pages

Відображає список дочірніх сторінок. Без аргументів, він відображає дочірні сторінки поточної сторінки вікі. Приклад:

{{child_pages}} -- може бути використаний тільки на вікі-сторінці
{{child_pages(depth=2)}} -- відображає тільки 2 рівня вкладень
include

Вставити вікі-сторінку. Приклад:

{{include(Foo)}}

або вставити сторінку з конкретного проекту вікі:

{{include(projectname:Foo)}}
collapse

Втавте блок тексту, який має з'являтись при натисканні на "Детальніше...". Приклад:

{{collapse(Детальніше...)
Це блок тексту прихований по замовчуванню.
Його можливо показати натиснувши на посилання
}}
thumbnail

Відображає інтерактивні мініатюри вкладеного зображення. Приклади:

{{thumbnail(image.png)}}
{{thumbnail(image.png, size=300, title=Thumbnail)}}

Підсвітка синтаксису коду

За замовчуванням підсвічування коду використовує CodeRay, швидка бібліотека для підсвітки синтаксису цілком розроблена на Ruby. На даний час вона підтримує синтаксис: c, clojure, cpp (c++, cplusplus), css, delphi (pascal), diff (patch), erb (eruby, rhtml), go, groovy, haml, html (xhtml), java, javascript (ecmascript, ecma_script, java_script, js), json, lua, php, python, ruby (irb), sass, sql, taskpaper, text (plain, plaintext), xml and yaml (yml) мови, де імена в дужках є псевдонімами.

Ви можете виділити підсвіткою код в будь-якому місці, яке підтримує вікі-форматування, використовуючи наступний синтаксис (зверніть увагу, що назва мови або псевдонім не чутливі до регістру):

~~~ ruby
  Place your code here.
~~~

Приклад:

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

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