Caves of Qud Wiki:Style Guide: Difference between revisions

“The”: revise
m Add note on putting {{Spoiler}} on endgame pages
 
(5 intermediate revisions by 3 users not shown)
Line 7: Line 7:
==Article Layout==
==Article Layout==
===Page Names and Capitalization===
===Page Names and Capitalization===
{{gamename}} has all items and creatures titles written in all lowercase, unless the name is proper ([[Sparafucile]] vs [[giant centipede nest]]). To keep in the same spirit, all items and creatures will follow the same convention. If possible, the capitalization format of the game must be obeyed as much as possible. As an example, all mutations are capitalized in Title Case as they are in game ([[Multiple Legs]]) but cybernetics are not ([[cherubic visage]]). Concepts and mechanics that have no official name will follow standard wiki title format. The same concept applies to capitalizations of terms that appear within the text of an article.


Exceptions can be made for section titles, table headers, and similar labels - these typically are written in Title Case regardless of the terminology involved.
As a rule, capitalize the same way the game does.
 
Item and creature names are generally written in all lowercase (e.g., {{F|giant centipede nest}}) unless the name is proper (e.g., {{F|Sparafucile}}).
 
Mutation names are Title Case (e.g., {{F|Multiple Legs}}); cybernetics (which are items) are not (e.g., {{F|cherubic visage}}).
 
Concepts and mechanics that are ordinary English words and don't appear in-game are generally not capitalized, but it may vary on a case by case basis.
 
Section titles, table headers, and similar labels are generally written in Title Case regardless of the terminology involved.


Examples of terms and their typical capitalization:
Examples of terms and their typical capitalization:
Line 19: Line 26:
| Mutation names
| Mutation names
| Title Case
| Title Case
| {{favilink|Corrosive Gas Generation}}
| {{f|Corrosive Gas Generation}}
|-
|-
| Skills
| Skills
Line 31: Line 38:
| Proper names
| Proper names
| Capitalized
| Capitalized
| {{favilink|Lake Hinnom}}, {{favilink|banner of the Holy Rhombus}}, {{favilink|flume-flier of the sky-bear}}
| {{f|Lake Hinnom}}, {{f|banner of the Holy Rhombus}}, {{f|flume-flier of the sky-bear}}
|-
|-
| Non-proper location names
| Non-proper location names
| Lowercase
| Lowercase
| {{favilink|desert canyons}}
| {{f|desert canyons}}
|-
|-
| Most items and creatures
| Most items and creatures
| Lowercase
| Lowercase
| {{favilink|spaser pistol}}, {{favilink|gelatinous prism}}
| {{f|spaser pistol}}, {{f|gelatinous prism}}
|-  
|-  
| Game mechanics terminology
| Game mechanics terminology
Line 101: Line 108:
The following are creatures:
The following are creatures:


* {{Favilink|snapjaw scavenger}}
* {{f|snapjaw scavenger}}
* {{Favilink|Q Girl}}
* {{f|Q Girl}}
* {{Favilink|giant amoeba}}
* {{f|giant amoeba}}
* {{Favilink|giant centipede nest}}
* {{f|giant centipede nest}}
* {{Favilink|yonderbrush}}
* {{f|yonderbrush}}
* {{Favilink|wine weep}}
* {{f|wine weep}}
* {{Favilink|pulsed field magnet}}
* {{f|pulsed field magnet}}


The following are not creatures:
The following are not creatures:


* {{Favilink|watervine}}
* {{f|watervine}}
* {{Favilink|witchwood tree}}
* {{f|witchwood tree}}


==== “Currently” ====
==== “Currently” ====
Line 124: Line 131:


