Battlestar Wiki:Standards and Conventions: Difference between revisions
More languages
More actions
Line 141: | Line 141: | ||
== Category Alphabetical == | == Category Alphabetical == | ||
All manually entered categories for any page should be in alphabetical order: 0-9 then A-Z. Categories should go below | All manually entered categories for any page should be in alphabetical order: 0-9 then A-Z. Categories should go below templates (if it's the last item) and before [[BW:FA]] and [[BW:QA]] templates, All interwiki language linksw should be last and should also be in alphabetical order. | ||
= See also = | = See also = |
Revision as of 03:54, 12 September 2006
| |||||
This page serves as the central hub for standards used in writing articles on Battlestar Wiki. Initially, it will probably consist of a lot of gesturing and debating on the talk page. Once a reasonable approximation of consensus is achieved on a topic, information about it will be moved here. Feel free to bring up new convention questions on the Talk page.
This page is not designed to supercede other project's or policies. Some overlap is expected, but project-specific standards and conventions should be moved to their project page, if one exists or a page created for a project, if one does not.
HTML vs. Wiki code
Wiki code is strongly preferable to the use of HTML coding on Battlestar Wiki. Wiki code is faster to type, and if everything is in wiki code, it all changes in unison in the case that a format or style changes, thus reducing mass re-edits to all pages during a huge update. Especially, <b> and <i> should always be replaced by their wiki code equivalents (''' and '', respectively).
Spelling and Numbers
Please use the American English spellings of words as much as possible in the English version of Battlestar Wiki. This is arbitrary, but a call had to be made for standardization.
If you are British, please feel free to add your contributions in the "Queen's English" if this makes it initially easier for you to contribute. However, please do not re-edit correctly spelled American English edits (including edits to your own contributions) to their British counterparts unless you are rewriting whole paragraphs, sections, or articles.
Use "the Twelve Colonies" or "the Colonies" rather than "the 12 Colonies" as it is the name of a sovereign government like "the United States." Likewise, "Colonial" should always be capitalized, although "colony" or "colonies" remains uncapitalized for the same reason we do not capitalize "state" or "states" when referring to one of the United States.
Numbers should use a period (.) for decimal places and a comma (,) for marking every three digits (e.g. 3,600 or 54,345,277). For ease of reading, such use of commas is encouraged. Numbers less than 11 should generally be written out long hand (i.e. seven, not 7).
Character Names
Characters should be introduced with both first and last name the first time they are mentioned in an article. Subsequent referalls may abbreviate to the last name. Never use only the first name when the last name is known (ie, "Kara Thrace" or "Thrace", but never "Kara").
There are several currently active characters who share the same last name. These characters include the Adamas, the Tighs, and the Tyrols, but also extend into the human aliases of the various Cylon agents, particularly the Sharon Valeriis. It is often tempting to refer to the supporting characters by their first names, and (William) Adama and (Saul) Tigh by their last. On Battlestar Wiki, we find this somewhat condescending.
Where neccessary, characters sharing the same last name should both be introduced using full names, and may subsequently be referred to with first names. For example, in a single article or section where the characters interact with each other, characters such as Ellen Tigh and Saul Tigh should be introduced by their full names. The character's first names may be used to differentiate in article sections and topics where the characters interact directly with each other in the course of an event (such as the Tigh's drinking episodes in season 2). If Saul and Ellen appear in the same article but are not interacting directly, the full names or titles should be used to differentiate.
An exception to the "last names only" convention is on a character's biography article. The character's last name may have precedence over all other characters of the same name. All others with the same last name may be referred to by their first name in biography articles. (For example, "Adama asks his son, Lee, to fix the sink.")
Other acceptable means for disambiguation include rank (Admiral Adama vs. Captain Adama) and callsign (Adama vs. "Apollo"). Callsigns are appropriate for summaries and military data, but not for biographies. For Re-imagined Series characters, it is a good rule of thumb to use their callsign in articles where story events place the character in actual flight in a fighter.
Character Titles
Members of the Quorum of Twelve should be referred to as delegates, not representatives. Although the show uses both terms, the "delegate" appears to be the formal title.
Ships
Ship names should always be italicized (e.g. Galactica). Italicization of ship names includes the possessive marker and other endings added to a ship's name (e.g. Galactica's, not Galactica's), but not articles.
Military ships generally receive no article (i.e. "Galactica" not "the Galactica") and civilian ships generally do receive an article (i.e. "the Rising Star" not "Rising Star"). There are some exceptions to this (e.g. Colonial One, Cloud 9). Usually, ship names ending in a number do not receive an article.
When possible, the first mention of a ship in an article should include the hull number (e.g. "Galactica (BS 75)"). Note that there is no hyphen in the hull number. All subsequent references to the same ship need not include the hull number, but can if some other reasoning dictates it.
Ships' nicknames should appear in quotes the first mention of the nickname only (e.g. "Pegasus, "The Beast", launch her alert Vipers."). Subsequently, the nickname may be used interchangably with the ship's actual name.
Typically, ships are treated as feminine objects. The use of "she" and "her" in referring to a ship by pronoun is encouraged, though not mandated.
When discussing Vipers, use of either "Mark" or "Mk." is acceptable, though "mk." is just sloppy. Also, Roman numerals are preferred. Thus, "Viper Mark II" or "Viper Mk. VII" but not "Viper mk. 2."
- (Note: Many of these guidelines are inspired by, modified from, or stolen directly from the US Navy's Style Guide.)
Verb Tense
In almost every case, the present tense should be used when relating events occurring in an episode (e.g. Baltar shoots Crashdown in the back in order to save Cally's life). This is in line with the traditional style used to discuss literary works of fiction. The reasons it is employed for those kinds of articles entirely apply here on Battlestar Wiki.
Exceptions can be made for articles dealing with "historical" events, where present tense can impede narrative flow. Typically, a historical event involves situations that occur prior to the Miniseries. "Flashback" scenes in episodes should be treated as historical events. "Thrace cried at Zak's funeral" is appropriate since this event occurs two years before the Miniseries, although we see the event in a flashback scene in "Act of Contrition."
Links to Episodes
When referring to episode titles as part of a sentence, use quote marks around the episode name. This helps keep the title distinct from other text. This is especially useful for unwieldly episode names such as "Kobol's Last Gleaming, Part I."
When citing a single episode title as a source for a body of text, use parentheses, but do not place quotes around the episode name. Citations go inside the sentence's punctuation.
- Example: "Galactica finds Pegasus (Pegasus)."
When citing multiple episode titles as a source for a body of text, place all episode names within one set of parentheses. Each episode title should use commas to separate them within the parentheticals. (Do not place quotes around the name of Miniseries, as this is a designation and not an actual episode name.)
- Example: Lee Adama is moody often (Miniseries, "33," "Water," "The Hand of God").
Signing Your Work
Don't. Battlestar Wiki is a collaboration of many writers. Be proud of your contributions, but do not take ownership of articles. Signatures will be removed without debate.
Images
All episode screenshots are copyright NBC/Universal or Universal Studios, and should be credited as such on image pages. If you upload an image, make sure you tag it correctly. You can do that by following the correct formats on the official policy on image tagging.
Images are desirable wherever their use is appropriate. Character pictures are currently being handled on the Battlestar Wiki:Characters project. Other articles needing images are listed at Battlestar Wiki:Requested Images.
Quote of the Day
Quotes for the Quote of the Day should all conform to this standard. In all cases, the naming conventions should agree with Character Names, above. The first occurences of all character and ship names within quotes should be linked. Pronouns (you, he, it) may be linked to clarify who or what the speaker is referring to. Linking of other words (jargon, etc.) is also left to a matter of discretion. All episode names should, of course, be linked.
For one-line quotes, the quote should appear first, enclosed in double-quotes with normal weighting and no italics (except to show emphasis). It should be followed with a hard line break (<br/>). Battlestar Wiki strives to be valid XHTML 1.0 Transitional, which means all tags, including <br> tags, must be closed. (We don't want to break anything, now do we?)
The following line should begin with a double en-dash (--) followed directly by the rank or position of the character being quoted, then their name. These should be non-italics and normally weighted, as well. Finally, the episode name, in italics, should appear in parenthesis after a space. Do not place any punctuation after the parenthesis.
- "The line, in normal-weighted text, enclosed in double quotes."<br/>
- --Rank and Name in Normal (Episode Name)
This will end up looking thus:
- "Ladies and gentlemen, please. Please. We are in a laboratory. There are hazardous chemical compounds everywhere. That--that's a thermo-nuclear bomb, for frak's sake, so..."
- --Dr. Gaius Baltar (Tigh Me Up, Tigh Me Down)
For quotes longer than one line, each utterance will appear on its own line. The speaker's rank or position and name should appear followed by a colon (:) first. All of this should be bold. The actual line follows, in normal weighted font, followed by a hard line break (<br/>). Subsequent utterences by the same speaker should begin simply with the character's name, as layed out in Character Names, above. After the final utterance of the quote, the episode name should appear in italics, prefaced by a double en-dash (--).
- Rank and Name 1: Humorous battle banter aimed at Speaker 2.<br/>
- Rank and Name 2: Scathing insult.<br/>
- Name 1: Pithy retort.<br/>
- --Episode Name
For example:
- Captain Lee Adama: Hey, how about you, Boomer? Doc tells me you're holding up better than anybody in the squadron.<br\>
- Lieutenant Sharon Valerii: I'm tired, like everybody else.<br\>
- Adama: You never seem it.<br\>
- Lieutenant Kara Thrace: 'Cause she's a Cylon.<br\>
- Valerii: You're just gonna make me come over there and kick your ass, aren't you?<br\>
- --33
- (Note: All quotes should go in the Quotes namesapce in the format, Quotes:MM DD).
Disambiguation
Because each of the Battlestar Galactica TV series reuses ship names, character names, episode titles and other terminology, it is occasionally necessary to write articles covering the same thing in different continuities.
When this is the case, an individual article should be used for each series. Articles should be namespaced according to the following schema:
- (TOS) - Original Series
- (RDM) - Re-imagined Series
- (Video Game) - 2003 Video Game
- (1980) - Galactica 1980
- (SDS) - Ill-fated Singer/DeSanto continuation project
- (SC) - Richard Hatch's "Second Coming" attempt
The non-namespaced article should serve as a disambiguation page, pointing to the related articles.
Examples of this in use are:
- Pegasus (TOS) vs. Pegasus (RDM) (disambiguation at Pegasus)
- Adama (TOS) vs. William Adama vs. Lee Adama (disambiguation at Adama)
Pages for characters that appear in more than one series should reserve the name in common for disambiguation (Cf. Adama, Baltar, etc.), but individual pages need not be tagged with the series name if there is sufficient information in the title otherwise so as to be disambiguous (Cf. Gaius Baltar vs. Baltar (TOS) or William Adama vs. Adama (TOS)).
Child articles of a disambiguation page should have a note applied at the top of the page (before everything, even the character template, etc.) linking back to the disambiguation page and its most relevant sister disambiguations. Keep the diambiguation links literal to make them distinctive. That is, don't change [[Baltar (TOS)]] to [[Baltar (TOS)|Baltar]]. This note should be preceded by a single tab and be in all italics. An example from Gaius Baltar's article:
- This page discusses the unwitting betrayer of the Twelve Colonies of Kobol in the Re-imagined Series. For information on the Original Series character that intentionally betrays the Twelve Colonies of Man, see Baltar (TOS).
Questions Section
Every episode-synopsis article includes a section called "Questions". The idea behind the section is, "These are the questions this episode raises and does not answer by itself." Since these pages are encyclopedic, it is not intended that the "Questions" section be used to actually speculate as to the answers! Please use the Analysis section of an episode article for brief speculation.
The rules of thumb on questions are:
- If a question is raised and not answered in the episode, it belongs in the Questions section on the encylopedic page.
- If a question is added to the encyclopedic page, and someone else realises it's actually answered in the same episode, it might make sense to add the answer after the question, but it probably makes more sense to move both the question and the answer to the Talk page, because it isn't really an unanswered question. If it's an ambiguous or obscure item that keeps coming up (or seems likely to), then it might belong in "Analysis" or "Notes."
- If a question is answered in a later episode, the analysis for that episode should note that the event refers to an earlier open plot point. The original page can be edited to point forward to the answer, but the answer itself should not be edited into the page for the episode that posed the question. An early example of this style appears on the encylopedia page for the episode "Water:" "Why do the Cylons want to keep Helo on Caprica?"
- Debates and discussion have no place on the encyclopedic pages; only on the talk pages. Encyclopedic pages should be neutral-point-of-view and descriptive. That is, when responding to a question, do not phrase the answer in such a way that the question (and the article) appears to be "arguing with itself."
- If a dispute occurs on whether a question is germane, appropriately located or answered, the debate should be moved over to a topic on the article's talk page. To aid others with the same question, a link to the debate should be added to the question so others know that this topic has an extended discussion elsewhere.
Category Alphabetical
All manually entered categories for any page should be in alphabetical order: 0-9 then A-Z. Categories should go below templates (if it's the last item) and before BW:FA and BW:QA templates, All interwiki language linksw should be last and should also be in alphabetical order.