YPPedia:Style guide

Defer questions of style to Style and How-to directories. If you're new to the wiki way, take a look at Notes for New Users for some useful links.

Article Names
Everything should follow:
 * Wikipedia's naming conventions
 * Wikipedia's disambiguation page

Pirate articles need to follow YPPedia policies in regards to creation/content and article names should be in-game capitalization (First letter capitalized and no spaces) such that a person could /who.

File Names
Uploaded files should be named clearly and plainly. All images should have the appropriate image tag included in the file description. For images created by the YPP community, please follow the following naming conventions:
 * Avatar-Artistname-filename - used for images used as avatars on the YPP Forums.
 * Art-Artistname-filename - used for images that are uploaded as fan art or entries for artistic contests not including the portrait background contests. Artistname should be replaced with the forum or account name of the artist and filename is the original name of the file.
 * Building-Ocean-Buildingname-Islandname - used for building images. Islandname is only used if the building name appears more than once on the same ocean.
 * Crews-crewname - used for portrait images illustrating crew articles.
 * Event-eventname-filename - used for images needed for event articles.
 * Flags-flagname - used for portrait images illustrating flag articles.
 * GCPP-codename-filename - used for images illustrating Grand Crafting Puzzle Project entries.
 * Monthly_artistname_file_name - used for images that are uploaded as entries for the Portrait Background Contest. Artistname should be replaced with the pirate name of the artist and file_name is the original name of the file.
 * Pirates-piratename - used for portrait images illustrating pirate articles.
 * Puzzle-puzzlename-filename - used for puzzling images.
 * Tutorial-tutorialname-filename - used for images illustrating tutorials.

Categories
Link to the appropriate categories page at the bottom of an article. For example, insert at the bottom an article about a pirate from the Midnight Ocean.


 * Commodities are Category:Commodities (see the category page for subcategories)
 * Crews should use the Infobox crew template to add the appropriate category to the page.
 * Flags will be added to the proper categories using the Infobox flag template.
 * Buildings should use the Infobox building template to add page to the appropriate category.
 * Pirates should use the Oceans template to note the oceans on which they play.


 * Wikipedia's categorization policy.

Capitalization
When referring to a puzzle as a noun, it should be capitalized. Other forms (verbs, gerunds, etc.) should be lower-case. Hearts, spades, and poker should be lower-case. If the puzzle is the first word in a sentence, it should be capitalized. Examples:


 * He is navigating the ship.
 * She enjoys the Navigation puzzle.
 * They were playing hearts.

Pirate names should be capitalized as they are in-game. The first letter is capitalized and the rest are lower-case. Crew, flag, and shoppe names should be capitalized exactly as they are in-game, no matter how unusual.

The word "atlantean" should be lowercase when referring to the atlantean shade of blue found in clothing and trinkets as in, "The pirate won an atlantean spiky coral." It should be capitalized when used to describe the source of the item as in, "The pirate won an Atlantean trinket." To avoid ambiguity, both of those sentences could be rewritten as, "The pirate won an atlantean-colored spiky coral," and "The pirate won a trinket from Atlantis."

Sample Pages
Because many pages contain information about similar topics, editors have created sample pages of these that can be used as a basis, without having to remember so many templates and formatting styles. These pages are guides only, and need not be used exactly. A good page layout always fits the information it provides.
 * YPPedia:Sample pirate page - for articles about individual pirates
 * YPPedia:Sample crew page - for articles about crews
 * YPPedia:Sample flag page - for articles about flags
 * YPPedia:History guidelines - suggestions for writing game histories

Templates
How To for templates: Wikipedia:Help:Template

(for comments on individual templates go to their discussion pages)

Everyday Infoboxes
These infoboxes are used on everyday articles about flags, crews, buildings and pirates. Refer to the accompanying "Use" page for instructions on how to use them.
 * Infobox building - for buildings.


 * Infobox crew - for active crews.
 * Infobox crew(defunct) - for dormant or disbanded crews on all oceans.


 * Infobox flag - for active flags.
 * Infobox flag(defunct) - for dormant or disbanded flags on all oceans.


 * Infobox pirate - for pirate articles.
 * Oceans - also for pirate articles
 * User_portraits - for including portrait gallery links on user pages.
 * My trinkets - for displaying a collection of trinkets on a pirate's page
 * My pets - For displaying pets a pirate owns.

Main Page & YPPedia Namespace Pages
WARNING: These templates feed the main page of YPPedia and vandalism on these pages is NOT taken lightly.
 * Help wanted - general list of things to do
 * All Oceans events - events on all oceans
 * Current Forum events - events on the forums
 * Current Cerulean events - events on the Cerulean Ocean
 * Current Emerald events - events on the Emerald Ocean
 * Current Meridian events - events on the Meridian Ocean
 * Current Real-life gatherings - events and meetups in real life
 * Current Game Gardens events - events on Game Gardens
 * Current Cerulean blockades - current blockades on the Cerulean Ocean
 * Current Emerald blockades - current blockades on the Emerald Ocean
 * Current Ice blockades - current blockades on the Ice Ocean
 * Current Meridian blockades - current blockades on the Meridian Ocean

