Справочник по языку разметки

WebMoney Wiki поддерживает язык разметки Textile.


Термины (wiki-слова)

[[Cправочник по языку разметки]]: Cправочник по языку разметки

[[Cправочник по языку разметки|Справочник]]: Справочник — ссылка с произвольным текстом.

[[Cправочник по языку разметки#ident|Как поставить ссылку на абзац]]: Как поставить ссылку на абзац — ссылка на определенный заголовок или на идентификатор абзаца на странице. Русские буквы не поддерживаются. Если в названии заголовка (идентификатора) есть пробелы, то вместо них ставятся дефисы.

[[Capitaller:Пример использования бюджетного автомата]] : Пример использования бюджетного автомата — ссылка на wiki-страницу из другого проекта.

[[Capitaller:| Раздел Capitaller]] : Раздел Capitaller — ссылка на главную страницу Wiki другого проекта.

Eсли страницы с wiki-статьей не существует, то ссылка отображается красным цветом: Несуществующая статья.

Стили текста

*жирный* : жирный

_курсив_ : курсив

*_жирный курсив_* : жирный курсив

+подчеркнутый+ : подчеркнутый

-перечеркнутый- : перечеркнутый

^Верхний^ : Верхний индекс

~Нижний~ : Нижний индекс

@моноширинный@ : моноширинный шрифт

%{color:red}красный текст% : красный текст

Заголовки

hn. Заголовок n-ного уровня, где n принимает значение от 1 до 6.

Например,

h1. Заголовок 
h2. Подзаголовок
h3. Подзаголовок

Списки

Обратите внимание на то, как работает вложенность элементов при вставке пустой строки между ними.

Вложенность сохраняется при наличие отступа у последующего элемента списка и сбрасывается - без отступа.

Маркированный список

Код:

* Пункт 1
* Пункт 2
** Пункт 2.1

 ** Пункт 2.1.1
*** Пункт 2.1.2
** Пункт 2.2
* Пункт 3

** Пункт 0

отображается как:

  • Пункт 1
  • Пункт 2
    • Пункт 2.1
      • Пункт 2.1.1
      • Пункт 2.1.2
    • Пункт 2.2
  • Пункт 3
  • Пункт 0

Нумерованный список

Код:

# Пункт 1
# Пункт 2

 ## Пункт 2.1

  ## Пункт 2.1.1
## Пункт 2.2
# Пункт 3

# Пункт 0

отображается как:

  1. Пункт 1
  2. Пункт 2
    1. Пункт 2.1
      1. Пункт 2.1.1
    1. Пункт 2.2
  3. Пункт 3
  1. Пункт 0

Красивый список

Для визуального выделения нумерации можно использовать макрос {{step(1)}}

Код:

{{step(1)}} Шаг первый
{{step}} Шаг второй
{{step(1)}} Шаг первый другого раздела страницы
{{step(b))}} Пункт b)

отображается как:

1 Шаг первый

2 Шаг второй

1 Шаг первый другого раздела страницы

b) Пункт b)

Абзац

Отступы и выравнивание

Для корректной обработки textile-разметки элементы форматирования абзаца (p, h, bq, fn) рекомендуется помещать в самое начало строки и отделять их от остального текста пустыми строками.


p. Обычный абзац. Сайт WebMoney Wiki служит для создания базы знаний о системе WebMoney силами всех участников системы.


p(. Абзац с отступом слева в 1em. Сайт WebMoney Wiki служит для создания базы знаний о системе WebMoney силами всех участников системы.


p((. Отступ слева в 2em. Сайт WebMoney Wiki служит для создания базы знаний о системе WebMoney силами всех участников системы.


p>. Выравнивание по правому краю. Сайт WebMoney Wiki служит для создания базы знаний о системе WebMoney силами всех участников системы.


p<. Выравнивание по левому краю (по умолчанию). Сайт WebMoney Wiki служит для создания базы знаний о системе WebMoney силами всех участников системы.


p)))>. Выравнивание по правому краю с отступом справа в 3em. Сайт WebMoney Wiki служит для создания базы знаний о системе WebMoney силами всех участников системы.


p=. Выравнивание по центру. Сайт WebMoney Wiki служит для создания базы знаний о системе WebMoney силами всех участников системы.


p<>. Выравнивание по ширине. Сайт WebMoney Wiki служит для создания базы знаний о системе WebMoney силами всех участников системы.


Отступы и выравнивание сохраняются до следующей пустой строки.

Идентификатор

