Правила разметки Textile
Textile — язык упрощённой разметки текста, использующийся для оформления летописи на странице героя и постов на форуме. Для разметки в нём применяются текстовые условные знаки. При этом в пределах Годвилля доступны далеко не все стандартные функции, а лишь наиболее востребованные.
При создании нового сообщения на форуме рядом с полем ввода отображается краткая справка по форматированию с основными подсказками[1] — все они кликабельны и применяют разметку к выделенному тексту. Проверить внешний вид сообщения до его отправки можно и нужно с помощью кнопки «Предварительный просмотр»[2].
Действующие правила разметки
Форум | Летопись | Textile | Требует выделения абзаца |
Отображение[3] |
---|---|---|---|---|
✓ | ✓ | _курсивный_ | Это курсивный текст | |
✓ | ✓ | *полужирный* | Это полужирный текст | |
✓ | ✓ | -зачёркнутый- | Это | |
✓ | ✓ | +подчёркнутый+ | Это подчёркнутый текст | |
✓ | ✓ | "замещающий текст":ccылка (например, https://wiki.godville.net/Форум)
"Ссылка летописи":/user/profile/plogs |
Ссылка, указанная после двоеточия, встраивается в выделенный синим замещающий текст.
Ссылка летописи И на форуме и в летописи в ссылке можно сокращать часть | |
✓ | ✗ | "Имя бога":пс | Вспомогательная функция форума формирует ссылку на страницу бога автоматически из введённого имени. "пс" при публикации или предпросмотре раскрывает ник на кирилице как ссылку в процентной кодировке. Вместо "пс" можно записать имя бога (примеры ниже), если нужна ссылка из меньшего числа символов или более человекочитаемая при редактировании. | |
✓ | ✓ | "Имя":Godville (например: God, God%20name, Бог_, Имя%20бога_) "Имя":/gods/Godville (например: God, God%20name, Бог, Имя%20бога) |
Имя В летописи без "/gods/" работает если в нике есть цифра или буква на латинице. Также работает, если после имени на кирилице поставить "_", (ссылка сформируется верно, но символ "_" остается видимым после ника - это неофициальный вариант использования). Имя И на форуме и в летописи имена работают с "/gods/". | |
✓ | ✓ | Списки (могут быть вложенными, в том числе комбинированного типа)
|
только снизу | Нумерованный список:
|
✓ | ✓ | bq. Цитата (либо цт. Цитата) | да | Выделение рамкой с зелёным фоном для приведения цитат (нет прямого аналога в энциклобогии). |
✓ | ✓ | bc. Текст без форматирования | да | Текст без форматирования Вставка текста без обработки разметки (теги <pre><code>). Для переноса строки используется одинарное нажатие клавиши Enter. Такой перенос работает многократно. |
✓ | ✓ | pre. Текст без форматирования | да | Текст без форматирования Аналог bc. (только тег <pre>). При отображении на форуме отличается размером шрифта. |
✓ | ✓ | notextile. Текст без форматирования | да | Текст без форматирования.
Аналог bc. Просто игнорирует разметку Textile. При отображении отличается размером шрифта и (на форуме) рамкой, которой выделен текст. Игнорирует одинарные переносы строки. |
✓ | ✓ | ==без форматирования== | без форматирования
Игнорирует разметку Textile. От | |
✓ | ✓ | bq.. Первый абзац цитаты
Второй абзац цитаты p. Текст под цитатой |
да | bq.. (с двумя точками) заключает в цитату несколько абзацев. p. завершает такую цитату.
|
✓ | ✓ | ^надстрочный^ | Это надстрочный текст | |
✓ | ✗ | ~подстрочный (на форуме)~ | Это подстрочный текст | |
— | ✓ | @подстрочный@ (в летописи) | Это подстрочный текст | |
✓ | — | @моноширинный@ (на форуме) | Это моноширинный текст
| |
✓ | ✓ | полу[*жирный*] | Это полужирный текст.
Чтобы применить форматирование только к части слова, нужно заключить эту часть в квадратные скобки[4][5]. | |
✓ | ✓ | многоточие... | многоточие… (три точки автоматически заменяются на единый символ) | |
✓ | ✓ | короткое - тире | короткое – тире (символ дефиса, окружённый пробелами, автоматически заменяется на короткое тире. Полезность вызывает вопросы, поскольку в русской типографике применяется длинное тире, а не короткое) | |
✓ | ✓ | длинное -- тире | длинное — тире (два символа дефиса автоматически заменяются на длинное тире) | |
✓ | ✓ | 2 х 2 = 4 | 2 × 2 = 4 (латинская буква «x» между двумя числами, отделённая отступами, автоматически заменяется знаком умножения) | |
✓ | ✓ | "текст в кавычках" | “текст в кавычках” (машинопечатные кавычки автоматически заменяются на английские двойные. Следует, однако, отметить, что в русской типографике применяются кавычки-«ёлочки») | |
✓ | ✓ | Rock'n'Roll | Rock’n’Roll (вертикальный штрих автоматически заменяется на апостроф) | |
✓ | ✓ | копирайт (c) | копирайт © | |
✓ | ✓ | знак правовой охраны товарного знака (r) | знак правовой охраны товарного знака ® | |
✓ | ✓ | товарный знак (tm) | товарный знак ™ | |
✓ | ✓ | Первая строка<br>Вторая строка | Первая строка Вторая строка Вставляет перенос строки. Малополезно, ведь того же эффекта можно добиться нажатием клавиши Enter. | |
без перехода[6] | без перехода | краткая сноска[1], краткая сноска[2] | краткая сноска[fn 1], краткая сноска[fn 2] | |
без перехода | без перехода | fn1. текст сноски | да | |
✗ | ✗ | !file.jpg! | <img src="file.jpg" alt="" />
Не поддерживается, но подстановка пустого тега осуществляется. Поэтому, чтобы избежать неправильного отображения текста между двумя восклицательными знаками, следует пользоваться модификаторами | |
✗ | ✗ | заголовки h1…h6 и некоторая другая разметка | Может также не отображаться вместе с включённым в неё текстом. Приём, решающий проблему, аналогичен. |
Примечания
- ↑ У пользователей расширенного интерфейса аналог имеется и в летописи.
- ↑ В дополнение к этому для проб и тестов работы разметки заведена специальная ветка форума.
- ↑ Отображение приведено условно с применением встроенных средств энциклобогии, в месте применения внешний вид результата может отличаться.
- ↑ Исключение: если нужно применить форматирование к первой части слова, стоящего в самом начале абзаца, следует ставить только закрывающую скобку:
_Кур_]сивный
. - ↑ Исключение из исключения: если в начале абзаца стоит
-
,^
,~
или@
, следует поставить обе скобки и дописатьp.
: например,p. [^Над^]строчный
. - ↑ Реализовано только внешнее оформление сносок, нажатие на ссылку не приводит к выравниванию экрана.