Difference between revisions of "UniWiki:Manual of Style"
Line 100: | Line 100: | ||
* '''quotations, titles of works (books, films, etc.):''' Quote these as given in the source (but see {{section link||Typographic conformity}}, below); | * '''quotations, titles of works (books, films, etc.):''' Quote these as given in the source (but see {{section link||Typographic conformity}}, below); | ||
− | * '''proper names:''' Use the subject's own spelling e.g., {{dothis|joint project of the | + | * '''proper names:''' Use the subject's own spelling e.g., {{dothis|joint project of the Caldari State and the Jovian Directorate}}; |
* '''URLs:''' Changing the spelling of part of an external link's URL will almost always break the link. | * '''URLs:''' Changing the spelling of part of an external link's URL will almost always break the link. | ||
+ | |||
+ | = Capital letters = | ||
+ | {{main|UniWiki:Manual of Style/Capital letters}} | ||
+ | |||
+ | UniWiki article titles and section headings use sentence case, not title case; see [[Wikipedia:Wikipedia:Article titles|WP:Article titles]] and {{section link||Section headings}} (above). For capitalization of list items, see {{section link||Bulleted and numbered lists}}. Other points concerning capitalization are summarized below; full information can be found at [[UniWiki:Manual of Style/Capital letters]]. | ||
+ | |||
+ | === Do not use capitals for emphasis === | ||
+ | Use italics, not capitals, to denote emphasis. | ||
+ | |||
+ | : ''Incorrect'': {{notthis|It is not only a LITTLE learning that is dangerous}}. | ||
+ | : ''Correct'': {{dothis|It is not only a ''little'' learning that is dangerous}}. | ||
+ | |||
+ | === Capitalization of "The" === | ||
+ | {{main|UniWiki:Manual of Style/Capital letters#Capitalization of "The"}} | ||
+ | |||
+ | Generally, do not capitalize ''the'' in the middle of a sentence: {{dothis|an article about the Amarr Empire}} (not {{nothis|about The Amarr Empire}}). However there are some conventional exceptions, including most titles of artistic works: {{dothis|Damella Macaper wrote ''The Seven Events of the Apocalypse''}} (but {{dothis|Heideran VII wrote the ''Pax Amarria''}}), and {{dothis|warp gates in The Kalevala Expanse}}. | ||
+ | |||
+ | === Titles of people === | ||
+ | {{main|UniWiki:Manual of Style/Capital letters#Titles of people}} | ||
+ | |||
+ | * '''In generic use''', apply lower case to words such as ''president'', ''king'', and ''emperor'' ({{dothis|Souro Foiritan was a Gallentean president}}; {{dothis|Jamyl Sarum was an Amarrian empress}}; {{dothis|Three directors attended the conference}}). | ||
+ | * '''Directly juxtaposed with the person's name''', such words begin with a capital letter ({{dothis|Empress Catiz}}, not {{nothis|empress Catiz}}). Standard or commonly used names of an office are treated as proper names ({{dothis|Maleatu Shakor is Matari Sanmatar}}; {{dothis|Jamyl Sarum was Empress of the Amarrian Empire}}; {{dothis|Jacus Roden is President of the Gallente Federation}}). Royal styles are capitalized ({{dothis|Her Majesty}}; {{dothis|His Grace}}); exceptions may apply for particular offices. | ||
+ | * For the use of titles and honorifics in biographical articles, see {{section link|UniWiki:Manual of Style/Biographies|Honorific prefixes}}. | ||
+ | |||
+ | === Religions, deities, philosophies, doctrines === | ||
+ | {{main|UniWiki:Manual of Style/Capital letters#Religions, deities, philosophies, doctrines and their adherents}} | ||
+ | |||
+ | * '''Religions, sects, and churches''' and their followers (in noun or adjective form) start with a capital letter. Generally, "the" is not capitalized before such names ({{dothis|the Order of St. Tetrimon}}, not {{nothis|The Order of St. Tetrimon}}). | ||
+ | * '''Pronouns for figures of veneration or worship''' are not capitalized, even if capitalized in a religion's scriptures. | ||
+ | * '''Spiritual or religious events''' are capitalized only when referring to specific incidents or periods ({{dothis|the Reclaiming}} and {{dothis|the Moral Reform}}; but {{dothis|a series of battles}} and {{dothis|moral reforms}}). | ||
+ | |||
+ | === Calendar items === | ||
+ | {{main|UniWiki:Manual of Style/Capital letters#Calendar items}} | ||
+ | |||
+ | * '''Months, days of the week, and holidays''' start with a capital letter ({{dothis|June}}, {{dothis|Monday}}; {{dothis|the Fourth of July}} refers only to the US Independence Day — otherwise {{dothis|July 4}} or {{dothis|4 July}}). | ||
+ | * '''Seasons''' are in lower case ({{xt|her last summer}}; {{xt|the winter solstice}}; {{xt|spring fever}}), except in personifications or in proper names for periods or events ({{dothis|Summer of Rage}}; {{dothis|Winter 2016}}). | ||
+ | |||
+ | === Celestial bodies === | ||
+ | {{main|UniWiki:Manual of Style/Capital letters#Celestial bodies}} | ||
+ | :''See also: [[Wikipedia:Wikipedia:Naming conventions (astronomical objects)|Wikipedia:Naming conventions (astronomical objects)]]'' | ||
+ | |||
+ | * The words '''<nowiki />''sun'', ''earth'', and ''moon''<nowiki />''' do not take capitals in general use ({{dothis|The sun was peeking over the mountain top}}; {{dothis|The tribal people of Matar thought of the whole earth as their home}}). They are capitalized when the entity is personified ({{xt|Sol Invictus ("Unconquered Sun") was the Roman sun god}}) or when used as the name of a specific body in a scientific or astronomical context ({{dothis|The Moon orbits the Earth}}; but {{xt|Kileakum is a moon of Eclipticum}}). | ||
+ | * '''Names of planets, moons, asteroids, comets, stars, constellations, and galaxies''' are proper names, and therefore capitalized ({{dothis|The planet Zorast sometimes eclipses the star Amarr, as seen from the surface of Oris}}; {{}}; {{dothis|The Andromeda Galaxy is a spiral galaxy}}). The first letter of every word in such a name is capitalized ({{dothis|Old Man Star}} and not {{notthis|Old man star}}; {{dothis|New Eden}}, not {{notthis|New eden}}). | ||
+ | * Words such as '''<nowiki />''comet'' and ''galaxy''<nowiki />''' should be capitalized where they form part of an object's proper name ({{dothis|New Eden Cluster}}). | ||
+ | |||
+ | === Compass points === | ||
+ | {{main|UniWiki:Manual of Style/Capital letters#Compass points}} | ||
+ | |||
+ | Do not capitalize '''directions''' such as ''north'', nor their related forms ({{dothis|We took the northern road}}), except where they are parts of proper names (such as {{dothis|Great North Road}}, {{dothis|Great Western Drive}} or {{dothis|South Pole}}). | ||
+ | |||
+ | Capitalize '''names of regions''' if they have attained proper-name status, including informal conventional names ({{dothis|Southern California}}; {{dothis|the Western Desert}}), and derived terms for people (e.g., a ''Southerner'' as someone from the [[Wikipedia:Southern United States|Southern United States]]). Do not capitalize descriptive names for regions that have not attained the status of proper names, such as {{dothis|southern Poland}}. | ||
+ | |||
+ | Composite directions may or may not be hyphenated, depending on the [[#National varieties of English|variety of English adopted]] in the article. {{dothis|Southeast Asia}} and {{dothis|northwest}} are more common in American English; but {{dothis|South-East Asia}} and {{dothis|north-west}} in British English. In cases such as {{dothis|north–south dialogue}} and {{dothis|east–west orientation}}, use an en dash; see {{section link||En dashes: other uses}}, below. | ||
+ | |||
+ | === Institutions === | ||
+ | {{main|UniWiki:Manual of Style/Capital letters#Institutions}} | ||
+ | |||
+ | Names of particular institutions are proper names and require capitals, but generic words for institutions (''university'', ''college'', ''hospital'', ''high school'') do not. For example: {{dothis|The university offers programs in arts and sciences}}, but {{this|Hedion University offers ...}}. | ||
+ | |||
+ | The word ''the'' at the start of a title is usually uncapitalized, but follow the institution's own usage ({{dothis|a degree from the University of Caille}}; but {{dothis|researchers at The Leisure Group}}). | ||
=Notes= | =Notes= | ||
{{Reflist}} | {{Reflist}} |
Revision as of 05:31, 21 December 2016
Template:Work in Progress The UniWiki Manual of Style (abbreviated as UMoS or simply MoS) is the style manual for all UniWiki articles. This primary page of the guideline covers certain topics (e.g., punctuation) in detail and summarizes the key points of other topics. The detail pages, which are cross-referenced here and linked by this page's menu or listed at UniWiki:Manual of Style/Contents, provide specific guidance on those topics. If any contradiction arises, this page has precedence over all detail pages of the guideline and the Simplified Manual of Style.
Much of this manual has been adapted from Wikipedia's Manual of Style. While care has been taken to adapt as many relevant sections as possible, any topics not covered here can most likely be found there, and interested editors are encouraged to refer to both the UMoS and Wikipedia's MoS for the most comprehensive instruction.
Further, this page and any UniWiki pages linked here serve only as a style manual. For all other guidelines, such as categorization and editing, the UniWiki defers to those guidelines set forth by Wikipedia, both because it has set a standard of excellence that UniWiki seeks to emulate, and because to develop UniWiki-specific guidelines of a similar caliber would be an unrealistic goal, given the relatively small number of Wiki Curators.
In particular, the UniWiki can be considered to operate under the following guidelines used by Wikipedia:
- Behavioral guidelines
- Relevant section of the content guidelines
- Editing guidelines
- Naming conventions (where applicable)
Links to relevant sections of the above can be found throughout this manual.
The UniWiki Manual of Style presents the UniWiki's house style. The goal is to make using the UniWiki easier and more intuitive by promoting clarity and cohesion, while helping editors write articles with consistent and precise language, layout, and formatting. Plain English works best. Avoid ambiguity and vague or unnecessarily complex wording. Any new content added to the body of this page should directly address a style issue that has occurred in a significant number of instances.
Style and formatting should be consistent within an article, though not necessarily throughout the UniWiki. Where more than one style is acceptable, editors should not change an article from one of those styles to another without a good reason. Edit warring over optional styles is unacceptable. If discussion cannot determine which style to use in an article, defer to the style used by the first major contributor. If a style or similar debate becomes intractable, refer the issue to the Wiki Manager, the Director of Communications, or, as a last resort, the Director of Operations.
Discuss style issues on the UMoS talk page.
Article titles, headings, and sections
Article titles
When choosing an article's title, refer to the article titles policy. A title should be a recognizable name or description of the topic that is natural, sufficiently precise, concise, and consistent with the titles of related articles. If these criteria are in conflict, they should be balanced against one another.
For guidance on formatting titles, see the Article title format section of the policy. Note the following:
- Capitalize the title's initial letter (except in rare cases where the first letter is purposely lowercase), but otherwise follow sentence case, not title case; e.g., Funding of EVE University projects, not Funding of EVE University Projects. This does not apply where title case would be expected were the title to occur in ordinary prose. See Wikipedia:Naming conventions (capitalization) for more details.
- Do not use A, An, or The as the first word (Economy of the Caldari State, not The economy of the Caldari State), unless it is an inseparable part of a name (The Kalevala Expanse) or it is part of the title of a work (The Seven Events of the Apocalypse, The Scope).
- Titles should normally be nouns or noun phrases: Early life, not In early life.[1]
- The final character should not be a punctuation mark unless it is part of a name (Saint-Louis-du-Ha! Ha!) or an abbreviation (Inverness City F.C.), or a closing round bracket or quotation mark is required (Kronos (ship)).
The guidance contained elsewhere in the UMoS, particularly § Punctuation (below) applies to all parts of an article, including the title.
Section organization
- Main article: UniWiki:Manual of Style/Layout
An article should begin with an introductory lead section, which should not contain section headings (see UniWiki:Manual of Style/Lead section). The remainder of the article may be divided into sections, each with a section heading (see below) that can be nested in a hierarchy.
The lead should be a concise summary. Newly added information does not always qualify as important enough for the lead; it should be placed in the most appropriate section or sections (see Lead section).
If there are at least four section headings in the article, a navigable table of contents is generated automatically and displayed between the lead section and the first heading.
If the topic of a section is also covered in more detail in a dedicated article, show this by inserting {{main|Article name}}
directly under the section heading (see also Summary style).
As explained in more detail in UniWiki:Manual of Style/Layout § Standard appendices and footers, optional appendix and footer sections containing the following lists may appear after the body of the article in the following order:
- internal links to related UniWiki articles (section heading "See also");
- notes and references (section heading "Notes" or "References", or a separate section for each; see Citing sources);
- relevant books, articles, or other publications that have not been used as sources (section heading "Further reading");
- relevant websites that have not been used as sources and do not appear in the earlier appendices (added as part of "Further reading" or in a separate section headed "External links");
- internal links organized into navigational boxes (sometimes placed at the top in the form of sidebars);
- Categories.
Other article elements include disambiguation hatnotes (normally placed at the very top of the article) and infoboxes (usually placed before the lead section).
Section headings
- See also: UniWiki:Manual of Style/Accessibility#Headings and UniWiki:Manual of Style/Layout#Order of article elements
Use equal signs to mark the enclosed text as a section heading: =Title=
for a primary section; ==Title==
for the next level (a subsection); and so on to the lowest-level subsection, with =====Title=====
. Spaces between the equal signs and the heading text are optional, and will not affect the way the heading is displayed. The heading must be typed on a separate line. Include one blank line above the heading, and optionally one blank line below it, for readability in the edit window (but not two or more consecutive blank lines, which will add unnecessary visible space in the rendered page). There is no need to include a blank line between a heading and sub-heading.
The provisions in § Article titles generally apply to section headings as well (for example, headings are in sentence case, not title case). The following points apply specifically to section headings:
- Headings should not refer redundantly to the subject of the article, or to higher-level headings, unless doing so is shorter or clearer. (Early life is preferable to His early life when his refers to the subject of the article; headings can be assumed to be about the subject unless otherwise indicated.)
- Section and subsection headings should preferably be unique within a page; otherwise section links may lead to the wrong place, and automatic edit summaries can be ambiguous.
- Citations should not be placed within or on the same line as section and subsection headings.
- Avoid starting headings with numbers (other than years), because this can be confusing for readers with the "Auto-number headings" preference selected.
Before changing a section heading, consider whether you might be breaking existing links to that section.
When placing an invisible comment on the same line as the heading, do not do this outside the == ==
markup:[2]
==Evolutionary implications==<!--This comment disrupts editing--> |
<!--This comment disrupts display as well as editing-->==Evolutionary implications== |
Several of the above provisions are also applicable to table headers, including sentence case and redundancy. Table headers are often useful places for citations (e.g., the source of all the data in a column), and many do begin with or are numbers. Table headers do not automatically generate link anchors. (For more information see UniWiki:Manual of Style/Tables § Captions and headers.)
Retaining existing styles
For some elements of style, there is more than one format that is acceptable. In general, editors should not change articles between acceptable formats unless there is some substantial reason for the change (unrelated to the choice of style or the preference of the editor), and edit-warring between optional styles is unacceptable.
Examples of topic-specific versions of this guideline include:
- Varieties of English
- Date formats
- Era styles
- Variations of citation style (where applicable)
National varieties of English
- See also: UniWiki:Manual of Style/Spelling
The UniWiki prefers no major national variety of the language over any other. These varieties (e.g., American English, British English, etc.) differ in many ways, including vocabulary (elevator vs. lift), spelling (center vs. centre), date formatting ("April 13" vs. "13 April"), and occasionally grammar (see § Plurals, below). The following subsections describe how to determine the appropriate variety for an article. (The accepted style of punctuation is covered in § Punctuation, below.)
Consistency within articles
- See also Wikipedia:Consistency for additional policies and guidelines on consistency.
While Wikipedia does not favor any national variety of English, within a given article the conventions of one particular variety should be followed when possible. The exceptions are:
- quotations, titles of works (books, films, etc.): Quote these as given in the source (but see § Typographic conformity, below);
- proper names: Use the subject's own spelling e.g., joint project of the Caldari State and the Jovian Directorate;
- URLs: Changing the spelling of part of an external link's URL will almost always break the link.
Capital letters
- Main article: UniWiki:Manual of Style/Capital letters
UniWiki article titles and section headings use sentence case, not title case; see WP:Article titles and § Section headings (above). For capitalization of list items, see § Bulleted and numbered lists. Other points concerning capitalization are summarized below; full information can be found at UniWiki:Manual of Style/Capital letters.
Do not use capitals for emphasis
Use italics, not capitals, to denote emphasis.
- Incorrect: It is not only a LITTLE learning that is dangerous.
- Correct: It is not only a little learning that is dangerous.
Capitalization of "The"
Generally, do not capitalize the in the middle of a sentence: an article about the Amarr Empire (not Template:Nothis). However there are some conventional exceptions, including most titles of artistic works: Damella Macaper wrote The Seven Events of the Apocalypse (but Heideran VII wrote the Pax Amarria), and warp gates in The Kalevala Expanse.
Titles of people
- Main article: UniWiki:Manual of Style/Capital letters#Titles of people
- In generic use, apply lower case to words such as president, king, and emperor (Souro Foiritan was a Gallentean president; Jamyl Sarum was an Amarrian empress; Three directors attended the conference).
- Directly juxtaposed with the person's name, such words begin with a capital letter (Empress Catiz, not Template:Nothis). Standard or commonly used names of an office are treated as proper names (Maleatu Shakor is Matari Sanmatar; Jamyl Sarum was Empress of the Amarrian Empire; Jacus Roden is President of the Gallente Federation). Royal styles are capitalized (Her Majesty; His Grace); exceptions may apply for particular offices.
- For the use of titles and honorifics in biographical articles, see UniWiki:Manual of Style/Biographies § Honorific prefixes.
Religions, deities, philosophies, doctrines
- Main article: UniWiki:Manual of Style/Capital letters#Religions, deities, philosophies, doctrines and their adherents
- Religions, sects, and churches and their followers (in noun or adjective form) start with a capital letter. Generally, "the" is not capitalized before such names (the Order of St. Tetrimon, not Template:Nothis).
- Pronouns for figures of veneration or worship are not capitalized, even if capitalized in a religion's scriptures.
- Spiritual or religious events are capitalized only when referring to specific incidents or periods (the Reclaiming and the Moral Reform; but a series of battles and moral reforms).
Calendar items
- Main article: UniWiki:Manual of Style/Capital letters#Calendar items
- Months, days of the week, and holidays start with a capital letter (June, Monday; the Fourth of July refers only to the US Independence Day — otherwise July 4 or 4 July).
- Seasons are in lower case (her last summer; the winter solstice; spring fever), except in personifications or in proper names for periods or events (Summer of Rage; Winter 2016).
Celestial bodies
- Main article: UniWiki:Manual of Style/Capital letters#Celestial bodies
- See also: Wikipedia:Naming conventions (astronomical objects)
- The words sun, earth, and moon do not take capitals in general use (The sun was peeking over the mountain top; The tribal people of Matar thought of the whole earth as their home). They are capitalized when the entity is personified (Sol Invictus ("Unconquered Sun") was the Roman sun god) or when used as the name of a specific body in a scientific or astronomical context (The Moon orbits the Earth; but Kileakum is a moon of Eclipticum).
- Names of planets, moons, asteroids, comets, stars, constellations, and galaxies are proper names, and therefore capitalized (The planet Zorast sometimes eclipses the star Amarr, as seen from the surface of Oris; {{}}; The Andromeda Galaxy is a spiral galaxy). The first letter of every word in such a name is capitalized (Old Man Star and not Old man star; New Eden, not New eden).
- Words such as comet and galaxy should be capitalized where they form part of an object's proper name (New Eden Cluster).
Compass points
- Main article: UniWiki:Manual of Style/Capital letters#Compass points
Do not capitalize directions such as north, nor their related forms (We took the northern road), except where they are parts of proper names (such as Great North Road, Great Western Drive or South Pole).
Capitalize names of regions if they have attained proper-name status, including informal conventional names (Southern California; the Western Desert), and derived terms for people (e.g., a Southerner as someone from the Southern United States). Do not capitalize descriptive names for regions that have not attained the status of proper names, such as southern Poland.
Composite directions may or may not be hyphenated, depending on the variety of English adopted in the article. Southeast Asia and northwest are more common in American English; but South-East Asia and north-west in British English. In cases such as north–south dialogue and east–west orientation, use an en dash; see § En dashes: other uses, below.
Institutions
- Main article: UniWiki:Manual of Style/Capital letters#Institutions
Names of particular institutions are proper names and require capitals, but generic words for institutions (university, college, hospital, high school) do not. For example: The university offers programs in arts and sciences, but Template:This.
The word the at the start of a title is usually uncapitalized, but follow the institution's own usage (a degree from the University of Caille; but researchers at The Leisure Group).
Notes
- ^ Using phrases like In early life is acceptable for section headings.
- ^ Placing comments in this way disrupts the software's handling of section edits and their edit summaries, and even heading display. For example, if one clicks the edit section button, the section heading is not automatically added to the edit summary; or in some cases, the edit section button fails to appear at all.