p(#ident). — присваивает абзацу идентификатор ident, на который можно поставить ссылку вида:

[[Cправочник по языку разметки#ident|Cсылка на идентификатор ident]]: Cсылка на идентификатор ident.

Цитаты

Цитаты в тексте можно выделить операторами bq. или > или >>

> "Ruby on Rails" — программный каркас, написанный на языке программирования Ruby.

или

>> Дайте две.

и даже

>>> Хорошо сидим.

Разделитель

Три дефиса ---, отделенные переносами строк от остального текста, преобразуются в html-тэг <hr>.


Таблицы

Любое количество пустых символов будет заменено одним пробелом, поэтому для удобства разметки можно использовать текстовый редактор и табуляцию. Перенос строки в тексте преобразуется парсером в <br>.

Код:

|_.UserID|_.Name|_.Group|_. attribute list |
|\3=.IT               |<. align left|
|1|Artur Pirozhkov |/2.Users |>. align right|
|2|Vasya Rogov        |=. center |
|3|John Smith |Admin
               (root)|^. valign top |
|4|-          |Nobody
               (anonymous)|~. valign bottom|

отображается как:

UserID Name Group attribute list
IT align left
1 Artur Pirozhkov Users align right
2 Vasya Rogov center
3 John Smith Admin
(root)
valign top
4 - Nobody
(anonymous)
valign bottom

Изображения

Внешние:

!image_url! — встраивает в текст изображение, находящееся по внешнему адресу image_url.

!>image_url! — изображение выровнено по правому краю, текст обтекает изображение по левому краю.

Прикрепленные:

!attached_image.png! — встраивает в текст изображение attached_image.png, прикрепленное к странице. При этом ссылки на прикрепленные файлы действуют только на той странице, к которой они прикреплены.

Примеры:
  • !bt_img.png! - изображение может размещаться прямо в тексте, после него абзац продолжается;
  • !>bt_img.png! - изображение размещается справа от текста
  • !bt_img.png(Описание ссылки)!:http://wiki.webmoney.ru/help/wiki_syntax.html - кликабельное изображение с описанием - Описание ссылки

Ссылки

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

Адреса http(s), ftp и mail автоматически преобразуются в "кликабельные" ссылки:

http://www.webmoney.ru: http://www.webmoney.ru

someone@foo.bar: .

Для размещения в ссылке произвольного текста используйте следующую разметку:

"Главная страница WebMoney Wiki":http://wiki.webmoney.ru: Главная страница WebMoney Wiki.

Изображение-ссылка

Ссылкой можно сделать изображение

!bt_img.png(Описание ссылки)!:http://wiki.webmoney.ru/help/wiki_syntax.html : Описание ссылки

Интервики-ссылка

Интервики-ссылка применяется в двух случаях:

  • для ссылки на произвольную статью в другой языковой редакции. Например,
    [[:en:webmoney:System commission|Комиссия системы (англ.)]]: Комиссия системы (англ.).
  • для связи одинаковых статей (переводов статей) на разных языках. В этом случае интервики-ссылка ставится без лидирующего двоеточия и в самом конце статьи, например, интервики-ссылка [[en:webmoney:System commission]], размещенная в конце статьи Комиссия системы, обеспечивает связь русской статьи и английского перевода. В режиме просмотра такая ссылка не отображается.

Макросы

Список доступных макросов и их описание (по-английски) вызывается макросом {{macro_list}}.

Содержание

{{TOC}} — отображает содержание страницы, которое формируется автоматически на основе заголовков.

{{>TOC}} — выравнивание блока содержания по правому краю.

Дочерние страницы

{{child_pages}} — выводит список ссылок на все дочерние статьи для данной страницы.
{{child_pages(О сайте)}} — выводит список ссылок для страницы О сайте.
{{child_pages(О сайте, depth=1)}} — выводит список с одним уровнем вложенности.
{{child_pages(О сайте, parent=1)}} — начинает список со ссылки на родительскую страницу.

Пример последнего макроса для страницы О сайте:



Включение текста

{{include(Термины)}} — включает в данном месте текста содержимое страницы Термины без каких-либо специальных обозначений.

Если включаемой страницы не существует или у пользователя нет к ней доступа, то будет выведено сообщение об ошибке.

Свертывание текста

{{collapse(См. свернутый текст)
Этот текст разворачивается при клике на ссылку.
Здесь допустимо блочное форматирование.
}}
— добавляет на страницу свернутый блок текста.

Данный макрос отображается так.

Пометка

Для визуального выделения абзаца в том числе и для нумерации можно использовать макрос {{step(<символ>)}}

Код:

{{step(!)}} Внимание.Для продолжения использования программы выполните перезагрузку системы в безопасном режиме.
{{step(§5)}} Параграф пятый
{{step(?)}} Вопрос
{{step(b))}} Пункт b)

отображается как:

! Внимание. Для продолжения использования программы выполните перезагрузку системы в безопасном режиме.

§5 Параграф пятый

? Вопрос

b) Пункт b)

Сноски

Ссылка на сноску указывается по тексту номером в квадратных скобках Текст[5], а текст сноски начинается с оператора fn5.

Код:

Поясняемый текст[5]

---

fn5. Поясняющий текст.

---

отображается как:

Поясняемый текст5


5 Поясняющий текст.


Исходный код

Чтобы избежать преобразования textile-разметки в html-код используйте тэги <pre></pre>.

<pre>
Внутри выделенного *тэгами* <pre> и </pre> блока текст 
[[Справочник по языку разметки|языка разметки]] 
не преобразовывается.
</pre>

Вставка видео роликов с youtube.com

Синтаксис:

{{youtube( video_key, [width, height] )}}

пример:
{{youtube(OENUy4wcAMo, 640, 480)}}

Прочие советы по оформлению

  • чтобы избежать разрыва строки между словами или символами в таких конструкциях как инициалы, сокращения с точками, числа с пробелом или единицами измерений, тире с предыдущим словом и т.п. рекомендуется ставить неразрывный пробелAlt + 0160 (на цифровой клавиатуре).
  • длинное тире — Alt + 0151 (на цифровой клавиатуре).

см. также
О сайте WebMoney Wiki
Как создать wiki-статью
Как отредактировать wiki-статью
Как разместить перевод wiki-статьи
Рекомендации по обработке иллюстраций
Правила и стиль изложения wiki-статей