Policy:Manual of Style
From Gineipaedia, the Legend of Galactic Heroes wiki
Gineipaedia's Manual of Style is a collection of guidelines for creating well-written articles. It consists mainly of rules and suggestions related to the formatting and structure of wiki pages, including grammar and spelling, and is intended to encourage the creation of consistent and easy to read articles.
Since this wiki is still relatively new and has few contributors, many of these guidelines are not yet set in stone. If you find you disagree with anything, please bring it up on this article's Talk page.
Contents[hide] |
Article structure/formatting
Sections under this heading refer to guidelines related to the 'major' aspects of constructing articles to fit into the wiki format.
Creating new articles
New articles should adhere to the following guidelines:
General article guidelines
The conventions below apply to all articles:
- For accessibility reasons, all article titles should use the Roman alphabet. Japanese names can be included within the article body.
- Accents and diacritics are allowed and encouraged where applicable in article titles (e.g., Annerose von Grünewald). Redirects from common alternate spellings (e.g., Annerose von Grunewald and Annerose von Gruenewald) should be created to the article with the proper name, however, to aid visitors with basic English keyboards.
- If at all possible, do not create separate articles for 'common' topics that aren't explicitly related to the story. For example, it is unnecessary to create an article about chairs or brandy, even though they appear in the anime, because they're common things that aren't relevant to the events of the story. There may be exceptions to this guideline occasionally, however, especially with 'classes' of things (like planets).
- All article names should be in sentence case (capitalising only the first word and proper names), except for articles about works of art (including episode and song titles). For example, use 'Into the Eternal Night (episode)' and 'Military ranks of the Free Planets Alliance', not 'Into the Eternal Night (Episode)' or 'Military Ranks Of The Free Planets Alliance'.
- Do not create articles that begin with words like 'the', 'a', or 'an', unless they're part of a title (like 'The Day Before Destiny (episode)') or proper name. For example, use 'Fourth Battle of Tiamat', not 'The Fourth Battle of Tiamat'.
- Heavy use of redirects and (if necessary) disambiguation pages is encouraged in general, in order to make articles easy to find. Related to the above, for example, redirects should be created from unique short names to their full names — e.g., 'Annerose' to 'Annerose von Grünewald'. However, if the short name is not unique (like 'Otto', which applies to several different characters), a disambiguation page should be created instead.
'Real-life' individuals
The conventions below apply to articles about 'real-life' people, including voice actors and production staff:
- Follow English naming conventions. Japanese names should be written with the given first, followed by a space and then the surname (e.g., Yoshiki Tanaka). (This is intended to make the site more friendly to visitors who are not acquainted with the Japanese styling.) As mentioned above, all article titles should use the Roman alphabet — however, redirects may be created from pages with the native spelling. Redirects may also be created from the Japanese name ordering.
- Do not create articles related to real-life people (or places) that were not involved or mentioned in the series in some way. If a character is named after a real-life historical figure, for example, a page should not be created for that figure. Instead, a note can be added in the character's 'Background information', with a link to an external source like Wikipedia.
Character naming conventions
The conventions below apply to articles about 'in-universe' people:
- Use the fullest and most common form of a character's most current name. For example, 'Reinhard von Lohengramm', rather than 'Reinhard von Musel' or 'Reinhard'. Unlike real-life individuals, names should not necessarily use English conventions. For instance, use 'Yang Wen-li', not the English-styled 'Wen-li Yang'. Other forms of the name should redirect to the full/common one, if applicable.
- Do not include ranks and titles (Marquis, Admiral, Commodore, &c.) in article names.
Introductions
Each article should begin with a short introduction (one or possibly two paragraphs), with the topic of the article in bold at or near the beginning of the first sentence. If the article is about a person, place, vehicle, or weapon that appears in the series, or if it is the name of an episode/film/novel, the name in bold should be followed by the original Japanese name (also in bold), as below:
- Staden (Japanese: シュターデン) was an admiral of the Galactic Empire. During the Imperial Civil War, he fought for the Lippstadt Alliance.
Japanese names can be obtained from labels or subtitles within the media itself, from credits, or, if necessary, from secondary material (production notes, interviews, Japanese Wikipedia, &c.).
The paragraph itself should be a brief summary of the major aspects of the article's topic. For example, an article about a person should include common identifying information like their allegiance (FPA or Empire), occupation (soldier, politician, &c.), rank, and important events the person was involved in (military engagements, crimes, political events, &c.). More detailed information about the topic should be split off into separate sections.
There is one exception to the introduction guideline: A separate introductory paragraph is not necessary when there is very little information about the topic. For example, the character Wagner appears for only a few minutes in one episode of the anime; as such, there is not enough information about him to fill up more than a few paragraphs. In this case, there is nothing to introduce, so what would have been the introductory paragraph can simply be merged into the main article.
Sections and headings
To create a new section in an article, surround the text with two or more equal signs (=). The wiki engine will automatically format the section heading with the appropriate amount of space above and below it, and will create a table of contents immediately before the first section if there are more than two or three in the article.
Sentence capitalisation should always be used in section headings. In other words, capitalise the first word and all proper nouns (names, events, &c.) in the heading, but leave everything else lower-case. Some examples of the correct and incorrect way to write headings:
Correct:
- Background information
- Early career
- Imperial Civil War
Incorrect:
- Background Information
- Early Career
- Imperial civil war
Section headings should be concise, accurate, and free of hyperlinks or citations (for readability reasons).
Lastly, new sections for 'in-universe' topics should only be created when readability demands it. As mentioned above, for example, there is no reason to create multiple sections for the character Wagner, because his appearance in the anime is so brief that it can be fully described in only two or three paragraphs.
However, 'real-life' and 'meta' topics should always be given separate sections, no matter how brief the main body of the article is. Examples of 'real-life' or 'meta' topics include the following:
- Apocrypha
- Appearances
- Background information
- External links
- References
- See also
Section and heading order
See Sections.
Infoboxes
Character pages should use the {{infobox character}} template, at the very top of the article, to display basic data (including affiliation, rank, relations, and voice actors) about each character.
An example of {{infobox character}} template usage can be found below:
{{infobox character
| image-top = Staaden.jpg
| caption-top = Admiral '''Staden''' ({{d|797|uc}})
| gender = Male
| affiliation = [[Galactic Empire]] ([[Lippstadt Alliance]])
| rank = [[Military ranks of the Galactic Empire#Admiral|Admiral]]
| status = Unknown ({{d|797|uc}})
| actor = [[Ichirō Murakoshi]]
}}
You can see the end result of this element on the page for Staden.
Additional infobox templates (for planets, vessels, &c.) will likely be created as the site grows.
Images
See Images.
Citations
Although Gineipaedia's citation guidelines are not as stringent as, for example, Wikipedia's, it is expected (if not required) that all 'in-universe' statements added to an article be sourced. This means that a reference to the episode/film/novel you obtained the information from should follow each individual 'block' of information from that source.
As a simple example of how this works, see the page on Staden. Note that he appeared in two episodes, one occurring later in time than the other, but the later episode also included information on his early background. The citations therefore are in the order of Second Episode, First Episode, Second Episode. Each time the source of information changes (after each 'block'), there is a citation to that episode.
When one 'block' of information includes references to several sources — for example, when a paragraph is composed of bits of data compiled from three separate episodes — it is not necessary to switch back and forth between citations over and over. Instead, the whole paragraph can be punctuated with a 'compound' citation, in the format you will see below.
Currently, there are templates in place to make citations. These templates are inspired or adapted from similar ones found on Memory Alpha, and work in much the same way. For more information, see their respective documentation pages:
- {{mciss}} — My Conquest Is the Sea of Stars
- {{logh}} — Legend of Galactic Heroes (OVA)
- {{gw}} — Golden Wings
- {{onw}} — Overture to a New War
- {{swv}} — The Silver-White Valley
- {{dmsn}} — Dreams of the Morning, Songs of the Night
- {{dis}} — Dishonour
When using as citations you'll almost always enclose these templates in parentheses.
Writing style
Sections under this heading refer to guidelines related to more 'minor' aspects of article creation, including grammar, spelling, date formats, link style, &c.
General
Please try to maintain an 'encyclopaedic' tone at all times when writing articles (normal conversational tone is fine on Talk pages, User pages, &c.). This means avoiding slang, expressions of emotion, and personal opinion. Additionally, please keep a 'matter of fact' perspective when writing episode synopses and the like — these should not read like fan fiction or novellas.
Spelling, grammar, and punctuation
The 'house style' of Gineipaedia is an international form of British English. This means that the following general rules apply:
- Use British spellings ('colour', 'defence', 'kilometre', 'capitalise', &c.).
- Prefer international terminology when possible (in other words, although UK English is preferred, do not use words that an international audience would be unfamiliar with).
- Use British punctuation — single-quotes are preferred to double-quotes, and commas and full stops / periods should usually go outside of quotes.
- Use English number formatting — this means using commas as digit separators ('20,000' for twenty-thousand, not '20.000' as in German) and dots for decimal separators ('1.29' for one-point-two-nine, not '1,29').
- Do not include a comma in numbers less than 10,000, unless quoting — use '9000', not '9,000'.
The exception to the above rules is when the series itself uses non-British spelling or terminology in proper nouns or in English phrases.
With all of the above said, it is understood that many users may not be familiar with UK spelling and grammar rules. It isn't strictly necessary to familiarise oneself with these — if you aren't sure what to do, just write the way you normally do. It's always better to have slightly inconsistently styled content than no content at all, and someone else will fix it later anyway.
Dashes
Related to the punctuation rules above, the preferred method of using dashes (—) is similar to the British style: an 'open' em dash (with a space on each side). This applies both to running text (dashes that occur in the middle of a normal sentence) and to 'offset' text (dashes that are used to separate a definition from a qualifier, like the sort used on the policy page.
Please do not use en dashes or hyphens in either of the above cases, if it can be helped. An em dash can be inserted on the Mac by pressing Option+Shift+- (minus key), or on Windows by holding Alt and pressing 0151 on the key pad.
En dashes should only be used for ranges of numbers and dates. When used with numbers, do not include a space (e.g., '100–500'); you may include one with dates (e.g., '5 May – 10 May').
Dates and units of measurement
All dates in 'in-universe' contexts should be given in U.C. or Space Era format where available. Other formats may be provided in addition to the U.C. date, but this should be limited to situations where a historical reference is important (for example, the date of the establishment of the Free Planets Alliance). (The U.C. date format was chosen because, although it is slightly less common in the series than R.C., it is the most consistent and longest-running system.)
Most dates on Gineipaedia should be written with the {{d}} template. This automatically converts the given date into all of the other applicable date formats, which should greatly help readers in deciphering the dates on the site. As an example, entering {{d|798|uc}} produces the following: 798 UC (489 IC / 3598 CE). See the documentation page linked above for more information on using this template.
When writing out full forms of both 'in-universe' and 'real-life' dates, use the format '<day of month> <full month>[ <full year>]'. Below are some examples of correct and incorrect date formats:
Correct:
- 10 December
- 21 May 1992
- 1 January 797 UC (488 IC / 3597 CE)
Incorrect:
- December 10
- 10th of December
- 21 May, 1992
- 01 January, 797 UC (488 IC / 3597 CE)
All other measurements should be given in the same format they were provided in in the series (usually centigrade, metres, grams, and the like) — they should not be converted to other units.
Hyperlinks
Hyperlinks are created using the format [[article-name|link-text]] or [external-url link-text] and are fairly straightforward. There are only three guidelines to keep in mind:
- Use the appropriate link text where necessary. Sometimes the 'flow' of an article demands that the text of the link be different from the name of the article you are linking to. Do not casually throw about links with the full name within articles. This applies particularly to internal pages with name spaces (for example, always use
[[:Category:FPA ships|FPA ships]]instead of[[:Category:FPA ships]]), as well as to links to external sites like Wikipedia. Never include full URLs (http://...) in article bodies.
- When linking to a character who is being referred to by rank or title (for example, "Marquis Lohengramm"), use only the character's name as the link text. In other words, use
Marquis [[Reinhard von Lohengramm|Lohengramm]], not[[Reinhard von Lohengramm|Marquis Lohengramm]].
- When linking to a word that is being used with a possessive (apostrophe-s) (or a contraction, although this will be rare), do not include the suffix in the link text. In other words, use
[[Siegfried Kircheis|Kircheis]]'s, not[[Siegfried Kircheis|Kircheis's]].