This rule is not related to uses of the word “currently” that are about something that is expected to change within a game session. For instance, “a creature that is currently flying” does not run afoul of this rule and does not call for a citation to justify that wording.
This rule is not related to uses of the word “currently” that are about something that is expected to change within a game session. For instance, “a creature that is currently flying” does not run afoul of this rule and does not call for a citation to justify that wording.
==== “Dynamic Encounter” / “Faction Encounter” ====
'''Dynamic encounters''' are a system by which the majority of objects in the game are automatically entered into various [[Modding:Encounters_and_Population|population tables]] that can be chosen based on a common ancestor blueprint, a tag, or a variety of other qualities.
'''Faction encounters''' are a type of random generation that rarely occurs in a wide variety of zones, in which a legendary and their entourage are present.
Players will often refer to faction encounters as dynamic encounters even though they are different mechanisms with different purposes. Often, it's not necessary for an article to use either term, but when they are used, try to be consistent.
E.g., worshippers of Oboroqoru roll on a ''dynamic encounter'' table to determine their creature type. Finding a legendary Mechanimist while traveling the overworld is an example of a ''faction encounter''.
Finding a dromad trader and their entourage is similar to a faction encounter but is not labeled as such in the game code. Consider simply “encounter” or other phrasing.


==== “Monster” ====
==== “Monster” ====


Avoid the word “monster”, except as used in the game. Prefer “creature” instead, regardless of how the player or player character may feel about the creature in question.
Avoid the word “monster”, except as used in the game or patch notes. Prefer “creature” instead, regardless of how the player or player character may feel about the creature in question.


===== "Parasang" =====
===== "Parasang" =====
Line 168: Line 187:
* Content related to hidden content that is not easily encountered by players, such as [[Tzimtzlum]], ''should'' include spoiler warnings.
* Content related to hidden content that is not easily encountered by players, such as [[Tzimtzlum]], ''should'' include spoiler warnings.
* Content related to special enemies, such as the [[Girsh Nephilim]], ''should'' include spoiler warnings.
* Content related to special enemies, such as the [[Girsh Nephilim]], ''should'' include spoiler warnings.
=== Endgame Content ===
{{Spoiler}}
Any content that appears after the player character starts to ascend the Spindle (i.e. after the player types in <code>ASCEND</code>) is considered endgame content, and should be placed in the <code>Endgame:</code> namespace. This includes the endings themselves, as well as creatures, items, locations, conversations, and events that may occur after ascension.
If you are using QBE, it will automatically upload any object that appears in the endgame to the correct namespace.
All articles in the <code>Endgame:</code> namespace '''''must''''' be prefaced with the [[Template:Spoiler|Spoiler template]].


==Formatting==
==Formatting==
Line 183: Line 212:
Item names such as [[Stopsvalinn]] have multicolor names in game. For ease of use, call [[Template:Qud text]] instead of manually changing each letter using the Color Template. If referring to an item or character in its page, use [[Template:name]] to automatically make the colored version of the item.
Item names such as [[Stopsvalinn]] have multicolor names in game. For ease of use, call [[Template:Qud text]] instead of manually changing each letter using the Color Template. If referring to an item or character in its page, use [[Template:name]] to automatically make the colored version of the item.


If referring to other items and characters with a link, you should use favilinks. There are three favilink templates available:
If referring to other items and characters with a link, you should use favilinks. There are three favilink templates available, each with an easier-to-type equivalent:


* [[Template:Favilink]] takes the name of an item or mutation and links to it.
* [[Template:Favilink]] (or [[Template:F]] for short) takes the name of an item or mutation and links to it.
* [[Template:Favilink page]] takes the name of a page and links to it.
* [[Template:Favilink page]] (or [[Template:F page]] for short) takes the name of a page and links to it.
* [[Template:Favilink id]] is useful when you wish to specifically link to an object by its blueprint ID, a mutation by its mutation ID, and so on.
* [[Template:Favilink id]] (or [[Template:F id]] for short) is useful when you wish to specifically link to an object by its blueprint ID, a mutation by its mutation ID, and so on.


The differences between these favilink types can be relevant when objects or mutations share the same name, for example, the {{favilink id|NightVision}} implant and the {{favilink id|Mutation:DarkVision}} mutation. The table below shows how one might link to one page versus the other:
The differences between these favilink types can be relevant when objects or mutations share the same name, for example, the {{f id|NightVision}} implant and the {{f id|Mutation:DarkVision}} mutation. The table below shows how one might link to one page versus the other:


