Справочный блок

< Вернуться к основной справке

XGM Помощь

Специальный

12
ГОД

GadenbIsh

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

» опубликован

» категория: Справочные статьи
» является статьей справочного раздела: Да

Специально для XGM был разработан новый формат разметки текста - txt2.

Новый формат относится к так называемым легковесным языкам разметки - аналог вики-разметки или markdown с адаптацией под наши особенности.

Базовое форматирование

эффект	код	результат
полужирный	слово, несколько слов	слово, несколько слов
курсив	_слово_, __несколько слов__	слово, несколько слов
зачеркивание	-слово-, --несколько слов--	~~слово~~, ~~несколько слов~~
выделение красным	!слово!, !!несколько слов!!	слово, несколько слов
выделение зеленым	+слово+, ++несколько слов++	слово, несколько слов
выделение синим	?слово?, ??несколько слов??	слово, несколько слов
моноширинный шрифт	""monospaced font""	`monospaced font`
оффтопик	// оффтоп //, // оффтоп	оффтоп
отключение форматирования	{{текст}}	текст
ссылка	http://xgm.guru	xgm.guru
ссылка с текстом	XGM (http://xgm.guru)	XGM
ссылка из нескольких слов	__сайт XGM__ (http://xgm.guru)	сайт XGM
ссылка на пользователя	@Кет, ~Феникс, ~~N7 Molot~~	Кет, Феникс, N7 Molot
этикетки	[[[простая]]] [??информационная??] [++успешно++] [!!опасность!!]	простая информационная успешно опасность

Комбинации из одного знака (*, _, -, !, +,?) действуют только на одно слово и не могут выделять часть слова. Комбинации из двух и трёх знаков действуют на любое количество символов в пределах одной строки. Комбинации из четырёх и более знаков не обрабатываются.

Ссылки

Просто ссылка с текстом: __Текст ссылки__ (https://example.com)

Для часто используемых ссылок можно использовать на месте URL в любом из трех описанных выше форматов ссылок следующие сокращения:
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

Сетка и блоки

В txt2 введена специальная система блочной разметки, подробности по ссылке.

Все остальные конструкции допускается использовать только в сообщениях, ресурсах и персональных сообщениях. В других местах (например, полях профиля) они не обрабатываются.

Изображения

Для вставки изображения следует вставить в текст прямую ссылку на него на отдельной строке - в этом случае будет вставлена полноразмерная картинка.
Ссылки на полную и уменьшенную версию (превью) определяются автоматически.

Поддерживаются следующие сторонние хостинги изображений:

dg-pic.tk
imgur.com (только прямые ссылки на изображения)

Пример:

http://xgm.guru/pics/article/22468_1t.png

Результат:

https://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/22468_1t.png - картинка 1
http://xgm.guru/pics/article/22468_1t.png - картинка 2
http://xgm.guru/pics/article/22468_1t.png - картинка
))

Результат:

картинка 1
картинка 2
картинка 3

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

Можно вставлять также ряд изображений-ссылок (при нажатии на изображение пользователя переносит на определенную ссылку). Работает только с двумя и более изображениями.

Пример:

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)

Результат:

https://xgm.guru/pics/article/22468_1t.png
https://xgm.guru/pics/article/22468_1t.png

Каждый ресурс может иметь свой уникальный аватар в кратком описании (иконка ресурса в ленте). Для этого нужно в начале первой строки краткого описания разместить следующего вида ссылку:

Пример:

<- http://xgm.guru/pics/article/25886_1.png

Видео

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

Добавлена поддержка загрузки и встраивания webm, mp4, ogg, ogv и ogm как файлов.
Кроме того, для gif ввели поддержку Gfycat!

Отключить автовоспроизведение можно в настройках профиля - "Облегчённый режим"

Просьба загружать видео как файлы только по тематике сайта.

Музыка

Чтобы вставить плеер со звуковым файлом, необходимо сначала прикрепить желаемый аудиофайл к посту, а затем нажать "Файлы ресурса" - "вставить ссылку на файл". После сохранения на месте ссылки будет отображен плеер.
Выглядит это примерно так:

https://xgm.guru/files/178/43987/Skairus_-_Hymn_of_XGM.mp3

Skairus - Гимн XGM

