Help:Manual of Style: Difference between revisions
Dat Hack3r (talk | contribs) m (Made the abbreviation thing more concise.) |
Dat Hack3r (talk | contribs) m (I hate Template:tl.) |
||
(13 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
This '''Manual of Style''' ('''MoS''') is a brief style manual for all articles on this Wiki. When a MoS guideline offers a choice of style, use only one alternative consistently throughout an article, and do not unreasonably alter a choice that has already been made. If there are any changes or suggestions you think should be made to the MoS, visit the talk page to discuss them. | This '''Manual of Style''' ('''MoS''') is a brief style manual for all articles on this Wiki. When a MoS guideline offers a choice of style, use only one alternative consistently throughout an article, and do not unreasonably alter a choice that has already been made. If there are any changes or suggestions you think should be made to the MoS, visit the talk page to discuss them. This Wiki has [[Help:Editing guide#No firm rules|no firm rules]], but you should follow these suggestions whenever possible to create consistent articles and avoid conflicts or confusion. | ||
== | == Layout == | ||
A [[Wikipedia:Wikipedia:Stub#Creating and improving a stub article|simple article]] should have, at least, (a) a lead section and (b) references. The following list includes additional standardized sections in an article. A complete article need not have all, or even most, of these elements. For standardized sections in articles on certain subjects, see {{section link|Help:Editing guide|Subject-specific content guidelines}}. | |||
# Before the article content | |||
## {{tlx|DISPLAYTITLE}}, {{tlx|Lowercase title}}, {{tlx|Italic title}} (some of these may also be placed before the infobox or after the infobox) | |||
## [[:Category:Article stubs|Stub template]] | |||
## [[Wikipedia:Wikipedia:Hatnote|Hatnotes]] | |||
## {{tlx|Featured list}}, {{tlx|Featured article}} and {{tlx|Good article}} (where appropriate for article status) | |||
## Deletion / protection tags ([[:Category:Candidates for deletion|deletion]] notices) | |||
## [[Wikipedia:Wikipedia:Infoboxes|Infoboxes]] {{efn|It is important that hatnotes and maintenance/dispute tags appear on the first page of the article. On the mobile site, the first paragraph of the lead section is moved above the infobox for the sake of readability. Since the infobox is generally more than one page long, putting hatnotes, etc., after it will result in them being placed after the first page, making them less effective.}} | |||
## Images | |||
# Article content | |||
## [[Wikipedia:Wikipedia:Lead section|Lead section]] (also called the introduction) {{efn|'''Boldface''' is often applied to the first occurrence of the article's title word or phrase in the lead. This is also done at the first occurrence of a term, commonly a synonym in the lead, that redirects to the article or one of its subsections, whether the term appears in the lead or not.}} | |||
## [[MW:Manual:Table_of_contents|Table of contents]] | |||
## Body | |||
# Appendices | |||
## [[#"See also" section|See also]]{{efn|name=Syntax|1=Syntax: | |||
<syntaxhighlight lang="wikitext" style="color: #000000; background: #FFFFFF; padding: 1em; border: 1px solid #8FBC8F; font-size:111%;"> | |||
== See also == | |||
* [[Help:Editing_guide]]{{snd}}an overview page that will answer all your editing-related questions | |||
* [[Wikipedia:Help:Cheatsheet]]{{snd}}a page that provides the most commonly used wiki markup | |||
</syntaxhighlight> | |||
Which produces: | |||
<blockquote style="background: #FFFFFF; padding: 1em; border: 1px solid #999999; font-size:111%;"> | |||
{{fake heading|See also}} | |||
* [[Help:Editing_guide]]{{snd}}an overview page that will answer all your editing-related questions | |||
* [[Wikipedia:Help:Cheatsheet]]{{snd}}a page that provides the most commonly used wiki markup | |||
</blockquote>}} | |||
## Notes and references (this can be two sections in some citation systems) | |||
## External links{{efn|name=Syntax}} | |||
# {{anchor|End matter}}End matter | |||
## [[MW:Help:Categories|Categories]] | |||
== Capital letters == | |||
Use [[Wikipedia:Sentence case|sentence case]] for article titles and section headings{{spaced ndash}}{{xt|Tips and pointers}}, not {{!xt|Tips and Pointers}}. | |||
Capitalize names of scriptures like {{xt|Bible}} and {{xt|Qur'an}}, but not {{xt|biblical}}. Always capitalize {{xt|God}} when it refers to a primary or only deity, but not pronouns that refer to deities: {{xt|he}} not {{!xt|He}}. | Capitalize names of scriptures like {{xt|Bible}} and {{xt|Qur'an}}, but not {{xt|biblical}}. Always capitalize {{xt|God}} when it refers to a primary or only deity, but not pronouns that refer to deities: {{xt|he}} not {{!xt|He}}. | ||
Avoid capitalizing the names of plants and animals. Among the exceptions are scientific names ({{xt|''Felis catus''}}) and [ | Avoid capitalizing the names of plants and animals. Among the exceptions are scientific names ({{xt|''Felis catus''}}) and [[Wikipedia:Proper noun|proper noun]]s occurring as part of a name ({{xt|Norway rat}}). | ||
The seasons ({{xt|summer}}, {{xt|winter}}, {{xt|spring}}, and {{xt|fall}}/{{xt|autumn}}) are not capitalized. Similarly, the compass points ({{xt|north}}, {{xt|southwest}}) are not capitalized. | The seasons ({{xt|summer}}, {{xt|winter}}, {{xt|spring}}, and {{xt|fall}}/{{xt|autumn}}) are not capitalized. Similarly, the compass points ({{xt|north}}, {{xt|southwest}}) are not capitalized. | ||
Line 12: | Line 45: | ||
When in doubt about whether to capitalize something, default to lowercase. | When in doubt about whether to capitalize something, default to lowercase. | ||
==Abbreviations== | == Abbreviations == | ||
To indicate ''approximately'', the non-italicized abbreviation {{xt|c.}} (followed by a space) is preferred over {{!xt|circa}}, {{!xt|ca.}}, or {{!xt|approx.}} | To indicate ''approximately'', the non-italicized abbreviation {{xt|c.}} (followed by a space) is preferred over {{!xt|circa}}, {{!xt|ca.}}, or {{!xt|approx.}} | ||
Line 19: | Line 52: | ||
Use "{{xt|and}}" instead of the "{{!xt|&}}" sign, except in tables, infoboxes, and official names like {{xt|AT&T}}. | Use "{{xt|and}}" instead of the "{{!xt|&}}" sign, except in tables, infoboxes, and official names like {{xt|AT&T}}. | ||
==Punctuation== | == Punctuation == | ||
===Apostrophes and quotation marks=== | === Apostrophes and quotation marks === | ||
Use straight quote marks {{key press|"}} and apostrophes {{key press|'}} as available from the keyboard, and not alternatives such as {{!xt|“ ”}} and {{!xt|‘ ’}}. | Use straight quote marks {{key press|"}} and apostrophes {{key press|'}} as available from the keyboard, and not alternatives such as {{!xt|“ ”}} and {{!xt|‘ ’}}. | ||
Line 27: | Line 60: | ||
Write {{xt|James's house}}, not {{!xt|James' house}}. | Write {{xt|James's house}}, not {{!xt|James' house}}. | ||
===Periods and commas=== | === Periods and commas === | ||
Place a [ | Place a [[Wikipedia:Full stop|full stop]] (a period) or a comma ''before'' a closing quotation mark if it belongs as part of the quoted material; otherwise put it after: {{xt|The word ''carefree'' means "happy"<span style{{=}}"background:#bfb">.</span>}} But {{xt|She said, "I'm feeling carefree<span style{{=}}"background:#bfb">.</span>"}} (Please do so irrespective of any rules associated with the variety of English in use.) | ||
An [ | An [[Wikipedia:Ellipsis|ellipsis]] should be written as three separate dots ({{xt|...}}): not spaced ({{!xt|. . .}}), and not using the single-character option ({{!xt|…}}). | ||
The [ | The [[Wikipedia:Serial comma|serial comma]] (for example the comma before ''and'' in "ham, chips, and eggs") is optional; be sensitive to possible ambiguity from thoughtless use or thoughtless avoidance. | ||
Avoid [ | Avoid [[Wikipedia:Comma splice|comma splice]]s. | ||
Picture captions should not end in a full stop (a period) unless they are complete sentences. | Picture captions should not end in a full stop (a period) unless they are complete sentences. | ||
===Dashes and hyphens=== | === Dashes and hyphens === | ||
Avoid using a hyphen after a standard -ly adverb ({{xt|a newly available home}}). | Avoid using a hyphen after a standard -ly adverb ({{xt|a newly available home}}). | ||
A hyphen is not a [ | A hyphen is not a [[Wikipedia:Dash|dash]]. Hyphens are used within words or to join words, but not in punctuating the parts of a sentence. Use an en dash (–) with <code>&nbsp;</code> before and a space after; or use an em dash (—) without spaces. See Wikipedia's [[Wikipedia:Wikipedia:How_to_make_dashes|How to make dashes]]. Avoid using two hyphens {{nowrap|(--)}} to make a dash; and avoid using a hyphen for a minus sign. | ||
Use an en dash, not a hyphen, between numbers: {{xt|pp. 14–21}}; {{xt|1953–2008}}. An en dash is also to connect parallel terms: {{xt|red–green colorblind}}; {{xt|a New York–London flight}}. Use spaces around the en dash only if the connected terms are multi-unit dates: {{xt|January 1999{{spaced ndash}}December 2000}}. | Use an en dash, not a hyphen, between numbers: {{xt|pp. 14–21}}; {{xt|1953–2008}}. An en dash is also to connect parallel terms: {{xt|red–green colorblind}}; {{xt|a New York–London flight}}. Use spaces around the en dash only if the connected terms are multi-unit dates: {{xt|January 1999{{spaced ndash}}December 2000}}. | ||
== Dates and numbers == | == Dates and numbers == | ||
Write {{xt|number 1}} or {{xt|No. 1}}, but not {{!xt|#1}}. Comic books are an exception. Do not use the symbol {{!xt|№}}. | Write {{xt|number 1}} or {{xt|No. 1}}, but not {{!xt|#1}}. Comic books are an exception. Do not use the symbol {{!xt|№}}. | ||
Write {{xt|12,000}} for twelve thousand, not {{!xt|12.000}}. | |||
Both {{xt|10 June 1921}} and {{xt|June 10, 1921,}} are correct, but should be consistent within an article. A comma is not used if only the month is given, such as {{xt|June 1921}}. | |||
{{xt|400 AD}} (or {{xt|AD 400}}) and {{xt|400 BC}} are correct; but so are {{xt|400 CE}} and {{xt|400 BCE}}. As always, use one style consistently in an article. | |||
Except on pages that are inherently time-sensitive and updated regularly<!-- Here's a good idea: we should make one of these. (e.g. [[Wikipedia:How the Current events page works|the "Current events" portal]]) -->, terms such as {{!xt|now}}, {{!xt|today}}, {{!xt|currently}}, {{!xt|present}}, {{!xt|to date}}, {{!xt|so far}}, {{!xt|soon}}, {{!xt|upcoming}}, {{!xt|ongoing}}, and {{!xt|recently}} should usually be avoided in favor of phrases such as {{xt|during the 2010s}}, {{xt|since 2010}}, and {{xt|in August 2020}}. Wording can usually be modified to remove the "now" perspective: not {{!xt|she is the current director}} but {{xt|she became director on 1 January {{CURRENTYEAR}}}}; not {{!xt|2010{{ndash}}present}} but {{xt|beginning in 2010}} or {{xt|since 2010}}. Terms likely to go out of date include {{!xt|best known for}}, {{!xt|holds the record for}}, etc. For current and future events, use phrases such as {{xt|as of {{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} or {{xt|since the beginning of {{CURRENTYEAR}}}} to signal the time-dependence of the information; use the template {{tlx|as of}} (or {{tlx|updated}}) in conjunction. | |||
Use {{xt|one, two, three, ..., eight, nine}} in most cases, not {{!xt|1, 2, 3, 4, 5, 6, 7, 8, 9}} (exceptions include times and dates, equations, sport scores, most measurements, and data in tables). Use digits for {{xt|10}} and higher (though some such numbers also may be written as words, when it helps clarity). | |||
{{xt| | == Markup == | ||
Instead of an ordinary space, use <code>&nbsp;</code> (a ''non-breaking space'') to prevent a line from ending in the middle of expressions like {{xt|17 kg}}, {{xt|565 BCE}}, {{xt|2:50 pm}}, {{xt|£11 billion}}, {{xt|129 million}}, {{xt|{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}, {{xt|5° 24′ 21.12″ N}}, or {{xt|Boeing 747}}; also after the number in {{xt|123 Fake Street}}, and before [[Wikipedia:Roman_numerals|Roman numerals]] in {{xt|World War II}} and {{xt|Pope Benedict XVI}}. Use <code>&nbsp;</code> in the same way inside a wikilink. (An alternative: enclose the whole expression using the template {{tlx|nowrap}}.) | |||
It does not matter how many spaces come after a period because extra spaces will not show, although blank lines will create one extra line. | |||
Use [[Wikipedia:Hyperlink#Wikis|wikilinks]], but only for words and phrases that are most likely to be helpful if clicked. Make sure each link goes to an article on the intended subject, and not to a disambiguation page or incorrect destination. | |||
== References == | |||
There are multiple [[Wikipedia:Wikipedia:Citing sources|citation]] styles. The most common uses {{tag|ref}} (''ref tags'') to create footnotes (sometimes called endnotes or notes), which will appear in the reference or endnote section. This citation should immediately follow the text to which it applies, including any punctuation (with some exceptions). | |||
== Usage == | |||
Due to OWOT having an international user base, this Wiki prefers no major national variety of the language over any other. These varieties (e.g. [[Wikipedia:American English|U.S. English]], [[Wikipedia:British English|British English]]) differ in vocabulary (''soccer'' vs. ''football''), spelling (''center'' vs. ''centre''), and occasionally grammar. | |||
Avoid words like ''I'', ''we'', and ''you'', except in quotations and names of works. | |||
Avoid phrases like {{!xt|note that}} and {{!xt|remember that}} (which assume "you" for the reader); and avoid such expressions as {{!xt|of course}} and {{!xt|obviously}}. | |||
== See also == | |||
* [[Help:Editing guide]]{{snd}}an overview page that will answer all your editing-related questions | |||
* [[Wikipedia:Help:Cheatsheet]]{{snd}}a page that provides the most commonly used wiki markup | |||
== Notes == | |||
{{Notelist}} | |||
[[Category:OWOT Wiki basic information]] | [[Category:OWOT Wiki basic information]] |
Latest revision as of 14:53, 13 November 2024
This Manual of Style (MoS) is a brief style manual for all articles on this Wiki. When a MoS guideline offers a choice of style, use only one alternative consistently throughout an article, and do not unreasonably alter a choice that has already been made. If there are any changes or suggestions you think should be made to the MoS, visit the talk page to discuss them. This Wiki has no firm rules, but you should follow these suggestions whenever possible to create consistent articles and avoid conflicts or confusion.
Layout
A simple article should have, at least, (a) a lead section and (b) references. The following list includes additional standardized sections in an article. A complete article need not have all, or even most, of these elements. For standardized sections in articles on certain subjects, see Help:Editing guide § Subject-specific content guidelines.
- Before the article content
{{DISPLAYTITLE}}
,{{Lowercase title}}
,{{Italic title}}
(some of these may also be placed before the infobox or after the infobox)- Stub template
- Hatnotes
{{Featured list}}
,{{Featured article}}
and{{Good article}}
(where appropriate for article status)- Deletion / protection tags (deletion notices)
- Infoboxes [a]
- Images
- Article content
- Lead section (also called the introduction) [b]
- Table of contents
- Body
- Appendices
- End matter
Capital letters
Use sentence case for article titles and section headings – Tips and pointers, not Tips and Pointers.
Capitalize names of scriptures like Bible and Qur'an, but not biblical. Always capitalize God when it refers to a primary or only deity, but not pronouns that refer to deities: he not He.
Avoid capitalizing the names of plants and animals. Among the exceptions are scientific names (Felis catus) and proper nouns occurring as part of a name (Norway rat).
The seasons (summer, winter, spring, and fall/autumn) are not capitalized. Similarly, the compass points (north, southwest) are not capitalized.
When in doubt about whether to capitalize something, default to lowercase.
Abbreviations
To indicate approximately, the non-italicized abbreviation c. (followed by a space) is preferred over circa, ca., or approx.
Write US or U.S., but not USA. Use US, not U.S., in an article using UK, PRC, etc.
Use "and" instead of the "&" sign, except in tables, infoboxes, and official names like AT&T.
Punctuation
Apostrophes and quotation marks
Use straight quote marks " and apostrophes ' as available from the keyboard, and not alternatives such as “ ” and ‘ ’.
Italicize names of books, films, TV series, music albums, paintings, and ships—but not short works like songs or poems, which should be in quotation marks.
Write James's house, not James' house.
Periods and commas
Place a full stop (a period) or a comma before a closing quotation mark if it belongs as part of the quoted material; otherwise put it after: The word carefree means "happy". But She said, "I'm feeling carefree." (Please do so irrespective of any rules associated with the variety of English in use.)
An ellipsis should be written as three separate dots (...): not spaced (. . .), and not using the single-character option (…).
The serial comma (for example the comma before and in "ham, chips, and eggs") is optional; be sensitive to possible ambiguity from thoughtless use or thoughtless avoidance.
Avoid comma splices.
Picture captions should not end in a full stop (a period) unless they are complete sentences.
Dashes and hyphens
Avoid using a hyphen after a standard -ly adverb (a newly available home).
A hyphen is not a dash. Hyphens are used within words or to join words, but not in punctuating the parts of a sentence. Use an en dash (–) with
before and a space after; or use an em dash (—) without spaces. See Wikipedia's How to make dashes. Avoid using two hyphens (--) to make a dash; and avoid using a hyphen for a minus sign.
Use an en dash, not a hyphen, between numbers: pp. 14–21; 1953–2008. An en dash is also to connect parallel terms: red–green colorblind; a New York–London flight. Use spaces around the en dash only if the connected terms are multi-unit dates: January 1999 – December 2000.
Dates and numbers
Write number 1 or No. 1, but not #1. Comic books are an exception. Do not use the symbol №.
Write 12,000 for twelve thousand, not 12.000.
Both 10 June 1921 and June 10, 1921, are correct, but should be consistent within an article. A comma is not used if only the month is given, such as June 1921.
400 AD (or AD 400) and 400 BC are correct; but so are 400 CE and 400 BCE. As always, use one style consistently in an article.
Except on pages that are inherently time-sensitive and updated regularly, terms such as now, today, currently, present, to date, so far, soon, upcoming, ongoing, and recently should usually be avoided in favor of phrases such as during the 2010s, since 2010, and in August 2020. Wording can usually be modified to remove the "now" perspective: not she is the current director but she became director on 1 January 2024; not 2010–present but beginning in 2010 or since 2010. Terms likely to go out of date include best known for, holds the record for, etc. For current and future events, use phrases such as as of November 2024 or since the beginning of 2024 to signal the time-dependence of the information; use the template {{as of}}
(or {{updated}}
) in conjunction.
Use one, two, three, ..., eight, nine in most cases, not 1, 2, 3, 4, 5, 6, 7, 8, 9 (exceptions include times and dates, equations, sport scores, most measurements, and data in tables). Use digits for 10 and higher (though some such numbers also may be written as words, when it helps clarity).
Markup
Instead of an ordinary space, use
(a non-breaking space) to prevent a line from ending in the middle of expressions like 17 kg, 565 BCE, 2:50 pm, £11 billion, 129 million, November 2024, 5° 24′ 21.12″ N, or Boeing 747; also after the number in 123 Fake Street, and before Roman numerals in World War II and Pope Benedict XVI. Use
in the same way inside a wikilink. (An alternative: enclose the whole expression using the template {{nowrap}}
.)
It does not matter how many spaces come after a period because extra spaces will not show, although blank lines will create one extra line.
Use wikilinks, but only for words and phrases that are most likely to be helpful if clicked. Make sure each link goes to an article on the intended subject, and not to a disambiguation page or incorrect destination.
References
There are multiple citation styles. The most common uses <ref>...</ref>
(ref tags) to create footnotes (sometimes called endnotes or notes), which will appear in the reference or endnote section. This citation should immediately follow the text to which it applies, including any punctuation (with some exceptions).
Usage
Due to OWOT having an international user base, this Wiki prefers no major national variety of the language over any other. These varieties (e.g. U.S. English, British English) differ in vocabulary (soccer vs. football), spelling (center vs. centre), and occasionally grammar.
Avoid words like I, we, and you, except in quotations and names of works.
Avoid phrases like note that and remember that (which assume "you" for the reader); and avoid such expressions as of course and obviously.
See also
- Help:Editing guide – an overview page that will answer all your editing-related questions
- Wikipedia:Help:Cheatsheet – a page that provides the most commonly used wiki markup
Notes
- ↑ It is important that hatnotes and maintenance/dispute tags appear on the first page of the article. On the mobile site, the first paragraph of the lead section is moved above the infobox for the sake of readability. Since the infobox is generally more than one page long, putting hatnotes, etc., after it will result in them being placed after the first page, making them less effective.
- ↑ Boldface is often applied to the first occurrence of the article's title word or phrase in the lead. This is also done at the first occurrence of a term, commonly a synonym in the lead, that redirects to the article or one of its subsections, whether the term appears in the lead or not.
- ↑ 3.0 3.1 Syntax:
== See also == * [[Help:Editing_guide]]{{snd}}an overview page that will answer all your editing-related questions * [[Wikipedia:Help:Cheatsheet]]{{snd}}a page that provides the most commonly used wiki markup
Which produces:
- Help:Editing_guide – an overview page that will answer all your editing-related questions
- Wikipedia:Help:Cheatsheet – a page that provides the most commonly used wiki markup