Правила разметки Textile

Textile — язык упрощённой разметки текста, использующийся для оформления летописи на странице героя и постов на форуме. Для разметки в нём применяются текстовые условные знаки. При этом в пределах Годвилля доступны далеко не все стандартные функции, а лишь наиболее востребованные.

При создании нового сообщения на форуме рядом с полем ввода отображается краткая справка по форматированию с основными подсказками[1] — все они кликабельны и применяют разметку к выделенному тексту. Проверить внешний вид сообщения до его отправки можно и нужно с помощью кнопки «Предварительный просмотр»[2].

Действующие правила разметки

Форум Летопись Textile Требует
выделения
абзаца
Отображение[3]
_курсивный_ Это курсивный текст
*полужирный* Это полужирный текст
-зачёркнутый- Это зачёркнутый текст
+подчёркнутый+ Это подчёркнутый текст
"замещающий текст":ccылка (например, https://wiki.godville.net/Форум)

"Ссылка летописи":/user/profile/plogs
"Ссылка форума":7

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

Ссылка летописи И на форуме и в летописи в ссылке можно сокращать часть https://godville.net.
Ссылка форума На форуме в ссылке можно сокращать часть https://godville.net/forums/show_topic/ оставляя номер темы и остальные параметры 7?page=last 7?post=7.

"Имя бога":пс Вспомогательная функция форума формирует ссылку на страницу бога автоматически из введённого имени. "пс" при публикации или предпросмотре раскрывает ник на кирилице как ссылку в процентной кодировке. Вместо "пс" можно записать имя бога (примеры ниже), если нужна ссылка из меньшего числа символов или более человекочитаемая при редактировании.
"Имя":Godville (например: God, God%20name, Бог_, Имя%20бога_)

"Имя":/gods/Godville (например: God, God%20name, Бог, Имя%20бога)

Имя В летописи без "/gods/" работает если в нике есть цифра или буква на латинице. Также работает, если после имени на кирилице поставить "_", (ссылка сформируется верно, но символ "_" остается видимым после ника - это неофициальный вариант использования).

Имя И на форуме и в летописи имена работают с "/gods/".
Позволяет сэкономить количество знаков, например, когда превышен допустимый размер летописи. В нике из нескольких слов подчёркивание "_" вместо пробела делает ссылку, но неправильную, правильная только с "%20".

Списки (могут быть вложенными, в том числе комбинированного типа)


Нумерованный список:
# Пункт уровня 1
# Пункт уровня 1
## Подпункт уровня 2
## Подпункт уровня 2
# Пункт уровня 1


Ненумерованный список:
* Пункт уровня 1
* Пункт уровня 1
** Подпункт уровня 2
** Подпункт уровня 2
* Пункт уровня 1


(каждый элемент должен начинаться с новой строки)

только снизу Нумерованный список:
  1. Пункт уровня 1
  2. Пункт уровня 1
    1. Подпункт уровня 2
    2. Подпункт уровня 2
  3. Пункт уровня 1


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

  • Пункт уровня 1
  • Пункт уровня 1
    • Подпункт уровня 2
    • Подпункт уровня 2
  • Пункт уровня 1
bq. Цитата (либо цт. Цитата) да Выделение рамкой с зелёным фоном для приведения цитат (нет прямого аналога в энциклобогии).
bc. Текст без форматирования да
Текст без форматирования

Вставка текста без обработки разметки (теги <pre><code>).
Для переноса строки используется одинарное нажатие клавиши Enter.
Такой перенос работает многократно.
pre. Текст без форматирования да
Текст без форматирования

Аналог bc. (только тег <pre>).
При отображении на форуме отличается размером шрифта.
notextile. Текст без форматирования да Текст без форматирования.

Аналог bc. Просто игнорирует разметку Textile. При отображении отличается размером шрифта и (на форуме) рамкой, которой выделен текст. Игнорирует одинарные переносы строки.

==без форматирования== без форматирования

Игнорирует разметку Textile. От notextile. отличается тем, что не требует выделения в абзац.

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. текст сноски да
  1. текст сноски 1
  2. текст сноски 2
!file.jpg! <img src="file.jpg" alt="" />

Не поддерживается, но подстановка пустого тега осуществляется. Поэтому, чтобы избежать неправильного отображения текста между двумя восклицательными знаками, следует пользоваться модификаторами ==, bc., pre. или notextile..

заголовки h1…h6 и некоторая другая разметка Может также не отображаться вместе с включённым в неё текстом. Приём, решающий проблему, аналогичен.

Примечания

  1. У пользователей расширенного интерфейса аналог имеется и в летописи.
  2. В дополнение к этому для проб и тестов работы разметки заведена специальная ветка форума.
  3. Отображение приведено условно с применением встроенных средств энциклобогии, в месте применения внешний вид результата может отличаться.
  4. Исключение: если нужно применить форматирование к первой части слова, стоящего в самом начале абзаца, следует ставить только закрывающую скобку: _Кур_]сивный.
  5. Исключение из исключения: если в начале абзаца стоит -, ^, ~ или @, следует поставить обе скобки и дописать p.: например, p. [^Над^]строчный.
  6. Реализовано только внешнее оформление сносок, нажатие на ссылку не приводит к выравниванию экрана.