Community Style Guidelines: Difference between revisions

Drastic chop-down since Cargo removed a lot of need for anyone to manually enter data.
(Drastic chop-down since Cargo removed a lot of need for anyone to manually enter data.)
 
Line 15: Line 15:


Where possible, a Belle/ship name should retain any accents or other markings of its native language.  For example, [[Algérie]] retains its accented letter.
Where possible, a Belle/ship name should retain any accents or other markings of its native language.  For example, [[Algérie]] retains its accented letter.
==Belle Detail Pages==
To keep large data-dumps off the main Belle pages, each Belle has (or will have) a "DetailsPage" that contains her stock configuration, information about vestures, and default armor statistics.  Such pages are very legible on mobile devices despite the large amount of data presented.  [[La_Motte-Picquet/DetailsPage|La Motte-Picquet]] has a fully-filled example of a details page. 
The Belle page template should take care of adding a "no details page" box to any newly-created Belle page, however if a page without such a notice is encountered, add the following code.  This adds a box with an automatically-generated link which invokes a pre-loaded template to build out the Belle's detail page.  The editor then only needs to fill all known fields.  Generally the below should be placed after the Gameplay Information section.
<pre>
{{NoBelleDetailsPage}}
</pre>
=== Empty Categories ===
Some Belles have nothing ''at all'' in a certain category--for instance some destroyers have no secondary battery, and most battleships do not equip torpedoes.  See [[Victory Belles Wikia:NoStockPage|this list]] of templates for use on Belle detail pages in these circumstances.
=== Multiple Items ===
When a Belle has more than one of an item (often the case with main battery guns), list the quantity ''before'' the item.  Follow the number with a space, an 'x,' another space, and finally the name.
:Example: 4 x 155mm/50 Mle 1920 Twin Turret Mle 1921
==Belle Name, Ship Name==


===Wiki Page===
===Wiki Page===
Line 59: Line 41:
There is no current (September 2021) consensus on capitalization of specific game terms.  For example, when discussing a Belle's main battery, should it be written "Battery I" or "battery I?"  Should nouns like "vestures" be capitalized?
There is no current (September 2021) consensus on capitalization of specific game terms.  For example, when discussing a Belle's main battery, should it be written "Battery I" or "battery I?"  Should nouns like "vestures" be capitalized?


When a two-word ship type (example: heavy cruiser) has its first word capitalized (such as being the first word in an Infobox) the second word should not be capitalized, which is in line with how Categories are named.
Two-word ship type categories (such as [[:Category:Light Cruiser|Light Cruiser]]) have both words capitalized.
 
==Empty Values==
When a value for a named line in an existing information box/table is not included, it will automatically populate with ''Unknown.''
 
Text for an empty value should follow these guidelines.
 
*If the line can be filled in the future, but the information that would populate it is not currently available, ''don't type anything into the template for that field!''  For example, a Belle with a voice whose actress has not been credited publicly at time of page creation would have her voice actress listed as ''Unknown''.  See the below template, which would be an ''Unknown'' Belle.<p>[[File:empty_template.JPG|300px]][[File:unknown_belle.JPG|300px]]</p>
*"None" if the line can be filled, but isn't.  For example, a Belle whose stock main battery contains an open but empty RDF slot should list RDF as "None," and an unvoiced Belle should list her voice actress as "None."
* "N/A" if the line applies to ''other'' uses of the table (as part of the template), but the line is not valid for the table in question.  For example, a Belle whose stock main battery configuration has a locked RDF slot would list this as "N/A."


== Equipment==
== Equipment==


Equipment names in Victory Belles can be very complex and lengthy, with a single digit denoting two different pieces of otherwise-similar equipment.  
Equipment names in Victory Belles can be very complex and lengthy, with a single digit denoting two different pieces of otherwise-similar equipment.  
===Wiki Page ===
No consensus yet exists (September 2021) as to how to name pages for equipment, and equipment pages aren't a priority for the wiki maintainers yet.


== Links==  
== Links==  
Line 120: Line 90:
:''Test Belle's historical ship displaced 25,000 tons.''  
:''Test Belle's historical ship displaced 25,000 tons.''  


===Trailing "k"===
If a value has a "k" (thousands) after it such as Max Range, do not enter it as the forms require actual numbers.  Convert the number.  So 21.6k becomes 21,600.
==Pages==
==Pages==
Pages should be derived from a template if at all possible.  This helps standardize the wiki's appearance.
All Belle main pages are template/Cargo driven and require very little human interaction[[Template:NewBellePage/doc|Documentation]] explains what options an editor might need to set.
 
Spaces should be replaced with underscores, like this page (Community_Style_Guide), rather than PascalCasingPageNames because they are easier to read in the URL.  Note that the opposite is true with templates, because having a ton of underscores in a template name is irritating when writing pagesTemplates are invisible to the user, page names aren't.
 
This game contains a large amount of data that needs to be presented in a unified, mobile-friendly format.  Tables allow corralling said data while maintaining a mobile-friendly experience.
 
Minimize image usage on main pages--just the infobox for the item, nothing more.  For example, if a Belle receives many Costumes, those should be documented on a "Costumes" page, not on her main page!


==Player/Reader References==
==Player/Reader References==
Line 138: Line 100:
==Speculative Belles==
==Speculative Belles==
Adding Belles whose presence has not been confirmed by either the developers or users finding said Belle in-game is not allowed.  Yes, we know a "shipgirl" game will probably ''eventually'' get Yamato, but she's not present right now so don't add her (or anyone else) based on guessing.
Adding Belles whose presence has not been confirmed by either the developers or users finding said Belle in-game is not allowed.  Yes, we know a "shipgirl" game will probably ''eventually'' get Yamato, but she's not present right now so don't add her (or anyone else) based on guessing.
== Table/Information Box==
===Table vs. Information Box===
The Infobox is a stock class on Fandom, and is restricted to loading on the right.  The Belle information box is the only (September 2021) current example.
Almost all the templates for tables on Belle "detail pages" are two-column setups with optional column headers and an optional title overall.  These work well on mobile and don't look horrible on desktop.
== Units of Measure==
When copying information directly from the game, use whatever unit is specified.  For example, if a US gun uses 6" but the Japanese equivalent uses 155mm, use 6" when talking about the US weapon and 155mm if the Japanese gun is being discussed.
If discussing historical ship displacements in trivia sections, use long tons, which is what Wikipedia itself uses for its ship entries.