General

 * CobCriVir - for Cobalt/Crimson/Viridian disambiguation
 * CompactTOC - for a horizontal, rather than the default vertical, table of contents.
 * CompactTOC2 - for a horizontal table of contents (also contains anchors to see also and external links sections).


 * &#123;&#123;Disambig&#125;&#125; - notice for disambiguation pages
 * Fn - footnotes
 * Release - for release date links (see the comment inside the template for more information).
 * Release-beta - for Beta release date links (see the comment inside the template for more information).
 * Release-alpha - for Alpha release date links (see the comment inside the template for more information).
 * Technical issue - for technical issues
 * TOCright - to create a right-aligned table of contents (see example at Midnight blockade history).
 * wrongtitle - to indicate a title which cannot be properly replicated due to technical limitations

Comments

 * Cleanup - for articles that need to be cleaned up to a higher standard of quality.
 * Cleanupfor - for providing a more information on areas that need cleaning.
 * Disputed - for articles that contain factual inaccuracies or questionable statements with no references.
 * Dubious - this should be used in conjunction with Disputed; insert the template after the dubious statement. Voice your opinion on the article's talk page.
 * Lowres - for images whose resolution makes it unsuitable.
 * Indevelopment - for templates currently in development; a 'template in beta' message
 * Inuse - for articles currently undergoing a major edit by an editor; you can also use Inusefor or Inuseuntil as necessary.
 * NPOV - for articles (likely flag or island histories) where a neutral point of view may not be present.
 * Testing - for things being tested on Ice that haven't been implemented yet.
 * Third person - for articles that need to be rewritten in third person.

Article/Image Sources
For a complete list of image tags, please see YPPedia:Image tags.


 * Contestentry - Artist attribution notice for fan art images entered in contests.
 * Fanart - Artist attribution notice for fan art images.
 * Avatar - Artist and user attribution for avatars used on the YPP forums.

Static Infoboxes
These infoboxes are used for more static pages. The information contained in these infoboxes rarely changes, if ever.
 * Commodities - for non-endpoint commodities (includes spot for image)
 * Commodities 2 - for finished commodities (includes spot for image)
 * Construction - for costs to build, upgrade, and downgrade buildings
 * Forageables - for foraged goods
 * Infobox island - for islands
 * Mug - for mugs
 * Ship - for ship information
 * Sword - for swords
 * Bludgeon - for bludgeons

Blockades, Islands, Commods, Buildings

 * Blockade - for linking to blockade history
 * Paint 0 - for unpaintable bits
 * Paint 1 - for single color areas
 * Paint 2 - for areas with two regions
 * Paint 3 - for areas with three regions
 * Paint 4 - for areas with four regions
 * Storage - for shoppe holds
 * Under construction - for shoppes that are being constructed

Puzzles

 * Carpentry Templates: Carpentry_5x5, Carpentry_6x5, Carpentry_6x6, Carpentry_10x10
 * Shipwrightery templates: Shipwrightery1x3, Shipwrightery3x1, Shipwrightery2x2, Shipwrightery2x3, Shipwrightery3x2, Shipwrightery4x1, Shipwrightery3x3, Shipwrightery2x4

Charts

 * Chart - creating charts and maps

Inventory Navigational Templates

 * Clothing - navigates clothing objects
 * Furniture - navigates furniture objects
 * Ship-2 - navigates ship articles
 * Sword-type - navigates sword articles
 * Bludgeon-type - navigates bludgeon articles
 * Drinking-navigation - navigates around drinking articles
 * Craftingpuzzle - navigates crafting puzzle articles
 * Dutypuzzle - navigates duty puzzle articles
 * Carousingpuzzle - navigates carousing puzzle articles
 * Brigand-Kings - navigates the brigand kings

Deletion

 * Various assorted templates for marking pages for deletion can be found under deletion.

Language

 * Various templates for languages on user pages can be found at Help:Language.
 * The template for adding language templates to the Help:Language page is Languages (see instructions on talk page).
 * The template for adding language boxes like the one seen at Category:User es can be found at UsersSpeak (see instructions on talk page).

Stubs

 * buildingstub - For building articles that need fleshing out.
 * crewstub - For crew articles that need fleshing out.
 * flagstub - For flag articles that need fleshing out.
 * piratestub - For pirate articles that need fleshing out.
 * sectstub - For sections of articles that need fleshing out.
 * stub - For other articles that need fleshing out.

Warnings for talk pages
These templates should be used with the subst: keyword preceding the template name. This copies the text to the including page, rather than transcluding it.
 * Butchery Crew - For warning people to mark a crew page as defunct, rather than blanking (Works for flag pages as well)
 * Butchery Pirate - For warning people to mark a pirate page as defunct, rather than blanking.
 * Frequency - For cases of unusually frequent article editing, rather than previewing.
 * Test - For lightly warning people for vandalism.
 * Test2 - For a second vandalism warning.
 * Test3 - For a third vandalism warning.
 * Test4 - For a fourth and final vandalism warning, not to be taken lightly.
 * Test explain - Allows adding of extra explanation to the standard test template.
 * Trophy warning - For warning people for editing the trophy page without consensus being reached on the forums.