Difference between revisions of "BattleTechWiki:Manual of Style/BattleTech Style Guide"

m
 
(33 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{construction}}
+
{{MoS guideline|MOS:BSG}}
{{Nutshell|BattleTech has its own specific format and style for many words found within its universe.}}
 
  
: ''Note: This style guide details stylistic elements that all editors should incorporate to help present a uniform style for the BattleTechWiki articles. It was borrowed from a similar guide being built by Editor [[User:Mbear|Mbear]].''
+
As ''BattleTech'' has its own specific format and style for many words found within its universe, our wiki attempts to uses this specific format style for many of the words found within its articles, as well as an overall aesthetic that attempts to match that of [[Catalyst Game Labs]]' ''[[BattleTech]]''. This style guide details stylistic elements that all editors should incorporate to help present a uniform style for articles.
  
==Abbreviations==
+
This is separate from the [[Policy:Manual_of_Style|policy of style for the entire wiki]].  
* When ''writing'' an article, write out the full name and only use abbreviations in subsequent mentions. When ''editing'' an article, be careful to ensure that at least the first mention is written out. For example, any reference to [[House Davion]]'s preeminent university should first be "[[New Avalon Institute of Science]]", while only subsequent mentions may be abbreviated as "NAIS." This means that no page should ever have an abbreviated and linked word/phrase, unless that is the sole name for it (e.g. [[ROM]]).
+
{{Style}}
  
==Article titles==
+
 
* Article titles should be in the form of a singular noun, such as [[BattleMech]].
+
==Guidelines==
 +
BattleTech writer style guides have repeatedly changed in the past. The general guideline is to follow the most recent example.
  
 
==BattleTech-specific names==
 
==BattleTech-specific names==
 +
These words retain their capitalization wherever within a sentence they are used.
 
The following words always appear in the form shown below:
 
The following words always appear in the form shown below:
 
<div style="-moz-column-count:3; column-count:3;">
 
<div style="-moz-column-count:3; column-count:3;">
* AeroSpace Fighter
 
 
* BattleMech
 
* BattleMech
 
* BattleTech
 
* BattleTech
 
* DropPort
 
* DropPort
 
* DropShip
 
* DropShip
 +
* IndustrialMech
 
* JumpShip
 
* JumpShip
 
* 'Mech  
 
* 'Mech  
Line 27: Line 28:
 
</div>
 
</div>
  
This section is an adaptable part of the guide; as new terms are introduced{{m}}in a stylistic way{{m}}with new products, they will be added here.
+
== House vs State ==
 
+
In writing about the fates and fortunes of the characters from the various Great Houses, it is to be understood (by the reader) the state and ruling family are separate entities. When referring to a House, the characters that belong to that specific family will be the focus of the statement; the state's name will specifically reference the nation, its government, and its collective people.
==Boldface==
+
: ''Ex: House Davion refers to Lucien Davion and his progeny; the Federated Suns refers to the Successor State founded by him.''
Most commonly, the article's subject is stated as early as possible in the first sentence, and placed in boldface.
 
: ''Ex: '''Nueva Castile''' is a small proto-state residing within the Deep Periphery.''
 
Only the first occurrence of this word or term is placed in boldface.
 
 
 
* If the subject of the article is often (or previously) known with an additional name (and has a redirect pointing to the article), it is common for that alternate name to appear in boldface in its first occurrence.
 
: ''Ex: The '''Binary Laser Cannon''' was a laser weapon previously considered ineffectual, but its effectiveness underwent reconsideration following the re-introduction of double heat sinks. The Binary Laser Cannon is also known informally as the '''Blazer'''.''
 
 
 
==Capitalization==
 
* Standard grammatical rules should be followed with regards to capitalization. Should emphasis be needed, it should be given in the form of italics or boldface, not all caps.
 
: Correct - BattleMechs are ''not'' robots.
 
: Incorrect - BattleMechs are NOT robots.
 
* One notable exception: Sarna capitalizes the proper name of military operations.
 
: ''Ex: [[Operation BIRD DOG]], [[Operation SAKKAKU]]''
 
 
 
* The families ruling the five [[Successor States]] should be referred to with capitals, i.e. House Davion, House Kurita, House Liao, House Marik, and House Steiner.
 
 
 
