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

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

XGM Помощь

Специальный

Мне нравится +488

12
ГОД

GadenbIsh

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

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

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

Специально для XGM был разработан новый формат разметки текста - txt2, заменивший используемые ранее BB-коды. Важно помнить, что BB коды больше не поддерживаются.

Новый формат относится к так называемым легковесным языкам разметки и обладает следующими преимуществами по сравнению с BB-кодами:

проще набирать, во многих случаях не требуется переключать раскладку, отпадает необходимость во вспомогательных панелях редактирования;
многие конструкции (выделение слов через *, цитаты через >) являются привычными для тех, кто часто пользуется email или мессенджерами типа Jabber или ICQ;
текст хорошо читается даже в исходном виде без обработки, что облегчает цитирование и редактирование сообщений;
новые возможности - вставка изображений сбоку от текста, вставка таблиц.

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

Следует напомнить, что использование средств форматирования не для смыслового выделения, а в целях "украшательства" является нарушением п1.4 правил пользования сайтом, особенно это касается изменения цвета текста.

эффект	код	результат
полужирный	слово, несколько слов	слово, несколько слов
курсив	_слово_, __несколько слов__	слово, несколько слов
зачеркивание	-слово-, --несколько слов--	~~слово~~, ~~несколько слов~~
выделение красным	!слово!, !!несколько слов!!	слово, несколько слов
выделение зеленым	+слово+, ++несколько слов++	слово, несколько слов
выделение синим	?слово?, ??несколько слов??	слово, несколько слов
моноширинный шрифт	""monospaced font""	`monospaced font`
оффтопик	// оффтоп //, // оффтоп	оффтоп
отключение форматирования	{{текст}}	текст
ссылка	http://xgm.guru	xgm.guru
ссылка с текстом	XGM (http://xgm.guru)	XGM
ссылка из нескольких слов	__сайт XGM__ (http://xgm.guru)	сайт XGM
ссылка на пользователя	~ZlaYa1000, ~~Q w e r t y~~	ZlaYa1000, Q w e r t y

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

Изображения

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

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

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 - картинка 3
))

Результат:

картинка 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

Видео

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

Музыкальный проигрыватель

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

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) можно указать, если автоматическое определение срабатывает некорректно.

Отключение форматирования

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

Пример:

Результат:

> *здесь* не действуют никакие правила форматирования

Списки

Пример:

- первый пункт
- второй пункт
 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. Первый опрос на сайте!

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

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

80

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

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

И помните,

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

Скачать - 5 МБ ↵ 61

Административное, Помощь, Форматирование, txt2

Просмотров: 41 478

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

Все комментарии
- ←
- 1
- 2
- 3
- →

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

nvc123 nvc123 57477 / 65000 Не в сети Блог Проекты: Diablo II.5 Во славу Лоа Union of High Elves zombie rush new Assasin's Wars 2D-Арт Android Hearthstone: Heroes of Warcraft Программирование Эволюция видов Christmas Preparations WarCraft 3	nvc123 #101 - 3 года назад 4 NilasAran_39, читай раздел изображения там сказано но знай что это работает лишь с галереями (то есть 2 и более картинок) впрочем это там тоже сказано https://xgm.guru/p/help/txt2#h3

NilasAran_39 NilasAran_39 28494 / 40000 Не в сети Блог Проекты: The Elder Scrolls WarCraft 3 Warcraft III:The Doom of Arthas Warhammer Devil Forge	NilasAran_39 #102 - 3 года назад 0 nvc123: Thanks. Не заметил

Skairus

11553 / 15000

Не в сети

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

Двери, которые лучше не открывать

Skairus #103 - 3 года назад 4

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

Это сообщение удалено

Msey Msey 30403 / 40000 Ну, допустим, Га Не в сети Блог Проекты: Game Dev Unity 3D Программирование Unity - скрытая папка	Msey #105 - 1 год назад 0 dg-pic.tk не актуален

ScorpioT1000 ScorpioT1000 130968 / 150000 Только вперёд! Не в сети Блог Проекты: Кампания Джека - Глава 1 ТТМФ Музыка WarCraft 3 World of WarCraft	ScorpioT1000 #106 - 1 год назад 2 txt2 не актуальна, надо менять нахрен

Fakov Fakov 101159 / 150000 Не в сети Блог Проекты: Islands ORPG Zombie Marsh Dj and Fruity Loops Зомби в Деревне! WarCraft 3 Color Escape Wrath of Energy Game Dev Construct 2 Nine Zombie in village.The game Unity 3D Государь	Fakov #107 - 1 год назад 0 txt2 збс, не гони

Msey Msey 30403 / 40000 Ну, допустим, Га Не в сети Блог Проекты: Game Dev Unity 3D Программирование Unity - скрытая папка	Msey #108 - 1 год назад 0 Кстати, я знаю, что можно тексту еще оранжевый цвет задать. Почему этот тэг не добавили?

tysch_tysch tysch_tysch 145526 / 150000 XGM around Не в сети Блог Проекты: ТТМФ TcX Прочее World of WarCraft StarCraft 2 StarCraft WarCraft 3 Game Observer Модмейкинг Литература Unity 3D Game Dev	tysch_tysch #109 - 1 год назад 0 Msey, давай добавим, какой код у него?

