Policy:Manual of Style

From Gineipaedia, the Legend of Galactic Heroes wiki

(Redirected from Gineipaedia:Manual of Style)
Jump to: navigation, search

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

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

Article titles

'Real-life' individuals

The conventions below apply to articles about 'real-life' people, including voice actors and production staff:

Character naming conventions

The conventions below apply to articles about 'in-universe' people:

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 (Alliance 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.

Headings should follow the same rules as those listed for article titles above. Specifically, always use sentence case, do not include a, an, or the at the beginning, and always use nouns or noun phrases. Section headings additionally 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:

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             = {{rank|ge|admiral}}
| status           = Unknown ({{d|797|uc}})
| actor            = [[Murakoshi Ichirō]]
}}

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 'block' of information from that source.

As an example, see the passage below:

Previously an instructor of strategic theory at the Imperial Officer Academy on Odin, Staden's knowledge was considered impressive, but he relied on theory rather than practice; as a result, his students (one of whom was Wolfgang Mittermeyer) referred to him as 'Succumbed to Theory Staden'. (LOGH: 'Bloodshed in Space')

By the Battle of Astarte in 796 UC (487 IC / 3596 CE), Staden had attained the rank of vice admiral in the Imperial Navy. Just prior to the engagement with Alliance forces during this campaign, he was placed (along with four other admirals) under the command of Count Reinhard von Lohengramm. Fearing defeat at the hands of an enemy fleet twice as large as their own, Staden protested Lohengramm's plan; however, it succeeded, leading ultimately to an Imperial victory at Astarte. (LOGH: 'In the Eternal Night')

Notice that each individual piece of information does not need to be sourced — only when the source of information changes do we need to add a citation. In the case above, the first paragraph contains information entirely from one episode, and the second paragraph contains information entirely from another episode — therefore, each paragraph gets one citation.

Not all paragraphs require a citation, however. If two (or more) consecutive paragraphs contain information solely from one source, it is only necessary to add the citation at the end of the last paragraph containing information from that source. For instance, see the abbreviated passage below:

Admiral Staden was uncomfortable with the weight of such an immense task on his shoulders. ... Just then, a communication was intercepted by his men which purported to indicate that the enemy was awaiting the arrival of Lohengramm's main fleet, after which they would attack in overwhelming numbers.

Although Staden correctly deduced that this was a false communication, intended to lure them into a trap, his men were restless and pressed him to attack. ... The remaining 30% of the fleet withdrew to Rentenberg Fortress, where Staden himself was hospitalized — not for combat wounds, but for stress-related illness. (LOGH: 'Bloodshed in Space')

The exception to the above rule is when one of the paragraphs contains an additional citation that does not apply to the other one(s). For instance:

As a result of these reductions, security in the palace during this time was quite lax. ... Lansburg's own ancestors had built a hidden corridor leading from the western end of the North Garden to the foot of the statue of Sigismund I in the South Garden; the knowledge of this corridor had been passed down to Lansburg and its entrance was relatively easily accessible thanks to the lack of security. (LOGH: 'The Abduction of the Young Emperor')

Late on the night of 6 July 798 UC (489 IC / 3598 CE), the Imperial military police were alerted to the existence of a republican arms factory. Unbeknownst to them — but known to Lohengramm — this was a decoy set up by Phezzan. Whilst Ulrich Kessler and his MPs were dispatched to seize the factory, ... They later set up a government-in-exile on Heinessen. (LOGH: 'The Abduction of the Young Emperor', 'The Arrow Is Released')

The second paragraph contains information from the same source as the first, but it also contains information from an additional source. In order to prevent confusion, we therefore source each paragraph separately.

The code for producing citations is relatively straight-forward; in the case of single-episode OVAs / films, a short template like {{mciss}} or {{gw}} is used, whilst episodes are cited according to the series or story arc, as below:

See Citation templates for more documentation on using each of these templates.

In general, the following citation guide lines should be followed:

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:

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:

Incorrect:

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:

See also

Personal tools
Namespaces
Variants
Actions
Miscellany
Common
Tool box