Difference between revisions of "Style Guide"

From Discovery Wiki
Jump to navigationJump to search
m (rm Template:Style Guide Navigation from top of the page (not very useful and replaced by Template:Guide Navigation; most people probably aren't looking for template pages at the top of the page when they come here))
 
(53 intermediate revisions by 12 users not shown)
Line 1: Line 1:
 
Hello! Welcome to the Discovery Mod Wiki Editing Style Guide.<br>
 
Hello! Welcome to the Discovery Mod Wiki Editing Style Guide.<br>
−
*'''Note: Please refrain from editing this Guide.''' If you have style suggestions please discuss them on the [[Talk:Style_Guide|Talk page]] or on the [http://discoverygc.com/forums/index.php?showtopic=21033 Discovery Forums]
+
*'''Note: Please refrain from editing this Guide.''' If you have style suggestions please discuss them on the [[Talk:Style_Guide|Talk page]] or on the [[dgctopic:21033|Discovery Forums]]
  
 
This Guide is intended as a reference for new and veteran wiki editors to acquaint themselves with the styles and formatting in use by the Discovery Mod Wiki. Following the directions and examples in this Guide will help the numerous people working on the Discovery Mod Wiki to maintain a consistent format and style across all of the wiki pages. Please be considerate of your co-editors and readers by attempting to keep consistency as much as possible. Consistency in style and format leads people to being able to find things quicker, to read faster, and to find the required information more efficiently.
 
This Guide is intended as a reference for new and veteran wiki editors to acquaint themselves with the styles and formatting in use by the Discovery Mod Wiki. Following the directions and examples in this Guide will help the numerous people working on the Discovery Mod Wiki to maintain a consistent format and style across all of the wiki pages. Please be considerate of your co-editors and readers by attempting to keep consistency as much as possible. Consistency in style and format leads people to being able to find things quicker, to read faster, and to find the required information more efficiently.
Line 6: Line 6:
 
If anything doesn't make sense or you don't understand something please give it some tries first and if you really don't get the idea, discuss it in the [[Talk:Style_Guide|talk page]]. We are always aiming to improve this Guide. If you are really struggling to comprehend what is going on, or are looking for ground-level basic wiki editing help then please see the following: This wiki uses [http://www.mediawiki.org MediaWiki]. For a more detailed overview about editing please consult the [http://meta.wikimedia.org/wiki/Help:Editing MediaWiki Handbook] or [http://en.wikipedia.org/wiki/Help:Wikitext_examples Wikitext example page].  
 
If anything doesn't make sense or you don't understand something please give it some tries first and if you really don't get the idea, discuss it in the [[Talk:Style_Guide|talk page]]. We are always aiming to improve this Guide. If you are really struggling to comprehend what is going on, or are looking for ground-level basic wiki editing help then please see the following: This wiki uses [http://www.mediawiki.org MediaWiki]. For a more detailed overview about editing please consult the [http://meta.wikimedia.org/wiki/Help:Editing MediaWiki Handbook] or [http://en.wikipedia.org/wiki/Help:Wikitext_examples Wikitext example page].  
  
−
To get started on learning the Discovery Wiki Styles click in the contents list on the subject you are interested in.
+
[http://dgc.mrawr.net/#gsc.tab=0&gsc.q=&gsc.sort=&gsc.ref=more%3Awiki Google Search of this site.]
  
 
== The Basics ==
 
== The Basics ==
 
Below are some 'rules' that should be adhered to, for across-the-wiki style and formatting consistency. Information added to the wiki pages should be factual and not biased or subjective to any person's opinion. If you think a ship "sux" keep those comments to yourself. We are looking for information that is useful and true. If that "suxxy ship" turns a full 360 degrees in two hours, then please do write that up.
 
Below are some 'rules' that should be adhered to, for across-the-wiki style and formatting consistency. Information added to the wiki pages should be factual and not biased or subjective to any person's opinion. If you think a ship "sux" keep those comments to yourself. We are looking for information that is useful and true. If that "suxxy ship" turns a full 360 degrees in two hours, then please do write that up.
 +
 +
Remember that Wiki interprets a linebreak as an actual <nowiki><br></nowiki> or even a beginning of new paragraph. To avoid redundant whitespaces, you should not add linebreaks between the infobox template and the text content itself, otherwise the text looks nudged down. The descriptions goes directly below the templates.
  
 
=== Spelling ===
 
=== Spelling ===
Line 25: Line 27:
 
Page titles should be in First Letter Capitalized format. This excludes conjunctions (of, and,). To keep track of these conjunction titled pages, please list them here if found or created, stating the page title and type of page.
 
Page titles should be in First Letter Capitalized format. This excludes conjunctions (of, and,). To keep track of these conjunction titled pages, please list them here if found or created, stating the page title and type of page.
  
−
*[[Jump_Gate_and_Trade_Lane_Parts]] (commodity)
+
*[[Jump Gate and Trade Lane Parts]] (commodity)
  
 
Page titles should be expanded. This means, please refrain from making pages titled ''"BPA"'', rather, expand the abbreviations so that ''"BPA"'' becomes ''"Bretonia Police Authority"''. This can be achieved by using [[Style_Guide#Piping_Links|piping links]], or simply writing out the abbreviations.
 
Page titles should be expanded. This means, please refrain from making pages titled ''"BPA"'', rather, expand the abbreviations so that ''"BPA"'' becomes ''"Bretonia Police Authority"''. This can be achieved by using [[Style_Guide#Piping_Links|piping links]], or simply writing out the abbreviations.
Line 36: Line 38:
 
| style="text-align: center; font-size: large; background: #339900; color: #ffffff;" |'''Lowercase Links'''
 
| style="text-align: center; font-size: large; background: #339900; color: #ffffff;" |'''Lowercase Links'''
 
|-
 
|-
−
| style="background: #f6f6f6;" | Passengers are [[civilians]] who have money and courage for interstellar travels. As [[transports]] are favorite targets for pirate attacks, many [[passengers]] find it safer to travel to distant places in freelancing ships. You will find passengers willing to travel on almost all populated planets, price they will pay you generally depends on the length of the route.  
+
| Passengers are civilians who have money and courage for interstellar travels. As [[transports]] are favorite targets for pirate attacks, many [[passengers]] find it safer to travel to distant places in freelancing ships. You will find passengers willing to travel on almost all populated planets, price they will pay you generally depends on the length of the route.  
 
|-
 
|-
 
|}
 
|}
Line 43: Line 45:
 
| style="text-align: center; font-size: large; background: #339900; color: #ffffff;" |'''Uppercase Links'''
 
| style="text-align: center; font-size: large; background: #339900; color: #ffffff;" |'''Uppercase Links'''
 
|-
 
|-
−
| style="background: #f6f6f6;" | This lush green world is the home of the [[Cambridge Research Institute]] - an institution devoted to pure scientific research. The idyllic green fields also find themselves home to the manor retreats of [[New London]]'s aristocracy during the warmer months of the year. Bretonia's epidemic food shortages required the planetary regents to place scientists and farmers together to develop more bountiful crops, making [[Cambridge]] the primary food supplier for [[Bretonia]]. Now many Cambridge scientists sympathise with the [[Gaian]] echo-terrorist movement, prompting the formation of political groups such as [[The Green Front]] and igniting bitter debates among researchers on topics such as terraforming.  
+
| This lush green world is the home of the [[Cambridge Research Institute]] - an institution devoted to pure scientific research. The idyllic green fields also find themselves home to the manor retreats of [[New London]]'s aristocracy during the warmer months of the year. Bretonia's epidemic food shortages required the planetary regents to place scientists and farmers together to develop more bountiful crops, making [[Cambridge]] the primary food supplier for [[Bretonia]]. Now many Cambridge scientists sympathise with the [[Gaians]] echo-terrorist movement, prompting the formation of political groups such as '''The Green Front''' and igniting bitter debates among researchers on topics such as terraforming.  
 
|-
 
|-
 
|}
 
|}
 
===== Piping Links=====  
 
===== Piping Links=====  
 
A piped link is when the highlighted words direct you to another discovery wiki page that does not use those words in the Title. The pipes should direct to the plural of items and subjects, unless it is a proper noun. See below for examples. The format is as follows <nowiki>[[Actual Piped Link|Words that are diplayed]]</nowiki>.
 
A piped link is when the highlighted words direct you to another discovery wiki page that does not use those words in the Title. The pipes should direct to the plural of items and subjects, unless it is a proper noun. See below for examples. The format is as follows <nowiki>[[Actual Piped Link|Words that are diplayed]]</nowiki>.
−
<pre>*[[New York System|New York]]
+
<pre>*[[Bretonia Police Authority|BPA]]
−
*[[Bretonia Police Authority|BPA]]
 
 
*4 [[Class 4 Guns]]
 
*4 [[Class 4 Guns]]
 
*1 [[Class 7 Turrets|Class 7 Turret]] ****note the 's' missing when piping from a single weapon.
 
*1 [[Class 7 Turrets|Class 7 Turret]] ****note the 's' missing when piping from a single weapon.
Line 55: Line 56:
  
 
''Results in:''
 
''Results in:''
−
*[[New York System|New York]]
 
 
*[[Bretonia Police Authority|BPA]]
 
*[[Bretonia Police Authority|BPA]]
 
*4 [[Class 4 Guns]]
 
*4 [[Class 4 Guns]]
 
*1 [[Class 7 Turrets|Class 7 Turret]] ****note the 's' missing when piping from a single weapon.
 
*1 [[Class 7 Turrets|Class 7 Turret]] ****note the 's' missing when piping from a single weapon.
 +
 +
=== Wiki lists===
 +
Wiki list sorting screws up when prices do not have the "$" in front of the price. Please add the dollar sign to all price lists and cost fields.
  
 
=== Images ===
 
=== Images ===
−
Any pictures that you upload should be well lit and the viewer should able to easily and clearly see what the subject is. Dark pictures with the sun backlighting the ships, although artistic, are unacceptable for this wiki. Please use well lit, isometric viewpoints for ships; well lit, well framed pictures for planets and bases. The pictures and images should be uploaded in the .jpg format and be of minimal filesize. If you don't know how to do this, please ask someone to do it for you, or contact someone who can do it. [[User_talk:Blodo|Blodo]] and [[User_talk:Chovynz|Chovynz]] are two people who can. ''Image example Specs: ''
+
Any pictures that you upload should be well lit and the viewer should able to easily and clearly see what the subject is. Dark pictures with the sun backlighting the ships, although artistic, are unacceptable for this wiki. Please use well lit, isometric viewpoints for ships; well lit, well framed pictures for planets and bases. The pictures and images should be uploaded in the .jpg format (or .png format if transparency is needed) and be of minimal filesize and reasonable pixel size (minimum of 800 x 600 is a good size to aim for).
−
*[http://discoveryfl.com/wiki/index.php/Image:Odin1.jpg Odin] (598 × 480 pixel, file size: 32 KB, MIME type: image/jpeg)
 
−
*[http://discoveryfl.com/wiki/index.php/Image:Nn_ss_gas_miner.jpg Gas_miner] (800 × 600 pixel, file size: 35 KB, MIME type: image/jpeg)
 
−
* [http://discoveryfl.com/wiki/index.php/Image:Newlondon.jpg Planet New London] (535 × 528 pixel, file size: 61 KB, MIME type: image/jpeg)
 
  
−
=== Categories ===
+
If you are uploading an image of a named object (such as a planet, or a specific station), use the formal name of the object. If you are uploading an image of a generic 3D model (such as a ship model, or a turret model), use the name of the 3D model instead of the item. For example, if you are uploading a picture of the generic Bretonian Battleship, use the name of the ship model, but if you are uploading a picture of the specific Battleship Derby, use the formal station name instead. This provides separation between the item and the underlying model, thereby allowing multiple items to reference a single model, and allowing an item to change models without breaking the other linked references.
−
Every page should have an appropriate category. Every category section should go at the base of the page - the very last thing on the page. See the specific subject for more information.
 
  
 +
''Example Image Specs: ''
 +
*[[:Image:Nn_ss_gas_miner.jpg|Gas_miner]] (800 × 600 pixel, file size: 35 KB, MIME type: image/jpeg)
 +
*[[:Image:Newlondon.jpg|New London]] (535 × 528 pixel, file size: 61 KB, MIME type: image/jpeg)
 +
*[[:Image:Argus_Battlecruiser.png]] (800 × 349 pixel, file size: 321 KB, MIME type: image/png)
 +
'''Note: Please use the lowercase ".jpg" extension, and not the UPPERCASE one.'''<br>
 +
'''Note2: There are some differences between filetypes of images used:'''
 +
*A '''jpg''' file does not have transparency. They are small in size and are suitable to be uploaded to this wiki directly. They are the thumbnails and medium pictures that you see when you go to a system/planet/etc... page. 
 +
*A '''png''' file can have transparency and the filesize is usually a somewhat larger. These can now be uploaded to the Wiki directly. A good suggestion is to get good renders of the ships and upload the png files.  Major Thanks and Kudos to Igiss for activating this!
  
 +
=== Categories ===
  
−
== Ship Pages ==
+
Every page should have an appropriate category. Every category section should go at the base of the page - the very last thing on the page. See the specific subject for more information. Clicking on this "[[Special:Categories|Categories]]" link will take you to the categories so that you can see what categories are available if you need more than basic ones. Try to fit them into an existing Category first, but if that isn't possible feel free to make more as needed.
−
{{Ship_Infobox
 
−
|name = RH-GM40 "Odin"
 
−
|image = Odin1.jpg
 
−
|shipclass = [[Fighters#Very_Heavy_Fighters|Very Heavy Fighter]]
 
−
|shipowner = [[Red Hessians]]
 
−
|guns = 6
 
−
|turrets = 1
 
−
|hull = 9,700
 
−
|cargo = 65
 
−
|maxregens = 62/62
 
−
|optwepclass = 8
 
−
|maxwepclass = 10
 
−
|maxshieldclass = 10
 
−
|maxspeed = 80
 
−
|maxthrust = 199
 
−
|maxpower = 11,400
 
−
|recharge = 1,160
 
−
|equipment =
 
−
[[Countermeasures]],<br>
 
−
[[Mines]],<br>
 
−
[[Torpedoes|Torpedo]]/[[Cruise Disruptors|Cruise Disruptor]]
 
−
|hullcost = 1,995,000
 
−
|fullcost = 2,128,130
 
−
}}
 
−
=== Template ===
 
−
There is a nice looking well working ship Infobox template that is being used. If you find a ship without the template or add a new ship, please format the ship page using the template. Copy and paste below into the top of your Ship page and fill out the fields. The Description of the ship goes directly under this Infobox.[[Odin|Example of complete Ship Page.]]
 
−
<pre>{{Ship_Infobox
 
−
|name =
 
−
|image =
 
−
|shipclass =
 
−
|shipowner =
 
−
|guns =
 
−
|turrets =
 
−
|hull =
 
−
|cargo =
 
−
|maxregens =
 
−
|optwepclass =
 
−
|maxwepclass =
 
−
|maxshieldclass =
 
−
|maxspeed =
 
−
|maxthrust = ??
 
−
|maxpower =
 
−
|recharge =
 
−
|equipment =
 
−
|hullcost =
 
−
|fullcost =
 
−
}}
 
−
Description goes here.</pre>
 
  
−
===Images===
+
For a category beginning with "The" e.g. "The Junkers Congress" you can key sort the category as following:
−
Images of ships are to be uploaded in .jpg format. If you don't know how to do this, please ask someone to do it for you, or contact someone who can do it. [[User_talk:Blodo|Blodo]] and [[User_talk:Chovynz|Chovynz]] are two people who can. ''Image example specs:''
 
−
*[http://discoveryfl.com/wiki/index.php/Image:Odin1.jpg Odin] (598 × 480 pixel, file size: 32 KB, MIME type: image/jpeg)
 
  
−
To use an uploaded image simply copy the name of the uploaded image into the template:<br> |image = imagename.jpg
 
−
 
−
=== Price and Ship Costs ===
 
−
There was found to be an awkward discrepancy between certain ship prices. To address this discrepancy we have followed this plan. On the [[Fighters|main ship lists]] is the Hull only price. That is the '''bare minimum''' that you can buy a ship for, minus all equipment, shields, weapons, nanobots and shield batteries. On the [[Odin|individual pages]] of the ships, you will see two price fields, one for the Hull only, and one for the complete package. The full price can be found by using Datastorm or going in game and taking screenshots. The Hull price is found in the ini files or on the main ship lists. We suggest you just copy and paste from the main list. Please make sure both fields are completed wherever possible.
 
−
 
−
=== Headings ===
 
−
Most ships do not need many headings. Here are some suggested ones.
 
−
*'''Weapon Hardpoints''' - Describes in detail what type guns, turrets or weapons the ship has and how many.
 
−
*'''Handling''' - Describes the maneuverability and way the ship moves through space. See [[Odin]] for a good informative handling example.
 
−
*'''Availability''' - Shows where the ship is sold.
 
−
* '''Media''' - Used for any further pictures or other media of the ships, that are different to the ones in the Infobox. Odin currently has 3 pictures associated with it. First is the thumbnail - what you see when you first come to the Odin page. The thumbnail is generated automatically by Wiki when you upload an image. The second picture is the medium scale image that has been uploaded to the Discovery Mod Wiki. The third is a PNG file that has transparency. This image is not stored on the wiki in any way and is stored at an image hosting site - like Imageshack or Photobucket. This PNG file goes under the '''Media''' heading.
 
 
<pre>
 
<pre>
−
==Weapon Hardpoints==
+
[[Category:Player Factions|Junkers]]
−
* 1 [[Class 5 Turrets|Class 5 Turret]]
 
−
* 2 [[Class 9 Guns]]
 
−
* 4 [[Class 3 Guns]]
 
−
 
 
−
==Handling==
 
−
The Odin is thoroughly classified as a relatively large, although agile VHF. It's armour rating isn't
 
−
especially high, and neither is it's power storage. When properly handled however...
 
  
−
==Availability==
+
This will put in the Player Factions categories, sorted under J, instead of T (default)
−
* [[Freeport 9]], [[Omicron Theta]]
+
Most factions will be fine, automatically via the {{Player Faction}} template.
−
* [[Planet Manhattan]], [[New York System]], [[Liberty]]
+
Manually adding this will override the automatic.  
−
 
 
−
== Media == ********Usage is [Link Name]
 
−
[http://img225.imageshack.us/img225/186/odineg0.png Ship render]
 
 
</pre>
 
</pre>
  
−
=== Categories ===
+
Copy and paste. In general, one or more of these categories below will suffice:
−
Every ship should have a Category assigned to it. At the very minimum this one below should be included in the Categories. Civilian line of ships will have the Civilian Category included; Outcasts ships will have the Outcasts Category.
 
−
<pre>[[Category: Ships]]</pre>
 
−
 
 
−
== Planet Pages ==
 
−
{{Base_Infobox
 
−
|name = New London
 
−
|image = Newlondon.jpg
 
−
|system = [[New London System]]
 
−
|sector = D6
 
−
|location = [[Bretonia]]
 
−
|owner = [[Bretonia Police Authority]]
 
−
|type = Terrestrial Planet
 
−
}}
 
−
Planet page titles are to be named '''Planet Name'''. There are a number of systems that have the same name as their major planet, so we use "Planet" to distinguish between the system and the planet.
 
−
 
 
−
When in text blocks and it is obvious the context is talking about a planet, you may drop the 'Planet'. ''I.e. "...the corsairs invaded Malta."'' When it is possible to be confused with the system please use "Planet Name".
 
−
 
 
−
Example Planet Page: [[Planet New London]]
 
−
 
 
−
=== Template ===
 
−
Please use the relevant information for the template fields
 
−
<pre>{{Base_Infobox
 
−
|name = New London
 
−
|image = Newlondon.jpg
 
−
|system = [[New London System]]
 
−
|sector = D6
 
−
|location = [[Bretonia]]
 
−
|owner = [[Bretonia Police Authority]]
 
−
|type = Terrestrial Planet
 
−
}}</pre>
 
−
 
 
−
===Images===
 
−
Images of Planets are to be uploaded in .jpg format. If you don't know how to do this, please ask someone to do it for you, or contact someone who can do it. [[User_talk:Blodo|Blodo]] and [[User_talk:Chovynz|Chovynz]] are two people who can. ''Image example specs:''
 
−
* [http://discoveryfl.com/wiki/index.php/Image:Newlondon.jpg Planet New London] (535 × 528 pixel, file size: 61 KB, MIME type: image/jpeg)
 
−
 
 
−
===Headings===
 
−
Here are some suggested headings for Planets.
 
−
<pre>==Additional information==
 
−
* '''Diameter:''' 12,753 Km
 
−
* '''Mass:''' 5.98 x 10e24 Kg
 
−
* '''Terrain:''' Terrestrial
 
−
* '''Temperature:''' -46°C to 43°C
 
−
* '''Escape Velocity:''' 11.27 Km/sec
 
  
−
==Imports==
+
<pre>[[Category:Liberty]]
−
*[[Oxygen]]
+
[[Category:Kusari]]
−
*[[Passengers]]
+
[[Category:Bretonia]]
 +
[[Category:Rheinland]]
 +
[[Category:Outcasts]]
 +
[[Category:Corsairs]]
 +
[[Category:Civilian]]
  
−
==Exports==
+
[[Category:Natural Phenomenon]]
−
*[[Boron]]
+
[[Category:Unnatural Phenomenon]]
−
*[[Consumer Goods]]
 
−
*[[Counterfeit Software]]
 
−
*[[Food Rations]]
 
−
*[[H-Fuel]]
 
  
−
== Ships for sale ==
+
[[Category:Commodities]]
−
*[[CSV]] - $186,670
+
[[Category:Weapons]]
−
*[[Startracker]] - $35,020
+
[[Category:Bases]]
−
*[[Patriot]] - $21,900</pre>
+
[[Category:Planets]]
 +
[[Category:Ships]]
 +
[[Category:Stations]]
 +
[[Category:Systems]]
  
−
=== Categories ===
+
[[Category:Factions]]
−
Categories should always be added. At the very minimum have these two. Please place these at the base of the Planet page.
+
[[Category:Player Factions]]</pre>
−
<pre>[[Category: Planets]]
 
−
[[Category: Bases]]</pre>
 
  
−
== Bases, Stations and Facilities ==
+
You can see a [[Special:Categories|full list of categories here]].
−
== Systems ==
+
==Guidelines for units of measurement==
−
== Factions ==
+
{| class="wikitable"
−
{{Faction_Infobox
+
! Unit of measurement || Definition(s) || align="right | Unit symbol(s)
−
|float = right
 
−
|width = 300px
 
−
|name = Gas Miners Guild
 
−
|image = Nn ss gas miner.jpg
 
−
|type = Organisation
 
−
|founding_date = 280-300 A.S.
 
−
|dissolution_date = ''still active''
 
−
|leader = Guild Chairman
 
−
|founder = ''unknown''
 
−
|primary_role = H-Fuel mining, refining and sales
 
−
|secondary_role = At least partial protection of Sigma systems
 
−
|base = [[Aomori Station]], [[Honshu system|Honshu]]
 
−
}}
 
−
 
 
−
=== Template ===
 
−
Please fill out the appropriate information fields with known data. Some information might need to be left alone or a Infocard modder asked for input. For now, do as you can. Example Faction Page: [[Gas Miners Guild]]
 
−
<pre>{{Faction_Infobox
 
−
|float = right
 
−
|width = 300px
 
−
|name = Gas Miners Guild
 
−
|image = Nn ss gas miner.jpg
 
−
|type = Organisation
 
−
|founding_date = 280-300 A.S.
 
−
|dissolution_date = ''still active''
 
−
|leader = Guild Chairman
 
−
|founder = ''unknown''
 
−
|primary_role = H-Fuel mining, refining and sales
 
−
|secondary_role = At least partial protection of Sigma systems
 
−
|base = [[Aomori Station]], [[Honshu system|Honshu]]
 
−
}}</pre>
 
−
 
 
−
=== Images ===
 
−
Images of Faction bases are to be uploaded in .jpg format. If you don't know how to do this, please ask someone to do it for you, or contact someone who can do it. [[User_talk:Blodo|Blodo]] and [[User_talk:Chovynz|Chovynz]] are two people who can. ''Image example specs:''
 
−
*[http://discoveryfl.com/wiki/index.php/Image:Nn_ss_gas_miner.jpg Gas_miner] (800 × 600 pixel, file size: 35 KB, MIME type: image/jpeg)
 
−
 
 
−
=== Headings ===
 
−
Here are some suggested headings for Factions.
 
−
*'''Synopsis''' - Gives a brief overview of the Faction.
 
−
*'''History''' - Describes in-depth history up to present day.
 
−
*'''Diplomacy''' - Lists allies and enemies.
 
−
*'''Known bases''' - Lists known bases and stations.
 
−
 
 
−
<pre>
 
−
== Synopsis ==
 
−
== History ==
 
−
== Diplomacy ==
 
−
== Known bases ==
 
−
</pre>
 
−
 
 
−
 
 
−
=== Diplomacy ===
 
−
Here is the template we use to list the allies and enemies. This is in [http://www.csstutorial.net/ CSS] format. Unless you [http://htmlhelp.com/reference/css/ know] what you are doing it is probably best left to other [http://www.w3schools.com/css/ CSS] users. Just copy and paste the whole lot and change the words as necessary. If you are feeling really adventurous you can try adding some extra enemies or allies and deleting a few. Each colored titled box starts at '''<nowiki>{| style="float:</nowiki>''' and ends at '''<nowiki>|}</nowiki>'''
 
−
 
 
−
<pre>{| style="float: left; margin-bottom: 10px; width: 25%; border: 1px solid #dddddd;" cellpadding="3"
 
−
|-
 
−
| style="text-align: center; font-size: larger; background: #339900; color: #ffffff;" |'''Allies'''
 
−
|-
 
−
| style="background: #f6f6f6;" | [[Kishiro Technologies]]
 
−
|-
 
−
| style="background: #f6f6f6;" | [[Zoners]]
 
−
|}
 
−
 
 
−
{| style="float: left; margin-bottom: 10px; margin-left: 1em; width: 25%; border: 1px solid #dddddd;" cellpadding="3"
 
 
|-
 
|-
−
| style="text-align: center; font-size: larger; background: #990000; color: #ffffff;" |'''Enemies'''
+
| Angles || Degrees    || align="right" | deg, °
 
|-
 
|-
−
| style="background: #f6f6f6;" | [[Outcasts]]
+
| Angular velocity || Degrees per second || align="right" | deg/s, °/s
 
|-
 
|-
−
| style="background: #f6f6f6;" | [[Corsairs]]
+
| Distance  || meters      || align="right" | m
 
|-
 
|-
−
| style="background: #f6f6f6;" | [[Hogosha]]
+
| Distance (geographical) || K, meters || align="right" | K, m
 
|-
 
|-
−
| style="background: #f6f6f6;" | [[Rheinland Federal Police]]
+
| Velocity || meters per second || align="right" | m/s
 
|-
 
|-
−
| style="background: #f6f6f6;" | [[Rheinland Military]]
+
| Energy (ship power cores) || Energy || align="right" | u
 
|-
 
|-
−
| style="background: #f6f6f6;" | [[Kruger Minerals]]
+
| Energy usage (equipment) || Energy per second || align="right" | u/s
 
|}
 
|}
−
<br clear="left">
+
<!--
−
</pre>
 
−
 
 
−
This results in:
 
−
{| style="float: left; margin-bottom: 10px; width: 25%; border: 1px solid #dddddd;" cellpadding="3"
 
−
|-
 
−
| style="text-align: center; font-size: larger; background: #339900; color: #ffffff;" |'''Allies'''
 
−
|-
 
−
| style="background: #f6f6f6;" | [[Kishiro Technologies]]
 
−
|-
 
−
| style="background: #f6f6f6;" | [[Zoners]]
 
−
|}
 
−
 
 
−
{| style="float: left; margin-bottom: 10px; margin-left: 1em; width: 25%; border: 1px solid #dddddd;" cellpadding="3"
 
−
|-
 
−
| style="text-align: center; font-size: larger; background: #990000; color: #ffffff;" |'''Enemies'''
 
−
|-
 
−
| style="background: #f6f6f6;" | [[Outcasts]]
 
−
|-
 
−
| style="background: #f6f6f6;" | [[Corsairs]]
 
−
|-
 
−
| style="background: #f6f6f6;" | [[Hogosha]]
 
−
|-
 
−
| style="background: #f6f6f6;" | [[Rheinland Federal Police]]
 
−
|-
 
−
| style="background: #f6f6f6;" | [[Rheinland Military]]
 
−
|-
 
−
| style="background: #f6f6f6;" | [[Kruger Minerals]]
 
−
|}
 
−
<br clear="left">
 
−
 
 
−
=== Categories ===
 
−
 
 
−
 
 
 
== To Add to this guide ==
 
== To Add to this guide ==
−
*Please refrain from editing this Guide
 
  
 
* Clear examples of wiki page name convention
 
* Clear examples of wiki page name convention
Line 351: Line 149:
 
* Use categories
 
* Use categories
  
−
* and over all simple quide lines like do we write wiki link names in text with caps.
+
* and over all simple guide lines like do we write wiki link names in text with caps.
 +
-->
 +
 
 +
=Centurion's Wiki Editing Style=
 +
 
 +
An overriding principle is that style and formatting choices should be consistent within a Wiki article, though not necessarily throughout the Wiki as a whole. Consistency within an article promotes clarity and cohesion. Writing should be clear and concise. Plain English works best: avoid jargon, and vague or unnecessarily complex wording.
 +
 
 +
==Titles==
 +
 
 +
This is a summary of the policy governing the titles of the articles within this Wiki/Encyclopedia. It applies to the titles of Wiki articles, not of external articles that are cited. The guidance here also applies to Section headings, immediately below. Where these guidelines conflict, the balance between them should be decided by consensus of other members, like [[User:Cshake]], [[User:Alex]], [[User:Blodo]] or even [[User:Centurion|me]].
 +
 
 +
* Article titles should conform to the rules of this Wiki, and they need to be in understandable English.
 +
 
 +
* Titles are '''NOT''' to be written in only capital letters.
 +
 
 +
* Titles should match the article contents, and should be neither too narrow nor too broad.
 +
 
 +
* Do not use '''a''', '''an''', or '''the''' as the first word (''Economy of the Second Empire'', '''not''' ''The economy of the Second Empire''), unless by convention it is an inseparable part of a name, like [[The Order]].
 +
 
 +
* Avoid special characters such as the slash (/), plus sign (+), braces ({ }), and square brackets ([ ]); use and instead of an ampersand (&), unless the ampersand is an accepted part of a name ([[Jack Cornelius Aubrey]] & [[Alexander Heneage Aubrey]]).
 +
Titles should be short.
 +
 
 +
* The final visible character of a title should not be a punctuation mark, unless the punctuation is part of a name (''Saint-Jardon-du-Ha! Ha!'').
 +
 
 +
==Text==
 +
 
 +
It is imperative that all the articles within this Wiki are in understandable US english. Every article within this Wiki needs to have a text-body inside, not only an image. Same goes for the 'market-list' articles aswell. This is a Wiki people, not a summary on what happens in the game. Everything should be written from the perspective of a narrator.
 +
 
 +
'''Small notes:'''
 +
 
 +
* Reduce consistency, since the text will no longer look uniform.
 +
{{Guide Navigation}}
 +
[[Category: Guides]]

Latest revision as of 17:25, 28 April 2015

Hello! Welcome to the Discovery Mod Wiki Editing Style Guide.

  • Note: Please refrain from editing this Guide. If you have style suggestions please discuss them on the Talk page or on the Discovery Forums

This Guide is intended as a reference for new and veteran wiki editors to acquaint themselves with the styles and formatting in use by the Discovery Mod Wiki. Following the directions and examples in this Guide will help the numerous people working on the Discovery Mod Wiki to maintain a consistent format and style across all of the wiki pages. Please be considerate of your co-editors and readers by attempting to keep consistency as much as possible. Consistency in style and format leads people to being able to find things quicker, to read faster, and to find the required information more efficiently.

If anything doesn't make sense or you don't understand something please give it some tries first and if you really don't get the idea, discuss it in the talk page. We are always aiming to improve this Guide. If you are really struggling to comprehend what is going on, or are looking for ground-level basic wiki editing help then please see the following: This wiki uses MediaWiki. For a more detailed overview about editing please consult the MediaWiki Handbook or Wikitext example page.

Google Search of this site.

The Basics

Below are some 'rules' that should be adhered to, for across-the-wiki style and formatting consistency. Information added to the wiki pages should be factual and not biased or subjective to any person's opinion. If you think a ship "sux" keep those comments to yourself. We are looking for information that is useful and true. If that "suxxy ship" turns a full 360 degrees in two hours, then please do write that up.

Remember that Wiki interprets a linebreak as an actual <br> or even a beginning of new paragraph. To avoid redundant whitespaces, you should not add linebreaks between the infobox template and the text content itself, otherwise the text looks nudged down. The descriptions goes directly below the templates.

Spelling

Spelling should be in the American international form. If you are unsure what the American international spelling is for a particular word, just leave the word as written for other editors to correct. Below are some examples of US / UK words.

  • Tire / Tyre
  • capitalized / capitalised
  • color / colour

Proper Nouns

A proper noun is the name that an item, place or person is known or called by. Proper nouns should have their first letter of every word of that noun capitalized. For example: "John Smith" is correct. "New york" is not correct.

Please use all words of a proper noun where required. e.g. James Powell, Ames Research Facility, Cadiz Base. There are exceptions to this rule and the Guide will go into further detail at the relevant places.

Page Titles

Page titles should be in First Letter Capitalized format. This excludes conjunctions (of, and,). To keep track of these conjunction titled pages, please list them here if found or created, stating the page title and type of page.

Page titles should be expanded. This means, please refrain from making pages titled "BPA", rather, expand the abbreviations so that "BPA" becomes "Bretonia Police Authority". This can be achieved by using piping links, or simply writing out the abbreviations.

In Text Links

In text links can use both lowercase words and uppercase. Use your discretion for which one is appropriate. Usually proper nouns will be first letter of every word capitalized.

Lowercase Links
Passengers are civilians who have money and courage for interstellar travels. As transports are favorite targets for pirate attacks, many passengers find it safer to travel to distant places in freelancing ships. You will find passengers willing to travel on almost all populated planets, price they will pay you generally depends on the length of the route.
Uppercase Links
This lush green world is the home of the Cambridge Research Institute - an institution devoted to pure scientific research. The idyllic green fields also find themselves home to the manor retreats of New London's aristocracy during the warmer months of the year. Bretonia's epidemic food shortages required the planetary regents to place scientists and farmers together to develop more bountiful crops, making Cambridge the primary food supplier for Bretonia. Now many Cambridge scientists sympathise with the Gaians echo-terrorist movement, prompting the formation of political groups such as The Green Front and igniting bitter debates among researchers on topics such as terraforming.
Piping Links

A piped link is when the highlighted words direct you to another discovery wiki page that does not use those words in the Title. The pipes should direct to the plural of items and subjects, unless it is a proper noun. See below for examples. The format is as follows [[Actual Piped Link|Words that are diplayed]]. 

*[[Bretonia Police Authority|BPA]]
*4 [[Class 4 Guns]]
*1 [[Class 7 Turrets|Class 7 Turret]] ****note the 's' missing when piping from a single weapon.

Results in:

Wiki lists

Wiki list sorting screws up when prices do not have the "$" in front of the price. Please add the dollar sign to all price lists and cost fields.

Images

Any pictures that you upload should be well lit and the viewer should able to easily and clearly see what the subject is. Dark pictures with the sun backlighting the ships, although artistic, are unacceptable for this wiki. Please use well lit, isometric viewpoints for ships; well lit, well framed pictures for planets and bases. The pictures and images should be uploaded in the .jpg format (or .png format if transparency is needed) and be of minimal filesize and reasonable pixel size (minimum of 800 x 600 is a good size to aim for).

If you are uploading an image of a named object (such as a planet, or a specific station), use the formal name of the object. If you are uploading an image of a generic 3D model (such as a ship model, or a turret model), use the name of the 3D model instead of the item. For example, if you are uploading a picture of the generic Bretonian Battleship, use the name of the ship model, but if you are uploading a picture of the specific Battleship Derby, use the formal station name instead. This provides separation between the item and the underlying model, thereby allowing multiple items to reference a single model, and allowing an item to change models without breaking the other linked references. 

Example Image Specs:

Note: Please use the lowercase ".jpg" extension, and not the UPPERCASE one.
Note2: There are some differences between filetypes of images used:

  • A jpg file does not have transparency. They are small in size and are suitable to be uploaded to this wiki directly. They are the thumbnails and medium pictures that you see when you go to a system/planet/etc... page.
  • A png file can have transparency and the filesize is usually a somewhat larger. These can now be uploaded to the Wiki directly. A good suggestion is to get good renders of the ships and upload the png files. Major Thanks and Kudos to Igiss for activating this!

Categories

Every page should have an appropriate category. Every category section should go at the base of the page - the very last thing on the page. See the specific subject for more information. Clicking on this "Categories" link will take you to the categories so that you can see what categories are available if you need more than basic ones. Try to fit them into an existing Category first, but if that isn't possible feel free to make more as needed.

For a category beginning with "The" e.g. "The Junkers Congress" you can key sort the category as following: 

[[Category:Player Factions|Junkers]]

This will put in the Player Factions categories, sorted under J, instead of T (default)
Most factions will be fine, automatically via the {{Player Faction}} template.
Manually adding this will override the automatic.

Copy and paste. In general, one or more of these categories below will suffice: 

[[Category:Liberty]]
[[Category:Kusari]]
[[Category:Bretonia]]
[[Category:Rheinland]]
[[Category:Outcasts]]
[[Category:Corsairs]]
[[Category:Civilian]]

[[Category:Natural Phenomenon]]
[[Category:Unnatural Phenomenon]]

[[Category:Commodities]]
[[Category:Weapons]]
[[Category:Bases]]
[[Category:Planets]]
[[Category:Ships]]
[[Category:Stations]]
[[Category:Systems]]

[[Category:Factions]]
[[Category:Player Factions]]

You can see a full list of categories here.

Guidelines for units of measurement

Unit of measurement Definition(s) Unit symbol(s)
Angles Degrees deg, °
Angular velocity Degrees per second deg/s, °/s
Distance meters m
Distance (geographical) K, meters K, m
Velocity meters per second m/s
Energy (ship power cores) Energy u
Energy usage (equipment) Energy per second u/s

Centurion's Wiki Editing Style

An overriding principle is that style and formatting choices should be consistent within a Wiki article, though not necessarily throughout the Wiki as a whole. Consistency within an article promotes clarity and cohesion. Writing should be clear and concise. Plain English works best: avoid jargon, and vague or unnecessarily complex wording.

Titles

This is a summary of the policy governing the titles of the articles within this Wiki/Encyclopedia. It applies to the titles of Wiki articles, not of external articles that are cited. The guidance here also applies to Section headings, immediately below. Where these guidelines conflict, the balance between them should be decided by consensus of other members, like User:Cshake, User:Alex, User:Blodo or even me.

  • Article titles should conform to the rules of this Wiki, and they need to be in understandable English.
  • Titles are NOT to be written in only capital letters.
  • Titles should match the article contents, and should be neither too narrow nor too broad.
  • Do not use a, an, or the as the first word (Economy of the Second Empire, not The economy of the Second Empire), unless by convention it is an inseparable part of a name, like The Order.
  • Avoid special characters such as the slash (/), plus sign (+), braces ({ }), and square brackets ([ ]); use and instead of an ampersand (&), unless the ampersand is an accepted part of a name (Jack Cornelius Aubrey & Alexander Heneage Aubrey).

Titles should be short.

  • The final visible character of a title should not be a punctuation mark, unless the punctuation is part of a name (Saint-Jardon-du-Ha! Ha!).

Text

It is imperative that all the articles within this Wiki are in understandable US english. Every article within this Wiki needs to have a text-body inside, not only an image. Same goes for the 'market-list' articles aswell. This is a Wiki people, not a summary on what happens in the game. Everything should be written from the perspective of a narrator.

Small notes:

  • Reduce consistency, since the text will no longer look uniform.
Rules and guidelines

What is a Wiki? • The Discovery Wiki • Editing rules • Style guide

Getting started

The Basics • Editing and creating pages • Wiki markup guide • Code generator guide • Uploading images

Common templates

Ships • Factions • Bases • Planets • Systems • Reviews • Version • Commodities

Other useful pages and tools

General wiki discussion • To-do list • Outdated pages • Wanted pages • Incomplete pages • Active editors • FLStat • Freelancer Companion

Retrieved from "https://discoverygc.com/wiki/index.php?title=Style_Guide&oldid=103693"