Text Formatting: различия между версиями

imported>Cheridan
(Created page with "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...")
 
imported>SpaceManiac
м (Remove "Game Resources" category)
 
(не показано 5 промежуточных версий 4 участников)
Строка 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.
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.


=== Use Span Classes Goddamn ===
== Use Span Classes Goddamn ==
Span classes allow for '''consistent''' and informative text formatting.
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 SOMEWHEEEEEERE. Make sure to use the appropriate one for the situation!
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 interface/stylesheet.dm. Make sure to use the appropriate one for the situation!




==== When you observe someone else doing something ====
<pre>user.visible_message("[user] begins welding [src]."</pre>


<pre>
John Smith begins welding the vent.
<nowiki>user << "<span class='notice'>You begin welding the vent...</span>"</nowiki>
</pre>


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.
:This one has '''no span class'''. It's when you see something mundane and boring.


<pre>
<nowiki>user << "<span class='warning'>You can't vent crawl while you're stunned!</span>"</nowiki>
</pre>


This is a warning! It shows up as simple red text, and are used for things like restriction notifications, machines malfunctioning,  
==== When you observe yourself doing something ====
<pre>to_chat(user, "<span class='notice'>You begin welding the vent...</span>"</pre>


<pre>
<span style="color:blue">You begin welding the vent...</span>
<nowiki>user.visible_message("<span class='danger'>[user.name] was shocked by the [src.name]!</span>", \</nowiki>
</pre>


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.
: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.


<pre>
<nowiki>target << "<span class='userdanger'>You are absorbed by the changeling!</span>"</nowiki>
</pre>


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.
==== 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.
 
 
==== When you see someone getting hurt or something else alarming ====
<pre>user.visible_message("<span class='danger'>[user] was shocked by [src]!</span>"</pre>
 
<span style="color:red">'''John Smith''' was shocked by the door!</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.
 
 
==== When you're hurt directly ====
<pre>to_chat(target, "<span class='userdanger'>You are absorbed by the changeling!</span>"</pre>
 
<span style="font-size:125%;color:red">'''You are absorbed by the changeling!'''</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.
 
 
{{Contribution guides}}

Текущая версия от 03:35, 4 декабря 2020

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.

Use Span Classes Goddamn

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 interface/stylesheet.dm. Make sure to use the appropriate one for the situation!


When you observe someone else doing something

user.visible_message("[user] begins welding [src]."

John Smith begins welding the vent.

This one has no span class. It's when you see something mundane and boring.


When you observe yourself doing something

to_chat(user, "<span class='notice'>You begin welding the vent...</span>"

You begin welding the vent...

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.


When you can't do something

to_chat(user, "<span class='warning'>You can't vent crawl while you're stunned!</span>"

You can't vent crawl while you're stunned!

This is a warning! It shows up as simple red text, and are used for things like restriction notifications and machines malfunctioning.


When you see someone getting hurt or something else alarming

user.visible_message("<span class='danger'>[user] was shocked by [src]!</span>"

John Smith was shocked by the door!

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.


When you're hurt directly

to_chat(target, "<span class='userdanger'>You are absorbed by the changeling!</span>"

You are absorbed by the changeling!

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.


Hosting Hosting a serverSetting up the databaseWorking with /tg/station as an upstream repository
Contributing Guide to contributing to the gameSetting up gitDownloading the source codeReporting issuesChangelogs
Coding Understanding SS13 codeSS13 for experienced programmersCode docsCoding standardsGetting Your Pull AcceptedBinary flags‎Text FormattingMySQL
Mapping Guide to mappingMap mergerGuide to door access
Spriting Guide to spritingResolving icon conflicts
Wiki Guide to contributing to the wikiWikicodeAutowiki