More actions
mNo edit summary |
Proton One (talk | contribs) |
||
| (22 intermediate revisions by 8 users not shown) | |||
| Line 1: | Line 1: | ||
{{UMoS guideline}} | {{UMoS guideline}} | ||
The '''UniWiki Manual of Style''' (abbreviated as '''UMoS''' or simply '''MoS''') is the [[Wikipedia:Style guide|style manual]] for all UniWiki articles. This primary page of the guideline covers certain topics (e.g., punctuation) in detail and | The '''UniWiki Manual of Style''' (abbreviated as '''UMoS''' or simply '''MoS''') is the [[Wikipedia:Style guide|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. See [[#Specific guidelines|Specific guidelines]] for additional information about specific topics. | ||
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. [[Wikipedia:Plain English|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. | 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. [[Wikipedia:Plain English|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 | Style and formatting should be consistent 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. 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 Department|Wiki Manager]]. | ||
Much of this manual has been adapted from Wikipedia's [[Wikipedia:Wikipedia:Manual of Style|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, see [[UniWiki:Welcome#UniWiki guidelines|UniWiki guidelines]]. | |||
= | ==Specific guidelines== | ||
== Article titles == | {{List subpages|caption = The detail pages linked below, provide guidance on specific topics. If any contradiction arises, [[UniWiki:Manual of Style|Manual of Style]] has precedence over all detail pages of the guideline.}} | ||
__TOC__ | |||
== Article titles, headings, and sections == | |||
=== Article titles === | |||
When choosing an article's title, refer to the [[Wikipedia:Wikipedia:Article titles|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. | When choosing an article's title, refer to the [[Wikipedia:Wikipedia:Article titles|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. | ||
| Line 34: | Line 25: | ||
* Do not use {{notthis|A}}, {{notthis|An}}, or {{notthis|The}} as the first word ({{dothis|Economy of the Caldari State}}, not {{notthis|The economy of the Caldari State}}), unless it is an inseparable part of a name ({{dothis|The Kalevala Expanse}}) or it is part of the title of a work (''{{dothis|The Seven Events of the Apocalypse}}'', ''{{dothis|The Scope}}''). | * Do not use {{notthis|A}}, {{notthis|An}}, or {{notthis|The}} as the first word ({{dothis|Economy of the Caldari State}}, not {{notthis|The economy of the Caldari State}}), unless it is an inseparable part of a name ({{dothis|The Kalevala Expanse}}) or it is part of the title of a work (''{{dothis|The Seven Events of the Apocalypse}}'', ''{{dothis|The Scope}}''). | ||
* Titles should normally be [[Wikipedia:Noun|nouns]] or [[Wikipedia:Noun phrase|noun phrases]]: {{dothis|Early life}}, not {{notthis|In early life}}.<ref>Using phrases like {{dothis|In early life}} is acceptable for section headings.</ref> | * Titles should normally be [[Wikipedia:Noun|nouns]] or [[Wikipedia:Noun phrase|noun phrases]]: {{dothis|Early life}}, not {{notthis|In early life}}.<ref>Using phrases like {{dothis|In early life}} is acceptable for section headings.</ref> | ||
* The final character should not be a punctuation mark unless it is part of a name ({{dothis|Saint-Louis-du-Ha! Ha!}}) or an abbreviation ({{dothis|Inverness City F.C.}}), or a closing round bracket or quotation mark is required ({{dothis|[[Kronos ( | * The final character should not be a punctuation mark unless it is part of a name ({{dothis|Saint-Louis-du-Ha! Ha!}}) or an abbreviation ({{dothis|Inverness City F.C.}}), or a closing round bracket or quotation mark is required ({{dothis|[[Kronos (expansion)]]}}). | ||
The guidance contained elsewhere in the UMoS, particularly {{section link||Punctuation}} (below) applies to all parts of an article, including the title. | The guidance contained elsewhere in the UMoS, particularly {{section link||Punctuation}} (below) applies to all parts of an article, including the title. | ||
== Section organization == | === Section organization === | ||
{{main|UniWiki:Manual of Style/Layout}} | {{main|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. | 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. | ||
| Line 58: | Line 48: | ||
* [[Wikipedia:Wikipedia:Categorization|Categories]]. | * [[Wikipedia:Wikipedia:Categorization|Categories]]. | ||
Other article elements include [[Wikipedia:Wikipedia:Hatnote|disambiguation hatnotes]] (normally placed at the very top of the article) and [[UniWiki:Manual of Style/ | Other article elements include [[Wikipedia:Wikipedia:Hatnote|disambiguation hatnotes]] (normally placed at the very top of the article) and [[UniWiki:Manual of Style/Infoboxes|infoboxes]] (usually placed before the lead section). | ||
== Section headings == | === Section headings === | ||
{{see also|UniWiki:Manual of Style/Accessibility#Headings|UniWiki:Manual of Style/Layout#Order of article elements}}, ''[[Wikipedia:Help:Section]]'' | {{see also|UniWiki:Manual of Style/Accessibility#Headings|UniWiki:Manual of Style/Layout#Order of article elements}}, ''[[Wikipedia:Help:Section]]'' | ||
Use equal signs to mark the enclosed text as a section heading: <code><nowiki>=Title=</nowiki></code> for a primary section; <code><nowiki>==Title==</nowiki></code> for the next level (a subsection); and so on to the lowest-level subsection, with <code><nowiki>=====Title=====</nowiki></code>. 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. | Use equal signs to mark the enclosed text as a section heading: <code><nowiki>==Title==</nowiki></code> for a primary section; <code><nowiki>===Title===</nowiki></code> for the next level (a subsection); and so on to the lowest-level subsection, with <code><nowiki>=====Title=====</nowiki></code>. A level 1 heading <code><nowiki>=Title=</nowiki></code> is possible, but these are usually reserved for the article title itself, which is automatically generated. 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 {{section link||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: | The provisions in {{section link||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: | ||
| Line 82: | Line 72: | ||
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 {{Section link|UniWiki:Manual of Style/Tables|Captions and headers}}.)'' | 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 {{Section link|UniWiki:Manual of Style/Tables|Captions and headers}}.)'' | ||
= Retaining existing styles = | == 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. | 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. | ||
| Line 91: | Line 81: | ||
* [[Wikipedia:Wikipedia:Citing sources#WP:CITEVAR|Variations of citation style]] (where applicable) | * [[Wikipedia:Wikipedia:Citing sources#WP:CITEVAR|Variations of citation style]] (where applicable) | ||
= National varieties of English = | === National varieties of English === | ||
{{see also|UniWiki:Manual of Style/Spelling}} | <!-- {{see also|UniWiki:Manual of Style/Spelling}} 2021-11-16 Spelling page does not exist anymore --> | ||
The UniWiki prefers no major national variety of the language over any other. These varieties (e.g., [[Wikipedia:American English|American English]], [[Wikipedia:British 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 {{section link||Plurals}}, below). The following subsections describe how to determine the appropriate variety for an article. (The accepted style of punctuation is covered in {{section link||Punctuation}}, below.) | The UniWiki prefers no major national variety of the language over any other. These varieties (e.g., [[Wikipedia:American English|American English]], [[Wikipedia:British 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 {{section link||Plurals}}, below). The following subsections describe how to determine the appropriate variety for an article. (The accepted style of punctuation is covered in {{section link||Punctuation}}, below.) | ||
=== Consistency within articles === | ==== Consistency within articles ==== | ||
{{hatnote|See also [[Wikipedia:Wikipedia:Consistency|Wikipedia:Consistency]] for additional policies and guidelines on consistency.}} | {{hatnote|See also [[Wikipedia:Wikipedia:Consistency|Wikipedia:Consistency]] for additional policies and guidelines on consistency.}} | ||
| Line 105: | Line 95: | ||
* '''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 = | == Capital letters == | ||
{{main|UniWiki:Manual of Style/Capital letters}} | {{main|UniWiki:Manual of Style/Capital letters}} | ||
| Line 128: | Line 118: | ||
* '''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}}). | * '''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 {{notthis|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. | * '''Directly juxtaposed with the person's name''', such words begin with a capital letter ({{dothis|Empress Catiz}}, not {{notthis|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. | ||
=== Religions, deities, philosophies, doctrines === | === Religions, deities, philosophies, doctrines === | ||
| Line 148: | Line 137: | ||
* 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}}). | * 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 | * '''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}}). | * 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}}). | ||
| Line 167: | Line 156: | ||
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}}). | 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}}). | ||
= Abbreviations = | == Abbreviations == | ||
{{main|UniWiki:Manual of Style/Abbreviations}} | {{main|UniWiki:Manual of Style/Abbreviations}} | ||
Abbreviations are shortened forms of words or phrases. In strict analysis, they are distinct from [[Wikipedia:Contraction (grammar)|contractions]], which use an [[Wikipedia:Apostrophe|apostrophe]] (e.g., ''won't'', see [[#Contractions|§ Contractions]]) and [[Wikipedia:Initialism|initialisms]] (including acronyms). An initialism is usually formed from some or all of the initial letters of words in a phrase. In some variations of English, an acronym is considered to be an initialism which is pronounced as a word (e.g., [[NATO]]), as distinct from the case where the initialism is said as a string of individual letters (e.g., ''US'', for [[Wikipedia:United States of America|United States]]). Herein, general statements regarding abbreviations are inclusive of acronyms, and the term ''acronym'' applies collectively to initialisms, without distinction that an acronym is said as a word. | Abbreviations are shortened forms of words or phrases. In strict analysis, they are distinct from [[Wikipedia:Contraction (grammar)|contractions]], which use an [[Wikipedia:Apostrophe|apostrophe]] (e.g., ''won't'', see [[#Contractions|§ Contractions]]) and [[Wikipedia:Initialism|initialisms]] (including acronyms). An initialism is usually formed from some or all of the initial letters of words in a phrase. In some variations of English, an acronym is considered to be an initialism which is pronounced as a word (e.g., [[Wikipedia:NATO|NATO]]), as distinct from the case where the initialism is said as a string of individual letters (e.g., ''US'', for [[Wikipedia:United States of America|United States]]). Herein, general statements regarding abbreviations are inclusive of acronyms, and the term ''acronym'' applies collectively to initialisms, without distinction that an acronym is said as a word. | ||
=== Write out both the full version and the abbreviation at first occurrence === | === Write out both the full version and the abbreviation at first occurrence === | ||
| Line 184: | Line 173: | ||
|- | |- | ||
| ''Correct (not a proper name)'': || {{dothis|He used a | | ''Correct (not a proper name)'': || {{dothis|He used a microwarpdrive (MWD)}} | ||
|- | |- | ||
| ''Incorrect'': || {{notthis|He used a MicroWarpDrive (MWD)}} | | ''Incorrect'': || {{notthis|He used a MicroWarpDrive (MWD)}} | ||
| Line 213: | Line 202: | ||
=== Ampersand === | === Ampersand === | ||
In normal text and headings, the word ''and'' should be used instead of the [[Wikipedia:Ampersand|ampersand]] (&); for example {{dothis|January 1 and 2}}, not {{notthis|January 1 & 2}}. Retain an ampersand when it is a legitimate part of a proper noun, such as in ''[[Up & Down (album)|Up & Down]]'' or [[AT&T]]. Ampersands may be used with consistency and discretion in places where space is extremely limited (i.e. tables and infoboxes). | In normal text and headings, the word ''and'' should be used instead of the [[Wikipedia:Ampersand|ampersand]] (&); for example {{dothis|January 1 and 2}}, not {{notthis|January 1 & 2}}. Retain an ampersand when it is a legitimate part of a proper noun, such as in ''[[Wikipedia:Up & Down (album)|Up & Down]]'' or [[Wikipedia:AT&T|AT&T]]. Ampersands may be used with consistency and discretion in places where space is extremely limited (i.e. tables and infoboxes). | ||
= Italics = | == Italics == | ||
:''Further information: [[UniWiki:Manual of Style/Text formatting]]'' | :''Further information: [[UniWiki:Manual of Style/Text formatting]]'' | ||
| Line 253: | Line 242: | ||
:''Correct'': {{dothis|<code><nowiki>The [[USS Adder (SS-3)|USS ''Adder'' (SS-3)]] was a submarine.</nowiki></code>}} | :''Correct'': {{dothis|<code><nowiki>The [[USS Adder (SS-3)|USS ''Adder'' (SS-3)]] was a submarine.</nowiki></code>}} | ||
= Controlling line breaks = | == Controlling line breaks == | ||
{{see also|Wikipedia:Line-break handling}} | {{see also|Wikipedia:Line-break handling}} | ||
| Line 280: | Line 269: | ||
Always insert hard/thin spaces symbolically (<code>&nbsp;</code>, <code>&thinsp;</code>), never by entering them as literal Unicode characters entered directly from the keyboard. | Always insert hard/thin spaces symbolically (<code>&nbsp;</code>, <code>&thinsp;</code>), never by entering them as literal Unicode characters entered directly from the keyboard. | ||
= Punctuation = | == Punctuation == | ||
== Apostrophes == | === Apostrophes === | ||
* Consistent use of the ''straight'' [[Wikipedia:Apostrophe|apostrophe]] ({{xt| <big>'</big> }}) is recommended, as opposed to the ''curly'' apostrophe ({{!xt| <big>‘ ’</big> }}). For details and reasons, see {{section link||Quotation marks}}, below. | * Consistent use of the ''straight'' [[Wikipedia:Apostrophe|apostrophe]] ({{xt| <big>'</big> }}) is recommended, as opposed to the ''curly'' apostrophe ({{!xt| <big>‘ ’</big> }}). For details and reasons, see {{section link||Quotation marks}}, below. | ||
| Line 300: | Line 289: | ||
:* Quotation marks ''not'' part of the article title should not be bolded (from [[Wikipedia:Jabberwocky|Jabberwocky]]: {{xt|"'''Jabberwocky'''" is a nonsense poem ...}}; from [[Wikipedia:Bill Clinton|Bill Clinton]]: {{xt|'''William Jefferson''' "'''Bill'''" '''Clinton''' is an American politician ...}}). | :* Quotation marks ''not'' part of the article title should not be bolded (from [[Wikipedia:Jabberwocky|Jabberwocky]]: {{xt|"'''Jabberwocky'''" is a nonsense poem ...}}; from [[Wikipedia:Bill Clinton|Bill Clinton]]: {{xt|'''William Jefferson''' "'''Bill'''" '''Clinton''' is an American politician ...}}). | ||
; Block quotations | ; Block quotations | ||
: Use quotation marks or block quotes (not both) to distinguish long quotations from other text. Multiparagraph quotations are always block-quoted. The quotations must be precise and exactly as in the source (except for certain | : Use quotation marks or block quotes (not both) to distinguish long quotations from other text. Multiparagraph quotations are always block-quoted. The quotations must be precise and exactly as in the source (except for certain ''allowable typographical changes''. The source should be cited clearly and precisely to enable readers to locate the text in question, and to quote it accurately themselves from Wikipedia. | ||
; Punctuation before quotations | ; Punctuation before quotations | ||
: The use of a comma before a quotation embedded within a sentence is optional, if a non-quoted but otherwise identical construction would work grammatically without the comma: | : The use of a comma before a quotation embedded within a sentence is optional, if a non-quoted but otherwise identical construction would work grammatically without the comma: | ||
| Line 325: | Line 314: | ||
: Do not use [[Wikipedia:grave accent|grave]] and [[Wikipedia:Acute accent|acute accents]] or backticks ({{!xt|<big>'''`'''</big>text<big>'''´'''</big>}}) as quotation marks (or as apostrophes). Likewise, avoid using the low-high ({{!xt|„ “}}) or [[Wikipedia:Guillemet|guillemet]] ({{!xt|« »}}) quotation marks that are common in [[Wikipedia:Non-English usage of quotation marks|several foreign languages]]. Editors may see {{!xt|′}} and {{!xt|″}} under the edit window as characters available for insertion; however, these are [[Wikipedia:prime (symbol)|prime]] and double-prime symbols, used to indicate subdivisions of the [[Wikipedia:degree (angle)|degree]], and should not be used to mark quotations. | : Do not use [[Wikipedia:grave accent|grave]] and [[Wikipedia:Acute accent|acute accents]] or backticks ({{!xt|<big>'''`'''</big>text<big>'''´'''</big>}}) as quotation marks (or as apostrophes). Likewise, avoid using the low-high ({{!xt|„ “}}) or [[Wikipedia:Guillemet|guillemet]] ({{!xt|« »}}) quotation marks that are common in [[Wikipedia:Non-English usage of quotation marks|several foreign languages]]. Editors may see {{!xt|′}} and {{!xt|″}} under the edit window as characters available for insertion; however, these are [[Wikipedia:prime (symbol)|prime]] and double-prime symbols, used to indicate subdivisions of the [[Wikipedia:degree (angle)|degree]], and should not be used to mark quotations. | ||
=== Reasons to prefer straight quotation marks and apostrophes === | ==== Reasons to prefer straight quotation marks and apostrophes ==== | ||
Typographical, or curly, quotation marks and apostrophes might be read more efficiently, and many think they look better. However, for practical reasons the straight versions are used on the UniWiki. | Typographical, or curly, quotation marks and apostrophes might be read more efficiently, and many think they look better. However, for practical reasons the straight versions are used on the UniWiki. | ||
| Line 381: | Line 370: | ||
: {{dothis|"Why", asked Darla, "are you sleeping?"}} | : {{dothis|"Why", asked Darla, "are you sleeping?"}} | ||
== Brackets and parentheses == | === Brackets and parentheses === | ||
The rules in this section apply to both round brackets {{xt|( )}}, often called [[Wikipedia:Bracket|parentheses]], and square brackets {{xt|[ ]}}. | The rules in this section apply to both round brackets {{xt|( )}}, often called [[Wikipedia:Bracket|parentheses]], and square brackets {{xt|[ ]}}. | ||
| Line 400: | Line 389: | ||
|- | |- | ||
| | | ''Incorrect'': || {{!xt|Nikifor Grigoriev (c. 1885–1919) (also known as Matviy Hryhoriyiv) was a Ukrainian insurgent leader.}} | ||
|- | |- | ||
| | | ''Correct'': || {{xt|Nikifor Grigoriev (c. 1885–1919, also known as Matviy Hryhoriyiv) was a Ukrainian insurgent leader.}} | ||
|- | |- | ||
| | | ''Correct'': || {{xt|Nikifor Grigoriev (c. 1885–1919) was a Ukrainian insurgent leader. He was also known as Matviy Hryhoriyiv.}} | ||
|} | |} | ||
| Line 413: | Line 402: | ||
* To make the grammar work. (Referring to someone's statement {{xt|"I hate to do laundry"}}, one could properly write {{xt|She "hate[s] to do laundry"}}.) | * To make the grammar work. (Referring to someone's statement {{xt|"I hate to do laundry"}}, one could properly write {{xt|She "hate[s] to do laundry"}}.) | ||
=== Sentences and brackets === | ==== Sentences and brackets ==== | ||
* If any sentence includes material that is enclosed in square or round brackets, it still must end—with a period, a question mark, or an exclamation mark— | * If any sentence includes material that is enclosed in square or round brackets, it still must end—with a period, a question mark, or an exclamation mark—''after'' those brackets. This principle applies no matter what punctuation is used within the brackets: | ||
:: {{xt|She refused all requests (except for basics such as food, medicine, etc.).}} | :: {{xt|She refused all requests (except for basics such as food, medicine, etc.).}} | ||
* However, if the entire sentence is within brackets, the closing punctuation falls within the brackets. (This sentence is an example.) This does not apply to matter that is added (or modified editorially) at the beginning of a sentence for clarity, which is usually in square brackets: | * However, if the entire sentence is within brackets, the closing punctuation falls within the brackets. (This sentence is an example.) This does not apply to matter that is added (or modified editorially) at the beginning of a sentence for clarity, which is usually in square brackets: | ||
| Line 429: | Line 418: | ||
:: {{xt|Clare demanded that he drive to the supermarket; she knew he hated driving.}} | :: {{xt|Clare demanded that he drive to the supermarket; she knew he hated driving.}} | ||
=== Brackets and linking === | ==== Brackets and linking ==== | ||
Brackets inside of links require special handling: | Brackets inside of links require special handling: | ||
| Line 444: | Line 433: | ||
If a URL itself contains square brackets, the wiki-text should use the [[Wikipedia:URL encoding|URL-encoded]] form <code><nowiki>http://</nowiki>example.site/foo.php?query={{xt|%5B}}xxx{{xt|%5D}}yyy</code>, rather than ...<code>query={{xt|[}}xxx{{xt|]}}yyy</code>. This will avoid truncation of the link after <code>xxx</code>. | If a URL itself contains square brackets, the wiki-text should use the [[Wikipedia:URL encoding|URL-encoded]] form <code><nowiki>http://</nowiki>example.site/foo.php?query={{xt|%5B}}xxx{{xt|%5D}}yyy</code>, rather than ...<code>query={{xt|[}}xxx{{xt|]}}yyy</code>. This will avoid truncation of the link after <code>xxx</code>. | ||
== Ellipses == | === Ellipses === | ||
Use an ''[[Wikipedia:Ellipsis|ellipsis]]'' (plural ''ellipses'') to indicate an omission of material from quoted text or some other omission, perhaps of the end of a sentence, often in a printed record of conversation. The ellipsis is represented by ''ellipsis points'': a set of three dots. | Use an ''[[Wikipedia:Ellipsis|ellipsis]]'' (plural ''ellipses'') to indicate an omission of material from quoted text or some other omission, perhaps of the end of a sentence, often in a printed record of conversation. The ellipsis is represented by ''ellipsis points'': a set of three dots. | ||
| Line 450: | Line 439: | ||
; Style | ; Style | ||
: Ellipsis points, or ellipses, have traditionally been implemented in three ways: | : Ellipsis points, or ellipses, have traditionally been implemented in three ways: | ||
:* '''Three unspaced periods''' ({{xt|...}}). This is the easiest way and gives a predictable appearance in HTML. | :* '''Three unspaced periods''' ({{xt|...}}). This is the easiest way and gives a predictable appearance in HTML. ''Recommended.'' | ||
:* '''Pre-composed ellipsis character''' ({{!xt|…}}) generated with the <code>&hellip;</code> character entity or as a literal "<code>…</code>". This is harder to input and edit and too small in some fonts. | :* '''Pre-composed ellipsis character''' ({{!xt|…}}) generated with the <code>&hellip;</code> character entity or as a literal "<code>…</code>". This is harder to input and edit and too small in some fonts. ''Not recommended.'' | ||
:* '''Three periods separated by spaces''' ({{!xt|. . .}}). This is an older style that is unnecessarily wide and requires non-breaking spaces to keep it from breaking at the end of a line. | :* '''Three periods separated by spaces''' ({{!xt|. . .}}). This is an older style that is unnecessarily wide and requires non-breaking spaces to keep it from breaking at the end of a line. ''Not recommended.'' | ||
; Function and implementation | ; Function and implementation | ||
| Line 469: | Line 458: | ||
; With square brackets | ; With square brackets | ||
: An ellipsis does not normally need square brackets around it, because its function is usually obvious—especially if the guidelines above are followed. Square brackets, however, may optionally be used for precision, to make it clear that the ellipsis is not itself quoted; this is usually only necessary if the quoted passage also uses three periods in it to indicate a pause or suspension. The ellipsis should follow exactly the principles given above but with square brackets inserted immediately before and after it ({{xt|Her long rant continued: "How do I feel? How do you | : An ellipsis does not normally need square brackets around it, because its function is usually obvious—especially if the guidelines above are followed. Square brackets, however, may optionally be used for precision, to make it clear that the ellipsis is not itself quoted; this is usually only necessary if the quoted passage also uses three periods in it to indicate a pause or suspension. The ellipsis should follow exactly the principles given above but with square brackets inserted immediately before and after it ({{xt|Her long rant continued: "How do I feel? How do you ''think'' I ... look, this has gone far enough! [...] I want to go home!"}}). | ||
== Commas == | === Commas === | ||
[[Wikipedia:Comma|Commas]] are the most frequently used punctuation marks and can be the most difficult to use well. Some important points regarding their use follow below and at {{section link||Semicolons}}. | [[Wikipedia:Comma|Commas]] are the most frequently used punctuation marks and can be the most difficult to use well. Some important points regarding their use follow below and at {{section link||Semicolons}}. | ||
| Line 480: | Line 469: | ||
|- | |- | ||
| | | ''Incorrect'': || {{!xt|John Smith, Janet Cooper's son is a well-known playwright.}} | ||
|- | |- | ||
| | | ''Correct'': || {{xt|John Smith, Janet Cooper's son, is a well-known playwright.}} | ||
|- | |- | ||
| | | ''Correct'': || {{xt|Janet Cooper's son John Smith is a well-known playwright.}} (when Janet has multiple sons) | ||
|- | |- | ||
| | | ''Correct'': || {{xt|Janet Cooper's son, John Smith, is a well-known playwright.}} (when Janet has only one son) | ||
|} | |} | ||
| Line 493: | Line 482: | ||
|- | |- | ||
| | | ''Incorrect'': || {{!xt|Burke and Wills, fed by locals (on beans, fish, and ''ngardu'') survived for a few months.}} | ||
|- | |- | ||
| | | ''Correct'': || {{xt|Burke and Wills, fed by locals (on beans, fish, and ''ngardu''), survived for a few months.}} | ||
|} | |} | ||
| Line 503: | Line 492: | ||
|- | |- | ||
| | | ''Awkward'': || {{!xt|Mozart was, along with the Haydns, both Joseph and Michael, and also Beethoven, one of Schubert's heroes.}} | ||
|- | |- | ||
| | | ''Much better'': || {{xt|Schubert's heroes included Mozart, Beethoven, and Joseph and Michael Haydn.}} | ||
|} | |} | ||
| Line 513: | Line 502: | ||
|- | |- | ||
| | | ''Incorrect'': || {{!xt|He set October 1, 2011 as the deadline for Chattanooga, Oklahoma to meet his demands.}} | ||
|- | |- | ||
| | | ''Correct'': || {{xt|He set October 1, 2011, as the deadline for Chattanooga, Oklahoma, to meet his demands.}} | ||
|} | |} | ||
| Line 523: | Line 512: | ||
|- | |- | ||
| | | ''Incorrect'': || {{!xt|She said, "Punctuation styles on Wikipedia change too often," and made other complaints.}} | ||
|- | |- | ||
| | | ''Correct'': || {{xt|She said, "Punctuation styles on Wikipedia change too often", and made other complaints.}} | ||
|} | |} | ||
* A comma may be included before a quotation embedded within a sentence (see {{section link||Quotation marks}} above). | * A comma may be included before a quotation embedded within a sentence (see {{section link||Quotation marks}} above). | ||
=== Serial commas === | ==== Serial commas ==== | ||
A [[Wikipedia:Serial comma|serial comma]] (also known as an ''Oxford comma'' or a ''Harvard comma'') is a comma used immediately before a conjunction (''and'' or ''or'', sometimes ''nor'') in a list of three or more items: the phrase {{xt|ham, chips, and eggs}} includes a serial comma, while {{xt|ham, chips and eggs}} omits it. Editors may use either convention so long as each article is internally consistent; however, there are times when the serial comma can create or remove confusion: | A [[Wikipedia:Serial comma|serial comma]] (also known as an ''Oxford comma'' or a ''Harvard comma'') is a comma used immediately before a conjunction (''and'' or ''or'', sometimes ''nor'') in a list of three or more items: the phrase {{xt|ham, chips, and eggs}} includes a serial comma, while {{xt|ham, chips and eggs}} omits it. Editors may use either convention so long as each article is internally consistent; however, there are times when the serial comma can create or remove confusion: | ||
| Line 553: | Line 542: | ||
**: Clearer: {{xt|The author thanked President Obama, Sinéad O'Connor, and her mother}}; or {{xt|The author thanked President Mary McAleese, Sinéad O'Connor, and her mother}}. | **: Clearer: {{xt|The author thanked President Obama, Sinéad O'Connor, and her mother}}; or {{xt|The author thanked President Mary McAleese, Sinéad O'Connor, and her mother}}. | ||
== Colons == | === Colons === | ||
A [[Wikipedia:Colon (punctuation)|colon]] ({{xt|:}}) informs the reader that what comes after it demonstrates, explains, or modifies what has come before, or is a list of items that has just been introduced. The items in such a list may be separated by commas; or, if they are more complex and perhaps themselves contain commas, the items should be separated by semicolons: | A [[Wikipedia:Colon (punctuation)|colon]] ({{xt|:}}) informs the reader that what comes after it demonstrates, explains, or modifies what has come before, or is a list of items that has just been introduced. The items in such a list may be separated by commas; or, if they are more complex and perhaps themselves contain commas, the items should be separated by semicolons: | ||
| Line 566: | Line 555: | ||
|- | |- | ||
| | | ''Correct'': || {{xt|He attempted it in two years: 1941 and 1943.}} | ||
|- | |- | ||
| | | ''Incorrect'': || {{!xt|The years he attempted it included: 1941 and 1943.}} | ||
|- | |- | ||
| | | ''Correct (special case)'': || {{xt|Spanish, Portuguese, French: these, with a few others, are the West Romance languages.}} | ||
|} | |} | ||
| Line 579: | Line 568: | ||
No sentence should contain more than one colon. There should never be a hyphen or a dash immediately following a colon. Only a single space follows a colon. | No sentence should contain more than one colon. There should never be a hyphen or a dash immediately following a colon. Only a single space follows a colon. | ||
== Semicolons == | === Semicolons === | ||
:''For usage in marking up description (definition) lists, see [[Wikipedia:Help:List#Description lists|Wikipedia:Description lists]]''. | :''For usage in marking up description (definition) lists, see [[Wikipedia:Help:List#Description lists|Wikipedia:Description lists]]''. | ||
| Line 587: | Line 576: | ||
|- | |- | ||
| | | ''Correct'': || {{xt|Though he had been here before, I did not recognize him.}} | ||
|- | |- | ||
| | | ''Incorrect'': || {{!xt|Though he had been here before; I did not recognize him.}} | ||
|} | |} | ||
| Line 597: | Line 586: | ||
|- | |- | ||
| | | ''Correct'': || {{xt|Oranges are an acid fruit; bananas are classified as alkaline.}} | ||
|- | |- | ||
| | | ''Incorrect'': || {{!xt|Oranges are an acid fruit, bananas are classified as alkaline.}} | ||
|} | |} | ||
| Line 607: | Line 596: | ||
|- | |- | ||
| | | ''Accepted'': || {{xt|"Life is short, art is long."}} (citing a brief [[Wikipedia:Aphorism|aphorism]]; see ''[[Wikipedia:Ars longa, vita brevis|Ars longa, vita brevis]]'') | ||
|- | |- | ||
| | | ''Accepted'': || {{xt|"I have studied it, you have not."}} (reporting brisk conversation, like this reply of [[Wikipedia:Isaac Newton|Newton]]'s) | ||
|} | |} | ||
| Line 617: | Line 606: | ||
|- | |- | ||
| | | ''Unwieldy'': || {{!xt|Oranges are an acid fruit; bananas are classified as alkaline; pears are close to neutral; these distinctions are rarely discussed.}} | ||
|- | |- | ||
| | | ''One better way'': || {{xt|Oranges are an acid fruit, bananas are alkaline, and pears are close to neutral; these distinctions are rarely discussed.}} | ||
|} | |} | ||
| Line 627: | Line 616: | ||
|- | |- | ||
| | | ''Confusing'': || {{!xt|Sales offices are located in Boston, Massachusetts, San Francisco, California, Singapore, and Millbank, London, England.}} | ||
|- | |- | ||
| | | ''Clear'': || {{xt|Sales offices are located in Boston, Massachusetts; San Francisco, California; Singapore; and Millbank, London, England.}} | ||
|} | |} | ||
As seen in the examples above, a semicolon does not automatically require the word that follows it to be capitalized. | As seen in the examples above, a semicolon does not automatically require the word that follows it to be capitalized. | ||
=== Semicolon before "however" === | ==== Semicolon before "however" ==== | ||
The meaning of a sentence containing a trailing clause that starts with the word "however" depends on the punctuation preceding that word. A common error is to use the wrong punctuation, thereby changing the meaning to one not intended. | The meaning of a sentence containing a trailing clause that starts with the word "however" depends on the punctuation preceding that word. A common error is to use the wrong punctuation, thereby changing the meaning to one not intended. | ||
| Line 645: | Line 634: | ||
| || {{xt|It was obvious they could not convert these people; however, they tried.}} | | || {{xt|It was obvious they could not convert these people; however, they tried.}} | ||
|- | |- | ||
| | | ''Meaning'': || {{xt|It was obvious they could not convert these people. Nevertheless, they tried.}} | ||
|} | |} | ||
| Line 655: | Line 644: | ||
| || {{xt|It was obvious they could not convert these people, however they tried.}} | | || {{xt|It was obvious they could not convert these people, however they tried.}} | ||
|- | |- | ||
| | | ''Meaning'': || {{xt|It was obvious they could not convert these people, regardless of how they tried.}} | ||
|} | |} | ||
| Line 665: | Line 654: | ||
| || {{xt|However they tried, it was obvious they could not convert these people.}} | | || {{xt|However they tried, it was obvious they could not convert these people.}} | ||
|- | |- | ||
| | | ''Meaning'': || {{xt|Regardless of how hard they tried, it was obvious they could not convert these people.}} | ||
|} | |} | ||
| Line 677: | Line 666: | ||
| || {{xt|He did not know, however, that the venue had been changed at the last minute.}} | | || {{xt|He did not know, however, that the venue had been changed at the last minute.}} | ||
|- | |- | ||
| | | ''Meaning'': || {{xt|However, he did not know that the venue had been changed at the last minute.}} | ||
|} | |} | ||
== Hyphens == | === Hyphens === | ||
[[Wikipedia:Hyphen|Hyphens]] ({{xt|-}}) indicate conjunction. There are three main uses: | [[Wikipedia:Hyphen|Hyphens]] ({{xt|-}}) indicate conjunction. There are three main uses: | ||
| Line 691: | Line 680: | ||
#* Hyphens can help with ease of reading ({{xt|face-to-face discussion}}, {{xt|hard-boiled egg}}); where non-experts are part of the readership, a hyphen is particularly useful in long noun phrases, such as those in Wikipedia's scientific articles: {{xt|gas-phase reaction dynamics}}. However, hyphens are never inserted into proper names in compounds ({{xt|Middle Eastern cuisine}}, not {{!xt|Middle-Eastern cuisine}}). | #* Hyphens can help with ease of reading ({{xt|face-to-face discussion}}, {{xt|hard-boiled egg}}); where non-experts are part of the readership, a hyphen is particularly useful in long noun phrases, such as those in Wikipedia's scientific articles: {{xt|gas-phase reaction dynamics}}. However, hyphens are never inserted into proper names in compounds ({{xt|Middle Eastern cuisine}}, not {{!xt|Middle-Eastern cuisine}}). | ||
#* A hyphen can help to disambiguate ({{xt|little-celebrated paintings}} is not a reference to little paintings; {{xt|a government-monitoring program}} is a program that monitors the government, whereas {{xt|a government monitoring program}} is a government program that monitors something else). | #* A hyphen can help to disambiguate ({{xt|little-celebrated paintings}} is not a reference to little paintings; {{xt|a government-monitoring program}} is a program that monitors the government, whereas {{xt|a government monitoring program}} is a government program that monitors something else). | ||
#* Many compounds that are hyphenated when used | #* Many compounds that are hyphenated when used ''[[Wikipedia:Attributive adjective|attributively]]'' (adjectives before the nouns they qualify: {{xt|a light-blue handbag}}, {{xt|a 34-year-old woman}}) or ''[[Wikipedia:Substantive|substantively]]'' (as a noun: {{xt|she is a 34-year-old}}), are usually ''not'' hyphenated when used ''[[Wikipedia:Predicative expression|predicatively]]'' (descriptive phrase separated from the noun: {{xt|the handbag was light blue}}, {{xt|the woman is 34 years old}}). Where there would otherwise be a loss of clarity, a hyphen may optionally be used in the predicative form as well ({{xt|hand-fed turkeys}}, {{xt|the turkeys were hand-fed}}). Awkward attributive hyphenation can sometimes be avoided with a simple rewording: {{xt|Hawaiian-native culture}} → {{xt|native Hawaiian culture}}. | ||
#* Avoid using a hyphen after a standard ''-ly'' adverb ({{xt|a newly available home}}, {{xt|a wholly owned subsidiary}}) unless part of a larger compound ({{xt|a slowly-but-surely strategy}}). In rare cases, a hyphen can be added to improve clarity if a rewritten alternative is awkward. Rewording is preferable: {{!xt|The idea was clearly stated enough}} can be disambiguated as {{xt|The idea clearly was stated often enough}} or {{xt|The idea was stated with enough clarity}}. | #* Avoid using a hyphen after a standard ''-ly'' adverb ({{xt|a newly available home}}, {{xt|a wholly owned subsidiary}}) unless part of a larger compound ({{xt|a slowly-but-surely strategy}}). In rare cases, a hyphen can be added to improve clarity if a rewritten alternative is awkward. Rewording is preferable: {{!xt|The idea was clearly stated enough}} can be disambiguated as {{xt|The idea clearly was stated often enough}} or {{xt|The idea was stated with enough clarity}}. | ||
#* A few words ending in ''-ly'' function as both adjectives and adverbs ({{xt|a kindly-looking teacher}}; {{xt|a kindly provided facility}}). Some such dual-purpose words (like {{xt|early}}, {{xt|only}}, {{xt|northerly}}) are not standard ''-ly'' adverbs, because they are not formed by addition of ''-ly'' to an independent current-English adjective. These need careful treatment: {{xt|Early flowering plants appeared around 130 million years ago}}, but {{xt|Early-flowering plants risk damage from winter frosts}}; {{xt|only child actors}} (no adult actors) but {{xt|only-child actors}} (actors without siblings). | #* A few words ending in ''-ly'' function as both adjectives and adverbs ({{xt|a kindly-looking teacher}}; {{xt|a kindly provided facility}}). Some such dual-purpose words (like {{xt|early}}, {{xt|only}}, {{xt|northerly}}) are not standard ''-ly'' adverbs, because they are not formed by addition of ''-ly'' to an independent current-English adjective. These need careful treatment: {{xt|Early flowering plants appeared around 130 million years ago}}, but {{xt|Early-flowering plants risk damage from winter frosts}}; {{xt|only child actors}} (no adult actors) but {{xt|only-child actors}} (actors without siblings). | ||
| Line 700: | Line 689: | ||
:::{| style="background:transparent" | :::{| style="background:transparent" | ||
|- | |- | ||
| | | ''Incorrect'': || {{!xt|9-mm gap}} | ||
|- | |- | ||
| | | ''Correct'': || {{xt|9 mm gap}} (''Markup:'' <code>9&nbsp;mm gap</code>) | ||
|- | |- | ||
| | | ''Incorrect'': || {{!xt|9 millimetre gap}} | ||
|- | |- | ||
| | | ''Correct'': || {{xt|9-millimetre gap}} | ||
|- | |- | ||
| | | ''Correct'': || {{xt|12-hour shift}} | ||
|- | |- | ||
| | | ''Correct'': || {{xt|12 h shift}} | ||
|} | |} | ||
| Line 725: | Line 714: | ||
'''Image filenames and redirects:''' Image filenames are not part of the encyclopedic content; they are tools. They are most useful if they can be readily typed, so they always use hyphens instead of dashes. Similarly, article titles with dashes should also have a corresponding redirect from a copy of the title with hyphens: for example, {{xt|[[Wikipedia:Michelson-Morley experiment|Michelson-Morley experiment]]}} redirects to {{xt|[[Wikipedia:Michelson-Morley experiment|Michelson–Morley experiment]]}}, because the latter title, although correct, is harder to search for. | '''Image filenames and redirects:''' Image filenames are not part of the encyclopedic content; they are tools. They are most useful if they can be readily typed, so they always use hyphens instead of dashes. Similarly, article titles with dashes should also have a corresponding redirect from a copy of the title with hyphens: for example, {{xt|[[Wikipedia:Michelson-Morley experiment|Michelson-Morley experiment]]}} redirects to {{xt|[[Wikipedia:Michelson-Morley experiment|Michelson–Morley experiment]]}}, because the latter title, although correct, is harder to search for. | ||
'''Non-breaking:''' A non-breaking hyphen (<code>&#8209;</code>) will | '''Non-breaking:''' A non-breaking hyphen (<code>&#8209;</code>) will ''not'' be used as a point of line-wrap. | ||
'''Soft hyphens:''' Use a [[Wikipedia:Soft hyphen|soft hyphen]] to indicate | '''Soft hyphens:''' Use a [[Wikipedia:Soft hyphen|soft hyphen]] to indicate ''optional'' locations where a word may be broken and hyphenated at the end of a line of text. Use of soft hyphens should be limited to special cases, usually involving [[Wikipedia:Longest English words|very long words]] or narrow spaces (such as captions in tight page layouts, or column labels in narrow tables). Widespread use of soft hyphens is strongly discouraged, because it makes the wikitext very difficult to read and to edit (for example, <code>This Wi&shy;ki&shy;source ex&shy;am&shy;ple is dif&shy;fi&shy;cult to un&shy;der&shy;stand</code>). An alternative syntax improves readability: | ||
:<code><nowiki>{{shy|This al|ter|na|tive syn|tax im|proves read|a|bil|ity}}</nowiki></code> | :<code><nowiki>{{shy|This al|ter|na|tive syn|tax im|proves read|a|bil|ity}}</nowiki></code> | ||
Hyphenation involves many subtleties that cannot be covered here; the rules and examples presented above illustrate the broad principles. | Hyphenation involves many subtleties that cannot be covered here; the rules and examples presented above illustrate the broad principles. | ||
== Dashes == | === Dashes === | ||
Two forms of dash are used on the UniWiki: '''[[Wikipedia:En dash|en dash]]''' ({{xt|–}}) and '''[[Wikipedia:Em dash|em dash]]''' ({{xt|—}}). Enter them as <code>&ndash;</code> or <code>&mdash;</code>. Do not substitute a double hyphen (<code>--</code>). | Two forms of dash are used on the UniWiki: '''[[Wikipedia:En dash|en dash]]''' ({{xt|–}}) and '''[[Wikipedia:Em dash|em dash]]''' ({{xt|—}}). Enter them as <code>&ndash;</code> or <code>&mdash;</code>. Do not substitute a double hyphen (<code>--</code>). | ||
| Line 740: | Line 729: | ||
Sources use dashes in varying ways, but for consistency and clarity the UniWiki adopts the following principles. | Sources use dashes in varying ways, but for consistency and clarity the UniWiki adopts the following principles. | ||
=== Punctuating a sentence (em or en dashes) === | ==== Punctuating a sentence (em or en dashes) ==== | ||
Dashes are often used to mark divisions within a sentence: in pairs (''parenthetical dashes'', instead of parentheses or pairs of commas); or singly (perhaps instead of a colon). They may also indicate an abrupt stop or interruption, in reporting direct speech. | Dashes are often used to mark divisions within a sentence: in pairs (''parenthetical dashes'', instead of parentheses or pairs of commas); or singly (perhaps instead of a colon). They may also indicate an abrupt stop or interruption, in reporting direct speech. | ||
| Line 747: | Line 736: | ||
:: {{xt|Another "planet" was detected—but it was later found to be a moon of Saturn.}} | :: {{xt|Another "planet" was detected—but it was later found to be a moon of Saturn.}} | ||
*An en dash is ''spaced'' (that is, with a space on either side) when used as sentence punctuation: | *An en dash is ''spaced'' (that is, with a space on either side) when used as sentence punctuation: | ||
:: {{xt|Another "planet" was | :: {{xt|Another "planet" was detected – but it was later found to be a moon of Saturn.}} | ||
Dashes can clarify the sentence structure when there are already commas or parentheses, or both. | Dashes can clarify the sentence structure when there are already commas or parentheses, or both. | ||
| Line 759: | Line 748: | ||
* Avoid: {{!xt|First—and most spectacularly—came the bishops—then the other clergy.}} Better: {{xt|First—and most spectacularly—came the bishops, who were followed by the other clergy.}} | * Avoid: {{!xt|First—and most spectacularly—came the bishops—then the other clergy.}} Better: {{xt|First—and most spectacularly—came the bishops, who were followed by the other clergy.}} | ||
=== Other uses (en dash only) === | ==== Other uses (en dash only) ==== | ||
The [[Wikipedia:En dash|en dash]] (–) has other roles, beyond its use as a sentence-punctuating dash (see immediately above). It is often analogous to the hyphen (see {{section link||Hyphens}}, above), which | The [[Wikipedia:En dash|en dash]] (–) has other roles, beyond its use as a sentence-punctuating dash (see immediately above). It is often analogous to the hyphen (see {{section link||Hyphens}}, above), which ''joins components'' more strongly than the en dash; or to the slash (see the section [[#Slashes|below]]), which ''separates alternatives'' more definitely. Consider the exact meaning when choosing which to use. | ||
==== In ranges that might otherwise be expressed with ''to'' or ''through'' ==== | ===== In ranges that might otherwise be expressed with ''to'' or ''through'' ===== | ||
{{hatnote|Here the ranges are ranges of numbers, dates, or times. For other ranges, such as ranges of physical locations, see {{section link||In compounds when the connection might otherwise be expressed with to, versus, and, or between}}.}} | {{hatnote|Here the ranges are ranges of numbers, dates, or times. For other ranges, such as ranges of physical locations, see {{section link||In compounds when the connection might otherwise be expressed with to, versus, and, or between}}.}} | ||
| Line 787: | Line 776: | ||
* {{xt|wavelengths in the range 28 mm – 17 m.}} | * {{xt|wavelengths in the range 28 mm – 17 m.}} | ||
==== In compounds when the connection might otherwise be expressed with ''to'', ''versus'', ''and'', or ''between'' ==== | ===== In compounds when the connection might otherwise be expressed with ''to'', ''versus'', ''and'', or ''between'' ===== | ||
Here the relationship is thought of as parallel, symmetric, equal, oppositional, or at least involving | Here the relationship is thought of as parallel, symmetric, equal, oppositional, or at least involving ''separate or independent elements''. The components may be nouns, adjectives, verbs, or any other independent part of speech. Often if the components are reversed there would be little change of meaning. | ||
* {{xt|boyfriend–girlfriend problems}}; {{xt|the Paris–Montpellier route}}; {{xt|a New York–Los Angeles flight}} | * {{xt|boyfriend–girlfriend problems}}; {{xt|the Paris–Montpellier route}}; {{xt|a New York–Los Angeles flight}} | ||
| Line 808: | Line 797: | ||
* {{xt|an Italian–Swiss border crossing}}; but {{xt|an Italian-Swiss newspaper}} for {{xt|Italian-speaking Swiss}} | * {{xt|an Italian–Swiss border crossing}}; but {{xt|an Italian-Swiss newspaper}} for {{xt|Italian-speaking Swiss}} | ||
* {{xt|France–Britain rivalry}}; {{xt|French–British rivalry}} | * {{xt|France–Britain rivalry}}; {{xt|French–British rivalry}} | ||
* Wrong: {{!xt|Franco–British rivalry}}; "Franco" is a | * Wrong: {{!xt|Franco–British rivalry}}; "Franco" is a ''combining form'', not independent, so use a hyphen: {{xt|Franco-British rivalry}} | ||
A slash or some other alternative may occasionally be better to express a ratio, especially in technical contexts ''(see {{section link||Slashes}}, below)''. | A slash or some other alternative may occasionally be better to express a ratio, especially in technical contexts ''(see {{section link||Slashes}}, below)''. | ||
| Line 833: | Line 822: | ||
Do not use spaces around en dash in any of the compounds above. | Do not use spaces around en dash in any of the compounds above. | ||
==== Instead of a hyphen, when applying a prefix to a compound that includes a space ==== | ===== Instead of a hyphen, when applying a prefix to a compound that includes a space ===== | ||
* {{xt|ex–prime minister Thatcher}}; {{xt|pre–World War II aircraft}} | * {{xt|ex–prime minister Thatcher}}; {{xt|pre–World War II aircraft}} | ||
| Line 843: | Line 832: | ||
The en dash in all of the compounds above is unspaced. | The en dash in all of the compounds above is unspaced. | ||
==== To separate parts of an item in a list ==== | ===== To separate parts of an item in a list ===== | ||
Spaced en dashes are sometimes used between parts of list items. Below are two examples. | Spaced en dashes are sometimes used between parts of list items. Below are two examples. | ||
| Line 854: | Line 843: | ||
** {{xt|"Bird on the Wire" – 6:14.}} | ** {{xt|"Bird on the Wire" – 6:14.}} | ||
=== Other dashes === | ==== Other dashes ==== | ||
Do not use substitutes for em or en dashes, such as the combination of two hyphens ({{!xt|--}}). These were [[Wikipedia:Typewriter#Typewriter conventions|typewriter approximations]]. | Do not use substitutes for em or en dashes, such as the combination of two hyphens ({{!xt|--}}). These were [[Wikipedia:Typewriter#Typewriter conventions|typewriter approximations]]. | ||
For a negative sign or subtraction operator, use a minus sign: {{xt|−}}. Input by clicking on it in the insert box beneath the edit window or by typing <code>&minus;</code>. | For a negative sign or subtraction operator, use a minus sign: {{xt|−}}. Input by clicking on it in the insert box beneath the edit window or by typing <code>&minus;</code>. | ||
== Slashes == | === Slashes === | ||
Generally, avoid joining two words with a [[Wikipedia:Slash (punctuation)|slash]], also called a forward slash or ''solidus'' ({{xt| / }}), because it suggests that the words are related without specifying how. Replace with clearer wording. | Generally, avoid joining two words with a [[Wikipedia:Slash (punctuation)|slash]], also called a forward slash or ''solidus'' ({{xt| / }}), because it suggests that the words are related without specifying how. Replace with clearer wording. | ||
| Line 883: | Line 872: | ||
Do not use the [[Wikipedia:Backslash|backslash]] character ({{!xt| \ }}) in place of a slash. | Do not use the [[Wikipedia:Backslash|backslash]] character ({{!xt| \ }}) in place of a slash. | ||
Prefer the division operator ({{xt| ÷ }}) to slash or fraction slash when representing elementary arithmetic in general text: {{xt|10 ÷ 2 = 5}}. In more advanced mathematical formulas, a [[Wikipedia:Vinculum (symbol)|vinculum]] or slash is preferred: {{xt|<var>x</var><sup><var>n</var></sup>/<var>n</var>!}}. ''(See {{section link|UniWiki:Manual of Style/Dates and numbers|Common mathematical symbols}} and [[Wikipedia:Help:Displaying a formula]].) | Prefer the division operator ({{xt| ÷ }}) to slash or fraction slash when representing elementary arithmetic in general text: {{xt|1=10 ÷ 2 = 5}}. In more advanced mathematical formulas, a [[Wikipedia:Vinculum (symbol)|vinculum]] or slash is preferred: {{xt|<var>x</var><sup><var>n</var></sup>/<var>n</var>!}}. ''(See {{section link|UniWiki:Manual of Style/Dates and numbers|Common mathematical symbols}} and [[Wikipedia:Help:Displaying a formula]].) | ||
=== And/or === | ==== And/or ==== | ||
Avoid writing {{!xt|and/or}}: Instead of {{!xt|Most suffered trauma and/or smoke inhalation}}, write simply {{xt|trauma or smoke inhalation}} (which would normally be interpreted to imply ''or both''); or, for emphasis or precision, write {{xt|trauma or smoke inhalation or both}}. Where more than two possibilities are present, instead of {{!xt|x, y, and/or z}} write {{xt|one or more of x, y, and z}} or {{xt|some or all of x, y, and z}}. | Avoid writing {{!xt|and/or}}: Instead of {{!xt|Most suffered trauma and/or smoke inhalation}}, write simply {{xt|trauma or smoke inhalation}} (which would normally be interpreted to imply ''or both''); or, for emphasis or precision, write {{xt|trauma or smoke inhalation or both}}. Where more than two possibilities are present, instead of {{!xt|x, y, and/or z}} write {{xt|one or more of x, y, and z}} or {{xt|some or all of x, y, and z}}. | ||
== Number sign == | === Number sign === | ||
Avoid using the {{!xt|[[octothorpe|#]]}} symbol (known as the [[Wikipedia:Number sign|number sign]], hash sign, or pound sign) when referring to numbers or rankings. Instead write "number", "No." or "Nos."; do not use the symbol {{!xt|№}}. For example: | Avoid using the {{!xt|[[Wikipedia:octothorpe|#]]}} symbol (known as the [[Wikipedia:Number sign|number sign]], hash sign, or pound sign) when referring to numbers or rankings. Instead write "number", "No." or "Nos."; do not use the symbol {{!xt|№}}. For example: | ||
:{| style="background:transparent" | :{| style="background:transparent" | ||
|- | |- | ||
| | | ''Incorrect'': || {{!xt|Her album reached #1 in the UK album charts.}} | ||
|- | |- | ||
| | | ''Correct'': || {{xt|Her album reached number one in the UK album charts.}} | ||
|} | |} | ||
== Terminal punctuation == | === Terminal punctuation === | ||
* [[Wikipedia:Full stop|Periods]] ("full stops"), [[Wikipedia:Question mark|question marks]], and [[Wikipedia:Exclamation mark|exclamation marks]] are [[Wikipedia:Terminal punctuation|terminal punctuation]]& | * [[Wikipedia:Full stop|Periods]] ("full stops"), [[Wikipedia:Question mark|question marks]], and [[Wikipedia:Exclamation mark|exclamation marks]] are [[Wikipedia:Terminal punctuation|terminal punctuation]]—the only punctuation marks used to end English sentences. | ||
* In some contexts, no terminal punctuation is necessary. In such cases, the sentence often does not start with a capital letter. See {{section link||Quotation marks}}, and {{section link||Sentences and brackets}}, above. [[Wikipedia:Sentence fragment|Sentence fragments]] in captions or lists should in most cases not end with a period. See {{section link||Formatting of captions}} and {{section link||Bulleted and numbered lists}}, below. | * In some contexts, no terminal punctuation is necessary. In such cases, the sentence often does not start with a capital letter. See {{section link||Quotation marks}}, and {{section link||Sentences and brackets}}, above. [[Wikipedia:Sentence fragment|Sentence fragments]] in captions or lists should in most cases not end with a period. See {{section link||Formatting of captions}} and {{section link||Bulleted and numbered lists}}, below. | ||
* For the use of three periods in succession, see {{section link||Ellipses}}, above. | * For the use of three periods in succession, see {{section link||Ellipses}}, above. | ||
| Line 912: | Line 901: | ||
** {{xt|The door flew open with a BANG! that made them jump.}} (Not encyclopedic, but acceptable in transcription from audio, or in direct quotation.) | ** {{xt|The door flew open with a BANG! that made them jump.}} (Not encyclopedic, but acceptable in transcription from audio, or in direct quotation.) | ||
== Spacing == | === Spacing === | ||
In normal text, never put a space | In normal text, never put a space ''before'' a comma, a semicolon, a colon, or a terminal punctuation mark (even in quoted material). Put a space ''after'' these, unless they end a paragraph or are followed by a closing parenthesis, quotation mark, or similar. | ||
=== Spaces following terminal punctuation === | ==== Spaces following terminal punctuation ==== | ||
The number of spaces following the terminal punctuation of a sentence in the wiki markup makes no difference on the UniWiki; the MediaWiki software condenses any number of spaces to just one when rendering the page (see [[Wikipedia:Sentence spacing|Sentence spacing]]). For this reason, editors may use any spacing style they prefer on the UniWiki. Multiple spacing styles may coexist in the same article, and adding or removing a double space is sometimes used as a [[Wikipedia:Help:dummy edit|dummy edit]]. | The number of spaces following the terminal punctuation of a sentence in the wiki markup makes no difference on the UniWiki; the MediaWiki software condenses any number of spaces to just one when rendering the page (see [[Wikipedia:Sentence spacing|Sentence spacing]]). For this reason, editors may use any spacing style they prefer on the UniWiki. Multiple spacing styles may coexist in the same article, and adding or removing a double space is sometimes used as a [[Wikipedia:Help:dummy edit|dummy edit]]. | ||
== Consecutive punctuation marks == | === Consecutive punctuation marks === | ||
Where a word or phrase that includes terminal punctuation ends a sentence, do not add a second terminal punctuation mark. If a quoted phrase or title ends in a question mark or exclamation mark, it may confuse readers as to the nature of the article sentence containing it, and so is usually better reworded to be mid-sentence. Where such a word or phrase occurs mid-sentence, new terminal punctuation (usually a period) must be added at the end. | Where a word or phrase that includes terminal punctuation ends a sentence, do not add a second terminal punctuation mark. If a quoted phrase or title ends in a question mark or exclamation mark, it may confuse readers as to the nature of the article sentence containing it, and so is usually better reworded to be mid-sentence. Where such a word or phrase occurs mid-sentence, new terminal punctuation (usually a period) must be added at the end. | ||
| Line 926: | Line 915: | ||
|- | |- | ||
| | | ''Incorrect'': || {{!xt|Slovak returned to the Red Hot Chili Peppers in 1985 after growing tired of What Is This?.}} | ||
|- | |- | ||
| | | ''Acceptable'': || {{xt|Slovak returned to the Red Hot Chili Peppers in 1985 after growing tired of What Is This?}} | ||
|- | |- | ||
| | | ''Better'': || {{xt|Slovak, after growing tired of What Is This?, returned to the Red Hot Chili Peppers in 1985.}} | ||
|} | |} | ||
== Punctuation and footnotes == | === Punctuation and footnotes === | ||
:''See also: [[Wikipedia:Wikipedia:Citing sources|Wikipedia:Citing sources]]'' | :''See also: [[Wikipedia:Wikipedia:Citing sources|Wikipedia:Citing sources]]'' | ||
| Line 940: | Line 929: | ||
When ref tags are used, a [[Wikipedia:Help:Footnotes#Creating the footnote list|footnote list]] must be added, and is usually placed in the [[UniWiki:Manual of Style/Layout#Notes and references|Notes and References]] section near the end of the article in the [[UniWiki:Manual of Style/Layout#Standard appendices and footers|standard appendices and footers]]. | When ref tags are used, a [[Wikipedia:Help:Footnotes#Creating the footnote list|footnote list]] must be added, and is usually placed in the [[UniWiki:Manual of Style/Layout#Notes and references|Notes and References]] section near the end of the article in the [[UniWiki:Manual of Style/Layout#Standard appendices and footers|standard appendices and footers]]. | ||
Exceptions: ref tags are placed | Exceptions: ref tags are placed ''before'' dashes, not after; and where a footnote applies only to material within parentheses, the ref tags belong just before the closing parenthesis. | ||
=== Punctuation after formulae === | === Punctuation after formulae === | ||
A sentence that ends with a formula should have terminal punctuation (period, exclamation mark, or question mark) after the formula. Within a sentence, place other punctuation (such as commas or colons) after the formula just as if the text were not a formula. | A sentence that ends with a formula should have terminal punctuation (period, exclamation mark, or question mark) after the formula. Within a sentence, place other punctuation (such as commas or colons) after the formula just as if the text were not a formula. | ||
= Dates and time = | == Dates and time == | ||
{{main|UniWiki:Manual of Style/Dates and numbers#Chronological items}} | {{main|UniWiki:Manual of Style/Dates and numbers#Chronological items}} | ||
| Line 992: | Line 981: | ||
|- | |- | ||
| | | ''Incorrect'': || {{!xt|He is the current ambassador to ...}} | ||
|- | |- | ||
| | | ''Correct'': || {{xt|As of March 2011, he is the ambassador to ...}} | ||
|} | |} | ||
= Numbers = | == Numbers == | ||
{{main|UniWiki:Manual of Style/Dates and numbers#Numbers}} | {{main|UniWiki:Manual of Style/Dates and numbers#Numbers}} | ||
| Line 1,008: | Line 997: | ||
* [[Wikipedia:Fewer vs. less|Fewer vs. less]]: In most cases, use ''fewer'' with [[Wikipedia:count noun|countable]] nouns and ''less'' with [[Wikipedia:mass noun|non-countable]] ones. However, ''less than'' (not ''fewer than'') is recommended before nouns that denote distance or time. For example, {{xt|I picked fewer than one hundred apples}}, but {{xt|we go on our trip in less than four weeks}}, and {{xt|he can run the 100 m in less than ten seconds}}, because the word ''time'' can be understood to be implied after ''less''. In short, if you'd count it, say ''fewer''. If you'd measure it, say ''less''. | * [[Wikipedia:Fewer vs. less|Fewer vs. less]]: In most cases, use ''fewer'' with [[Wikipedia:count noun|countable]] nouns and ''less'' with [[Wikipedia:mass noun|non-countable]] ones. However, ''less than'' (not ''fewer than'') is recommended before nouns that denote distance or time. For example, {{xt|I picked fewer than one hundred apples}}, but {{xt|we go on our trip in less than four weeks}}, and {{xt|he can run the 100 m in less than ten seconds}}, because the word ''time'' can be understood to be implied after ''less''. In short, if you'd count it, say ''fewer''. If you'd measure it, say ''less''. | ||
= Currencies = | == Currencies == | ||
{{main|UniWiki:Manual of Style/Dates and numbers#Currencies and monetary values}} | {{main|UniWiki:Manual of Style/Dates and numbers#Currencies and monetary values}} | ||
* Use the full abbreviation on first use ({{xt|US$}} for the US dollar and {{xt|A$}} for the Australian dollar), | * Use the full abbreviation on first use ({{xt|US$}} for the US dollar and {{xt|A$}} for the Australian dollar), ''unless the currency is already clear from context''. For example, the Government of the United States always spends money in American dollars, and never in Canadian or Australian dollars. | ||
* Use only one symbol with ranges, as in {{xt|$250–300}}. | * Use only one symbol with ranges, as in {{xt|$250–300}}. | ||
* In articles that are not specific to a country, express amounts of money in [[Wikipedia:United States dollars|United States dollars]], [[Wikipedia:Euros|euros]], or [[Wikipedia:Pounds sterling|pounds sterling]]. Do not link the names or symbols of currencies that are commonly known to English-speakers ({{xt|$}}, {{xt|£}}, {{xt|€}}), unless there is a particular reason to do so; do not use potentially ambiguous currency symbols, unless the meaning is clear in the context. | * In articles that are not specific to a country, express amounts of money in [[Wikipedia:United States dollars|United States dollars]], [[Wikipedia:Euros|euros]], or [[Wikipedia:Pounds sterling|pounds sterling]]. Do not link the names or symbols of currencies that are commonly known to English-speakers ({{xt|$}}, {{xt|£}}, {{xt|€}}), unless there is a particular reason to do so; do not use potentially ambiguous currency symbols, unless the meaning is clear in the context. | ||
* Most currency signs are placed | * Most currency signs are placed ''before'' the number; they are unspaced ({{xt|$123}}), except for alphabetic signs ({{xt|R 75}}). | ||
* In the context of the UniWiki, ISK is understood to mean "InterStellar Kredits", the in-game currency of EVE, as opposed to the Icelandic krona. | * In the context of the UniWiki, ISK is understood to mean "InterStellar Kredits", the in-game currency of EVE, as opposed to the Icelandic krona. | ||
= Units of measurement = | == Units of measurement == | ||
{{main|UniWiki:Manual of Style/Dates and numbers#Units of measurement}} | {{main|UniWiki:Manual of Style/Dates and numbers#Units of measurement}} | ||
| Line 1,024: | Line 1,013: | ||
* In a direct quotation, always keep the source units. If a conversion is required, it should appear within square brackets in the quote, or else an obscure use of units can be explained in a [[Wikipedia:Footnotes|footnote]]. | * In a direct quotation, always keep the source units. If a conversion is required, it should appear within square brackets in the quote, or else an obscure use of units can be explained in a [[Wikipedia:Footnotes|footnote]]. | ||
* Where space is limited (such as tables, infoboxes, parenthetical notes, and mathematical formulas) use unit symbols. In main text it is usually better to spell out unit names, but symbols may also be used when a unit (especially one with a long name) is used repeatedly. However, spell out the first instance of each unit in an article (for example, {{xt|the typical batch is 250 kilograms ... and then 15 kg of emulsifier is added}}), except for unit names that are hardly ever spelled out (e.g., the degree Celsius). Most unit names are not capitalized. Use "per" when writing out a unit, rather than a slash: {{xt|meter per second}}, not {{!xt|meter/second}}. (For spelling differences, follow {{section link||National varieties of English}}, above.) | * Where space is limited (such as tables, infoboxes, parenthetical notes, and mathematical formulas) use unit symbols. In main text it is usually better to spell out unit names, but symbols may also be used when a unit (especially one with a long name) is used repeatedly. However, spell out the first instance of each unit in an article (for example, {{xt|the typical batch is 250 kilograms ... and then 15 kg of emulsifier is added}}), except for unit names that are hardly ever spelled out (e.g., the degree Celsius). Most unit names are not capitalized. Use "per" when writing out a unit, rather than a slash: {{xt|meter per second}}, not {{!xt|meter/second}}. (For spelling differences, follow {{section link||National varieties of English}}, above.) | ||
* For ranges, see {{section link||En dashes: other uses}}, above, and UniWiki:Manual of Style/ | * For ranges, see {{section link||En dashes: other uses}}, above, and UniWiki:Manual of Style/Dates and numbers, at {{section link|nopage=y|Wikipedia:Manual of Style/Dates and numbers|Date ranges|Percentages|Unit names and symbols|Formatting of monetary values}}. | ||
* When dimensions are given, each number should be followed by a unit name or symbol (e.g., write {{xt|1 m × 3 m × 6 m}}, not {{!xt|1 × 3 × 6 m}}). | * When dimensions are given, each number should be followed by a unit name or symbol (e.g., write {{xt|1 m × 3 m × 6 m}}, not {{!xt|1 × 3 × 6 m}}). | ||
* When they form a compound adjective, values and spelled-out unit names should be separated by a hyphen: for example, {{xt|a five-day holiday}}. An exception is when the hyphenated construction has another meaning in the context. | * When they form a compound adjective, values and spelled-out unit names should be separated by a hyphen: for example, {{xt|a five-day holiday}}. An exception is when the hyphenated construction has another meaning in the context. | ||
* Unit symbols are preceded by figures, not by spelled-out numbers. Values and unit symbols are separated by a [[Wikipedia:Non-breaking space|non-breaking space]]. For example, {{xt|5 min}}. The percent sign and units of degrees, minutes, and seconds | * Unit symbols are preceded by figures, not by spelled-out numbers. Values and unit symbols are separated by a [[Wikipedia:Non-breaking space|non-breaking space]]. For example, {{xt|5 min}}. The percent sign and units of degrees, minutes, and seconds ''for angles and coordinates'' are unspaced. | ||
* Standard unit symbols do not require a [[Wikipedia:Full stop|full stop]] (period). However, non-standard abbreviations should always be given a full stop. | * Standard unit symbols do not require a [[Wikipedia:Full stop|full stop]] (period). However, non-standard abbreviations should always be given a full stop. | ||
* No ''s'' is appended, e.g., {{xt|km}}, not {{!xt|kms}}. | * No ''s'' is appended, e.g., {{xt|km}}, not {{!xt|kms}}. | ||
* Write powers of unit symbols with HTML, e.g., {{xt|<nowiki>5 km<sup>2</sup></nowiki>}} not [[Wikipedia:Unicode subscripts and superscripts|Unicode superscripts and subscripts]]. | * Write powers of unit symbols with HTML, e.g., {{xt|<nowiki>5 km<sup>2</sup></nowiki>}} not [[Wikipedia:Unicode subscripts and superscripts|Unicode superscripts and subscripts]]. | ||
* For quantities of bytes and bits, specify whether the binary or decimal meanings of K, M, G, etc. are intended. The [[Wikipedia:Binary prefixes#IEC standard prefixes|IEC prefixes]] ''kibi-'', ''mebi-'', ''gibi-'', etc. (symbols Ki, Mi, Gi, etc.) are not familiar to most readers and should not generally be used (for exceptions, see {{section link|UniWiki:Manual of Style/ | * For quantities of bytes and bits, specify whether the binary or decimal meanings of K, M, G, etc. are intended. The [[Wikipedia:Binary prefixes#IEC standard prefixes|IEC prefixes]] ''kibi-'', ''mebi-'', ''gibi-'', etc. (symbols Ki, Mi, Gi, etc.) are not familiar to most readers and should not generally be used (for exceptions, see {{section link|UniWiki:Manual of Style/Dates and numbers|Quantities of bytes and bits}}). | ||
** When discussing computer equipment and other real life hardware concepts, units should be specified as stated above. | ** When discussing computer equipment and other real life hardware concepts, units should be specified as stated above. | ||
** When discussing in-game concepts (particularly drones), megabits (Mbits) should be used. | ** When discussing in-game concepts (particularly drones), megabits (Mbits) should be used. | ||
= Common mathematical symbols = | == Common mathematical symbols == | ||
* For a negative sign or subtraction operator, use a minus sign ({{xt|−}}, Unicode character U+2212 <small>MINUS SIGN</small>). Input by clicking on it in the insert box beneath the edit window or by typing <code>&minus;</code>. | * For a negative sign or subtraction operator, use a minus sign ({{xt|−}}, Unicode character U+2212 <small>MINUS SIGN</small>). Input by clicking on it in the insert box beneath the edit window or by typing <code>&minus;</code>. | ||
* For a multiplication sign between numbers, use {{xt|×}} (Unicode character U+00D7 <small>MULTIPLICATION SIGN</small>), which is input by clicking on it in the edit toolbox under the edit window or by typing <code>&times;</code>. The letter {{xt|x}} should not be used to indicate multiplication, but it is used (unspaced) as the substitute for "by" in terms such as {{xt|[[4x4]]}}. | * For a multiplication sign between numbers, use {{xt|×}} (Unicode character U+00D7 <small>MULTIPLICATION SIGN</small>), which is input by clicking on it in the edit toolbox under the edit window or by typing <code>&times;</code>. The letter {{xt|x}} should not be used to indicate multiplication, but it is used (unspaced) as the substitute for "by" in terms such as {{xt|[[Wikipedia:4x4|4x4]]}}. | ||
* [[Wikipedia:Exponentiation|Exponentiation]] is indicated by a superscript, {{xt|''a''<sup>''n''</sup>}} (typed as <code><nowiki>''a''<sup>''n''</sup></nowiki></code>. [[Wikipedia:Exponential notation|Exponential notation]] can be spaced or unspaced, depending on circumstances. | * [[Wikipedia:Exponentiation|Exponentiation]] is indicated by a superscript, {{xt|''a''<sup>''n''</sup>}} (typed as <code><nowiki>''a''<sup>''n''</sup></nowiki></code>. [[Wikipedia:Exponential notation|Exponential notation]] can be spaced or unspaced, depending on circumstances. | ||
* Do not use programming language notation outside computer program listings. In most programming languages, subtraction, multiplication, and exponentiation are respectively represented by the [[Wikipedia:Hyphen-minus|hyphen-minus]] <code>-</code>, the [[Wikipedia:Asterisk|asterisk]] <code>*</code>, and either the [[Wikipedia:Caret|caret]] <code>^</code> or the double asterisk <code>**</code>, and [[Wikipedia:Scientific notation|scientific notation]] is replaced by [[Wikipedia:E notation|E notation]]. | * Do not use programming language notation outside computer program listings. In most programming languages, subtraction, multiplication, and exponentiation are respectively represented by the [[Wikipedia:Hyphen-minus|hyphen-minus]] <code>-</code>, the [[Wikipedia:Asterisk|asterisk]] <code>*</code>, and either the [[Wikipedia:Caret|caret]] <code>^</code> or the double asterisk <code>**</code>, and [[Wikipedia:Scientific notation|scientific notation]] is replaced by [[Wikipedia:E notation|E notation]]. | ||
| Line 1,051: | Line 1,040: | ||
* Variables are italicized, but digits and punctuation are not; only ''x'' and ''y'' are italicized in {{xt|2(5''x'' + ''y'')<sup>2</sup>}}. The [[Wikipedia:Semantic HTML|semantic HTML]] element {{tag|var}} can be used to distinguish variables from other uses of italics, as illustrated in the code example above. | * Variables are italicized, but digits and punctuation are not; only ''x'' and ''y'' are italicized in {{xt|2(5''x'' + ''y'')<sup>2</sup>}}. The [[Wikipedia:Semantic HTML|semantic HTML]] element {{tag|var}} can be used to distinguish variables from other uses of italics, as illustrated in the code example above. | ||
= Grammar and usage = | == Grammar and usage == | ||
== Possessives == | === Possessives === | ||
{{hatnote|For thorough treatment of the English possessive, see [[Wikipedia:Apostrophe|Apostrophe]].}} | {{hatnote|For thorough treatment of the English possessive, see [[Wikipedia:Apostrophe|Apostrophe]].}} | ||
=== Singular nouns === | ==== Singular nouns ==== | ||
* For the possessive of most singular nouns, including proper names and words ending with a double-s, add ''<nowiki />'s'' ({{xt|my daughter's achievement}}, {{xt|my niece's wedding}}, {{xt|Cortez's men}}, {{xt|the boss's office}}, {{xt|Glass's books}}, {{xt|Illinois's largest employer}}, {{xt|Descartes's philosophy}}, {{xt|Verreaux's eagle}}). | * For the possessive of most singular nouns, including proper names and words ending with a double-s, add ''<nowiki />'s'' ({{xt|my daughter's achievement}}, {{xt|my niece's wedding}}, {{xt|Cortez's men}}, {{xt|the boss's office}}, {{xt|Glass's books}}, {{xt|Illinois's largest employer}}, {{xt|Descartes's philosophy}}, {{xt|Verreaux's eagle}}). | ||
: '''Exception:''' Abstract nouns ending with an /s/ sound, when followed by ''sake'' ({{xt|for goodness' sake}}, {{xt|for his conscience' sake}}). | : '''Exception:''' Abstract nouns ending with an /s/ sound, when followed by ''sake'' ({{xt|for goodness' sake}}, {{xt|for his conscience' sake}}). | ||
| Line 1,065: | Line 1,054: | ||
*#* Add ''<nowiki />'s'' if the possessive has an additional 'z' sound at the end: {{xt|Jan Hus's life}}, {{xt|Morris's works}}. | *#* Add ''<nowiki />'s'' if the possessive has an additional 'z' sound at the end: {{xt|Jan Hus's life}}, {{xt|Morris's works}}. | ||
*#* Some possessives have two possible pronunciations: {{xt|James's house}} or {{xt|James' house}}, {{xt|Brahms's music}} or {{xt|Brahms' music}}, {{xt|Vilnius's location}} or {{xt|Vilnius' location}}, {{xt|Dickens's novels}} or {{xt|Dickens' novels}}. | *#* Some possessives have two possible pronunciations: {{xt|James's house}} or {{xt|James' house}}, {{xt|Brahms's music}} or {{xt|Brahms' music}}, {{xt|Vilnius's location}} or {{xt|Vilnius' location}}, {{xt|Dickens's novels}} or {{xt|Dickens' novels}}. | ||
: Apply just | : Apply just ''one'' of these two practices consistently within an article. | ||
=== Plural nouns === | ==== Plural nouns ==== | ||
* For a normal plural noun, ending with a pronounced ''s'', form the possessive by adding just an apostrophe ({{xt|my sons' wives}}, {{xt|my nieces' weddings}}). | * For a normal plural noun, ending with a pronounced ''s'', form the possessive by adding just an apostrophe ({{xt|my sons' wives}}, {{xt|my nieces' weddings}}). | ||
* For a plural noun | * For a plural noun ''not'' ending with a pronounced ''s'', add ''<nowiki />'s'' ({{xt|women's careers}}, {{xt|people's habits}}, {{xt|the mice's whiskers}}; {{xt|The two Dumas's careers were controversial}}, but where rewording is an option, this may be better: {{xt|The career of each Dumas was controversial}}). | ||
=== Official names === | ==== Official names ==== | ||
* Official names (of companies, organizations, or places) should not be altered. ({{xt|[[St. Thomas' Hospital]]}} should therefore | * Official names (of companies, organizations, or places) should not be altered. ({{xt|[[Wikipedia:St. Thomas' Hospital|St. Thomas' Hospital]]}} should therefore ''not'' be rendered as {{!xt|St. Thomas's Hospital}}, even for consistency.) | ||
==Pronouns== | === Pronouns === | ||
=== First-person pronouns === | ==== First-person pronouns ==== | ||
While certain topics and articles found on the UniWiki will be based on opinion, such as fittings or guides, UniWiki articles should be written in an impersonal voice and style, so never use ''I'', ''my'', or similar forms (except in quotations). This restriction does not apply to talk or user pages. | While certain topics and articles found on the UniWiki will be based on opinion, such as fittings or guides, UniWiki articles should be written in an impersonal voice and style, so never use ''I'', ''my'', or similar forms (except in quotations). This restriction does not apply to talk or user pages. | ||
| Line 1,086: | Line 1,075: | ||
* The author's ''we'' found in scientific writing: {{xt|We are thus led also to a definition of "time" in physics}} (Albert Einstein); {{xt|Throughout the proof of this theorem we assume that the function ƒ is uniformly continuous}}. Often rephrasing using the [[Wikipedia:English passive voice|passive voice]] is preferable: {{xt|Throughout the proof of this theorem it is assumed that the function ƒ is uniformly continuous.}} | * The author's ''we'' found in scientific writing: {{xt|We are thus led also to a definition of "time" in physics}} (Albert Einstein); {{xt|Throughout the proof of this theorem we assume that the function ƒ is uniformly continuous}}. Often rephrasing using the [[Wikipedia:English passive voice|passive voice]] is preferable: {{xt|Throughout the proof of this theorem it is assumed that the function ƒ is uniformly continuous.}} | ||
=== Second-person pronouns === | ==== Second-person pronouns ==== | ||
In general, writers should avoid addressing the reader directly by using the second-person [[Wikipedia:Generic you|generic ''you'']] or ''your''; it is often ambiguous, and contrary to the tone of an encyclopedia (see also {{section link||Instructional and presumptuous language}}, below). | In general, writers should avoid addressing the reader directly by using the second-person [[Wikipedia:Generic you|generic ''you'']] or ''your''; it is often ambiguous, and contrary to the tone of an encyclopedia (see also {{section link||Instructional and presumptuous language}}, below). | ||
| Line 1,096: | Line 1,085: | ||
* The [[Wikipedia:English passive voice|passive voice]] may sometimes be used instead: {{xt|Impurities are removed before bottling}}. | * The [[Wikipedia:English passive voice|passive voice]] may sometimes be used instead: {{xt|Impurities are removed before bottling}}. | ||
== Plurals == | === Plurals === | ||
:''See also: [[Wikipedia:English plurals#Collective noun|Collective nouns]] | :''See also: [[Wikipedia:English plurals#Collective noun|Collective nouns]] | ||
| Line 1,103: | Line 1,092: | ||
Some [[Wikipedia:Collective noun|collective nouns]]—such as ''team'' (and proper names of them), ''army'', ''company'', ''crowd'', ''fleet'', ''government'', ''majority'', ''mess'', ''number'', ''pack'', and ''party''—may refer either to a single entity or to the members that compose it. In British English, such words are sometimes treated as singular, but more often treated as plural, according to context. Exceptionally, names of towns and countries usually take singular verbs (unless they are being used to refer to a team or company by that name, or when discussing actions of that entity's government). For example, in {{xt|[[Wikipedia:England national football team|England]] are playing [[Wikipedia:Germany national football team|Germany]] tonight}}, ''England'' refers to a [[Wikipedia:Association football|football]] team; but in {{xt|England is the most populous country of the United Kingdom}}, it refers to the country. In North American English, these words (and ''the United States'', for historical reasons) are almost invariably treated as singular; the major exception is when sports teams are referred to by nicknames that are plural nouns, when plural verbs are commonly used to match. See also {{section link||National varieties of English}}, above. | Some [[Wikipedia:Collective noun|collective nouns]]—such as ''team'' (and proper names of them), ''army'', ''company'', ''crowd'', ''fleet'', ''government'', ''majority'', ''mess'', ''number'', ''pack'', and ''party''—may refer either to a single entity or to the members that compose it. In British English, such words are sometimes treated as singular, but more often treated as plural, according to context. Exceptionally, names of towns and countries usually take singular verbs (unless they are being used to refer to a team or company by that name, or when discussing actions of that entity's government). For example, in {{xt|[[Wikipedia:England national football team|England]] are playing [[Wikipedia:Germany national football team|Germany]] tonight}}, ''England'' refers to a [[Wikipedia:Association football|football]] team; but in {{xt|England is the most populous country of the United Kingdom}}, it refers to the country. In North American English, these words (and ''the United States'', for historical reasons) are almost invariably treated as singular; the major exception is when sports teams are referred to by nicknames that are plural nouns, when plural verbs are commonly used to match. See also {{section link||National varieties of English}}, above. | ||
== Verb tense == | === Verb tense === | ||
:''See also: [[Wikipedia:Wikipedia:Writing better articles#Tense|Tense]] | :''See also: [[Wikipedia:Wikipedia:Writing better articles#Tense|Tense]] | ||
| Line 1,115: | Line 1,104: | ||
Tense can be used to distinguish between current and former status of a subject: {{xt|Dún Aonghasa '''is''' the ruin of a prehistoric Irish cliff fort. Its original shape '''was''' presumably oval or D-shaped, but parts of the cliff and fort have since collapsed into the sea.}} (Emphasis added for clarity.) | Tense can be used to distinguish between current and former status of a subject: {{xt|Dún Aonghasa '''is''' the ruin of a prehistoric Irish cliff fort. Its original shape '''was''' presumably oval or D-shaped, but parts of the cliff and fort have since collapsed into the sea.}} (Emphasis added for clarity.) | ||
= Vocabulary = | == Vocabulary == | ||
=== Contractions === | === Contractions === | ||
| Line 1,138: | Line 1,127: | ||
This guideline is relaxed in the case of guides, syllabi, and articles describing PvE encounters. In these cases, such language can and should be used when necessary to draw the reader's attention to important pieces of information. | This guideline is relaxed in the case of guides, syllabi, and articles describing PvE encounters. In these cases, such language can and should be used when necessary to draw the reader's attention to important pieces of information. | ||
Similarly, phrases such as ''of course'', ''naturally'', ''obviously'', ''clearly'', and ''actually'' make presumptions about readers' knowledge, and call into question the reason for including the information in the first place. Do not | Similarly, phrases such as ''of course'', ''naturally'', ''obviously'', ''clearly'', and ''actually'' make presumptions about readers' knowledge, and call into question the reason for including the information in the first place. Do not ''tell'' readers that something is ironic, surprising, unexpected, amusing, coincidental, etc. Simply state the sourced facts and allow readers to draw their own conclusions. Such constructions can usually just be deleted (and [[Wikipedia:Letter case|letter case]] adjusted if necessary), leaving behind proper sentences, with a more academic and less pushy tone: {{!xt|Note that this was naturally subject to controversy in more conservative newspapers.}} becomes {{xt|This was subject to controversy in more conservative newspapers.}} | ||
=== Subset terms === | === Subset terms === | ||
| Line 1,185: | Line 1,174: | ||
When the notions named by jargon are too complex to explain concisely in a few parenthetical words, [[Wikipedia:Make technical articles understandable#Write one level down|write one level down]]. For example, consider adding a brief background section with <code><nowiki>{{|main}}</nowiki></code> tags pointing to the full treatment article(s) of the prerequisite notions; this approach is practical only when the prerequisite concepts are central to the exposition of the article's main topic and when such prerequisites are not too numerous. Short articles like [[Wikipedia:Wikipedia:Stub|stubs]] generally do not have such sections. | When the notions named by jargon are too complex to explain concisely in a few parenthetical words, [[Wikipedia:Make technical articles understandable#Write one level down|write one level down]]. For example, consider adding a brief background section with <code><nowiki>{{|main}}</nowiki></code> tags pointing to the full treatment article(s) of the prerequisite notions; this approach is practical only when the prerequisite concepts are central to the exposition of the article's main topic and when such prerequisites are not too numerous. Short articles like [[Wikipedia:Wikipedia:Stub|stubs]] generally do not have such sections. | ||
= Media files = | == Media files == | ||
:''See also: [[Wikipedia:Wikipedia:Creation and usage of media files|Wikipedia:Creation and usage of media files]] | :''See also: [[Wikipedia:Wikipedia:Creation and usage of media files|Wikipedia:Creation and usage of media files]] | ||
| Line 1,194: | Line 1,183: | ||
* Use captions to clarify the relevance of the image to the article (see {{section link||Captions}}, below). | * Use captions to clarify the relevance of the image to the article (see {{section link||Captions}}, below). | ||
* Each image should be inside the major section to which it relates (within the section defined by the most recent level 1 level 2 heading or at the top of the lead section), not immediately above the section heading. | * Each image should be inside the major section to which it relates (within the section defined by the most recent level 1 level 2 heading or at the top of the lead section), not immediately above the section heading. | ||
* Avoid sandwiching text between two images that face each other | * Avoid sandwiching text between two images that face each other and between an image and an infobox or similar. | ||
* It is often preferable to place images of faces so that the face or eyes look toward the text. However, it is not necessary to reverse an image simply to have the subject facing the text. | * It is often preferable to place images of faces so that the face or eyes look toward the text. However, it is not necessary to reverse an image simply to have the subject facing the text. | ||
* Multiple images in the same article can be staggered right-and-left (for example, [[Wikipedia:Timpani|Timpani]]). | * Multiple images in the same article can be staggered right-and-left (for example, [[Wikipedia:Timpani|Timpani]]). | ||
| Line 1,200: | Line 1,189: | ||
* Avoid referring to images as being on the left or right. Image placement is different for viewers of the mobile version of Wikipedia, and is meaningless to people having pages read to them by assistive software. Instead, use captions to identify images. | * Avoid referring to images as being on the left or right. Image placement is different for viewers of the mobile version of Wikipedia, and is meaningless to people having pages read to them by assistive software. Instead, use captions to identify images. | ||
* [[Wikipedia:Wikipedia:Alternative text for images|Alt text]] takes the place of an image for text-only readers, including those using [[Wikipedia:Screen Reader|screen readers]]. Images should have an alt attribute added to the 'alt' parameter. See [[Wikipedia:Wikipedia:Alternative text of images|Wikipedia:Alternative text of images]] for more information. | * [[Wikipedia:Wikipedia:Alternative text for images|Alt text]] takes the place of an image for text-only readers, including those using [[Wikipedia:Screen Reader|screen readers]]. Images should have an alt attribute added to the 'alt' parameter. See [[Wikipedia:Wikipedia:Alternative text of images|Wikipedia:Alternative text of images]] for more information. | ||
* To maintain visual harmony with the UniWiki's dark black background, consider using dark-themed images when possible. This helps integrate images seamlessly into the overall design, avoiding a stark contrast with the dark backdrop. | |||
=== Other media files === | === Other media files === | ||
| Line 1,222: | Line 1,212: | ||
* Captions for technical charts and diagrams may need to be substantially longer than those for other images. Captions for technical images should fully describe all the elements of the image and indicate the image's significance. | * Captions for technical charts and diagrams may need to be substantially longer than those for other images. Captions for technical images should fully describe all the elements of the image and indicate the image's significance. | ||
= Bulleted and numbered lists = | == Bulleted and numbered lists == | ||
{{main|UniWiki:Manual of Style/Lists|UniWiki:Manual of Style/Embedded lists}} | {{main|UniWiki:Manual of Style/Lists|UniWiki:Manual of Style/Embedded lists}} | ||
| Line 1,240: | Line 1,230: | ||
*** '''Other elements''', they are formatted consistently in either sentence case or lower case. | *** '''Other elements''', they are formatted consistently in either sentence case or lower case. | ||
= Links = | == Links == | ||
=== Wikilinks === | === Wikilinks === | ||
{{main|UniWiki:Manual of Style/Linking}} | {{main|UniWiki:Manual of Style/Linking}} | ||
:''See also: [[Wikipedia:Help:Link|Wikipedia:Links]]'' | :''See also: [[Wikipedia:Help:Link|Wikipedia:Links]]'' | ||
'''Make [[Wikipedia:Help:Link|links]] only where they are relevant and helpful in the context''': Excessive use of hyperlinks can be distracting and may slow the reader down. Redundant links (like the one in {{!xt|the tallest people on [[Wikipedia:Earth|Earth]]}}) clutter the page and make future maintenance harder. High-value links that | '''Make [[Wikipedia:Help:Link|links]] only where they are relevant and helpful in the context''': Excessive use of hyperlinks can be distracting and may slow the reader down. Redundant links (like the one in {{!xt|the tallest people on [[Wikipedia:Earth|Earth]]}}) clutter the page and make future maintenance harder. High-value links that ''are'' worth pursuing should stand out clearly. | ||
'''Linking to sections''': A hash sign (<code>#</code>) followed by the appropriate heading will lead to a relevant part of a page. For example, <code><nowiki>[[EVE University Management#Director of Operations]]</nowiki></code> links to a particular section of the article [[EVE University Management]]. | '''Linking to sections''': A hash sign (<code>#</code>) followed by the appropriate heading will lead to a relevant part of a page. For example, <code><nowiki>[[EVE University Management#Director of Operations]]</nowiki></code> links to a particular section of the article [[EVE University Management]]. | ||
| Line 1,259: | Line 1,248: | ||
External links should not normally be used in the body of an article. Instead, articles can include an ''External links'' section at the end, pointing to further information outside the UniWiki as distinct from citing sources. The standard format is a primary heading, <code>==External links==</code>, followed by a bulleted list of links. Identify the link and briefly indicate its relevance to the article. For example: | External links should not normally be used in the body of an article. Instead, articles can include an ''External links'' section at the end, pointing to further information outside the UniWiki as distinct from citing sources. The standard format is a primary heading, <code>==External links==</code>, followed by a bulleted list of links. Identify the link and briefly indicate its relevance to the article. For example: | ||
: <code><nowiki>* [https:// | : <code><nowiki>* [https://universe.eveonline.com/chronicles EVE Chronicles]</nowiki></code> | ||
: <code><nowiki>* [https://www.eveonline.com/ EVE Online homepage]</nowiki></code> | : <code><nowiki>* [https://www.eveonline.com/ EVE Online homepage]</nowiki></code> | ||
These will appear as: | These will appear as: | ||
:* [https:// | :* [https://universe.eveonline.com/chronicles EVE Chronicles] | ||
:* [https://www.eveonline.com/ EVE Online homepage] | :* [https://www.eveonline.com/ EVE Online homepage] | ||
One major exception to this guideline is when referencing in-game items that do not have an entry on the UniWiki. As of this writing, the UniWiki does not have an internal item database, nor does it have pages for most in-game items. Thus, in the event that a particular item must be referenced explicitly, it is acceptable to link to an available public database of items for this purpose. This should be done sparingly—most item references do not need to be linked. | One major exception to this guideline is when referencing in-game items that do not have an entry on the UniWiki. As of this writing, the UniWiki does not have an internal item database, nor does it have pages for most in-game items. Thus, in the event that a particular item must be referenced explicitly, it is acceptable to link to an available public database of items for this purpose. This should be done sparingly—most item references do not need to be linked. | ||
= Miscellaneous = | == Miscellaneous == | ||
=== Keep markup simple === | === Keep markup simple === | ||
| Line 1,286: | Line 1,274: | ||
* cause disputes, since other editors may disagree aesthetically with the choice of style. | * cause disputes, since other editors may disagree aesthetically with the choice of style. | ||
Outside article text, different font sizes are routinely used in navigation templates and [[Wikipedia:Wikipedia:Infobox|infoboxes]], tables (especially in larger ones), and some other contexts where alternatives are not available (such as table captions). Specify font sizes | Outside article text, different font sizes are routinely used in navigation templates and [[Wikipedia:Wikipedia:Infobox|infoboxes]], tables (especially in larger ones), and some other contexts where alternatives are not available (such as table captions). Specify font sizes ''relatively'' (for example in CSS with <code>font-size: 85%</code>) rather than ''absolutely'' (like <code>font-size: 8pt</code>). | ||
==== Color coding ==== | ==== Color coding ==== | ||
{{main|UniWiki:Manual of Style/Accessibility#Color}} | {{main|UniWiki:Manual of Style/Accessibility#Color}} | ||
Information should be accessible to all. Do not use color | Information should be accessible to all. Do not use color ''alone'' to mark differences in text: they may be invisible to people with [[Wikipedia:Color blindness|color blindness]]. Also, black-and-white printouts, older computer displays with fewer colors, and monochrome displays (older [[Wikipedia:Personal digital assistant|PDAs]] and cell phones) cannot show such distinctions. | ||
Choose colors that can be distinguished by the readers with the commonest form of colorblindness ([[Wikipedia:Color blindness#Red-green color blindness|red–green]]), such as [[maroon (color)|<span style="background: white; color: maroon">maroon</span>]] and [[teal|<span style="background: white; color: teal">teal</span>]]; and | Choose colors that can be distinguished by the readers with the commonest form of colorblindness ([[Wikipedia:Color blindness#Red-green color blindness|red–green]]), such as [[Wikipedia:maroon (color)|<span style="background: white; color: maroon">maroon</span>]] and [[Wikipedia:teal|<span style="background: white; color: teal">teal</span>]]; and ''additionally'' mark the differences with change of font or some other means ([[Wikipedia:maroon (color)|<span style="background: white; font-family: Georgia, serif; color: maroon; font face: Times New Roman">maroon and alternative font face</span>]], [[Wikipedia:teal|<span style="background: white; color: teal">teal</span>]]). Avoid low contrast between text and background colors. Viewing the page with [http://colorfilter.wickline.org/ Wickline] can help with the choice of colors. See also [[Wikipedia:Color coding|color coding]]. | ||
In addition to vision accessibility problems, usage of only color to encode attributes in tables (for example, Gold, Silver, or Bronze achievement levels) instead of a separate sortable column, disables the use of the powerful Wikitable sortability feature on that attribute for all readers. Even for readers with unimpaired color vision, excessive background shading of table entries impedes readability and recognition of Wikilinks. Background color should be used only as a | In addition to vision accessibility problems, usage of only color to encode attributes in tables (for example, Gold, Silver, or Bronze achievement levels) instead of a separate sortable column, disables the use of the powerful Wikitable sortability feature on that attribute for all readers. Even for readers with unimpaired color vision, excessive background shading of table entries impedes readability and recognition of Wikilinks. Background color should be used only as a ''supplementary'' visual cue, and should be subtle (consider using lighter, less-dominant [[Wikipedia:Pastel (color)|pastel]] hues) rather than a glaring spotlight. | ||
=== Scrolling lists and collapsible content === | === Scrolling lists and collapsible content === | ||
| Line 1,319: | Line 1,307: | ||
This notation can be inserted with a single click in ''Wiki markup'', just under the edit pane in edit mode. | This notation can be inserted with a single click in ''Wiki markup'', just under the edit pane in edit mode. | ||
=Notes= | == Notes == | ||
{{Reflist}} | {{Reflist}} | ||
{{UniWikiNav}} | |||
[[Category:Editing]] | |||
[[Category:UniWiki Manual of Style]] | |||