Meta:Writing Conventions: Difference between revisions

From The Talos Principle Wiki
No edit summary
No edit summary
Line 44: Line 44:
There is no super-category for Terminal Documents because there is no desire to see a list of documents from both TTP1 and TTP2 together.
There is no super-category for Terminal Documents because there is no desire to see a list of documents from both TTP1 and TTP2 together.


Spoilers
== Spoilers ==
 
For content that involves spoilers, hints or locations, that you would like to be initially hidden, use the [[Template:Spoiler|Spoiler template]].
For content that involves spoilers, hints or locations, that you would like to be initially hidden, use the [[Template:Spoiler|Spoiler template]].


Example:
Example:
<blockquote><pre>{{Spoiler|Santa lives in the North Pole|secret location}}</pre>
<blockquote><pre>{{Spoiler|Santa lives in the North Pole|secret location}}</pre>
{{Spoiler|Santa lives in the North Pole|secret location}}
{{Spoiler|Santa lives in the North Pole|secret location}}</blockquote>
</blockquote>

Revision as of 15:42, 19 November 2023

Below are writing conventions that should be consistent throughout the wiki.

The #writing-conventions channel on Discord is used to discuss existing and new conventions before they are added here.

Hex Strings

The games often contain strings of hexadecimal characters. Please use {{HexString|hex|plain}} for all such strings, omitting the second argument if a translation is not known.

Example: {{HexString|00}} becomes 00 (no translation).
Example: {{HexString|48656c6c6f|Hello}} becomes 48656c6c6f (translation available as tooltip).

There is also an automatically-generated list of pages with untranslated hex strings.

Article titles

In general, article titles should not use parentheses unless required for disambiguation. One significant exception to this is the articles for New Humans, which should be formatted as Name (Number) when the serial number is known.

Example: Byron (7)


Screenshots

Use Photomode to remove HUD elements and Ultra settings. Use 4k resolution (3840 × 2160) if your display supports it. Otherwise use the highest 16:9 aspec ratio you can use. Convert PNG screenshots to JPEG before uploading.


Terminal Documents and Audio Logs

Many of the terminals and their entries use underscores. Because MediaWiki URLs use underscores for spaces, spaces and underscores are conflated to spaces in titles. To remedy this remember to add {{DISPLAYTITLE:Article_title}} when creating Article title if there should be an underscore.

Text files should use Category:TTP1 Documents or Category:TTP2 Documents.

Example: Baby_Steps begins with {{DISPLAYTITLE:Baby_Steps}} and ends with [[Category:TTP2 Documents]] [[Category:TTP2]].

Collectibles

Every terminal document and puzzle has its own article. However,

  • Lost Labs
  • Star Monuments
  • Ancient Human Artifacts

are described on their respective area pages and should not have their own articles.

Pages such as Star and Ancient Human Artifact will include links to the relevant sections of the area pages.


Categories

In general, pages should list any super-categories that their categories belong to.

Example: 1k (1000) lists [[Category:New Human]] [[Category:TTP2 Characters]] [[Category:Characters]] [[Category:TTP2]].

There is no super-category for Terminal Documents because there is no desire to see a list of documents from both TTP1 and TTP2 together.

Spoilers

For content that involves spoilers, hints or locations, that you would like to be initially hidden, use the Spoiler template.

Example:

{{Spoiler|Santa lives in the North Pole|secret location}}
[ secret location ]
Santa lives in the North Pole