* Clan commands are always capitalized, such as with Point, Star, Nova, Trinary, Supernova, Cluster, Galaxy, and Touman. Clans do not have an "officer" or "enlisted" corps. They have trueborn and freeborn, and every rank is a regimented form of their "Warrior Corps". These include Point Commander, Star Commander, Star Captain, Star Colonel, and Khan, which are capitalized.
 
 
 
* "Clan" should be capitalized whenever referring to the descendants of Kerensky. Clan Jade Falcon. "I am a Clan warrior." The Northwind Highlanders also use the term "clan", of course, and should be capitalized only when used with a proper name: Clan McDougal. Yakuza clans are not capitalized excepted when used as part of a full name: the Nogachi Clan.
 
 
 
* Military commands are also capitalized:
 
: Correct - Twenty-first Galedon Regulars, Ninety-seventh Adder Sentinels, Seventh Deneb Light Cavalry
 
: Incorrect - Fifth sword of light, 8th orloff grenadiers
 
 
 
* The word "century" is not capitalized.
 
: ''Ex: The 20th century, the 31st century
 
 
 
''For the stylistic use of capitalization of certain BattleTech names, seee the [[Policy:BattleTech_Style_Guide#BattleTech-specific_names|BattleTech-specific names]] section.
 
 
 
==English language==
 
There are many different countries that speak and write in English, leading to different spellings of some words. Since BattleTech is created by an American company, it is most appropriate to write articles using American spelling and grammar. Editors who are familiar with other methods of spelling are not mandated to write articles in 'American' English since they are unfamiliar with it, but the article should be converted to American style by those that do.
 
  
 
==Military Commands==
 
==Military Commands==
* When military command article titles involve numbers, the text should always be represented as a number.  
+
* When military command '''article titles''' involve numbers, the text should always be represented as a number.  
 
: ''Ex: [[1st Davion Guards]], [[304th Assault (Clan Ghost Bear)]]''
 
: ''Ex: [[1st Davion Guards]], [[304th Assault (Clan Ghost Bear)]]''
  
* When writing about military commands ''in the body of an article'', the numerical portion of the command's title should be spelled out, unless it is higher than one hundred.
+
* When writing about military commands '''in the body of an article''', the numerical portion of the command's title should be spelled out, unless it is higher than one hundred.
 
: ''Ex: First Davion Guards, 304th Assault (Clan Ghost Bear)''
 
: ''Ex: First Davion Guards, 304th Assault (Clan Ghost Bear)''
  
Line 75: Line 45:
 
: ''Ex: [[Golden Keshik (Clan Wolf-in-Exile)]]''
 
: ''Ex: [[Golden Keshik (Clan Wolf-in-Exile)]]''
  
==Numbers==
+
==Titles==
* Write out any number under 11.  
+
* '''In generic use''', apply lower case to words such as ''president'', ''professor'', and ''emperor''. Exceptions are made for non-English words and specific titles that incorporate a number into the title, such as "First Prince".
: ''Ex: Three, Seven, Nine, 13, 15, 23''
+
: ''Ex:
* Use commas to aid in understanding every three spaces.
+
: - ''Edmund Davion served in the role of president for just over thirteen years. He, however, was never a First Prince.''
: ''Ex: 2,983,802,928''
+
: - ''Stefan Amaris envisioned himself a galactic emperor.''
* Use decimal points to indicate numbers smaller than one, not commas.  
+
 
: ''Ex: 394.09''
+
* '''Directly juxtaposed with the person's name''', such words begin with a capital letter.
 +
: ''Ex:
 +
: - ''Coordinator Yama Von Rohrs served in that role from 2470 to 2508.''
 +
: - ''Professor Emeritus Dietrich Mathers was a professor from the Lyran Alliance.''
 +
 
 +
* '''Standard or commonly used names of an office''' are treated as proper names. Royal styles are capitalized; exceptions may apply for particular offices.
 +
: ''Ex:
 +
: - ''Daniel Calderon was Protector of the Realm.''
 +
: - ''"His Majesty, the first of his name, Lord of..."''
 +
 
 +
== Italics ==
 +
Italics apply throughout an article, to include the opening, main body, infoboxes and references.
 +
 
 +
The following should generally appear italicized:
 +
* Model names for BattleMechs, ProtoMechs, DropShips, JumpShips, WarShips, Space Stations, and aerospace fighters (e.g. ''Atlas'', ''Minotaur'', ''Union'', ''Scout'', ''Carrack'', ''Olympus'', and ''Stuka'', respectively);
 +
** Note that ’Mech and aerospace fighter variant/configuration designations, such as AS7-K and numerals following Clan BattleMech variants, are not italicized.
 +
** IIC and LAM are part of a design's name rather than variants and should be in italics (e.g. ''Highlander IIC'', ''Stinger LAM'').
 +
* Not italicized are model names of combat vehicles, support vehicles, conventional aircraft, naval vessels, and battle armor (e.g. Manticore, Bailey, Angel, Sovereign, and Void, respectively);
 +
* Specific vehicle & vessel names (eg. ''Oceans of the Stars'', ''Liberator'', ''Yen Lo Wang'');
 +
** Note that a [[Naval Prefixes|prefix]] such as SLS is not part of the name proper, and thus is not italicized (eg. "SLS ''Prinz Eugen''", not "''SLS Prinz Eugen''").
 +
* All foreign language and ranks (with the exception of the Federated Suns or Lyran ranks) (ex: ''ja'', ''Kommandant'', ''Tai-sho'', Sergeant Major);<ref>[[:File:Italicized ranks.png| Per Line Developer Ray Arrastia, 02Aug2022]] (screencap)</ref>
 +
* Traditional Clan words that differ from common English (ex: ''surat'', ''chalcas'', rede).
 +
 
 +
===Words that should appear non-italicized===
 +
The following words should generally appear non-italicized:
 +
{{div col|colwidth=25em}}
 +
* BattleMech
 +
* OmniMech
 +
* 'Mech
 +
* MechWarrior
 +
* BattleTech
 +
* DropShip
 +
* JumpShip
 +
* WarShip
 +
* Aerospace/Conventional fighter
 +
* OmniFighter
 +
* ProtoMech
 +
* Variant/Configuration designations (ex: AS7-K, STU-K15)
 +
* Vehicles (ex: Indra, Swift Wind)
 +
* Infantry (ex: Jump, Rifle)
 +
* Battle armor (neither the word nor classes; ex: Elemental, Nighthawk)
 +
{{div col end}}
  
''For the use of numbers in military commands, see the [[Policy:BattleTech_Style_Guide#Military_Commands|Military Commands]] section.''
+
===Epigraphs===
 +
Epigraphs (the location and date stamp seen in chapter headers) are italicized as well, as are quotations taken out of the body text and placed as a header. Names of publications (such as for books, stories, magazines, films, box sets, etc.) should also be italicized, though sections from within a publication should not be; instead, they are highlighted by quotations (ex: "Advanced Rules", "Active Probes"). The exception is a work of fiction, or short story, within a publication, which would be italicized.
  
 +
==Notes==
 +
* This policy is based on [[BattleCorps]]' Classic BattleTech Style Guide.
 +
* Contents were borrowed from a similar guide being built by Admin [[User:Mbear|Mbear]], among others.
 +
* All sections of this guide are adaptable, as new terms are introduced—in a stylistic way—with new products.
  
[[Category:Manual of Style]][[Category:Uncompleted Policies]]
+
==References==
 +
<references/>

Latest revision as of 10:59, 11 March 2024


As BattleTech has its own specific format and style for many words found within its universe, our wiki attempts to uses this specific format style for many of the words found within its articles, as well as an overall aesthetic that attempts to match that of Catalyst Game Labs' BattleTech. This style guide details stylistic elements that all editors should incorporate to help present a uniform style for articles.

This is separate from the policy of style for the entire wiki.


Guidelines[edit]

BattleTech writer style guides have repeatedly changed in the past. The general guideline is to follow the most recent example.

BattleTech-specific names[edit]

These words retain their capitalization wherever within a sentence they are used. The following words always appear in the form shown below:

  • BattleMech
  • BattleTech
  • DropPort
  • DropShip
  • IndustrialMech
  • JumpShip
  • 'Mech
  • MechWarrior
  • OmniMech
  • OmniFighter
  • ProtoMech
  • WarShip

House vs State[edit]

In writing about the fates and fortunes of the characters from the various Great Houses, it is to be understood (by the reader) the state and ruling family are separate entities. When referring to a House, the characters that belong to that specific family will be the focus of the statement; the state's name will specifically reference the nation, its government, and its collective people.

Ex: House Davion refers to Lucien Davion and his progeny; the Federated Suns refers to the Successor State founded by him.

Military Commands[edit]

  • When military command article titles involve numbers, the text should always be represented as a number.
Ex: 1st Davion Guards, 304th Assault (Clan Ghost Bear)
  • When writing about military commands in the body of an article, the numerical portion of the command's title should be spelled out, unless it is higher than one hundred.
Ex: First Davion Guards, 304th Assault (Clan Ghost Bear)
  • The full name of a command should be used rather than an abbreviation, however common.
Ex: Valexa Capellan March Militia instead of Valexa CMM.
  • All Clan commands should have the Clan name after the title in parenthesis.
Ex: Golden Keshik (Clan Wolf-in-Exile)

Titles[edit]

  • In generic use, apply lower case to words such as president, professor, and emperor. Exceptions are made for non-English words and specific titles that incorporate a number into the title, such as "First Prince".
Ex:
- Edmund Davion served in the role of president for just over thirteen years. He, however, was never a First Prince.
- Stefan Amaris envisioned himself a galactic emperor.
  • Directly juxtaposed with the person's name, such words begin with a capital letter.
Ex:
- Coordinator Yama Von Rohrs served in that role from 2470 to 2508.
- Professor Emeritus Dietrich Mathers was a professor from the Lyran Alliance.
  • Standard or commonly used names of an office are treated as proper names. Royal styles are capitalized; exceptions may apply for particular offices.
Ex:
- Daniel Calderon was Protector of the Realm.
- "His Majesty, the first of his name, Lord of..."

Italics[edit]

Italics apply throughout an article, to include the opening, main body, infoboxes and references.

The following should generally appear italicized:

  • Model names for BattleMechs, ProtoMechs, DropShips, JumpShips, WarShips, Space Stations, and aerospace fighters (e.g. Atlas, Minotaur, Union, Scout, Carrack, Olympus, and Stuka, respectively);
    • Note that ’Mech and aerospace fighter variant/configuration designations, such as AS7-K and numerals following Clan BattleMech variants, are not italicized.
    • IIC and LAM are part of a design's name rather than variants and should be in italics (e.g. Highlander IIC, Stinger LAM).
  • Not italicized are model names of combat vehicles, support vehicles, conventional aircraft, naval vessels, and battle armor (e.g. Manticore, Bailey, Angel, Sovereign, and Void, respectively);
  • Specific vehicle & vessel names (eg. Oceans of the Stars, Liberator, Yen Lo Wang);
    • Note that a prefix such as SLS is not part of the name proper, and thus is not italicized (eg. "SLS Prinz Eugen", not "SLS Prinz Eugen").
  • All foreign language and ranks (with the exception of the Federated Suns or Lyran ranks) (ex: ja, Kommandant, Tai-sho, Sergeant Major);[1]
  • Traditional Clan words that differ from common English (ex: surat, chalcas, rede).

Words that should appear non-italicized[edit]

The following words should generally appear non-italicized:

  • BattleMech
  • OmniMech
  • 'Mech
  • MechWarrior
  • BattleTech
  • DropShip
  • JumpShip
  • WarShip
  • Aerospace/Conventional fighter
  • OmniFighter
  • ProtoMech
  • Variant/Configuration designations (ex: AS7-K, STU-K15)
  • Vehicles (ex: Indra, Swift Wind)
  • Infantry (ex: Jump, Rifle)
  • Battle armor (neither the word nor classes; ex: Elemental, Nighthawk)

Epigraphs[edit]

Epigraphs (the location and date stamp seen in chapter headers) are italicized as well, as are quotations taken out of the body text and placed as a header. Names of publications (such as for books, stories, magazines, films, box sets, etc.) should also be italicized, though sections from within a publication should not be; instead, they are highlighted by quotations (ex: "Advanced Rules", "Active Probes"). The exception is a work of fiction, or short story, within a publication, which would be italicized.

Notes[edit]

  • This policy is based on BattleCorps' Classic BattleTech Style Guide.
  • Contents were borrowed from a similar guide being built by Admin Mbear, among others.
  • All sections of this guide are adaptable, as new terms are introduced—in a stylistic way—with new products.

References[edit]