View source for Help:Manual of Style

MyWikiBiz, Author Your Legacy — Friday November 22, 2024

← Help:Manual of Style

You do not have permission to edit this page, for the following reasons:

• The action you have requested is limited to users in one of the groups: Users, vuser.
• This page has been protected to prevent editing or other actions.
• You must confirm your email address before editing pages. Please set and validate your email address through your user preferences.

---

You can view and copy the source of this page.

If everyone follows this '''Manual of Style''', [[Directory:Centiare]] will be easier for readers and editors to use. However, different Centiare articles are written with different audiences in mind, and editors are free to adapt their style accordingly. This manual, along with the supplemental manuals linked from it, provides guidance for those seeking it, but does not prescribe rigid rules that must always be followed. {{style}} ==Which style to use== If this page does not specify which usage is preferred: * Use other reliable resources, such as the style guides listed below. * Discuss your problems or propose missing style guidance on [[Wikipedia talk:Manual of Style]]. * Simply look around. Open articles for editing to see how editors have put it together. Style guides that can be used on Centiare include ''[[The Chicago Manual of Style]]'' (from the [[University of Chicago Press]]) and [[Fowler's Modern English Usage|Fowler’s ''Modern English Usage'' (3rd edition)]] (from the [[Oxford University Press]]). ''Chicago'' also provides an online guide, the ''Chicago Manual of Style Online''. [http://www.chicagomanualofstyle.org/home.html] Style guides available at no cost are the ''Mayfield Electronic Handbook of Technical & Scientific Writing'' [http://www.imoat.net/handbook/] and the ''CMS Crib Sheet'' by Dr. Abel Scribe. [http://www.docstyles.com/cmscrib.htm] ==Article titles== {{main|Centiare:Naming conventions}} If possible, make the title the [[subject (grammar)|subject]] of the first sentence of the article (as opposed to putting it in the [[Predicate (grammar)|predicate]] or in a subsequent sentence). For example, write “This '''Manual of Style''' is a style guide” instead of “This style guide is known as ....”. Use the article title as early as possible in the article. Use boldface for the first (and only the first) appearance of the article title and any synonyms of the article title (including acronyms). Use three apostrophes to produce the boldface&nbsp;&ndash; <code><nowiki>'''article title'''</nowiki></code> produces '''article title'''</span>. This example illustrates the use of boldface in an article on [[Río de la Plata]]: <blockquote> The '''Río de la Plata''' (from [[Spanish language|Spanish]]: “River of [[Silver]]”), also known by the [[English language|English]] name '''River Plate''', as in the [[Battle of the River Plate]], or sometimes ('''La''') '''Plata River'''. </blockquote> Avoid other uses of boldface in the first paragraph, so the reader will not confuse the text with synonyms. As a general rule, do not put links in * the boldface title or synonym in the article’s first mention or * any section title. Follow the normal rules for italics in choosing whether to put part or all of the title in italics: <blockquote> '''''Tattoo You''''' is an album by [[The Rolling Stones]], released in [[1981]]. </blockquote> ==Sections and headings== {{main|Wikipedia:Manual of Style (headings)}} {{see also|Wikipedia:Guide to layout}} {{see also|Wikipedia:Lead section}} {{see also|Help:Section}} ===Markup=== Use the <tt>==</tt> (two equal signs) style markup for headings (also called ''section titles''), not the <nowiki>'''</nowiki> (triple apostrophes) used to make words appear '''boldface''' in [[Wikipedia:How_to_edit_a_page#Character_formatting|character formatting]]. Start with <tt>==</tt>, add the heading title, then end with <tt>==</tt>. This section's heading was created with the markup: :<code><nowiki>==Sections and headings==</nowiki></code> This subsection's heading was created with the markup: :<code><nowiki>===Markup===</nowiki></code> ===Wording=== Use ''sentence-style'' rather than ''headline-style'' capitalization: capitalize only the first letter of the first word and of any [[Noun#Proper nouns and common nouns|proper nouns]] in an article title or section title, leaving all other letters in lower case. For example, use the heading ''Rules and regulations'', not ''Rules and Regulations''. Avoid special characters in headings, such as an ampersand (&), a plus sign (+), curly braces ({}), or square braces ([]). In place of the ampersand, use the word ''and'' unless the ampersand is part of a formal name. Keep the heading short: headings with more than ten words may defeat their purpose. Avoid redundancy and unnecessary words in headings, such as articles (''a'', ''an'', and ''the''), [[pronoun]]s, and repetition of the article title. Do not give identical titles to different sections. Doing so would tend to confuse the reader, and would make it more difficult for any writer to create a section link to any such section except the first. ===Section management===<!-- if you change the section title, change the text correspondingly --> Be generous in adding sub-headings. They help readers to get an overview of the article and to find subtopics of interest. Create sub-headings if a section becomes too long, and choose appropriate sub-headings to aid in your exposition. Avoid changing section headings&nbsp;&mdash; that will break section-specific links from within the article or from other articles. If you link to a section, leave an editor's note to remind others that the section title is linked. List the names of the linking articles, so when the title needs changing, others can fix the links more easily. For example: <nowiki> <!-- </nowiki>This section is linked from [[Richard Dawkins]] and [[Daniel Dennett]]<nowiki> --> </nowiki>. If you refer to a section without linking, italicize the section name. For example, this paragraph is in the section on ''Section management''. If you link to a section, do not italicize the section name, unless it otherwise requires italics (for example, if it is the title of a book). Linking a term provides sufficient indication that you are using a term as a term, which is what you would otherwise use italics for. If you change a section title, you may be able to check for broken links. For example, at google.com you could search for ''wikipedia “section management”'' and have a fair chance of finding links to this section. ==Capital letters== {{main|Wikipedia:Manual of Style (capital letters)}} [[American English]] and [[British English]] sometimes differ in their inclination to use capitals. If possible, as with spelling, use rules appropriate to the cultural and linguistic context. In other words, do not enforce American rules on pages about Commonwealth topics or Commonwealth rules on pages about American topics. In regard to pages about other cultures, choose either style, but be consistent within the page itself. Initial capitals and all capitals should not be used for emphasis. For example, “aardvarks, which are Not The Same as anteaters” and “aardvarks, which are NOT THE SAME as anteaters” are both incorrect. Where wording cannot provide the emphasis, use italics (“aardvarks, which are ''not the same'' as anteaters”). ===Titles=== Titles such as ''president'', ''king'', or ''emperor'' start with a capital letter when used as a title (followed by a name): “President Nixon”, not “president Nixon”. When used generically, they should be in lower case: “De Gaulle was the French president.” The correct formal name of an office is treated as a proper noun. Hence: “Hirohito was Emperor of Japan.” Similarly, “Louis XVI was the French king” but “Louis XVI was King of France”, ''King of France'' being a title in that context. Likewise, capitalize royal titles: “Her Majesty” or “His Highness”. (Reference: ''[[Chicago Manual of Style]]'' 14th ed., 7.16; [http://www.guardian.co.uk/styleguide/page/0,5817,184841,00.html ''The Guardian Manual of Style''], “Titles” keyword.) Exceptions may apply for specific offices. In the case of “prime minister”, either both words begin with a capital letter or neither, except of course when the term begins a sentence. When using the term generically, do not capitalize it: “There are many prime ministers around the world.” When referring to a specific office, generally use uppercase: “The British Prime Minister is Tony Blair.” (A good rule of thumb is this: when the modifier is the definite article ''the'', use “Prime Minister”; when the modifier is the indefinite article ''a'', use “prime minister”. When there is no article, some style manuals recommend, for example, “British prime minister”.) For the use of titles and honorifics in biographical articles, see [[Wikipedia:Manual of Style (biographies)#Honorific_prefixes]]. ===Religions, deities, philosophies, doctrines, and their adherents=== Names of religions, whether as a noun or an adjective, and their followers start with a capital letter. The [[Latter Day Saint movement]] has particular complications — see [[Wikipedia:Manual of Style (Latter Day Saints)]] and [[Wikipedia:Naming conventions (Latter Day Saints)]]. Deities begin with a capital letter: ''God'', ''Allah'', ''Freya'', ''the Lord'', ''the Supreme Being'', ''the Messiah''. (Note that articles, such as “the” are not capitalized.) The same is true when referring to important religious figures, such as Muhammad, by terms such as ''the Prophet''. Transcendent ideas in the Platonic sense also begin with a capital letter: ''Good'' and ''Truth''. Pronouns referring to deities, or nouns (other than names) referring to any material or abstract representation of any deity, human or otherwise, do not begin with a capital letter. Thus while it is accepted correct usage to say, “He prayed to Wotan”; since ''Wotan'' in this case is a proper name, it is correctly capitalized, but the common use of gods in this sense is not capitalized. Thus one would ''not'' say "He prayed to the God Wotan," but instead would say "He prayed to the god Wotan." The following sentence would be correct usage: “It was thought that he prayed to God, but it turned out he prayed to one of the Norse gods.” Do not capitalize the names of types of mythical creatures, such as elves, fairies, nymphs and genies. The exception is some works of fantasy, such as those of [[J. R. R. Tolkien]], where initial capitals are used to indicate that the different categories of mythical creatures are being treated as ethnicities or races. Philosophies, theories, doctrines, and systems of thought do ''not'' begin with a capital letter, unless the name derives from a proper noun: lowercase ''republican'' refers to a system of political thought; uppercase ''Republican'' refers to a specific [[Republican Party]] (each party name being a proper noun). ===Calendar items=== The names of months, days, and holidays always begin with a capital letter: June, Monday, Fourth of July (when referring to the [[Independence Day (United States)|U.S. Independence Day]], otherwise July 4 or 4 July). Seasons, in almost all instances, are lowercased: “this summer was very hot”; “the winter solstice occurs about December 22”; “I’ve got spring fever.” They start with a capital letter when personified, therefore functioning as proper nouns: “I think Spring is showing her colors”; “Old Man Winter”. Dates normally should be followed by commas: “In 2001, Bob got married”, “On April 10, I will be having a party.” An exception is when they are used to modify other terms: “The 1993 edition has several errors.” ===Animals, plants, and other organisms=== {{main|Wikipedia:WikiProject Tree of Life#Article titles and common names|Wikipedia:Naming conventions (fauna)}} Capitalize the name of a genus but not the name of a species (and italicize both names): for example, the tulip tree is ''Liriodendron tulipifera''. Editors have hotly debated whether the common names of species should start with a capital letter, and this remains unresolved. As a matter of truce, both styles are acceptable (except for proper names), but create a [[Wikipedia:Redirect|redirect]] from the alternative form. ===Celestial bodies=== Names of other planets and stars are proper nouns and begin with a capital letter: “The planet Mars can be seen tonight in the constellation Gemini, near the star Pollux.” The words ''sun'', ''earth'', and ''moon'' are proper nouns when the sentence uses them in an astronomical context, but not elsewhere: so “The Sun is a main sequence star, with a spectral class of G2”; but “It was a lovely day and the sun was warm.” Note that these terms are proper nouns only when they refer to specific celestial bodies (our Sun, Earth and Moon): so “The Moon orbits the Earth”; but “Pluto’s moon Charon”. ===Directions and regions=== Regions that are proper nouns, including widely known expressions such as ''Southern California'', start with a capital letter. Follow the same convention for related forms: a person from the [[Southern United States]] is a ''Southerner''. Directions (''north'', ''southwest'', etc.) are not proper nouns and do not start with a capital letter. The same is true for their related forms: someone might call a road that leads north a ''northern'' road, compared to the [[Great North Road (United Kingdom)|Great North Road]]. If you are not sure whether a region has attained proper-noun status, assume it has not. ===Institutions=== Proper names of specific institutions (for example, [[Harvard University]], [[New York-Presbyterian Hospital]], [[George Brown College]], etc.) are proper nouns and require capitalization. However, the words for ''types'' of institutions (university, college, hospital, high school, etc.) do not require capitalization if they do not appear in a proper name: :Incorrect: ::The University offers programs in arts and sciences. :Correct: ::The university offers…'' or ''The University of Ottawa offers… ==Italics== {{further|[[Wikipedia:Manual of Style (text formatting)]]}} Use the <code><nowiki>''</nowiki></code> (italic) markup. Example: :<code><nowiki>''This is italic.''</nowiki></code> which produces: <div style="background-color: white"> :''This is italic.'' </div> Italics are mainly used to ''emphasize'' certain words. Italics for emphasis should be used ''sparingly''. They are also used in these other cases: ===Titles=== {{main|Wikipedia:Manual of Style (titles)}} Italics are used for the titles of works of literature and art. (The titles of articles, chapters, and other short works are not italicized but are enclosed in double quotation marks.) ===Words as words=== Use italics when writing about words as words or letters as letters (to indicate the [[use-mention distinction]]). For example: *''Deuce'' means ''two''. *The term ''panning'' is derived from ''panorama'', a word coined in [[1787]]. *The most common letter in English is ''e''. === Foreign terms === Wikipedia prefers italics for phrases in other languages and for isolated foreign words that do not yet have common use in the English language. Use anglicized spellings for such words, or use the native spellings if they use the [[Latin alphabet]] (with or without [[diacritic]]s). For example: “Reading and writing in Japanese requires familiarity with ''[[hiragana]]'', ''[[katakana]]'', ''[[kanji]]'', and sometimes ''[[romaji|r&#333;maji]]''.” [[Loan word]]s or phrases that have common use in English, however—[[praetor]], [[Gestapo]], [[samurai]], [[esprit de corps]]—do not require italicization. If looking for a good rule of thumb, do not italicize words that appear in an English language dictionary. Per the [[Wikipedia:Guide to writing better articles#Use other languages sparingly|guide to writing better Wikipedia articles]], use foreign words sparingly, and include native spellings in non-Latin scripts in parentheses. Native spellings in non-Latin scripts (such as [[Greek alphabet|Greek]] or [[Cyrillic alphabet|Cyrillic]]) should not be italicized at all, even where this is technically feasible; the difference of script suffices. ===Quotations in italics=== Do not put an entire quotation in italics just because it is a quotation. ===Italics within quotations=== Use italics inside quotations if the source material does, or if you want to add emphasis. If you do the latter, insert the editorial note "[emphasis added]" at the end of the quotation. For example: "Now cracks a noble heart. Good night sweet prince: And ''flights of angels'' sing thee to thy rest [emphasis added]". If the source uses italics for emphasis, and you want to stress that the emphasis is the source's and not yours, you can add [emphasis in original] after the quote. ==Acronyms and abbreviations== {{main|Wikipedia:Manual of Style (abbreviations)}} Do not assume that your reader is familiar with the acronym or abbreviation you are using. The standard writing style is to spell out the acronym or abbreviation on the first reference (wikilinked if appropriate) and then show the acronym or abbreviation after it, in parentheses. This tells readers they will probably find it later in the text and makes it easy for them to refer back to it. For example: <blockquote>The [[Ontario New Democratic Party|New Democratic Party]] (NDP) won the [[Ontario general election, 1990|1990 Ontario election]] with a significant majority. However, the NDP quickly became unpopular with the voters.</blockquote> If the term is already in parentheses, use ''or'' to indicate the acronym. For example: <blockquote>They first debated the issue in 1992 (at a convention of the New Democratic Party or NDP).</blockquote> It can also be helpful in a longer article to spell out the acronym or abbreviation for the reader again or to rewikify it if it has not been used for a while, especially at its first use in a major section. When abbreviating ''United States'', “U.S.” is the more common style in that country. When referring to the United States in a long abbreviation (USA, USN, USAF), periods should not be used. When including the United States in a list of countries, do not abbreviate the “United States” (for example, “France and the United States”, not “France and the U.S.”). [[MediaWiki|The software]] that Wikipedia runs on does not support [[HTML]] acronym or abbreviation elements (<code>&lt;acronym&gt;</code> or <code>&lt;abbr&gt;</code>), so these tags should not be inserted into the source. (See [[Mediazilla:671]].) Contemporary style omits many periods and spaces that were traditionally required. For example, ''PhD'' is preferred over ''Ph.D.'' or ''Ph. D.''. ==Quotations== Whenever reasonable, use the style that was used in the original text; do not alter it to conform to Wikipedia punctuation. An exception: when a quotation encloses a quotation, use the Wikipedia style of beginning with double-quotes outermost; working inward, alternate single-quotes with double-quotes. For example, you might quote an article that says, “She disputed his statement that ‘Voltaire never said “I disapprove of what you say, but I will defend to the death your right to say it”’”. Or applying this rule to a block quote (though passages this short would generally not be block-quoted), you might quote the article as saying <blockquote>She disputed his statement that “Voltaire never said ‘I disapprove of what you say, but I will defend to the death your right to say it’”.</blockquote> Here are two examples from the ''Chicago Manual of Style'' that show how to handle commas and capital letters at the beginning of a quote within a sentence: <blockquote> He said that “to have is to hold”. <p> She said, “Go now”. </blockquote> Avoid linking from within quotes, as doing so clutters the quotation, violates the principle of leaving quotations unchanged, and may mislead or confuse the reader. On the other hand, consider this example (quoted from John Adams): "If [[Aristotle]], [[Livy]], and [[James Harrington|Harrington]] knew what a republic was, the British constitution is much more like a republic than an empire". Every alternative to those links seems awkward. Format a long quote (over four lines) as a [[block quotation]], which Wikipedia will indent from both margins. Do not enclose the block quote in quotation marks. To format a block quotation, do not use the wiki indentation mark <code>:</code> &mdash; instead, use the [[HTML]] <code>&lt;blockquote&gt;</code> tag: &lt;blockquote> Four score and seven years ago, our fathers brought forth on this continent a new nation, conceived in Liberty, and dedicated to the proposition that all men are created equal. &lt;/blockquote> Result: <blockquote>Four score and seven years ago, our fathers brought forth on this continent a new nation, conceived in Liberty, and dedicated to the proposition that all men are created equal.</blockquote> By itself, <code>&lt;blockquote&gt;</code> does not properly format multiparagraph quotes, but you can remedy the problem by manually adding <code>&lt;p&gt;</code> tags between paragraphs. See [[Mediazilla:6200 |MediaWiki bug 6200]]. Except with well-known quotations (from Shakespeare, etc.), and those from the subject of the article or section, always name the person whom you quote for a full sentence or more. Name the person in the text, not in a footnote, unless the person is the subject of the article or is otherwise obvious. In the case of a famous line from a play in an article on the play, attribution is not necessary. ==Punctuation== In most cases, simply follow the usual rules of English punctuation. A few points where Wikipedia may differ from usual usage follow. ===Quotation marks=== With [[quotation marks]], we borrow one practice from U.S. usage and one from the rest of the world. The guideline is to use the double-quotes (“”) for most quotations — they are easier to read on the screen — and use single-quotes (‘’) for quotations nested within quotations. Starting with double-quotes is the U.S. custom. When punctuating quoted passages, include the [[punctuation mark]] inside the quotation marks ''only if'' the sense of the punctuation mark is part of the quotation (“logical” quotations). This is commonplace outside of the US. In the very rare case of a multi-paragraph quotation that is not block-quoted, put double-quotes at the beginning of each paragraph, but at the end of only the last paragraph. Examples: *Arthur said the situation “is deplorable”. (When a sentence fragment is quoted, [[full stop]] [period] is outside.) *Arthur said, “The situation is deplorable.” (When a complete sentence is quoted, period is inside.) *Martha asked, “Are you coming?” (When quoting a question, question mark is inside.) *Did Martha say, “Come with me”? (When questioning a quote, question mark is outside.) If you change the case of the initial letter of a quote, Wikipedia neither requires nor recommends that you follow the older convention of “[f]ormally indicating the case change with square brackets”. When the title of an article appearing in the lead paragraph requires quotation marks (for example, the title of a song or poem), the quotation marks should not be in boldface, as they are not part of the title: <blockquote>“'''Jabberwocky'''” is a nonsense poem by Lewis Carroll.</blockquote> Use quotation marks or block quotes to distinguish quotations from other text. Quotations should not be italicized unless the material otherwise calls for italics (emphasis, use of non-English words, etc.). ==== Long quotations ==== Long quotations (more than four lines) may be rendered as [[block quotation]]s, without quotation marks or italics. A long quotation is indented by using <nowiki> <blockquote> </blockquote> </nowiki> notation, which indents both left and right margins (see [[#Quotations]]). ==== Look of quotation marks and apostrophes ==== There are two options when considering the look of the quotation marks themselves (your keyboard probably does not have keys for both): * [[Quotation_mark#Quotation marks in English|Typographic]] <big><b>“</b>text<b>”, ‘</b>text<b>’</b></big> * [[Quotation_mark#Typewriter quotation marks|Typewriter]] <big><b>"</b>text<b>", '</b>text<b>'</b></big> As there is no consensus in Wikipedia on which should be preferred, either is acceptable. If quotation marks or apostrophes appear in article titles, ensure that there is a redirect with the other type of glyphs. Never use [[grave accent|grave]] and [[acute accent]]s or backticks (<big><b>`</b>text<b>´</b></big>) as quotation marks or apostrophes. ==== Quotation marks affect searching ==== If a word or phrase appears in an article in single-quotes, such as 'abcd', the [[Wikipedia:Searching]] facility considers the single-quotes to be part of the word and will find that word or phrase only if the search string is also within single-quotes. (When trying this out with the example mentioned, remember that this article is in the Wikipedia namespace.) Avoiding this complication is an additional reason to use double-quotes, for which the difficulty does not arise. It may even be a reason to use double-quotes for quotations within quotations. === Brackets === A bracketed phrase is enclosed by the punctuation of a sentence (as shown here). (But one or more sentences wholly inside brackets have their punctuation inside the brackets.) These rules apply to square “[ ]” as well as round “( )” brackets ([[parentheses]]). If sets of brackets must be nested, use the contrasting type (normally square brackets appear within round brackets [parentheses]). Or reduce clutter by replacing brackets appropriately with commas or semicolons or colons&nbsp;&mdash; or em-dashes. Avoid adjacent sets of brackets&nbsp;&mdash; either put the parenthetic phrases in one set separated by commas, or rewrite the sentence. For example, this sentence: * Nikifor Grigoriev (c. 1885–1919) (also known as Matviy Hryhoriyiv) was a Ukrainian insurgent leader. would be better written as either of these: * Nikifor Grigoriev (c. 1885–1919), also known as Matviy Hryhoriyiv, was a Ukrainian insurgent leader. * Nikifor Grigoriev (c. 1885–1919) was a Ukrainian insurgent leader. He was also known as Matviy Hryhoriyiv. ===Serial commas=== The [[serial comma]] (also known as the ''Oxford comma'' or ''Harvard comma'') is a comma used immediately before a conjunction in a list of three or more items. The phrase “ham, chips, and eggs” is written with a serial comma, but “ham, chips and eggs” is not. Sometimes omitting the comma can lead to an ambiguous sentence, as in this example: “The author would like to thank her parents, Sinéad O’Connor and President Bush.” Sometimes including the comma can also lead to an ambiguous sentence, as in: “The author would like to thank her mother, Sinéad O’Connor, and President Bush” which may be a list of either two or three people. In such cases, there are three options for avoiding ambiguity: * A choice can be made whether to use or omit the comma after the penultimate item in such a way as to avoid ambiguity. * The sentence can be recast to avoid listing the items in an ambiguous manner. * The items in the list can be presented using a formatted list. If the presence of the final serial comma does not affect ambiguity of the sentence (as in most cases), there is no Wikipedia consensus on whether it should be used. <!-- can someone double check Fowler? the rule here seems to be Brit = no comma, Amer = comma --> <!-- checked: it is recommended in Fowler’s since the 1920s, and is not particularly a transatlantic division, as associations with both Harvard and Oxford show --> Some style authorities support a mandatory final serial comma. These include Fowler’s ''[[Fowler's Modern English Usage|Modern English Usage]]'' (Brit.), the ''[[Chicago Manual of Style]]'' (Amer.), and [[Strunk and White]]’s ''[[The Elements of Style|Elements of Style]]'' (Amer.). Others recommend avoiding it where possible; these include ''[[The Times]]'' (Brit.), ''[[The New York Times]]'' (Amer.) and ''[[The Economist]]'' (Brit.). See [[serial comma]] for further authorities and discussion. Proponents of the serial comma, such as ''The Elements of Style'', cite its disambiguating function and consistency as reasons for its use. Opponents consider it extraneous in situations where it does not explicitly resolve ambiguity. Many non-journalistic style guides recommend its use, while many newspaper style guides discourage its use; Wikipedia, by having no consensus, allows either style and therefore enables the avoidance of ambiguity. By convention, the names of railroads and railways do not employ the serial comma (for example, [[Cleveland, Cincinnati, Chicago and St. Louis Railroad]]). This is also the standard for [[law firm]]s and similar corporate entities (for example, [[Skadden, Arps, Slate, Meagher & Flom]]). ===Colons=== [[Colon (punctuation)|Colons]] ( : ) should not have spaces before them: :Correct: ::He attempted it in two years: 1941 and 1943 :Incorrect: ::He attempted it in two years : 1941 and 1943 ===Dashes=== {{main|Wikipedia:Manual of Style (dashes)}} The hyphen (-) is used to form compound words. The en-dash (–) is used to specify numeric ranges. The em-dash (—) can be used to link clauses of a sentence, as can the spaced en dash ( – ); see [[Wikipedia:Manual of Style_(dashes)|main article]]. Other dashes, notably the double-hyphen (--), should be avoided. ===Spaces after the end of a sentence=== There are no guidelines on whether to use one space after the end of a sentence, or two ([[French spacing (English)|French spacing]]), but the issue is not important as the difference shows up only in the edit box. See [[Wikipedia talk:Manual of Style archive (spaces after a full stop/period)|Wikipedia talk: Manual of Style archive (spaces after the end of a sentence)]] for a discussion on this. ===Contractions=== In general, formal writing is preferred. Therefore, avoid the use of contractions&nbsp;— such as ''don’t'', ''can’t'', ''won’t'', ''would’ve'', ''they’d'', and so on — unless they occur in a quotation. ===Slashes=== Avoid joining two words by a slash, as it suggests that they are related, but does not say how. Spell it out to avoid ambiguities. Also, the construct ''and/or'' is awkward outside of legal writing. Use “x or y or both”, to explicitly conjoin with the inclusive ''or'', or “either x or y, but not both”, to explicitly specify the exclusive ''or''. ===Ellipses=== An ''[[ellipsis]]'' is a series of three dots (periods) indicating omitted text. The pre-composed ellipsis character (&amp;hellip; … ) may be used: it displays three dots, but it looks a bit different in some fonts, so it may be better just to type the dots. To prevent the ellipsis from wrapping to the beginning of a line, regardless of where the line breaks of the reader’s browser fall, enter a non-breaking space before it (&amp;nbsp;... ). Examples: ''in the middle of your sentence&nbsp;… or after your comma,&nbsp;… or before one…, or at the end of your sentence…. In your question…? Or even your exclamation…!'' Note that square brackets indicate editorial replacements as well as editorial insertions. For example, suppose that a source says “X contains Y. Under certain circumstances, X may contain Z as well.” Then it is correct to quote this work as saying “X contains Y [and sometimes] Z” (without ellipsis). ==Pronunciation== {{main|Wikipedia:Manual of Style (pronunciation)}} ==Scientific style== {{main|Wikipedia:Technical terms and definitions}} *For [[Units of measurement|unit]]s of measure, use [[SI]] units as the main units in science articles, unless there are compelling historical or pragmatic reasons not to do so (for example, [[Hubble's constant|Hubble’s constant]] should be quoted in its most common unit of ([[Kilometre|km]]/[[Second|s]])/[[Megaparsec|Mpc]] rather than its SI unit of s⁻¹). For other articles, [[Imperial unit|Imperial]], [[United States customary units |U.S. customary]], or [[Metric system|metric]] units may be used as the main units of measurement. See [[Wikipedia:Manual of Style (dates and numbers)#Units of measurement]] for further guidance. The Wikipedia rule for commas and periods in numbers is, for example 12,345,678.901 &mdash; contrary to Continental style. *In articles about [[chemical]]s and [[chemistry]], use the style of the [[IUPAC|International Union of Pure and Applied Chemistry]] (IUPAC) for chemical names wherever possible except in article titles, where the common name should be used if different followed by mention of the IUPAC name. For general information see [[systematic name]], and for organic compounds in particular see [[IUPAC nomenclature]]. *In [[periodic table group]]s, use the <!--if you want to say “new” here, please follow the section in this manual about avoiding the word ''new''-->IUPAC names (these use [[Arabic numerals|Hindu-Arabic numerals]], not [[Roman numerals]] or letters). *For [[mathematics]] and [[mathematical formula]]e, see [[Wikipedia:WikiProject Mathematics]]. ==Simple tabulation== Lines that start with blank spaces are boxed and displayed in a fixed-width font, for simple tabulation. foo bar baz alpha beta gamma A line that contains only a blank space inserts a blank line into the table. For a complete guide to more complex tables see [[:Meta:Help:Table]]. ==Usage and spelling== ===Usage=== *Possessives of singular nouns ending in "s" should generally maintain the additional "s" after the [[Apostrophe#Possessive_forms_of_nouns_ending_in_s|apostrophe]]. However, if a form without an "s" after the apostrophe is much more common for a particular word or phrase, follow that form, such as with "Moses' Laws" and "Jesus' tears". *[[List of Latin abbreviations|Abbreviations of Latin terms]] like "[[i.e.]]", "[[e.g.]]", or "[[n.b.]]", or use of the Latin terms in full, such as "[[nota bene]]", or "[[List_of_Latin_phrases_(P–Z)#V|vide infra]]", should be left as the original author wrote them. However, articles intended for a general audience will be more widely understood if English terms such as "that is", "for example", or "note" are used instead. *Use an unambiguous word or phrase in preference to an ambiguous one. For example, use "other meaning" rather than "alternate meaning" or "alternative meaning", since "alternate" means only "alternating" to a British-English speaker, and "alternative" suggests "nontraditional" or "out-of-the-mainstream" to an American-English speaker. ===Avoid first-person pronouns and ''one''=== Wikipedia articles must not be based on one person’s opinions or experiences. Thus, “I” can never be used except, of course, when it appears in a quotation. For similar reasons, avoid the use of “we” and “one”. A sentence such as “We [or One] should note that some critics have argued in favor of the proposal” sounds more personal than encyclopedic. Nevertheless, it is sometimes appropriate to use “we” or “one” when referring to an experience that ''anyone'', any reader, would be expected to have, such as general perceptual experiences. For example, although it might be best to write, “When most people open their eyes, they see something”, it is still legitimate to write, “When we open our eyes, we see something”, and it is certainly better than using the [[passive voice]]: “When the eyes are opened, something is seen.” It is also acceptable to use “we” in mathematical derivations; for example: “To [[Normalisation_of_a_wavefunction|normalize the wavefunction]], we need to find the value of the arbitrary constant ''A''.” ===Avoid second-person pronouns=== Use of the second person (“you”), which is often ambiguous and contrary to the tone of an encyclopedia, is discouraged. Instead, refer to the subject of the sentence, for example: :Good: ::When a player moves past “go”, that player collects $200. :Good: ::Players passing “go” collect $200. :Bad: ::When you move past “go”, you collect $200. This guideline does not apply to quoted text, which should be quoted exactly. The guideline also does not apply to the Wikipedia namespace, where ''you'' refers to the writers to whom articles in the namespace are addressed. ==National varieties of English== {{see also|Wikipedia:Manual of Style (spelling)}} Cultural clashes over grammar, spelling, and capitalisation/capitalization are a common experience on Wikipedia. Remember that millions of people have been taught to use a form of English different from yours, including different spellings, grammatical constructions, and punctuation. For the English Wikipedia, while a nationally predominant form should be used, there is no preference among the major national varieties of English; none is more “correct” than any other. However, there is certain etiquette generally accepted on Wikipedia, as listed here. They are roughly in order of importance; guidelines earlier in this list will usually take precedence over guidelines later: * '''Articles should use the same dialect throughout.''' ** Each article should have uniform spelling and not a haphazard mix of different spellings, which can be jarring to the reader. For example, do not use ''center'' in one place and ''centre'' in another in the same article (except in quotations or for comparison purposes). ** If an article is predominantly written in one type of English, aim to conform to that type rather than provoking conflict by changing to another. (Sometimes, this can happen quite innocently, so please [[Wikipedia:Please do not bite the newcomers|do not be too quick to make accusations]]!) * '''If there is a strong tie to a specific region/dialect, use that dialect.''' ** Proper names should retain their original spellings, for example, ''[[United States Department of Defense]]'' and ''[[Australian Defence Force]]''. ** Articles that focus on a topic specific to a particular English-speaking country should generally conform to the usage and spelling of that country. For example: *** [[American Civil War]]: [[American English]] usage and spelling *** Tolkien’s ''[[The Lord of the Rings]]'': [[British English]] usage and spelling *** [[Uluru]] (Ayers Rock): [[Australian English]] usage and spelling *** [[List of European Union institutions|European Union institutions]]: British, [[Hiberno-English|Irish]] and Maltese English usage and spelling *** The city of [[Montreal]]: [[Canadian English]] usage and spelling *** [[Taj Mahal]]: [[Indian English]] usage and spelling. * '''Try to find words that are common to all.''' ** In choosing words or expressions (especially article titles) there may be value in selecting one that does not have multiple variant spellings if there are synonyms that are otherwise equally suitable and reasonable. In extreme cases of conflicting names, a contrived substitute (such as [[fixed-wing aircraft]]) is acceptable. ** If the spelling appears in an article name, you should make [[Wikipedia:Redirect|redirect]] pages to accommodate the other variants, as with [[Artefact]] and [[Artifact]]. * '''Follow the dialect of the first contributor.''' ** If all else fails, consider following the spelling style preferred by the first major contributor (that is, not a [[Wikipedia:Stub|stub]]) to the article. For reference on different dialects, consult Wikipedia articles such as [[English plural]] and [[American and British English differences]]. Finally, in the event of conflicts on this issue, please remember that if the use of ''your'' preferred version of English seems like a matter of great national pride to you, the differences are actually relatively minor when you consider the many users who are not native English speakers at all and yet make significant contributions to the English-language Wikipedia, or how small the differences between national varieties are compared with other languages. There are many more productive and enjoyable ways to participate than worrying and fighting about which version of English to use on any particular page. ==Big, little, long, short== Try to use accurate measurements whenever possible. Use specific information. :Good: ::The average male wallaby is 1.6 metres from head to tail. :Bad: ::The wallaby is small. :Good: ::The cyanobacterium ''Prochlorococcus marinus'' is 0.5 to 0.8 micrometres across. :Bad: ::''Prochlorococcus marinus'' is a tiny cyanobacterium. :Good: ::The dugong swam down the coast in a herd five kilometres long and 300 metres wide. :Bad: ::The huge herd of dugong stretched a long way down the coast. ==Images== Some general guidelines which should be followed in the absence of a compelling reason not to: *Start the article with a right-aligned image. *When using multiple images in the same article, they can be staggered left-and-right (Example: [[Timpani]]). *Avoid sandwiching text between two images facing each other. *Generally, right-alignment is preferred to left- or center-alignment. (Example: [[Race]]). **''Exception:'' Portraits with the head looking to the right should be left-aligned (looking into the text of the article) when this does not interfere with navigation or other elements. In such cases it may be appropriate to move the Table of Contents to the right by using <nowiki>{{TOCright}}</nowiki>. Since faces are not perfectly symmetrical it is generally inadvisable to use photo editing software to reverse a right-facing portrait image; however, some editors employ this controversial technique when it does not alter obvious non-symmetrical features (such as [[Mikhail Gorbachev]]’s birthmark) or make included text in the image unreadable. *If there are too many images in a given article, consider using a gallery. *Do not place left-aligned images directly below second-level (<code>===</code>) headings, as this disconnects the heading from the text it precedes. Instead, place the image directly above the heading. For example, use: <nowiki>[[Image:Image relating to section 1a.jpg|frame|left|]]</nowiki> === Section 1a === First paragraph of section 1a. : not: === Section 1a === <nowiki>[[Image:Image relating to section 1a.jpg|frame|left|]]</nowiki> First paragraph of section 1a. *Use {{[[Template:Commons|Commons]]}} to link to more images on Commons, wherever possible. *Use captions to explain the relevance of the image to the article. *In most cases the size of images should not be hardcoded.<!-- As per [[Wikipedia:Extended image syntax]]. --> The current image markup language is more or less this: <code><nowiki>[[Image:picture.jpg|120px|right|thumb|Insert caption here]]</nowiki></code> {{see|Wikipedia:Picture tutorial}} ==Captions== {{main|Centiare:Captions}} Photos and other graphics should have captions unless they are “self-captioning”, as in reproductions of album or book covers, or when the graphic is an unambiguous depiction of the subject of the article. For example, in a biography article, a caption is not needed for a portrait of the subject pictured alone; however, most entries use the name of the subject and the birth and death years and an approximation of the date when the image was taken: “John Smith (1812–95) circa 1880” or “John Smith (1812–95) on January 12, 1880 in Paris”. Complete sentences in captions should always end in a period (or other appropriate punctuation). If the caption is not a complete sentence, it generally should not have a period at the end. Captions should not be italicized unless they are book titles or related material. The caption always starts with a capital letter. Remember that the full information concerning the image is contained in the image entry, so people looking for more information can click on the photo to see the full details. ==Bulleted lists== Do not use bullets if the passage reads easily using plain paragraphs or indented paragraphs. If every paragraph in a section is bulleted, it is likely that none should be bulleted. Do not mix grammatical styles in a list&nbsp;&ndash; either use all complete sentences or use all sentence fragments. Begin each item with a capital letter, even if it is a sentence fragment. When using complete sentences, provide a period at the end of each. When using sentence fragments, do not provide a period at the end. ==Numbered lists== All the rules for bulleted lists apply also to numbered lists. Use numbered rather than bulleted lists only if you will be referring back to items by number, or the sequence of the items is critical (for example, you are explaining step 1, step 2, etc. of a multi-step process). ==Identity== This is perhaps an area where Wikipedians’ flexibility and plurality are an asset, and where we would not want all pages to look exactly alike. Wikipedia’s [[Wikipedia:Neutral point of view|neutral point of view]] and [[Wikipedia:No original research|no original research]] policies always take precedence. However, here are some nonbinding guidelines that may help: *Where known, use terminology that subjects use for themselves ([[self-identification]]). This can mean using the term an individual uses for himself or herself, or using the term a group most widely uses for itself. This includes referring to [[transgender]] individuals according to the names and pronouns they use to identify themselves. *Use specific terminology: People from Ethiopia (a country in Africa) should be described as Ethiopian, not African. *Do not assume that any one term is the most [[inclusive]] or [[accurate]]. *If possible, terms used to describe people should be given in such a way that they [[grammatical modifier|qualify]] other nouns. Thus, ''black people'', not ''blacks''; ''gay people'', not ''gays''; and so forth. *Also note: The term ''Arab'' refers to people and things of ethnic Arab origin. The term ''Arabic'' refers to the Arabic language or [[writing system]] (and related concepts). For example, “Not all Arab people write or converse in Arabic, but nearly all are familiar with Arabic numerals.” *In a direct quotation, use the original text, even if the originator does not conform with the above guidelines. ==Wikilinking== {{main|Wikipedia:Manual of Style (links)|Wikipedia:Only make links that are relevant to the context}} Make only [[Help:Contents/Links|links]] relevant to the context. It is not useful and can be very distracting to mark all possible words as hyperlinks. Links should add to the user’s experience; they should not detract from it by making the article harder to read. A high density of links can draw attention away from the high-value links that you would like your readers to follow up. Redundant links clutter up the page and make future maintenance harder. A link is the equivalent of a footnote in a print medium. Imagine if every second word in an encyclopedia article were followed by “(see:)”. Hence, the links should not be so numerous as to make the article harder to read. Check links after they are wikified to make sure they direct to the correct concept; many dictionary words lead to disambiguation pages and not to complete articles on a concept. If an anchor into a targeted page (the label after a pound sign (#) in a URL) is available, is likely to remain stable, and gets the reader to the relevant area significantly faster, then use it. When wikilinks are rendered as URLs by the [[MediaWiki]] software, the initial character becomes capitalized and spaces are replaced by underscores. When including wikilinks in an article, there is no need to use capitalization or underscores, since the software produces them automatically. This feature makes it possible to avoid a [[:Help:piped link|piped link]] in many cases. The correct form in English orthography can be used as a straight link. Wikilinks that begin sentences or are proper nouns should be capitalized as normal. ==Miscellaneous notes== ===Keep markup simple=== Use the simplest markup to display information in a useful and comprehensible way. Markup may appear differently in different browsers. Use HTML and CSS markup sparingly and only with good reason. Minimizing markup in entries allows easier editing. In particular, do not use the CSS <code>float</code> or <code>line-height</code> properties because they break rendering on some browsers when large fonts are used. ===Formatting issues=== Formatting issues such as font size, blank space and color are issues for the Wikipedia site-wide [[Cascading Style Sheets|style sheet]] and should not be dealt with in articles except in special cases. If you absolutely must specify a font size, use a relative size, that is, <code>font-size: 80%</code>; not an absolute size, for example, <code>font-size: 8pt</code>. It is also almost never a good idea to use other style changes, such as font family or color. Typically, the usage of custom font styles will * reduce consistency — the text will no longer look uniform with typical text; * reduce usability — it will likely be impossible for people with custom stylesheets (for accessibility reasons, for example) to override it, and it might clash with a different skin as well as bother people with [[color blindness]]; and * increase arguments — there is the possibility of other Wikipedians disagreeing with choice of font style and starting a debate about it for aesthetic purposes. For such reasons, it is typically not good practice to apply inline CSS for font attributes in articles. ==== Color coding ==== {{main|Wikipedia:Accessibility}} Using color ''alone'' to convey information ([[color coding]]) should not be done. This is not accessible to people with [[color blindness]] (especially [[monochromacy]]), on black-and-white printouts, on older monitors with fewer colors, on monochrome displays ([[Personal digital assistant|PDAs]], [[cell phone]]s), and so on. If it is necessary to use colors, try to choose colors that are unambiguous (such as <font color=orange>orange</font> and <font color=violet>violet</font>) when viewed by a person with [[Color_blindness#Red-green_color_blindness|red-green color blindness]] (the most common type). In general, this means that shades of red and green should not both be used as color codes in the same image. Viewing the page with [http://www.vischeck.com/vischeck/vischeckURL.php Vischeck] can help with deciding if the colors should be altered. It is certainly desirable to use color as an aid for those who can see it, but the information should still be accessible without it. ===Invisible comments=== Invisible comments are used to communicate with other editors in the article body. These comments are only visible when editing the page. They are invisible to ordinary readers. Normally if an editor wants to discuss issues with other potential editors, they will do it on the talk page. However, it sometimes makes more sense to put comments in the article body, because an editor would like to leave instructions to guide other editors when they edit this section, or leave reminders on specific issues (for example, do not change the section title since others have linked here). To do so, enclose the text which you intend to be read only by editors within <code>&lt;!--</code> and <code>--&gt;</code>. For example, the following: :<code>Hello &lt;!-- This is a comment. --&gt; world.<br/></code> is displayed as: :Hello <!-- This is a comment. --> world. So the comment can be seen when viewing the wiki source (although not, incidentally, the HTML source). Note: Comments may introduce unwanted whitespace when put on certain places, such as the top of an article. Avoid placing comment fields in places where they might change the rendered result of the article. ===Legibility=== Consider the [[wiktionary:legible|legibility]] of what you are writing. Make your entry easy to read on a screen. Make judicious use of devices such as bulleted lists and boldface. For more on this, see [http://www.useit.com/alertbox/9710a.html “How Users Read on the Web”] by [[Jakob Nielsen (usability consultant)|Jakob Nielsen]]. ==External links== {{main|Wikipedia:External links}} Links to websites outside of Wikipedia can be listed at the end of an article or embedded within the body of an article. === List of links === The standard format for a list of links is to have a header named <code><nowiki>== External links ==</nowiki></code> followed by a bulleted list of links. External links should summarize the website’s contents, and indicate why the website is relevant to the article. For example: :<code><nowiki>*[http://www.aidsnews.org/ AIDS treatment news]</nowiki></code> When wikified, the link will appear as: *[http://www.aidsnews.org/ AIDS treatment news] === Embedded links === {{main|Wikipedia:Citing sources}} External links can be embedded in the body of an article to provide specific references. These links have no description other than an automatically generated number. For example: :<code><nowiki>Sample text [http://www.example.com]</nowiki></code>. When wikified, the link will appear as: :Sample text [http://www.example.com]. An embedded external link should be accompanied by a [[Wikipedia:Citing sources#How and where to cite sources|full citation]] in the article’s References section. ====Footnotes==== {{main|Wikipedia:Footnotes}} The References or Notes section can have a code which will copy your embedded link (with its external link, description and/or quote), into the References or Notes section and make it a functioning link there. Do not use this code with an embedded link alone; use it only if you're adding a citation or description of the link. Here is a demonstration: The embedded link format can look like this: : <code><nowiki><ref name="test1">[http://www.qqwxyz.com The name of your external link goes here.] Further explanation can go here.</ref></nowiki></code> It will produce this: <ref name="test1">[http://www.qqwxyz.com The name of your external link goes here.] Further explanation can go here.</ref> <nowiki>In the "References" section</nowiki> the code can look like this: : <code><nowiki><div class="references-small"><references/></div></nowiki></code> It will produce this copy of the embedded link you have made above: <div class="references-small"><references/></div> NOTE: The code will place all properly formatted references on the page here. ==Submanuals== {{col-start}} {{col-break}} * [[Wikipedia:Manual of Style (abbreviations)|Abbreviations]] * [[Wikipedia:Manual of Style (biographies)|Biographies]] * [[Wikipedia:Manual of Style (capital letters)|Capital letters]] * [[Wikipedia:Manual of Style (command-line examples)|Command-line examples]] * [[Wikipedia:Manual of Style (dashes)|Dashes]] * [[Wikipedia:Manual of Style (dates and numbers)|Dates and numbers]] * [[Wikipedia:Manual of Style (disambiguation pages)|Disambiguation pages]] * [[Wikipedia:Manual of Style (headings)|Headings]] * [[Wikipedia:Manual of Style (Latter Day Saints)|Latter Day Saints]] * [[Wikipedia:Manual of Style (legal)|Legal]] * [[Wikipedia:Manual of Style (links)|Links]] {{col-break}} * [[Wikipedia:Manual of Style (lists of works)|Lists of works]] * [[Wikipedia:Manual of Style (mathematics)|Mathematics]] * [[Wikipedia:Manual of Style (music)|Music]] * [[Wikipedia:Manual of Style (national varieties of English)|National varieties of English]] * [[Wikipedia:Manual of Style (pronunciation)|Pronunciation]] * [[Wikipedia:Manual of Style (spelling)|Spelling]] * [[Wikipedia:Manual of Style (text formatting)|Text formatting]] * [[Wikipedia:Manual of Style (titles)|Titles]] * [[Wikipedia:Manual of Style (trademarks)|Trademarks]] * [[Wikipedia:Manual of Style (writing about fiction)|Writing about fiction]] {{col-break}} * Region-specific ** [[Wikipedia:Manual of Style (Arabic)|Arabic]] ** [[Wikipedia:Manual of Style (China-related articles)|China-related articles]] ** [[Wikipedia:Manual of Style (Ethiopia-related articles)|Ethiopia-related articles]] ** [[Wikipedia:Manual of Style (Indic-related articles)|Indic-related articles]] ** [[Wikipedia:Manual of Style (Ireland-related articles)|Ireland-related articles]] ** [[Wikipedia:Manual of Style (Islam-related articles)|Islam-related articles]] ** [[Wikipedia:Manual of Style (Japan-related articles)|Japan-related articles]] ** [[Wikipedia:Manual of Style (Korea-related articles)|Korea-related articles]] ** [[Wikipedia:Manual of Style (Philippine-related articles)|Philippine-related articles]] ** [[Wikipedia:Manual of Style (Thailand-related articles)|Thailand-related articles]] ** [[Wikipedia:Manual of Style (U.S. state highways)|U.S. state highways]] {{col-end}} ==See also== <!-- This list is now sorted alphabetically. You are free to edit it further if you have an idea how to sort them better. Please, when adding a link, also provide a short resume of the article. --[[User:Eleassar777|Eleassar777]] 06:32, 19 Apr 2005 (UTC) --> *[[Style guide]], the Wikipedia entry on “style guides”. Contains links to the online style guides of some magazines and newspapers. *[[Wikipedia:Annotated article]] — the article contains annotations that show how it should be edited preferentially. *[[Wikipedia:Avoiding common mistakes]] gives a list of common mistakes and how to avoid them. *[[Wikipedia:Be bold in updating pages]] should define your attitude toward page updates. *[[Wikipedia:Cite sources]] explains process and standards for citing references in articles. *[[Wikipedia:Editing policy]] has even more editing guidelines. *[[Wikipedia:Guide to layout]] is an example of how to lay out an article. *[[Wikipedia:How to edit a page]] is a short primer on editing pages. *[[Wikipedia:Introduction]] is a gentle introduction to the world of Wikipedia. *[[Wikipedia:Perfect stub article]] shows what you should aim for at a minimum when starting a new article. *[[Wikipedia:Policies and guidelines]] is the main stop for policies and, well, guidelines. *[[Wikipedia:How to edit a page#Wiki markup|Wiki markup]] explains the mechanics of what codes are available to you when editing a page, to do things like titles, links, external links, and so on. *[[Wikipedia:WikiProject]] sets out boilerplates for certain areas of knowledge. *[[Meta:Reading level]] (discussion)

Return to Help:Manual of Style.