Difference between revisions of "Help: Manual of Style"

From A Wiki of Ice and Fire
Jump to: navigation, search
(References)
(touch up (reshuffled text))
Line 2: Line 2:
  
 
==General rules==
 
==General rules==
 +
===Editing===
 
* Use the '''Preview''' button.
 
* Use the '''Preview''' button.
* Follow the format of existing pages as much as possible, you can always use the [[Sandbox|sandbox]] to test code.
+
* Follow the format of existing pages as much as possible. You can always use the [[Sandbox|sandbox]] to test codes.
 
* Add a descriptive summary when [[Help:Editing pages|editing a page]]. A "minor edit" is a fix to a typo or small change that does not affect the page, with no summary required.
 
* Add a descriptive summary when [[Help:Editing pages|editing a page]]. A "minor edit" is a fix to a typo or small change that does not affect the page, with no summary required.
  
 
===Discussion===
 
===Discussion===
* Sign your name at the end of your post by adding four tildes (<nowiki>~~~~</nowiki>).
+
* When uncertain about something, or in disagreement, discuss the issue on the article's talk page, or on the talk page of another user. The names of talk pages begin with <code><nowiki>Talk:</nowiki></code>. If no talk page exists, feel free to create one.
* Indent your post with a colon (:) when replying to a previous post.
+
* At the end of your post, sign it with your name and stamp it with a date and time by adding <nowiki>--~~~~</nowiki>.
 +
* When replying to a previous post, indent your post using a colon (:).
 +
* Use headings to sort the contents of the talk page into topics, if necessary.
  
