Data loading...
|
12 ГОД |
GadenbIsh
Об оформлении текстовPublished |
» категория: Справочные статьи
» является статьей справочного раздела: Да
» является статьей справочного раздела: Да
Специально для XGM был разработан новый формат разметки текста - txt2.
Новый формат относится к так называемым легковесным языкам разметки - аналог вики-разметки или markdown с адаптацией под наши особенности.
Базовое форматирование
| эффект | код | результат |
|---|---|---|
| полужирный | *слово*, **несколько слов** | слово, несколько слов |
| курсив | _слово_, __несколько слов__ | слово, несколько слов |
| зачеркивание | -слово-, --несколько слов-- | |
| предупреждающий акцент | !слово!, !!несколько слов!! | слово, несколько слов |
| успешный акцент | +слово+, ++несколько слов++ | слово, несколько слов |
| информационный акцент | ?слово?, ??несколько слов?? | слово, несколько слов |
| моноширинный шрифт | ""monospaced font"" | monospaced font |
| оффтопик | // оффтоп //, // оффтоп | оффтоп |
| отключение форматирования | {{*текст*}} | *текст* |
| ссылка | https://xgm.guru | xgm.guru |
| ссылка с текстом | XGM (https://xgm.guru) | XGM |
| ссылка из нескольких слов | __сайт XGM__ (https://xgm.guru) | сайт XGM |
| ссылка на пользователя | @Кет, ~Феникс, ~~N7 Molot~~ | Кет, Феникс, N7 Molot |
| этикетки | [[[обычный]]] [??информационный??] [++успешный++] [!!предупреждающий!!] | обычный информационный успешный предупреждающий |
Комбинации из одного знака (*, _, -, !, +,?) действуют только на одно слово и не могут выделять часть слова. Комбинации из двух и трёх знаков действуют на любое количество символов в пределах одной строки. Комбинации из четырёх и более знаков не обрабатываются.
Ссылки
Просто ссылка с текстом: __Текст ссылки__ (https://example.com)
Для часто используемых ссылок можно использовать на месте URL в любом из трех описанных выше форматов ссылок следующие сокращения:
w:Wikipedia - Wikipedia
в:Википедия - в:Википедия
g:Google - Google
я:Яндекс - я:Яндекс
s:поиск+по+сайту - поиск по сайту
При запросах из нескольких слов пробелы следует заменять на символ + (в случае Википедии - на _)
w:Wikipedia - Wikipedia
в:Википедия - в:Википедия
g:Google - Google
я:Яндекс - я:Яндекс
s:поиск+по+сайту - поиск по сайту
При запросах из нескольких слов пробелы следует заменять на символ + (в случае Википедии - на _)
URI схемы приложений
Так же поддерживаются схемы: http, https, ftp, mailto, callto, skype, sip, sips, tg, steam, tel, bitcoin, facetime
Пример: __Подписаться на наш Telegram__ (tg://resolve?domain=xgmguru)
Результат: Подписаться на наш Telegram
Результат: Подписаться на наш Telegram
Сетка и блоки
В txt2 введена специальная система блочной разметки, подробности по ссылке.
Все остальные конструкции допускается использовать только в сообщениях, ресурсах и персональных сообщениях. В других местах (например, полях профиля) они не обрабатываются.
Изображения
Доступные форматы: .png, .jpg, .jpeg, .gif и .webp формат .gif - не подходит для краткого описания
Для вставки изображения следует вставить в текст прямую ссылку на него на отдельной строке - в этом случае будет вставлена полноразмерная картинка.
Ссылки на полную и уменьшенную версию (превью) определяются автоматически.
Ссылки на полную и уменьшенную версию (превью) определяются автоматически.
Поддерживаются следующие сторонние хостинги изображений:
Пример:
http://xgm.guru/pics/article/22468_1t.png
Результат:
Для вставки сбоку от текста либо по центру следует дописать перед ссылкой один из следующих префиксов (в этом случае будет вставлена миниатюра изображения с увеличением по клику): "->" - справа от текста, "<-" - слева от текста и "<>" - по центру.
Пример:
-> http://xgm.guru/pics/article/25886_1.png - справа от текста
<- http://xgm.guru/pics/article/25886_1.png - слева от текста
<> http://xgm.guru/pics/article/25886_1.png - по центру
<- http://xgm.guru/pics/article/25886_1.png - слева от текста
<> http://xgm.guru/pics/article/25886_1.png - по центру
Для вставки нескольких изображений подряд каждую ссылку с соответствующим префиксом следует разместить на отдельной строке.
Можно добавлять описания изображениям после ссылки через " - ".
Можно добавлять описания изображениям после ссылки через " - ".
Результат:
Для создания галереи изображений используется следующий формат:
((галерея
http://xgm.guru/pics/article/22468_1t.png - картинка 1
http://xgm.guru/pics/article/22468_1t.png - картинка 2
http://xgm.guru/pics/article/22468_1t.png - картинка
))
http://xgm.guru/pics/article/22468_1t.png - картинка 1
http://xgm.guru/pics/article/22468_1t.png - картинка 2
http://xgm.guru/pics/article/22468_1t.png - картинка
))
Результат:
Две и более идущие подряд ссылки на изображения без выравнивания автоматически преобразуются в галерею. Если это преобразование нежелательно, можно вставить пустые строки между ссылками.
Можно вставлять также ряд изображений-ссылок (при нажатии на изображение пользователя переносит на определенную ссылку). Работает только с двумя и более изображениями.
Пример:
http://xgm.guru/pics/article/22468_1t.png (http://xgm.guru/p/help/txt2)
http://xgm.guru/pics/article/22468_1t.png (http://xgm.guru/p/help/txt2)
http://xgm.guru/pics/article/22468_1t.png (http://xgm.guru/p/help/txt2)
Результат:
Каждый ресурс может иметь свой уникальный аватар в кратком описании (иконка ресурса в ленте). Для этого нужно в начале первой строки краткого описания разместить следующего вида ссылку:
Пример:
<- http://xgm.guru/pics/article/25886_1.png
Видео
Для вставки видеоролика следует вставить на отдельной строке ссылку на страницу с роликом.
В настоящий момент поддерживаются следующие хостинги видео:
В настоящий момент поддерживаются следующие хостинги видео:
Добавлена поддержка загрузки и встраивания webm, mp4, ogg, ogv и ogm как файлов.
Кроме того, для gif ввели поддержку Gfycat!
Кроме того, для gif ввели поддержку Gfycat!
Отключить автовоспроизведение можно в настройках профиля - "Облегчённый режим"
Просьба загружать видео как файлы только по тематике сайта.
Музыка
Чтобы вставить плеер со звуковым файлом, необходимо сначала прикрепить желаемый аудиофайл к посту, а затем нажать "Файлы ресурса" - "вставить ссылку на файл". После сохранения на месте ссылки будет отображен плеер.
Выглядит это примерно так:
Выглядит это примерно так:
Заголовки
Для разных уровней задаются знаки "равно":
- На новой строке;
- Перед и после имени;
- Только перед именем.
Количество знаков "=" - произвольное.
Предусмотрены ссылки на ресурсы с переходом сразу на конкретный заголовок. Для этого к ссылке необходимо прибавить #hn, где n - номер заголовка. Форматы номера:
h1 - первый заголовок первого уровня
h1.1 - первый заголовок второго уровня под первым заголовком первого уровня
h1.1.1 - первый заголовок третьего уровня под первым второго и первого уровней
h1 - первый заголовок первого уровня
h1.1 - первый заголовок второго уровня под первым заголовком первого уровня
h1.1.1 - первый заголовок третьего уровня под первым второго и первого уровней
Пример:
Заголовок первого уровня
=
=== Заголовок второго уровня ===
=== Заголовок третьего уровня
http://xgm.guru/p/help/txt2#h5 - ссылка ведёт на данную главу
http://xgm.guru/p/help/txt2#h15.3 - ссылка ведёт на 3 подзаголовок 15 заголовка
=
=== Заголовок второго уровня ===
=== Заголовок третьего уровня
http://xgm.guru/p/help/txt2#h5 - ссылка ведёт на данную главу
http://xgm.guru/p/help/txt2#h15.3 - ссылка ведёт на 3 подзаголовок 15 заголовка
» Результат (кликнуть)
Заголовок первого уровня
Заголовок второго уровня
Заголовок третьего уровня
Цитаты
Пример:
> цитата
> возможно, многострочная
>
> символ > ставится на каждой строке
> пробел после > *обязателен* даже для пустых строк
> > цитаты могут быть вложенными
ответ на цитату - простой перевод строки
> при этом ответ может не отделяться пустой строкой от цитируемого текста
> возможно, многострочная
>
> символ > ставится на каждой строке
> пробел после > *обязателен* даже для пустых строк
> > цитаты могут быть вложенными
ответ на цитату - простой перевод строки
> при этом ответ может не отделяться пустой строкой от цитируемого текста
Результат:
ответ на цитату - простой перевод строкицитата
возможно, многострочнаясимвол > ставится на каждой строке
пробел после > обязателен даже для пустых строкцитаты могут быть вложенными
при этом ответ может не отделяться пустой строкой от цитируемого текста
Альтернативный вариант:
((цитата
многострочная цитата
без выделения каждой строки
))
многострочная цитата
без выделения каждой строки
))
Разделитель страницы
Один или более знаков "-" на отдельной строке заменяет их на горизонтальную линию по ширине страницы.
Пример:
--
Результат:
Выравнивание
Если надо центрировать блок текста, и тег заголовка для этого не подходит, это можно сделать так:
((центр
текст по центру
))
текст по центру
))
Для выравнивания по правому краю используется аналогичный формат:
((вправо
текст по правому краю
))
текст по правому краю
))
Каты (спойлеры, скрытый текст)
Пример:
>> смотреть сюда
текст под катом
<<
текст под катом
<<
Результат:
» смотреть сюда
текст под катом
Альтернативный вариант (можно использовать для создания вложенных катов):
((кат смотреть сюда
текст под катом
))
текст под катом
))
Результат:
» смотреть сюда
текст под катом
Блоки кода
Начинаются с "" на отдельной строке, заканчиваются "" на отдельной строке.
Если надо внутри такого блока вставить "" на отдельной строке, следует поставить лишний пробел в конце такой строки.
Если надо внутри такого блока вставить "" на отдельной строке, следует поставить лишний пробел в конце такой строки.
Пример:
""
function H2I takes handle h returns integer
return h
return 0
endfunction
""
function H2I takes handle h returns integer
return h
return 0
endfunction
""
Результат:
function H2I takes handle h returns integer
return h
return 0
endfunction
Альтернативный вариант:
Пример:
((код jass
function H2I takes handle h returns integer
...
))
function H2I takes handle h returns integer
...
))
Результат:
function H2I takes handle h returns integer
...
endfunctionБлоки кода с подписью
Такое возможно только с помощью альтернативного способа.
Такое возможно только с помощью альтернативного способа.
Пример:
((код jass - Простой пример функции на Jass
function H2I takes handle h returns integer
...
endfunction
))
function H2I takes handle h returns integer
...
endfunction
))
Результат:
Простой пример функции на Jass
function H2I takes handle h returns integer
...
endfunctionЯзык (perl, php, css, xml, html, javascript, java, cpp, delphi, sql, jass, lua) можно указать, если автоматическое определение срабатывает некорректно.
Отключение форматирования
Начинается с {{ на отдельной строке, заканчивается }} на отдельной строке.
Если надо внутри такого блока вставить }} на отдельной строке, следует поставить лишний пробел в конце такой строки.
Блоки кода также отключают форматирование.
Если надо внутри такого блока вставить }} на отдельной строке, следует поставить лишний пробел в конце такой строки.
Блоки кода также отключают форматирование.
Пример:
{{
> *здесь* не действуют никакие правила форматирования
}}
> *здесь* не действуют никакие правила форматирования
}}
Результат:
> *здесь* не действуют никакие правила форматирования
Списки
Пример:
- первый пункт
- второй пункт
1. подпункт два-один
* подпункт два-один-один
* подпункт два-один-два
2. подпункт два-два
- третий пунктРезультат:
- первый пункт
- второй пункт
- подпункт два-один
- подпункт два-один-один
- подпункт два-один-два
- подпункт два-два
- подпункт два-один
- третий пункт
Количество пробелов произвольное, но все маркеры одного списка должны иметь одинаковый отступ (пробелами либо табуляциями), и строки между маркерами должны иметь больший отступ.
* и - полностью взаимозаменяемы, для нумерованных списков также распознается формат со скобкой и пробелом после числа - 1) , 2) и т.д.
* и - полностью взаимозаменяемы, для нумерованных списков также распознается формат со скобкой и пробелом после числа - 1) , 2) и т.д.
Полоса прогресса
Пример:
[ 5%]
[ 10% ] - элементарный вариант
[ 2 / 5 ] - расширенный
[ 4 / 3 - 19 ] - профессиональный, где 4 - текущее значение, 3 - минимальное значение, 19 - максимальное значение
[ 28.11.2015 / 27.11.2016 ] - обратный отсчёт, где первое значение - дата старта, второе - дата финиша
[ 10% ] - элементарный вариант
[ 2 / 5 ] - расширенный
[ 4 / 3 - 19 ] - профессиональный, где 4 - текущее значение, 3 - минимальное значение, 19 - максимальное значение
[ 28.11.2015 / 27.11.2016 ] - обратный отсчёт, где первое значение - дата старта, второе - дата финиша
Результат:
5%
10% - элементарный вариант
2 / 5 (40%) - расширенный
6% - профессиональный, где 4 - текущее значение, 3 - минимальное значение, 19 - максимальное значение
Осталось 0 дней (100%) - обратный отсчёт, где первое значение - дата старта, второе - дата финиша
Таблицы
Пример:
столбец1|столбец2|столбец3
--------------------------
1-1 | 1-2 | 1-3
2-1 | 2-2 | 2-3
--------------------------
1-1 | 1-2 | 1-3
2-1 | 2-2 | 2-3
Результат:
| столбец1 | столбец2 | столбец3 |
|---|---|---|
| 1-1 | 1-2 | 1-3 |
| 2-1 | 2-2 | 2-3 |
Перед таблицей обязательно наличие пустой строки.
Вместо | могут использоваться символы табуляции, для вставки из Word или других страниц.
Если строк в таблице 3 и более, заголовок можно опустить.
Вместо | могут использоваться символы табуляции, для вставки из Word или других страниц.
Если строк в таблице 3 и более, заголовок можно опустить.
Расширенные примеры
Исходный код таблицы базового форматирования
» Открыть
эффект код результат
-
полужирный {{*слово*, **несколько слов**}} *слово*, **несколько слов**
курсив {{_слово_, __несколько слов__}} _слово_, __несколько слов__
зачеркивание {{-слово-, --несколько слов--}} -слово-, --несколько слов--
выделение красным {{!слово!, !!несколько слов!!}} !слово!, !!несколько слов!!
выделение зеленым {{+слово+, ++несколько слов++}} +слово+, ++несколько слов++
выделение синим {{?слово?, ??несколько слов??}} ?слово?, ??несколько слов??
моноширинный шрифт {{""monospaced font""}} ""monospaced font""
оффтопик {{// оффтоп //, // оффтоп}} // оффтоп
отключение форматирования {{{{*текст*}}}} {{*текст*}}
ссылка {{http://xgm.guru}} http://xgm.guru
ссылка с текстом {{XGM (http://xgm.guru)}} XGM (http://xgm.guru)
ссылка из нескольких слов {{__сайт XGM__ (http://xgm.guru)}} __сайт XGM__ (http://xgm.guru)
ссылка на пользователя {{~ZlaYa1000, ~~__Dark Lord__~~}} ~ZlaYa1000, ~~Dark Lord~~Англоязычные аналоги
Для некоторых альтернативных вариантов действуют англоязычные аналоги: "gallery", "quote", "center", "right", "code".
Спрятанный код
Пример:
>> code
""
int main(int argc, wchar_t ** argv) { return 0; }
""
<<
""
int main(int argc, wchar_t ** argv) { return 0; }
""
<<
Результат:
» code
int main(int argc, wchar_t ** argv) { return 0; }Видео по центру
Пример:
((центр
http://www.youtube.com/watch?v=18aCtDi1bLw
))
http://www.youtube.com/watch?v=18aCtDi1bLw
))
Большая картинка по центру
Пример:
((центр
http://xgm.guru/pics/article/22468_1t.png
))
http://xgm.guru/pics/article/22468_1t.png
))
Несколько картинок по центру
Пример:
((центр
<> http://xgm.guru/pics/article/22468_1t.png
<> http://xgm.guru/pics/article/22468_1t.png
<> http://xgm.guru/pics/article/22468_1t.png
))
<> http://xgm.guru/pics/article/22468_1t.png
<> http://xgm.guru/pics/article/22468_1t.png
<> http://xgm.guru/pics/article/22468_1t.png
))
Результат:
Галерея по центру
Пример:
((центр
((галерея
http://xgm.guru/pics/article/22468_1t.png - Я
http://xgm.guru/pics/article/22468_1t.png - люблю
http://xgm.guru/pics/article/22468_1t.png - модмейкинг!
))
))
((галерея
http://xgm.guru/pics/article/22468_1t.png - Я
http://xgm.guru/pics/article/22468_1t.png - люблю
http://xgm.guru/pics/article/22468_1t.png - модмейкинг!
))
))
Результат:
Опросы
((опрос Что это такое?
Первый опрос на сайте!
Невероятная вещь
Какой то квадрат
))
» Результат
Опрос: Что это такое?
Всего проголосовали: 263
Каждый опрос может иметь от двух до 16 вариантов ответа.
Если вы измените уже созданный опрос, то все результаты голосований сбросятся.
Если вы измените уже созданный опрос, то все результаты голосований сбросятся.
Опросы можно ограничивать датой окончания и запретом накруток.
Чтобы выставить дату окончания голосования и запретить голосовать пользователям, зарегистрированным после его создания, нужно выставить с новой строки команду закрывается дд.мм.гггг или closes dd.mm.yyyy.
Чтобы выставить дату окончания голосования и запретить голосовать пользователям, зарегистрированным после его создания, нужно выставить с новой строки команду закрывается дд.мм.гггг или closes dd.mm.yyyy.
Закрытие будет считаться в 12:00 по Москве.
Изменение даты сбрасывает голоса! Это техническое ограничение.
Изменение даты сбрасывает голоса! Это техническое ограничение.
Пример:
((опрос Что это такое?
закрывается 15.09.2020
Первый опрос на сайте!
Невероятная вещь
Какой то квадрат
))
» Результат
Опрос: Что это такое?
Окончен.
Окончен.
Всего проголосовали: 0
Опрос окончен 15.09.2020 12:00:00 мск.
И помните,
...что ни один способ форматирования не сделает вашу письменную речь красивее, чем логичное и грамотное изложение мыслей.
Views: 61 802
Like +92
- 5
PUVer
PUVer
Блог
Проекты:
Divinity Original Sin
Литература
Весёлая Ферма
Во власти наживы
Fantasy Pirates
Альфа тест
SageOne
SageOne
Блог
Проекты:
Unity
Unity - скрытая папка
Liches
Bergi_Bear
Bergi_Bear
Блог
Проекты:
WarCraft 3
Robot Defense
Наследие Альянса
Гильдия «Черамор»
TcX
The Binding of Isaac
XGM Staff
Альфа тест
WarMake
Vlod
Vlod
Надеюсь, такая возможность будет не только у зарегистрированных пользователей, но и у всех читателей сайта
tysch_tysch
tysch_tysch
Блог
Проекты:
TcX
Прочее
World of WarCraft
StarCraft
Freelance
Моддинг
Литература
Unity
Diablo
Vlod
Vlod
Msey
Msey
Блог
Проекты:
Unity
Программирование
Unity - скрытая папка
Tensor Games
Алгоритмы
Freelance
ScorpioT1000
ScorpioT1000
Блог
Проекты:
ТТМФ
Музыка
World of WarCraft
Cyberpunk 2077
N7 Molot
N7 Molot
Блог
Проекты:
WarCraft 3
Гильдия «Черамор»
Unity
Альфа тест
Project: «Anger»
StarCraft 2
World of WarCraft
Storm The Castle
World of Warcraft Modding
Heroes of Might&Magic
Fantasy Mini Battle
ScorpioT1000
ScorpioT1000
Блог
Проекты:
ТТМФ
Музыка
World of WarCraft
Cyberpunk 2077
Чтобы выставить дату окончания голосования и запретить голосовать пользователям, зарегистрированным после его создания, нужно выставить с новой строки команду закрывается дд.мм.гггг или closes dd.mm.yyyy.
Изменение даты сбрасывает голоса! Это техническое ограничение.
Окончен.
Опрос окончен 15.09.2020 12:00:00 мск.
N7 Molot
N7 Molot
Блог
Проекты:
WarCraft 3
Гильдия «Черамор»
Unity
Альфа тест
Project: «Anger»
StarCraft 2
World of WarCraft
Storm The Castle
World of Warcraft Modding
Heroes of Might&Magic
Fantasy Mini Battle
Бодро!)
ScorpioT1000
ScorpioT1000
Блог
Проекты:
ТТМФ
Музыка
World of WarCraft
Cyberpunk 2077
Пример webp картинки слева.
N7 Molot
N7 Molot
Блог
Проекты:
WarCraft 3
Гильдия «Черамор»
Unity
Альфа тест
Project: «Anger»
StarCraft 2
World of WarCraft
Storm The Castle
World of Warcraft Modding
Heroes of Might&Magic
Fantasy Mini Battle
Поправил описание