Editing Battlestar Wiki:Standards and Conventions/Formatting

{{project|Standards and Conventions on Formatting|image=BSG WIKI SC.png|shortcut=BW:FORMAT<br/>BW:FORMATTING}}

{{Battlestar Wiki Standards and Conventions}}

==HTML vs. Wiki code==

{{mainarticle|Battlestar Wiki:Markup}}

The usage of [[BW:MARKUP|Wiki code]] supersedes the use of HTML coding on Battlestar Wiki. Wiki code is faster to type and, if everything is in wiki code, allows changes to cascade automatically in the event that a format or style is modified, thus reducing mass re-edits to all pages during a huge update. 

Especially, &lt;b&gt; and &lt;i&gt; should ''always'' be replaced by their wiki code equivalents (<nowiki>'''</nowiki> and <nowiki>''</nowiki>, respectively).

For a tutorial on coding and formatting using Wiki code, see: [[Battlestar Wiki: Tutorial (Formatting)]].

==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 [[:md:BWM:ITP|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 [[:md:Battlestar Wiki Media:Requested Images|Battlestar Wiki Media:Requested Images]].

To find out how to add images using Wiki code, see: [[Battlestar Wiki:Tutorial (Images)]].

=== Image galleries ===

Image galleries should be used '''''sparingly''''', and then only in ''extreme circumstances''. 

We do not permit image galleries to depict multiple shots of a character or of events in an episode, due to [[w:fair use|fair use]] issues. Image galleries, like the ones on certain image gallery websites that will remain nameless are ''illegal'', since their use is not covered under the aforementioned fair use copyright laws of the United States.<ref>For those of you wondering why these sites are rarely gone after, it is because going after such websites costs more money than its actually worth. Still, just because no one goes after these sites, it doesn't mean that they're in the right in the eyes of copyright law.</ref>

Where to use image galleries:

* On ship pages, such as ''[[Galactica (RDM)|Galactica]]''.
** At ''maximum'', a "ship image" gallery would include various views of the ship (forward, stern, port, starboard, topside, and underside), as well as some interior shots of the ship (corridor, major areas, etc.) Do not include multiple pictures of the same thing. 
* On pages that are too small for images to be included inline with text.

Pages with galleries containing one picture will most likely have the gallery removed and, at worst, the picture deleted.

==Audio==
All audio clips from the show are copyright NBC/Universal or Universal Studios, and should be credited as such on their file's description pages.  If you upload an audio clip, make sure you tag it correctly. You can do that by following the correct formats on the [[:md:BWM:ATP|official policy]] on audio tagging.

Audio clips are desirable wherever their use is appropriate. For instance, it is acceptable to use audio on the following pages:

* To help illustrate articles in a way pictures cannot. 
** Examples: [[Case Orange]], [[Action stations]]
* To bring notable quotes to light in audio format, namely on [[Portal:Episodes|episode guide entries]]:
** Examples: [[Crossroads, Part II#Noteworthy Quotes]]

== Category Rules ==
{{mainarticle|Battlestar Wiki:Categories}}
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 links should be last and should also be in alphabetical order. Interwiki links are maintained by [[User:InterBot|Interwiki Bot]].

All categories up to the "parent" category should be included. For example, [[Colonial One]] has all of these cats:

<pre>

{{Ships}} ↔

[[Category:A to Z]] ¿
[[Category:Colonial]] *
[[Category:Colonial Craft]]
[[Category:Colonial Craft (RDM)]]
[[Category:Ships]] *
[[Category:Ships (RDM)]]
[[Category:RDM]]

{{quality article}} ↔
{{featured article}} ↔

or

[[de:Colonial One]] ‡
</pre>

The categories marked with a * are the parent categories, because the next category after that is "A to Z" in which is included in all article pages. The ''A to Z'' ¿ category is always first and always included on every page.

Note: The "Ships" template ({{tl|Ships}}) is before the categories. The one interwiki link for Colonial One is after "RDM" category but before the featured and quality article templates. The FA and QA templates are not used if the article conforms to "[[BW:REAL|Real Point of View]]" rules. If a template auto-creates "categories", place the template in-between the categories so that it would not break the alphabetical order of the categories.

From ''"[[Antibiotics]]"''...
<pre>
[[Category:A to Z]]

{{Drugs}}

[[Category:Technology]]
[[Category:Technology (RDM)]]
[[Category:Terminology]]
[[Category:Terminology (RDM)]]
[[Category:RDM]]
</pre>


By doing this, this allows people to browse by series or non-series if they goto the category view.

<pre>
RDM                              TOS                             Ships
|- Colonial Craft (RDM)   |- Colonial Craft (TOS)  |- Ships (TOS)
|- Ships (RDM)               |- Ships (TOS)              |- Ships (RDM)
</pre>
     
The only time that this does not apply is to the series category. <code>TOS</code>, <code>TSC</code>, <code>1980</code>, <code>RDM</code>, <code>Comics</code>, and <code>Video Game</code> should be be the last category added ''and'' this is also the list of the "top level" categories on Battlestar Wiki. If the article contains more than one series or genre, make sure they they are in this order also. This includes any double categories as shown by the example for [[Richard Hatch]]:

<pre>
{{DEFAULTSORT:Hatch, Richard}}
[[Category:A to Z]]
[[Category:Cast]]
[[Category:Cast (TOS)]]
[[Category:Cast (TSC)]]
[[Category:Cast (RDM)]]
[[Category:TOS]]
[[Category:TSC]]
[[Category:RDM]]
</pre>

Pages that are lists should be categorized in their sub-category itself with <code>|*</code>, but not when you add the <code><nowiki>[[Category:Lists]]</nowiki></code>. It makes the lists the first items in the category view.

Individuals and characters with proper names should be sorted by ''last'' name, then ''first'' and ''middle'' names. To achieve this, use:

: <code><nowiki>{{DEFAULTSORT:lastname, firstname middlename}}</nowiki></code>

You may still override the default sort by piping the <code><nowiki>[[Category:]]</nowiki></code> syntax like so:

: <code><nowiki>[[Category:A to Z|Hatch, Richard]]</nowiki></code>

Be sure to '''check your work.''' Make sure there aren't other sub-categories that you can add to to the article to make navigation and reference easier. Categories are an easy and powerful addition to every article, so be sure to be thorough.
=== [[Caprica (series)]] ===
All ''Caprica'' series related articles should have <code>Caprica (series)</code> category before <code>RDM</code> as it is not a top level category.

==Links==

===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 unwieldy episode names such as "[[Kobol's Last Gleaming, Part I]]".
:*Example: "In the episode "[[Pegasus (episode)|Pegasus]]", ''Galactica'' finds ''[[Pegasus (RDM)|Pegasus]]''."

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 (episode)|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]]").

Although ''Battlestar Wiki'' uses [[w:Quotation_mark#Punctuation|American punctuation rules]] otherwise, placing all punctuation within the quotation marks, it is encouraged to make an exception for episode and book titles, placing commas or periods ''outside'' the quotation marks in those cases.

=== "Red Links" ===

A "red link" is a term for a link to an article that does not exist on the wiki, but can be created. 

There are many methods to dealing with red links:

# Determine whether or not the link contains a misspelling. If so, correct it.
# Determine if the link needs to be piped, i.e. <code><nowiki>[[Lee]]</nowiki></code> should be <code><nowiki>[[Lee Adama|Lee]]</nowiki></code>.
# If the article does not exist in any namespace or any form, then create the article. You can either fill it out with content or simply tag it with {{tl|requested}} and save it.

While some believe that red links out there help create articles here, the overwhelming fact that many red links on [[Special:Wantedpages|the "Wanted Pages" list]] are links to images served on our [[md:Main Page|Media repository]] necessitates the usage of creating an article and applying the {{tl|requested}} template.<ref>See the [[Battlestar Wiki:Think Tank/Red Link Policy|Red Link]] think tank proposal for the origins of this addition.</ref>