===Dates and years===
+
===Spelling===
* Use [[Template:Date]] to link to the [[Years after Aegon's Conquest]]; <code><nowiki>{{Date|300}}</nowiki></code> links to [[300 AC]], <code><nowiki>{{Date|54}}</nowiki></code> links to [[54 AC]], etc. Links to the years present in [[Template:Years]] can also be made using regular wiki linking, e.g. <code><nowiki>[[54 AC]]</nowiki></code>. Links made to years before Aegon's Conquest can be made by typing <code><nowiki>[[Years before Aegon's Conquest|12 BC]]</nowiki></code>, which links to page [[Years before Aegon's Conquest]]. Writing <code><nowiki>[[Years before Aegon's Conquest#Year 12 Before the Conquest|12 BC]]</nowiki></code> ensures that the reader immediately jumps to the linked year on that page, provided it has its own subheader.
+
* Words should be spelled using the American English spelling.
  
 
===Punctuation===
 
===Punctuation===
Line 20: Line 23:
 
===Tense===
 
===Tense===
 
* Articles that cover events taking place before the novels should be written in past tense. However, events taking place in the book series should utilize present tense - even if the event is outdated by new books in the series.
 
* Articles that cover events taking place before the novels should be written in past tense. However, events taking place in the book series should utilize present tense - even if the event is outdated by new books in the series.
 
===Spelling===
 
*Words should be spelled using the American English spelling.
 
  
 
==Article layout==
 
==Article layout==
An article should begin with an introductory lead section which summarizes the subject's status when it is introduced in the story. It is followed by the rest of the article divided into sections, each with a section heading. If there are at least four section headings in the article, a navigable table of contents is generated automatically and displayed between the lead and the first heading. As a form of spoiler protection, plot details from the books should be presented in a chronological context through the "Recent Events" section.<ref>[[User:Ran]], [http://asoiaf.westeros.org/index.php/topic/34958-the-asoiaf-wiki-thread/page-9#entry2217375 forum post].</ref><ref>[[User:Ran]], [http://asoiaf.westeros.org/index.php/topic/45165-grammar/?p=2217445 forum post].</ref>
+
An article should begin with an introductory lead section which summarizes the subject's status when it is introduced in the story. It is followed by the rest of the article divided into sections, each with a section heading. If there are at least four section headings in the article, a navigable table of contents is generated automatically and displayed between the lead and the first heading. As a form of spoiler protection, plot details from the books should be presented in a chronological context through the "Recent Events" section.<ref>asoiaf.westeros.org: [http://asoiaf.westeros.org/index.php/topic/34958-the-asoiaf-wiki-thread/page-9#entry2217375 the ASOIAF wiki thread, post by Ran (August 27, 2010)]</ref><ref>asoiaf.westeros.org: [http://asoiaf.westeros.org/index.php/topic/45165-grammar/?p=2217445 Grammar, post by Ran (August 27, 2010)]</ref>
  
 
===Introduction===
 
===Introduction===
* The first occurrence of the [name of the] subject of the article at first mention must be bolded, preferably in the first sentence in the article.
+
* The first occurrence of the [name of the] subject of the article at first mention must be in '''bold''', preferably in the first sentence in the article. Frequently used nicknames can be written in bold as well.
* The lead section should be about one to three paragraphs long, dependent on the overall size of the article. Often, a single sentence suffices.
+
* The lead section should be about one to three paragraphs long, dependent on the overall size of the article. Often, a single short paragraph suffices.
 
* Ideally, the lead section should describe the status of the topic when it is first introduced by [[George R. R. Martin]]. Spoilers should not be included in the lead.
 
* Ideally, the lead section should describe the status of the topic when it is first introduced by [[George R. R. Martin]]. Spoilers should not be included in the lead.
  
 
===Body===
 
===Body===
* The physical appearance and personalities of characters can be described in an "Appearance and Character" section.
+
* The physical appearance and personalities of characters can be described in an "Appearance and Character" section, found at the top of the page. The section is re-titled to "Appearance" of to "Character" when only information about one of the two topics is available.
* General history (pre-''[[A Song of Ice and Fire]]'') should be described in the past tense in a "History" section. Some historical information, such as revelations in [[A Storm of Swords-Chapter 80|''A Storm of Swords''-Chapter 80]] or [[A Dance with Dragons-Chapter 13|''A Dance with Dragons''-Chapter 13]], is used by George R. R. Martin for drama instead of [[w:worldbuilding|worldbuilding]]. These major spoilers can instead be presented within the "Recent Events" section.
+
* General history (pre-''[[A Game of Thrones]]'') should be described in the past tense in a "History" section. Some historical information, such as revelations in [[A Storm of Swords-Chapter 80|''A Storm of Swords''-Chapter 80]] or [[A Dance with Dragons-Chapter 13|''A Dance with Dragons''-Chapter 13]], is used by George R. R. Martin for drama instead of [[w:worldbuilding|worldbuilding]]. These major spoilers can instead be presented within the "Recent Events" section.
* Plot from the novels of ''A Song of Ice and Fire'' should be presented chronologically and in the present tense in a "Recent Events" section. This should be subdivided by book (''A Game of Thrones'', ''A Clash of Kings'', ''A Storm of Swords'', ''A Feast for Crows'', ''A Dance with Dragons'', ''The Winds of Winter''). This allows the reader of an article to follow along according to how far in the books they have read without being spoiled by books they have yet to read. To prevent spoilers in the "History" section, "Recent Events" can also include a [[POV character]]'s revelations regarding major events which occurred before ''A Song of Ice and Fire''.
+
* Plot from the novels of ''A Song of Ice and Fire'' should be presented chronologically and in the present tense in a "Recent Events" section. This should be subdivided by book (''A Game of Thrones'', ''A Clash of Kings'', ''A Storm of Swords'', ''A Feast for Crows'', ''A Dance with Dragons'', ''The Winds of Winter''). This allows the reader of an article to follow along according to how far in the books they have read without being spoiled by books they have yet to read. To prevent spoilers in the "History" section, "Recent Events" can also include a [[POV character]]'s revelations regarding major events which occurred before the novels.
* For the "Genealogy" section, use [[Template:Familytree]].
+
* Sections titled "Quotes by [character]" and "Quotes about [character]" can be used to display 'spoken' quotes from the books. These
* "See also" is a section where the reader can be find related articles, or a gallery of images of the subject. If a related topic has already been linked to earlier in the article, it should generally not be included in the "See also" section.
+
* For the "Family" section, use [[Template:Familytree]].
 +
* "See also" is a section where the reader can be find related articles. If a related topic has already been linked to earlier in the article, it should generally not be included in the "See also" section.
  
 
===Links===
 
===Links===
Line 46: Line 47:
 
===References and notes===
 
===References and notes===
 
:{{Main|Help:Referencing_and_Canon{{!}}Referencing and Canon}}
 
:{{Main|Help:Referencing_and_Canon{{!}}Referencing and Canon}}
* For all articles, all references and sources are combined under the same subsection: "References". For this, simply type <code><nowiki>{{references}}</nowiki></code> at the bottom. Within the text, books can be cited using [[Template:Ref]], while other sources can be cited using the wiki coding <code><nowiki><Ref>text</ref></nowiki></code>
+
* For all text, references must be added.
* Cite only sources that are considered canon and reliable sources like [http://www.westeros.org/Citadel/Concordance/ Concordance]. Do not cite secondary sources unless there are valid conclusions drawn based on the previous.
+
* All references and sources are combined under the same subsection: "References". For this, simply type <code><nowiki>{{references}}</nowiki></code> at the bottom. Within the text, books can be cited using [[Template:Ref]], while other sources can be cited using the wiki coding <code><nowiki><Ref>text</ref></nowiki></code>
 +
* Cite only sources that are considered canon and reliable, like [[So Spake Martin]], [[Not a Blog]], etc.
 
* The section "Notes" can be used for explanatory information. The section is placed only when relevant, and should be located above the "References" section. To use notes on a page, type type <code><nowiki>{{Notes}}</nowiki></code> below the subheader. Within the text, a note can be placed using the reference wiki-code type <code><nowiki><ref group="N">Note.</ref></nowiki></code>.
 
* The section "Notes" can be used for explanatory information. The section is placed only when relevant, and should be located above the "References" section. To use notes on a page, type type <code><nowiki>{{Notes}}</nowiki></code> below the subheader. Within the text, a note can be placed using the reference wiki-code type <code><nowiki><ref group="N">Note.</ref></nowiki></code>.
  
==Sources and Copying==
+
===Copying===
Information for the content of pages comes from a lot of different sources. If the source of your contributions is something other than the books, please state your sources. <br>
+
You are allowed to copy text from [[w:Wikipedia|Wikipedia]]. However, original content is much preferred!
Copying from Wikipedia is okay; the content of Wikipedia is free but there are some rules, which are stated in our [[Help:Attribution|attribution help page]].  
+
 
In short you have to refer to the original article. This is a must!
+
Content of Wikipedia is released under the [[w::GNU_Free_Documentation_License|GNU Free Documentation License]]. When you copy text from Wikipedia, there are specific requirements that have to be followed. When part of your text is derived from Wikipedia, the [[Template:EnWP|EnWP template]] has to be placed at the bottom of the page, below the reference list.
* A good way to do this is using the template <nowiki>{{EnWP|<article from Wikipedia>}}</nowiki>
 
  
 
==Images==
 
==Images==
Line 60: Line 61:
 
* Always tag the images you are uploading with copyright information; for this you can use [[Template:copyright tags|copyright tags]] template.
 
* Always tag the images you are uploading with copyright information; for this you can use [[Template:copyright tags|copyright tags]] template.
 
* It is preferred that any primary image used (be it a photo or an artistic depiction) is one that does not deviate too much from how the character is described.<ref>[[User:Linda]], [http://asoiaf.westeros.org/index.php/topic/50947-for-some-reason-this-really-annoys-me/page__view__findpost__p__2681674 forum post].</ref>
 
* It is preferred that any primary image used (be it a photo or an artistic depiction) is one that does not deviate too much from how the character is described.<ref>[[User:Linda]], [http://asoiaf.westeros.org/index.php/topic/50947-for-some-reason-this-really-annoys-me/page__view__findpost__p__2681674 forum post].</ref>
 
 
* When [[Help:Images|uploading images]] to the Wiki, the rule of the thumb is to use JPEG for photographic images, and PNG for everything else.
 
* When [[Help:Images|uploading images]] to the Wiki, the rule of the thumb is to use JPEG for photographic images, and PNG for everything else.
* Superseded or replaced images should be kept to preserve Wiki historical record. Deletion, should only be used in case of copyright violation or technical reasons.
+
* Superseded or replaced images should be kept to preserve Wiki historical record. Deletion should only be used in case of copyright violation or technical reasons.
 
* You should always be watchful not to overwhelm an article with images by adding more just because you can.
 
* You should always be watchful not to overwhelm an article with images by adding more just because you can.
 +
* Permission to use an image should always be requested from the artist. Earlier given permission does not apply to new images.
 +
 +
===Categories===
 +
{{See also|Help:Categories}}
  
 +
* Each page and each image should be labeled with one or more categories, as appropriate. You can use the [[Help:Categories Overview|Categories Overview]] to find out more on how they are organized.
  
==Categories & Templates==
+
===Templates===
: {{See also|Help:Categories|Help:Templates}}
+
{{See also|Help:Templates}}
 +
* You can find a list of templates here: [[:Category:Templates]] and an overview of the most common ones here:[[Help:Templates Overview]]. Many of the templates used in the wiki automatically tag the pages with the appropriate category.
  
* Each page and each image should be labeled with a category or more if appropriate. You can use the [[Help:Categories Overview|Categories Overview]] to find out more on how they are organized.
+
====Dates and years====
* You can find a list of templates here: [[:Category:Templates]] and an overview of the most common ones here:[[Help:Templates Overview]]. Many of the Templates used in the wiki automatically tag the pages with the appropriate category.
+
* Use [[Template:Date]] to link to the [[Years after Aegon's Conquest]]; <code><nowiki>{{Date|300}}</nowiki></code> links to [[300 AC]], <code><nowiki>{{Date|54}}</nowiki></code> links to [[54 AC]], etc. Links to the years present in [[Template:Years]] can also be made using regular wiki linking, e.g. <code><nowiki>[[54 AC]]</nowiki></code>. Links made to years before Aegon's Conquest can be made by typing <code><nowiki>[[Years before Aegon's Conquest|12 BC]]</nowiki></code>, which links to page [[Years before Aegon's Conquest]]. Writing <code><nowiki>[[Years before Aegon's Conquest#Year 12 Before the Conquest|12 BC]]</nowiki></code> ensures that the reader immediately jumps to the linked year on that page, provided it has its own subheader.
  
 
==Notes==
 
==Notes==

Revision as of 22:02, 24 January 2019

This Manual of Style is a collection of rules of thumb and guidelines for giving our wiki a consistent look and feel. It is intended as a handy reference for editors. Feel free to suggest or discuss guidelines, over at the forum or on the discussion tab.

General rules

Editing

  • Use the Preview button.
  • Follow the format of existing pages as much as possible. You can always use the sandbox to test codes.
  • Add a descriptive summary when editing a page. A "minor edit" is a fix to a typo or small change that does not affect the page, with no summary required.

Discussion

  • When uncertain about something, or in disagreement, discuss the issue on the article's talk page, or on the talk page of another user. The names of talk pages begin with Talk:. If no talk page exists, feel free to create one.
  • At the end of your post, sign it with your name and stamp it with a date and time by adding --~~~~.
  • When replying to a previous post, indent your post using a colon (:).
  • Use headings to sort the contents of the talk page into topics, if necessary.

Spelling

  • Words should be spelled using the American English spelling.

Punctuation

  • For quotations, use "double quotes" and 'single quotes' for nesting quotations; thus "quotations 'within' quotations".
  • Write formally. Avoid using contractions such as don't, can't, won't, would've, or they'd.
  • Avoid using slashes to join words. Instead, spell it out.

Tense

  • Articles that cover events taking place before the novels should be written in past tense. However, events taking place in the book series should utilize present tense - even if the event is outdated by new books in the series.

Article layout

An article should begin with an introductory lead section which summarizes the subject's status when it is introduced in the story. It is followed by the rest of the article divided into sections, each with a section heading. If there are at least four section headings in the article, a navigable table of contents is generated automatically and displayed between the lead and the first heading. As a form of spoiler protection, plot details from the books should be presented in a chronological context through the "Recent Events" section.[1][2]

Introduction

  • The first occurrence of the [name of the] subject of the article at first mention must be in bold, preferably in the first sentence in the article. Frequently used nicknames can be written in bold as well.
  • The lead section should be about one to three paragraphs long, dependent on the overall size of the article. Often, a single short paragraph suffices.
  • Ideally, the lead section should describe the status of the topic when it is first introduced by George R. R. Martin. Spoilers should not be included in the lead.

Body

  • The physical appearance and personalities of characters can be described in an "Appearance and Character" section, found at the top of the page. The section is re-titled to "Appearance" of to "Character" when only information about one of the two topics is available.
  • General history (pre-A Game of Thrones) should be described in the past tense in a "History" section. Some historical information, such as revelations in A Storm of Swords-Chapter 80 or A Dance with Dragons-Chapter 13, is used by George R. R. Martin for drama instead of worldbuilding. These major spoilers can instead be presented within the "Recent Events" section.
  • Plot from the novels of A Song of Ice and Fire should be presented chronologically and in the present tense in a "Recent Events" section. This should be subdivided by book (A Game of Thrones, A Clash of Kings, A Storm of Swords, A Feast for Crows, A Dance with Dragons, The Winds of Winter). This allows the reader of an article to follow along according to how far in the books they have read without being spoiled by books they have yet to read. To prevent spoilers in the "History" section, "Recent Events" can also include a POV character's revelations regarding major events which occurred before the novels.
  • Sections titled "Quotes by [character]" and "Quotes about [character]" can be used to display 'spoken' quotes from the books. These
  • For the "Family" section, use Template:Familytree.
  • "See also" is a section where the reader can be find related articles. If a related topic has already been linked to earlier in the article, it should generally not be included in the "See also" section.

Links

Everything that appears in a narrative this wiki covers may be linked, such as dates, places, people, and events. However, do not over link; it is recommended that you limit the number of times you link the same topic in a single article. Generally, it is preferred that you link only the first instance of a topic in each section of an article. If you have made a link in captions or the infobox, it is a good idea to make the same link in the article.

Do not use external links in the body of an article. Articles can include an external links section at the end as further reading. The following sites can be linked: official sites that relate to the topic, articles about the subject of article on other encyclopedias, or vast resources that contain neutral and accurate information that has not been mentioned in the article.

References and notes

  • For all text, references must be added.
  • All references and sources are combined under the same subsection: "References". For this, simply type {{references}} at the bottom. Within the text, books can be cited using Template:Ref, while other sources can be cited using the wiki coding <Ref>text</ref>
  • Cite only sources that are considered canon and reliable, like So Spake Martin, Not a Blog, etc.
  • The section "Notes" can be used for explanatory information. The section is placed only when relevant, and should be located above the "References" section. To use notes on a page, type type {{Notes}} below the subheader. Within the text, a note can be placed using the reference wiki-code type <ref group="N">Note.</ref>.

Copying

You are allowed to copy text from Wikipedia. However, original content is much preferred!

Content of Wikipedia is released under the GNU Free Documentation License. When you copy text from Wikipedia, there are specific requirements that have to be followed. When part of your text is derived from Wikipedia, the EnWP template has to be placed at the bottom of the page, below the reference list.

Images

  • Uploaded images must be related to A Song of Ice and Fire and its derivative works, the one exception being if you want to upload an image for your userpage, of yourself or for a userbox.
  • Always tag the images you are uploading with copyright information; for this you can use copyright tags template.
  • It is preferred that any primary image used (be it a photo or an artistic depiction) is one that does not deviate too much from how the character is described.[3]
  • When uploading images to the Wiki, the rule of the thumb is to use JPEG for photographic images, and PNG for everything else.
  • Superseded or replaced images should be kept to preserve Wiki historical record. Deletion should only be used in case of copyright violation or technical reasons.
  • You should always be watchful not to overwhelm an article with images by adding more just because you can.
  • Permission to use an image should always be requested from the artist. Earlier given permission does not apply to new images.

Categories

  • Each page and each image should be labeled with one or more categories, as appropriate. You can use the Categories Overview to find out more on how they are organized.

Templates

  • You can find a list of templates here: Category:Templates and an overview of the most common ones here:Help:Templates Overview. Many of the templates used in the wiki automatically tag the pages with the appropriate category.

Dates and years

  • Use Template:Date to link to the Years after Aegon's Conquest; {{Date|300}} links to 300 AC, {{Date|54}} links to 54 AC, etc. Links to the years present in Template:Years can also be made using regular wiki linking, e.g. [[54 AC]]. Links made to years before Aegon's Conquest can be made by typing [[Years before Aegon's Conquest|12 BC]], which links to page Years before Aegon's Conquest. Writing [[Years before Aegon's Conquest#Year 12 Before the Conquest|12 BC]] ensures that the reader immediately jumps to the linked year on that page, provided it has its own subheader.

Notes