ScorpioT1000 ScorpioT1000 130968 / 150000 Только вперёд! Не в сети Блог Проекты: Кампания Джека - Глава 1 ТТМФ Музыка WarCraft 3 World of WarCraft	ScorpioT1000 #110 - 1 год назад 0 Они могут поменяться с новым дизайном, кстати (но это не скоро). Поэтому не стоит злоупотреблять.

2 комментария удалено

NazarPunk NazarPunk 17178 / 25000 На связи Проекты: Некромант XGM Staff WarCraft 3 Гильдия «Черамор»	NazarPunk #113 - 9 месяцев назад 0 ((альтернативный синтаксис катов не работает ))

Uber Uber 41343 / 65000 Не в сети Блог Проекты: Прочее	Uber #114 - 9 месяцев назад 0 ((кат Всё работает текст под катом )) » Всё работает текст под катом

NazarPunk NazarPunk 17178 / 25000 На связи Проекты: Некромант XGM Staff WarCraft 3 Гильдия «Черамор»	NazarPunk #115 - 9 месяцев назад (отредактировано NazarPunk) 0 Uber: Всё работает Извиняюсь, что-то затупил(

Rockmaf Rockmaf 4151 / 6500 Prototype! Не в сети Блог	Rockmaf #116 - 6 месяцев назад 0 Многому узнал,спасибо!!

ScorpioT1000 ScorpioT1000 130968 / 150000 Только вперёд! Не в сети Блог Проекты: Кампания Джека - Глава 1 ТТМФ Музыка WarCraft 3 World of WarCraft	ScorpioT1000 #117 - 3 месяца назад 3 Теперь поддерживаются следующие сторонние хостинги изображений: dg-pic.tk imgur.com (только прямые ссылки на изображения)

Bergi_Bear Bergi_Bear 19226 / 25000 На связи Блог Проекты: WarCraft 3 Robot Defense Наследие Альянса Гильдия «Черамор»	Bergi_Bear #118 - 3 месяца назад 0 ScorpioT1000, а в будущем планирует загрузка изображений как в вк например, где просто контр С контр V или дрег анд дроп? или это сильно сложно и останется как есть до скончания веков =(?

NazarPunk NazarPunk 17178 / 25000 На связи Проекты: Некромант XGM Staff WarCraft 3 Гильдия «Черамор»	NazarPunk #119 - 3 месяца назад 0 Bergi_Bear: где просто контр С контр V или дрег анд дроп? Ctrl+V реализовать несложно. Я хотел даже userscript написать, чтоб самому пользоваться.

PT153 PT153 23552 / 25000 Не в сети	PT153 #120 - 3 месяца назад 0 Bergi_Bear: дрег анд дроп Это уже давно есть.

NazarPunk NazarPunk 17178 / 25000 На связи Проекты: Некромант XGM Staff WarCraft 3 Гильдия «Черамор»	NazarPunk #121 - 3 месяца назад 0 PT153: Это уже давно есть. Загрузки изображения из буфера нет. прикреплены файлы Файлы

Bergi_Bear

19226 / 25000

На связи

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

WarCraft 3
Robot Defense
Наследие Альянса
Гильдия «Черамор»

Bergi_Bear #122 - 3 месяца назад 0

PT153:

Это уже давно есть.

Чтобы вставить эту картинку я сохранил её предварительно на рабочий стол, потом перетащил в окно прикрепления файлов

https://xgm.guru/files/178/43987/comments/419393/102206.jpg

прикреплены файлы

Файлы

102206.jpg

PT153

23552 / 25000

Не в сети

PT153 #123 - 3 месяца назад (отредактировано PT153) 0

NazarPunk:

Загрузки изображения из буфера нет.

А про это не говорил.
Из буфера нет, а drag&drop для файлов из файлов компьютера давно был.
Bergi_Bear:

Чтобы вставить эту картинку я сохранил её предварительно на рабочий стол, потом перетащил в окно прикрепления файлов

Понял, про что ты.

Bergi_Bear Bergi_Bear 19226 / 25000 На связи Блог Проекты: WarCraft 3 Robot Defense Наследие Альянса Гильдия «Черамор»	Bergi_Bear #124 - 3 месяца назад 0 вместо токо чтобы нажать правой кнопкой (копировать изображение), вставить в поле комментария

NazarPunk NazarPunk 17178 / 25000 На связи Проекты: Некромант XGM Staff WarCraft 3 Гильдия «Черамор»	NazarPunk #125 - 3 месяца назад 0 Bergi_Bear: а в будущем планирует загрузка изображений как в вк например Держите. прикреплены файлы Файлы

ScorpioT1000 ScorpioT1000 130968 / 150000 Только вперёд! Не в сети Блог Проекты: Кампания Джека - Глава 1 ТТМФ Музыка WarCraft 3 World of WarCraft	ScorpioT1000 #126 - 3 месяца назад 0 Чтобы было как в вк, надо хранить их у себя, а у нас не соцсеточка с мемчиками. Другое дело opengraph, но это позже

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

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

Популярные ссылки

Расширенное форматирование

Изображения

Видео

Музыкальный проигрыватель

Unity Web Player

Заголовки

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

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

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

Цитаты

Разделитель страницы

Выравнивание

Каты (спойлеры, скрытый текст)

Блоки кода

Отключение форматирования

Списки

Полоса прогресса

Таблицы

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

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

Англоязычные аналоги

Спрятанный код

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

Большая картинка по центру

Несколько картинок по центру

Галерея по центру

Опросы

И помните,

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

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