Unity Web Player

Чтобы вставить плеер кнопку запуска веб приложений написанных с использованием Unity3D, необходимо сначала прикрепить желаемое приложение к посту, а затем нажать "Файлы ресурса" - "вставить ссылку на файл". После сохранения на месте ссылки будет отображаться кнопка для запуска этого приложения.
Выглядит это примерно так:

Запустить плеер:
web_test.unity3d

Заголовки

Для разных уровней задаются знаки "равно":

На новой строке;
Перед и после имени;
Только перед именем.

Количество знаков "=" - произвольное.

Предусмотрены ссылки на ресурсы с переходом сразу на конкретный заголовок. Для этого к ссылке необходимо прибавить #hn, где n - номер заголовка. Форматы номера:
h1 - первый заголовок первого уровня
h1.1 - первый заголовок второго уровня под первым заголовком первого уровня
h1.1.1 - первый заголовок третьего уровня под первым второго и первого уровней

Пример:

Заголовок первого уровня
=

=== Заголовок второго уровня ===
=== Заголовок третьего уровня

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

Альтернативный вариант:

Пример:

((код jass
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
))

Результат:

Простой пример функции на 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 (40%) - расширенный

6% - профессиональный, где 4 - текущее значение, 3 - минимальное значение, 19 - максимальное значение

Осталось 0 дней (100%) - обратный отсчёт, где первое значение - дата старта, второе - дата финиша

Таблицы

Пример:

столбец1|столбец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 и более, заголовок можно опустить.

Расширенные примеры

Исходный код таблицы базового форматирования

» Открыть

эффект	код	результат
-
полужирный	{{*слово*, **несколько слов**}}	*слово*, **несколько слов**
курсив	{{_слово_, __несколько слов__}}	_слово_, __несколько слов__
зачеркивание	{{-слово-, --несколько слов--}}	-слово-, --несколько слов--
выделение красным	{{!слово!, !!несколько слов!!}}	!слово!, !!несколько слов!!
выделение зеленым	{{+слово+, ++несколько слов++}}	+слово+, ++несколько слов++
выделение синим	{{?слово?, ??несколько слов??}}	?слово?, ??несколько слов??  
моноширинный шрифт	{{""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; }
""
<<

Результат:

» code

int main(int argc, wchar_t ** argv) { return 0; }

Видео по центру

Пример:

((центр
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
))

Результат:

https://xgm.guru/pics/article/22468_1t.png https://xgm.guru/pics/article/22468_1t.png https://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 - модмейкинг!
))
))

Результат:

Я
люблю
модмейкинг!

Опросы

((опрос Что это такое?
Первый опрос на сайте!
Невероятная вещь
Какой то квадрат
))

» Результат

Опрос: Что это такое?

#1. Первый опрос на сайте!

135
#2. Невероятная вещь

44
#3. Какой то квадрат

84

Всего проголосовали: 263

Каждый опрос может иметь от двух до 16 вариантов ответа.
Если вы измените уже созданный опрос, то все результаты голосований сбросятся.

Опросы можно ограничивать датой окончания и запретом накруток.
Чтобы выставить дату окончания голосования и запретить голосовать пользователям, зарегистрированным после его создания, нужно выставить с новой строки команду закрывается дд.мм.гггг или closes dd.mm.yyyy.

Закрытие будет считаться в 12:00 по Москве.
Изменение даты сбрасывает голоса! Это техническое ограничение.

Пример:

((опрос Что это такое?
закрывается 15.09.2020
Первый опрос на сайте!
Невероятная вещь
Какой то квадрат
))

» Результат

Опрос: Что это такое?
Окончен.

#1. Первый опрос на сайте!
#2. Невероятная вещь
#3. Какой то квадрат

Всего проголосовали: 0

Опрос окончен 15.09.2020 12:00:00 мск.

И помните,

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

Скачать - 5 МБ 78

Просмотров: 54 865

Мне нравится +90 - 5

Все комментарии
- Предыдущая
- 1
- 2
- 3
- 4

» Лучшие комментарии