{| class="wikitable"
{| class="wikitable"
Line 195: Line 224:
! Examples
! Examples
|-
|-
| {{favilink id|NightVision}} (the implant)
| {{f id|NightVision}} (the implant)
|
|
* <code><nowiki>{{favilink|Night Vision}}</nowiki></code>
* <code><nowiki>{{f|Night Vision}}</nowiki></code>
* <code><nowiki>{{favilink id|NightVision}}</nowiki></code>
* <code><nowiki>{{f id|NightVision}}</nowiki></code>
* <code><nowiki>{{favilink page|Night Vision (implant)}}</nowiki></code>
* <code><nowiki>{{f page|Night Vision (implant)}}</nowiki></code>
|-
|-
| {{favilink id|Mutation:DarkVision}} (the mutation)
| {{f id|Mutation:DarkVision}} (the mutation)
|
|


* <code><nowiki>{{favilink page|Night Vision}}</nowiki></code>
* <code><nowiki>{{f page|Night Vision}}</nowiki></code>
* <code><nowiki>{{favilink id|Mutation:DarkVision}}</nowiki></code>
* <code><nowiki>{{f id|Mutation:DarkVision}}</nowiki></code>
|}
|}


Note that mutations linked with [[Template:Favilink id]] must be prefixed with <code><nowiki>Mutation:</nowiki></code> to distinguish them from object blueprint IDs.
Note that mutations linked with [[Template:F id]] must be prefixed with <code><nowiki>Mutation:</nowiki></code> to distinguish them from object blueprint IDs.


Use of favilink should follow [[#Links | the general rules for linking]].
Use of favilink should follow [[#Links | the general rules for linking]].
Line 271: Line 300:
and so on. In general, work can be added to any page that is at least tangentially relevant to it. For example:
and so on. In general, work can be added to any page that is at least tangentially relevant to it. For example:


* If you have a stylized depiction of a snapjaw, then that would certainly be relevant to the [[Snapjaws]] page or a more specific page, such as {{favilink|Snapjaw Scavenger}}.
* If you have a stylized depiction of a snapjaw, then that would certainly be relevant to the [[Snapjaws]] page or a more specific page, such as {{f|Snapjaw Scavenger}}.
* An OC that comes from the [[Mopango]] faction could be added to the [[Mopango]] page.
* An OC that comes from the [[Mopango]] faction could be added to the [[Mopango]] page.
* An OC with the {{favilink|Multiple Arms}} mutation could be added to the page for that mutation.
* An OC with the {{f|Multiple Arms}} mutation could be added to the page for that mutation.


If you have questions about whether a particular work of art would be appropriate for the wiki and where it could go, please ask in <code>#wiki-discussion</code> in the Caves of Qud wiki.
If you have questions about whether a particular work of art would be appropriate for the wiki and where it could go, please ask in <code>#wiki-discussion</code> in the Caves of Qud wiki.
Line 333: Line 362:
Now add your art to the page of your choosing! To do this, you'll need to visit the page you want to add your work to, hit <code>Edit</code>, and then link to your art.
Now add your art to the page of your choosing! To do this, you'll need to visit the page you want to add your work to, hit <code>Edit</code>, and then link to your art.


For example, suppose that your art was uploaded to [https://wiki.cavesofqud.com/wiki/File:Super_Cool_Dromad.webp File:Super_Cool_Dromad.webp]. Then to link your art in the {{favilink|Dromad}} page (or perhaps the [[Dromad merchants]] page), you would go to that page, edit it, and then add the following line to the page in the location that you want to upload it:
For example, suppose that your art was uploaded to [https://wiki.cavesofqud.com/wiki/File:Super_Cool_Dromad.webp File:Super_Cool_Dromad.webp]. Then to link your art in the {{f|Dromad}} page (or perhaps the [[Dromad merchants]] page), you would go to that page, edit it, and then add the following line to the page in the location that you want to upload it:


<syntaxhighlight lang="moin">
<syntaxhighlight lang="moin">