Форматирование текста: различия между версиями

Материал из SS220 Paradise Wiki (SS13)
Перейти к навигации Перейти к поиску
(Перевод)
(Обновил информацию про спаны)
 
(не показана 1 промежуточная версия 1 участника)
Строка 1: Строка 1:
{{Требуется перевод}}
 
Значит, хотите вы, чтобы код делал какую-то штуку, и вы хотите использовать оповещение в чате для информирования игроков. Хорошо! Вот немного о том, как это делается.
Значит, хотите вы, чтобы код делал какую-то штуку, и вы хотите использовать оповещение в чате для информирования игроков. Хорошо! Вот немного о том, как это делается.
== Классы (span) ==
Классы тега <span> обеспечивают '''последовательное''' и информативное форматирование текста.


== Классы <span> ==
Для удобства использования и стандартизации текста, все <span> теги записаны в [https://github.com/ss220-space/Paradise/blob/master220/code/__DEFINES/_span.dm <code>\code\__DEFINES\_span.dm</code>], и имеют формат: <code>span_CLASS("string")</code>. Все доступные классы можно найти в [https://github.com/ss220-space/Paradise/blob/master220/tgui/packages/tgui-panel/styles/tgchat/chat-default.scss <code>\tgui\packages\tgui-panel\styles\tgchat\chat-default.scss</code>].
Классы тега <span> обеспечивают '''последовательное''' и информативное форматирование текста.


С подобными классами вы уже можете быть знакомы, если имеете опыт в верстке на HTML. Существуют различные типы классов, которые можно найти в [https://github.com/ParadiseSS13/Paradise/blob/master/goon/browserassets/css/browserOutput.css#L241 <code>\goon\browserassets\css\browserOutput.css</code>].
С подобными классами вы уже можете быть знакомы, если имеете опыт в верстке на HTML.
Убедитесь, что используете соответствующие классы в подходящей ситуации!
Убедитесь, что используете соответствующие классы в подходящей ситуации!


=== None ===
== None / Mixed ==
'''''Вы наблюдаете, как кто-то что-то делает'''''
'''''Без категории'''''
<pre>user.visible_message("[user] начинает заваривать [src]...")</pre>
<pre>user.visible_message("[user] начинает заваривать [src]...")</pre>


John Smith начинает заваривать вентиляцию.
John Smith начинает заваривать вентиляцию.


:Здесь '''отсутствует''' класс <span>. Для обыденного и скучного.
:Здесь '''отсутствует''' класс <span>. Для обыденного и скучного, обычно означает что разработчик забыл прописать тэг.


'''''Без категории'''''
<pre>to_chat(world, span_warning([span_fontsize4("Список антагонистов")] которые могли появится сегодня:))</pre>


=== Notice ===
<span style="color:red;"><span style='font-size: 18px;'>Список антагонистов</span> которые могли появится сегодня:</span>
'''''Вы видите, как ВЫ что-то делаете'''''
<pre>to_chat(user, "<span class='notice'>Вы начинаете заваривать вентиляцию...</span>")</pre>


<span style="color:blue">Вы начинаете заваривать вентиляцию...</span>
:Здесь '''смешанные классы'''. Обычно используется для красоты и каждый класс по отдельности передаёт смысл.


:Это '''уведомление'''. Уведомления появляются в виде простого синего текста и используются для полезных информационных сообщений. Многоточие "..." в конце уведомления подразумевает, что действие потребует время для завершения.
== Alerts ==
Категория спанов, что информируют игрока, про что-либо.


 
==== Warning ====
=== Warning ===
'''''Вы не можете что-то сделать'''''
'''''Вы не можете что-то сделать'''''
<pre>to_chat(user, "<span class='warning'>Вы не можете залезть в вентиляцию, когда оглушены!</span>")</pre>
<pre>to_chat(user, span_warning("Вы не можете держать предмет!"))</pre>


<span style="color:red">''Вы не можете залезть в вентиляцию, когда оглушены!''</span>
<span style="color:red">''Вы не можете держать предмет!''</span>


:Это '''предупреждение'''! Предупреждения появляются в виде простого красного текста и используются для отображения запретов, и сообщений о поломках машин.
:Это '''предупреждение'''! Предупреждения появляются в виде простого красного текста и используются для запретов или привлечения внимания к "плохим" действиям, что напрямую не вредят игроку.


=== Danger ===
==== Danger ====
'''''Вы видите, что кто-то получает травму или что-то тревожное'''''
'''''Вы видите, что кто-то получает травму или что-то тревожное'''''
<pre>user.visible_message("<span class='danger'>[user] was shocked by \the [src]!</span>")</pre>
<pre>user.visible_message(span_danger("[user] was shocked by \the [src]!"))</pre>


<span style="color:red">'''John Smith was shocked by the door!'''</span>
<span style="color:red">'''John Smith was shocked by the door!'''</span>


:Это '''тревога'''! Жирнющий красный текст, используемый в ситуациях, когда кто-то, кроме вас, получает урон или над ним совершается действие с потенциальным вредом, например, заковывание в наручники.
:Это '''тревога'''! Жирный красный текст, используемый в ситуациях, когда кто-то, кроме вас, получает урон или над ним совершается действие с потенциальным вредом, например, заковывание в наручники.


=== Userdanger ===
==== Userdanger ====
'''''ВАМ НАНЕСЕН УРОН'''''
'''''Вам нанесён урон'''''
<pre>to_chat(target, "<span class='userdanger'>Вас поглотил генокрад!</span>")</pre>
<pre>to_chat(target, span_userdanger("Вас поглотил генокрад!"))</pre>


<span style="font-size:125%;color:red">'''Вас поглотил генокрад!'''</span>
<span style="font-size:125%;color:red">'''Вас поглотил генокрад!'''</span>


:Это '''личная тревога'''! Используется в единственной ситуации: когда игрок, видящий это сообщение, получает прямой урон от атак или способностей антагонистов.
:Это '''личная тревога'''! Используется в единственной ситуации: когда игрок, видящий это сообщение, получает прямой урон от атак или способностей антагонистов.
==== Notice ====
'''''Игра хочет убедиться, что вы увидели это'''''
<pre>to_chat(user, span_notice("Вы начинаете заваривать вентиляцию..."))</pre>
<span style="color:blue">Вы начинаете заваривать вентиляцию...</span>
:Это '''уведомление'''. Уведомления появляются в виде простого синего текста и используются для полезных информационных сообщений.





Текущая версия от 21:31, 8 октября 2025

Значит, хотите вы, чтобы код делал какую-то штуку, и вы хотите использовать оповещение в чате для информирования игроков. Хорошо! Вот немного о том, как это делается.

Классы (span)

Классы тега обеспечивают последовательное и информативное форматирование текста.

Для удобства использования и стандартизации текста, все теги записаны в \code\__DEFINES\_span.dm, и имеют формат: span_CLASS("string"). Все доступные классы можно найти в \tgui\packages\tgui-panel\styles\tgchat\chat-default.scss.

С подобными классами вы уже можете быть знакомы, если имеете опыт в верстке на HTML. Убедитесь, что используете соответствующие классы в подходящей ситуации!

None / Mixed

Без категории

user.visible_message("[user] начинает заваривать [src]...")

John Smith начинает заваривать вентиляцию.

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

Без категории

to_chat(world, span_warning([span_fontsize4("Список антагонистов")] которые могли появится сегодня:))

Список антагонистов которые могли появится сегодня:

Здесь смешанные классы. Обычно используется для красоты и каждый класс по отдельности передаёт смысл.

Alerts

Категория спанов, что информируют игрока, про что-либо.

Warning

Вы не можете что-то сделать

to_chat(user, span_warning("Вы не можете держать предмет!"))

Вы не можете держать предмет!

Это предупреждение! Предупреждения появляются в виде простого красного текста и используются для запретов или привлечения внимания к "плохим" действиям, что напрямую не вредят игроку.

Danger

Вы видите, что кто-то получает травму или что-то тревожное

user.visible_message(span_danger("[user] was shocked by \the [src]!"))

John Smith was shocked by the door!

Это тревога! Жирный красный текст, используемый в ситуациях, когда кто-то, кроме вас, получает урон или над ним совершается действие с потенциальным вредом, например, заковывание в наручники.

Userdanger

Вам нанесён урон

to_chat(target, span_userdanger("Вас поглотил генокрад!"))

Вас поглотил генокрад!

Это личная тревога! Используется в единственной ситуации: когда игрок, видящий это сообщение, получает прямой урон от атак или способностей антагонистов.

Notice

Игра хочет убедиться, что вы увидели это

to_chat(user, span_notice("Вы начинаете заваривать вентиляцию..."))

Вы начинаете заваривать вентиляцию...

Это уведомление. Уведомления появляются в виде простого синего текста и используются для полезных информационных сообщений.


Как внести свой вклад?
Общее Руководство по разработке
Сервер Настройка базы данных, Запуск локального сервера
Код Структура кода SS13, SS13 для опытных программистов, Форматирование текста
Маппинг Руководство по маппингу (гугл документ)
Спрайтинг Руководство по спрайтингу (гугл документ)
Вики Руководство по редактированию вики
Перевод Как делать перевод игры (гитхаб)