Bergi_Bear Bergi_Bear 66564 / 100000 Адепт Lua Не в сети Блог Проекты: Dendy Tanks WarCraft 3 Reforged Robot Defense Наследие Альянса Гильдия «Черамор» TcX XGM Staff Альфа тест	Bergi_Bear #153 - 2 месяца назад 0 Варкрафтеры на диалапах и эджах не потянут - вырубай

Vlod

3708 / 4000

Не в сети 3 дня

Vlod #154 - 2 месяца назад (отредактировано Vlod) 1

ScorpioT1000, видео/аудио потенциально могут весить во много раз больше картинок. Но дело тут даже не в весе, а в эстетике. Возможно, пользователи, которые попросили вас ограничить автовоспроизведение видео контента имели ввиду не вес файлов.
Надеюсь, такая возможность будет не только у зарегистрированных пользователей, но и у всех читателей сайта

tysch_tysch tysch_tysch 149667 / 150000 Тот самый Тыща На связи Блог Проекты: ТТМФ TcX Прочее World of WarCraft StarCraft 2 StarCraft WarCraft 3 Reforged Game Observer Моддинг Литература Unity 3D Game Dev Diablo	tysch_tysch #155 - 2 месяца назад 0 Хватит сидеть инкогнито, мы всё равно следим за вами

Vlod Vlod 3708 / 4000 Не в сети 3 дня	Vlod #156 - 2 месяца назад 1 Нет новым пользователям на xgm?

Msey Msey 56462 / 65000 🌈🌈🌈🌈 Не в сети 1 день Блог Проекты: Game Dev Unity 3D Программирование Unity - скрытая папка Алгоритмы	Msey #157 - 2 месяца назад 2 Имхо лучше сделать наоборот автовоспроизведение гифок по умолчанию отключенным

ScorpioT1000 ScorpioT1000 143222 / 150000 CYBER FORCE Не в сети Блог Проекты: Кампания Джека - Глава 1 ТТМФ Музыка WarCraft 3 Reforged World of WarCraft	ScorpioT1000 #158 - 2 месяца назад (отредактировано ScorpioT1000) 0 Небольшой импрувмент

N7 Molot N7 Molot 121528 / 150000 old "molot39" Не в сети Блог Проекты: Музыка WarCraft 3 Reforged Гильдия «Черамор» Unity 3D Альфа тест Project: «Anger» StarCraft 2 World of WarCraft	N7 Molot #159 - 2 месяца назад 1 Msey: Имхо лучше сделать наоборот автовоспроизведение гифок по умолчанию отключенным Я о том же писал...

ScorpioT1000

143222 / 150000

CYBER FORCE

Не в сети

Блог
Проекты:

Кампания Джека - Глава 1
ТТМФ
Музыка
WarCraft 3 Reforged
World of WarCraft

ScorpioT1000 #160 - 3 дня назад (отредактировано ScorpioT1000) 1

NEW

Закрытие будет считаться в 12:00 по Москве.
Изменение даты сбрасывает голоса! Это техническое ограничение.

Пример:

((опрос Что это такое?
закрывается 15.09.2020
Первый опрос на сайте!
Невероятная вещь
Какой то квадрат
))

Результат:

Опрос: Что это такое?
Окончен.

#1. Первый опрос на сайте!
#2. Невероятная вещь
#3. Какой то квадрат

Всего проголосовали: 0

Опрос окончен 15.09.2020 12:00:00 мск.

N7 Molot N7 Molot 121528 / 150000 old "molot39" Не в сети Блог Проекты: Музыка WarCraft 3 Reforged Гильдия «Черамор» Unity 3D Альфа тест Project: «Anger» StarCraft 2 World of WarCraft	N7 Molot #161 - 3 дня назад 1 ScorpioT1000: Бодро!)

PUVer PUVer 57358 / 65000 Не в сети 1 день Блог Проекты: God's word: The True Way Divinity Original Sin Литература Весёлая Ферма Во власти наживы Fantasy Pirates Альфа тест	PUVer #151 - 9 лет назад 18 От этого %##$#$#$!! форматирования только матом орать хочется><

SageOne SageOne 45310 / 65000 x Не в сети Блог Проекты: Diablo Unity 3D Unity - скрытая папка Liches	SageOne #152 - 9 лет назад 8 PUVer, тебе надо такой тег: `((центр ссылка на изображение ))` тогда изображение будет по центру и в полный размер