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

Материал из SS220 Paradise Wiki (SS13)
Перейти к навигации Перейти к поиску
(Новая страница: «So you're making some code to do something, and you'd like to use a chat-pane text message to inform the players about it. Good for you! Now, there's a few things to know when doing this. == Span Classes == Span classes allow for '''consistent''' and informative text formatting. You may be familiar with span classes if you have previous experience with HTML. There are various types of classes, which can all be found in [https://github.com/ParadiseSS13/Para...»)
 
(Обновил информацию про спаны)
 
(не показаны 4 промежуточные версии 2 участников)
Строка 1: Строка 1:
So you're making some code to do something, and you'd like to use a chat-pane text message to inform the players about it. Good for you! Now, there's a few things to know when doing this.


== Span Classes ==
Значит, хотите вы, чтобы код делал какую-то штуку, и вы хотите использовать оповещение в чате для информирования игроков. Хорошо! Вот немного о том, как это делается.
Span classes allow for '''consistent''' and informative text formatting.
== Классы (span) ==
Классы тега <span> обеспечивают '''последовательное''' и информативное форматирование текста.


You may be familiar with span classes if you have previous experience with HTML. There are various types of classes, which can all be found in [https://github.com/ParadiseSS13/Paradise/blob/master/goon/browserassets/css/browserOutput.css#L241 <code>\goon\browserassets\css\browserOutput.css</code>].
Для удобства использования и стандартизации текста, все <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>].
Make sure to use the appropriate one for the situation!


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


=== None ===
== None / Mixed ==
'''''When you observe someone else doing something'''''
'''''Без категории'''''
<pre>user.visible_message("[user] begins welding [src]...")</pre>
<pre>user.visible_message("[user] начинает заваривать [src]...")</pre>


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


:This one has '''no span class'''. It's when you see something mundane and boring.
:Здесь '''отсутствует''' класс <span>. Для обыденного и скучного, обычно означает что разработчик забыл прописать тэг.


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


=== Notice ===
<span style="color:red;"><span style='font-size: 18px;'>Список антагонистов</span> которые могли появится сегодня:</span>
'''''When you observe yourself doing something'''''
<pre>to_chat(user, "<span class='notice'>You begin welding the vent...</span>")</pre>


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


:This is a '''notice'''. Notices show up in simple blue text, and are used for benign informational messages. This notice ends with "...", which implies that the action will take a period of time to complete.
== Alerts ==
Категория спанов, что информируют игрока, про что-либо.


==== Warning ====
'''''Вы не можете что-то сделать'''''
<pre>to_chat(user, span_warning("Вы не можете держать предмет!"))</pre>


=== Warning ===
<span style="color:red">''Вы не можете держать предмет!''</span>
'''''When you can't do something'''''
<pre>to_chat(user, "<span class='warning'>You can't vent crawl while you're stunned!</span>")</pre>


<span style="color:red">''You can't vent crawl while you're stunned!''</span>
:Это '''предупреждение'''! Предупреждения появляются в виде простого красного текста и используются для запретов или привлечения внимания к "плохим" действиям, что напрямую не вредят игроку.


:This is a '''warning'''! It shows up as simple red text, and are used for things like restriction notifications and machines malfunctioning.
==== Danger ====
'''''Вы видите, что кто-то получает травму или что-то тревожное'''''
<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>


=== Danger ===
:Это '''тревога'''! Жирный красный текст, используемый в ситуациях, когда кто-то, кроме вас, получает урон или над ним совершается действие с потенциальным вредом, например, заковывание в наручники.
'''''When you see someone getting hurt or something else alarming'''''
<pre>user.visible_message("<span class='danger'>[user] was shocked by \the [src]!</span>")</pre>


<span style="color:red">'''John Smith was shocked by the door!'''</span>
==== Userdanger ====
'''''Вам нанесён урон'''''
<pre>to_chat(target, span_userdanger("Вас поглотил генокрад!"))</pre>
 
<span style="font-size:125%;color:red">'''Вас поглотил генокрад!'''</span>


:This is '''danger'''! This is heavier red text, used in situations where someone other than yourself is being harmed or having some other potentionally harmful action taken against them, such as cuffing.
:Это '''личная тревога'''! Используется в единственной ситуации: когда игрок, видящий это сообщение, получает прямой урон от атак или способностей антагонистов.


=== Userdanger ===
==== Notice ====
'''''When you're hurt directly'''''
'''''Игра хочет убедиться, что вы увидели это'''''
<pre>to_chat(target, "<span class='userdanger'>You are absorbed by the changeling!</span>")</pre>
<pre>to_chat(user, span_notice("Вы начинаете заваривать вентиляцию..."))</pre>


<span style="font-size:125%;color:red">'''You are absorbed by the changeling!'''</span>
<span style="color:blue">Вы начинаете заваривать вентиляцию...</span>


:This is '''userdanger'''! Userdanger is used in only one situation: when the person receiving the text message is being directly harmed, such as from attacks or antagonist abilities.
:Это '''уведомление'''. Уведомления появляются в виде простого синего текста и используются для полезных информационных сообщений.




Текущая версия от 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 для опытных программистов, Форматирование текста
Маппинг Руководство по маппингу (гугл документ)
Спрайтинг Руководство по спрайтингу (гугл документ)
Вики Руководство по редактированию вики
Перевод Как делать перевод игры (гитхаб)
Источник — https://wiki.ss220.space/index.php?title=Форматирование_текста&oldid=37799