Руководство по оформлению текстов

На нашем сайте для оформления статей, новостей и некоторых других текстов (например, описаний событий) используется свой формат, основанный на BBCode.

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

Текст

Абзацы

Отделяйте абзацы текста двумя переводами строки, как это принято в вебе. Один перевод строки тоже допустим, но он не отделяет абзацы друг от друга:

Я первый абзац. Я первый абзац. Я первый абзац. Я первый абзац. Я первый абзац. Я первый абзац. Я первый абзац. Я первый абзац.

А я второй абзац. А я второй абзац. А я второй абзац. А я второй абзац. А я второй абзац. А я второй абзац. А я второй абзац.
А тут только один перевод строки.

Разделы и подразделы

Большие тексты разбивайте на логические части для структурирования и удобства чтения. Для этого отмечайте разделы (начинайте строку с «## ») и подразделы (начинайте строку с «### »):

## Раздел

### Подраздел

Результат:

Раздел

Подраздел

Пробел между решетками и самим заголовком важен. Иначе строка не будет считаться заголовком раздела/подраздела.

Содержание статьи формируется автоматически. Если вы хотите, чтобы раздел/подраздел не попадал в содержание (как в нашем примере), то добавьте в конце строки «#».

BBCode и его расширения

Оформление текста

Поддерживатся полужирный текст, курсив, зачеркивание, подчеркивание и цвет. Оформляются они аналогично BBCode:

[b]Полужирный текст[/b]
[i]Курсив[/i]
[s]Зачеркивание[/s]
[u]Подчеркивание[/u]
[color=#ff0000]Красный цвет[/color]

Результат:

Полужирный текст
Курсив
Зачеркивание
Подчеркивание
Красный цвет

Злоупотреблять этими тегами (особенно цветом) не рекомендуется, ибо слишком пестрое оформление затрудняет чтение.

Ссылки

Аналогично BBCode:

[url]http://warcry.ru[/url]
[url=http://warcry.ru]Самый классный сайт[/url]

Результат:

Картинки

Используйте тег [img].

Видео YouTube

Используйте тег [youtube].

Цитаты

Используйте тег [quote].

Цитаты Blizzard (блюпосты)

Используйте тег [bluepost].

Спойлеры

Используйте тег [spoiler].

Вики-ссылки

Сайт поддерживает ссылки с двойными скобками а-ля Википедия. Они позволяют встраивать ссылки на статьи, новости, события, стримы, а также игровые сущности типа предметов, заданий и заклинаний World of Warcraft и карт Hearthstone.

У этих ссылок общий формат:

[[{tag:}id{|param1}...{|paramN}{|label}]]

Примеры:

[[World of Warcraft]]
[[Night Elves|Ночные эльфы]]
[[news:10082|Открыт предзаказ World of Warcraft: Battle for Azeroth]]
[[item:49623|Темная Скорбь]]
[[card:knife-juggler|Жонглер кинжалами]]

Результат:

Закрывающего тега в этих ссылках нет.

Статьи

У каждой статьи есть английское и русское название. Например, «Night Elves» и «Ночные эльфы». Кроме этого, у статьи может быть категория (например, «Раса» (Race)), которая позволяет создавать разные статьи с одинаковым английским названием.

Ссылка на статью формируется на основе ее английского названия и категории, если она есть. Поэтому и в вики-ссылке на статью нужно указывать эти элементы:

[[World of Warcraft]]
[[World of Warcraft|WoW]]
[[Night Elves|Ночные эльфы]]
[[Night Elves|Race|Ночные эльфы]]

Результат:

World of Warcraft — ссылка по английскому названию статьи
WoW — ссылка та же, но ее текст другой
Ночные эльфы — без категории одна статья (история расы)
Ночные эльфы — с категорией — другая (информация о расе в World of Warcraft)

Обратите внимание, что при отсутствии статьи с заданной комбинацией «английское название» + «категория» (категория может быть не задана), но при этом существует статья с тем же англ. названием (с категорией или без), то откроется именно эта статья. Неактивной будет лишь ссылка с тем же названием, но другой существующей категорией.

Например, у нас есть статья о нежити как игровой расе в WoW, но общей статьи о нежити пока нет. Все ссылки на эту сущность с категорией и без будут пока открывать статью об игровой расе, но как только будет добавлена статья о нежити в целом, ссылки на статью без категории будут вести именно на нее.

Undead — такой статьи нет, но ссылка активная
Undead/Race — такая статья есть (все эти ссылки открывают эту статью)
Undead/Class — такой статьи нет, категория существует, ссылка неактивная
Undead/Fluffy — нет ни статьи такой, ни категории (категория игнорируется)

Нактивные (отсутствующие) статьи

Особенностью вики-ссылок на статьи (в отличие от других вики-ссылок) является то, что парсер проверяет наличие статьи с такими параметрами. Если она есть, то ссылка будет активной, если такой статьи нет, то ссылка будет неактивной, но при наведении на нее будет отображаться ее английское название (или любой текст, который вместо него будет указан).

Также этот функционал можно использовать для создания всплывающих описаний к слову или фразе и для расшифровки аббревиатур.

Формат:

[[War of the Ancients|Война Древних]]
[[Russian Federation|Российская Федерация]]
[[let's go|идем]]
[[Союз Советских Социалистических Республик|СССР]]

Результат:

Война Древних — такой статьи у нас еще нет, может, ее напишете вы?
Российская Федерация
идем
СССР

Новости, события, стримы и теги

Это ссылки на новости, события, стримы и теги нашего сайта.

Формат одинаковый и простой:

Новость:
[[news:10082|Открыт предзаказ World of Warcraft: Battle for Azeroth]]

Событие:
[[event:3|Overwatch League: 1-й этап]]

Стрим:
[[stream:thijs|Thijs]]

Тег:
[[tag:BlizzCon|Все по тегу BlizzCon]]

Результат:

Для новостей и событий задается их id, для стримов — алиас (и то, и другое можно увидеть в адресной строке соответствующей страницы).

Ссылки на сущности World of Warcraft

Ссылки на карты Hearthstone

Галерея

Можно вставлять картинки из нашей галереи. Для этого используйте тег [[gallery]].

В отличие от основной галереи, при нажатии на картинку она не открывается в новом окне, а отображается в lightbox'е.

В качестве параметров этому тегу можно передавать как список id картинок, так и тег, по которому будут эти картинки подбираться. Формат тега следующий:

[[gallery:{id1,id2,...,idN}{|grid}]]
[[gallery:{tag}{|maxPictures}{|grid}]]

Этот тег работает следующим образом:

  • Если в нем перечислен набор числовых id картинок, то именно они и отображаются (если картинки с такими id есть). Повторяющиеся id игнорируются.

Код:

[[gallery:1950,1989]]

Результат:

  • id картинки можно найти в адресной строке этой картинки. Например, id картинки https://warcry.ru/gallery/KAI/20152015.
  • Если указан хотя бы один строковый тег, то числовые id игнорируются, и отображаются картинки по указанному тегу в обратной хронологической последовательности.
  • Картинки, вставленные в текст таким образом, будут обновляться по мере пополнения галереи.
  • Также под галереей добавляется кнопка, по которой можно перейти на страницу со всеми картинками по данному тегу.

Код:

[[gallery:D.Va]]

Результат:

  • Если задано несколько тегов, то все теги кроме первого игнорируются.
  • Отображаемое число картинок по тегу по умолчанию — 4. Если надо поменять это число, задайте его через «|».

Код:

[[gallery:D.Va|2]]

Результат:

  • Также можно поменять визуальное отображение галереи. По умолчанию она отображается в виде flexbox'а (см. выше), но можно переключить внешний вид на grid (как в галерее). Для этого добавьте модификатор «|grid».

Код:

[[gallery:D.Va|9|grid]]

Результат:

Списки

BBCode

Markdown

Горячие клавиши

В редакторе поддерживаются некоторые горячие клавиши:

  • Ctrl-B — полужирный
  • Ctrl-I — курсив
  • Ctrl-U — подчеркнутый
  • Ctrl-H — подраздел
  • Shift-Ctrl-H — раздел
  • Ctrl-E — выровнять по центру
  • Ctrl-R — выровнять по правому краю
  • Ctrl-K — гиперссылка
  • Ctrl-M — картинка
  • Ctrl-L — список
  • Ctrl-Alt-L — нумерованный список
  • Ctrl-Y — видео на YouTube
  • Ctrl-Alt-X — кат