Wikipedia:Manual of Style/Layout: Difference between revisions
→Lead section: Switch to order in which these two items would appear in an article |
WhatamIdoing (talk | contribs) |
||
| Line 109: | Line 109: | ||
=== See also === |
=== See also === |
||
{{shortcut|WP:ALSO|WP:SEEALSO}} |
{{shortcut|WP:ALSO|WP:SEEALSO}} |
||
The "See also" section provides a bulleted list of internal links to related Wikipedia articles. A reasonable number of relevant links that would be in a hypothetical "perfect article" are suitable to add to the "See also" section of a less developed one.<ref>This of course refers only to links related to the topic, not links that are incidental, e.g. linking to a jargon word in a sentence</ref> Links already included in the body of the text are generally not repeated in "See also"; however, whether a link belongs in the "See also" section is ultimately a matter of editorial judgment and common sense |
The "See also" section provides a bulleted list of internal links to related Wikipedia articles. A reasonable number of relevant links that would be in a hypothetical "perfect article" are suitable to add to the "See also" section of a less developed one.<ref>This of course refers only to links related to the topic, not links that are incidental, e.g. linking to a jargon word in a sentence</ref> Links already included in the body of the text are generally not repeated in "See also"; however, whether a link belongs in the "See also" section is ultimately a matter of editorial judgment and common sense. A "perfect" article then may not have a "See also" section at all, though some links may not naturally fit into the body of text and others may not be included due to size constraints. Links that would be included if the article were not kept relatively short for other reasons may thus be appropriate, though should be used in moderation, as always. These may be useful for readers looking to read as much about a topic as possible, including subjects only peripherally related to the one in question. The section should not link to [[Wikipedia:Red link|pages that do not exist]]. |
||
A less common practice is to name the section "Related topics". "See also" is the most appropriate place to link a [[Wikipedia:Portal|Portal]] with {{tl|portal}}. |
A less common practice is to name the section "Related topics". "See also" is the most appropriate place to link a [[Wikipedia:Portal|Portal]] with {{tl|portal}}. |
||
It is helpful to alphabetize the links if there are more than a few of them. Also provide a brief explanatory sentence when the relevance of the added links is not immediately apparent. For example: |
It is helpful to alphabetize the links if there are more than a few of them. Also provide a brief explanatory sentence when the relevance of the added links is not immediately apparent. For example: |
||
*[[Everyman|Related person]] made a similar achievement on April 4, 2005. |
*[[Everyman|Related person]] made a similar achievement on April 4, 2005. |
||
Revision as of 03:19, 20 August 2008
 | This page documents an English Wikipedia style guideline. Editors should generally follow it, though exceptions may apply. Substantive edits to this page should reflect consensus. When in doubt, discuss first on this guideline's talk page. |
| Manual of Style (MoS) |
|---|
This Wikipedia Guide to Layout is an annotated, working guide to the basics of laying out an article. Complicated articles may be best modeled on the layout of an existing article of appropriate structure. This guide is not about how to use wiki markup (see Help:Editing for that); nor is it about writing style (see Manual of Style for that).
Lead section
As explained in more detail at WP:Accessibility, items in the lead should be presented in the following order: disambiguation links, maintenance tags, infoboxes, images, introductory text, and navigational boxes, moving to the heading of the first section.
As explained in more detail at Wikipedia:Lead section § Introductory text, all but the shortest articles should start with introductory text (the "lead"). The lead should establish significance, include mention of consequential or significant criticism or controversies, and be written in a way that makes readers want to know more. The appropriate length of the lead depends on that of the article, but should normally be no more than four paragraphs. The lead itself has no heading and, on pages with more than three headings, automatically appears above the table of contents, if present.
Disambiguation templates
A "for topics of the same name ..." line is sometimes put at the beginning, to link to an article about another meaning of the word, or in the case of a link that many readers are likely to follow instead of reading the article. Do not make this initial link a section. In such cases, the line should be italicized and indented using templates. A horizontal line should not be placed under this line. See also Wikipedia:Hatnote
First paragraph
Normally, the opening paragraph summarizes the most important points of the article. It should clearly explain the subject so that the reader is prepared for the greater level of detail that follows. If further introductory material is appropriate before the first section, it can be covered in subsequent paragraphs in the lead. Introductions to biographical articles commonly double as summaries, listing the best-known achievements of the subject. Because some readers will read only the opening of an article, the most vital information should be included.
The subject of the article should be mentioned in bold text ("The '''Solar System''' consists of ...") at a natural place, preferably in the first sentence, although see bolding titles and establishing the context for exceptions. If the subject is normally italicized (for example, a work of art, literature, album or ship), its first mention should be both bold and italic ("The 1656 painting '''''Las Meninas''''' by Diego Velázquez ...").
If the subject of the article has more than one name, each new form of the name should be in bold on its first appearance.
Sodium hydroxide (Na O H), also known as caustic soda or lye ...
If an article's title has a parenthetical disambiguator, it should not be included in the bold text. Egg (food) should start with:
An egg is an ovum produced by ...", not "An egg (food) is an ovum produced by...
Make the context clear in the first few words.
In quantum physics, the Heisenberg uncertainty principle ...
Avoid links in the bold title words, and avoid circular definitions. However, most words describing titles should be linked to more detail.
Buddhist meditation, which is meditation used in the practice of Buddhism, "includes any method of meditation that has Enlightenment as its ultimate aim." (Kamalashila 1996)
Body sections
Headings and paragraphs
The number of single-sentence paragraphs should be minimized, since these can inhibit the flow of the text. By the same token, paragraphs become hard to read once they exceed a certain length.
Headings help to make an article clearer and populate the table of contents, which users can choose under 'Preferences' to view (the default) or not to view; see Wikipedia:Section and Wikipedia:Manual of Style.
Headings are hierarchical, so you should start with ==Heading== and follow it with ===Subheading===, ====Subsubheading====, and so forth.
Articles generally comprise prose paragraphs, not bullet points; however, sometimes a bulleted list can break up what would otherwise be an overly large, grey mass of text, particularly if the topic requires significant effort on the part of readers. Bulleted lists should not be overused in the main text, but are typical in the reference and reading sections at the bottom. Just as for paragraphs, any sections and subsections that are very short or very long will make the article look cluttered and inhibit the flow. Short paragraphs and single sentences generally do not warrant their own subheading, and in these circumstances, it may be preferable to use bullet points. See also Wikipedia:Guide to writing better articles#Paragraphs.
Between paragraphs and between sections, there should be only a single blank line. Multiple blank lines unnecessarily lengthen the article and can make it more difficult to read.
The degree to which subtopics should appear in a single article or be given their own pages is a matter of judgment and of controlling the total length of the article.
If the order in which sections should appear is not clear, use an alphabetical or chronological order. An alphabetical order is especially useful when sections are divided for countries, states, or other divisions.
If a section is a summary of another article
When a section is a summary of another article, it should have a link before the text (but after the section heading). You can use the main template to generate this link:
{{main|Circumcision and law}}
- which produces:
"See also" for one section
If the "See also" refers to articles relevant specifically to a particular section, references to articles that are not wikilinked from the text may be placed immediately after the section heading for that section. Such additional references should be grouped together at the beginning of the section for easy selection by the reader, along with any {{Main}} templates, rather than being scattered throughout the text of a section. You can use one of the following templates to generate these links:
- {{Details}} - which generates For more details on this topic, see
- {{Further}} - which generates Further information:
- {{See also}} - which generates See also:
{{See}}(deprecated)
Standard appendices
Certain optional standard sections, when used, should be placed at the bottom of an article. There is consensus that the plural form of the section name should be used. Common appendix sections:
Quotations(deprecated)- See also
- Notes (or Footnotes)
- References (or combined with Notes into Notes and references)
- Further reading (or Bibliography or Books)
- External links
These sections should all be level 2 headings so that they appear as sections rather than subsections in the table of contents. Syntax:
== See also ==
* [[Wikipedia:How to edit a page]]
* [[Wikipedia:Manual of Style]]
which produces:
See also
Order of appendices:
- If there is an External links section, it should be last.[1]
- Any section which concerns material outside Wikipedia (including References, Bibliography, and External links) should come after any section that concerns Wikipedia material (including See also) to help keep the distinction clear.[2]
- "Notes" is for footnotes containing source citations or commentary on the main text. "References" is a list of referenced materials (books, websites, etc. cited in the main text). Notes and references are often listed under one heading.
- Succession boxes and navigational footers go at the end of the article, following the last appendix section, but preceding the "categories and interwiki links".
See also
The "See also" section provides a bulleted list of internal links to related Wikipedia articles. A reasonable number of relevant links that would be in a hypothetical "perfect article" are suitable to add to the "See also" section of a less developed one.[3] Links already included in the body of the text are generally not repeated in "See also"; however, whether a link belongs in the "See also" section is ultimately a matter of editorial judgment and common sense. A "perfect" article then may not have a "See also" section at all, though some links may not naturally fit into the body of text and others may not be included due to size constraints. Links that would be included if the article were not kept relatively short for other reasons may thus be appropriate, though should be used in moderation, as always. These may be useful for readers looking to read as much about a topic as possible, including subjects only peripherally related to the one in question. The section should not link to pages that do not exist.
A less common practice is to name the section "Related topics". "See also" is the most appropriate place to link a Portal with {{portal}}.
It is helpful to alphabetize the links if there are more than a few of them. Also provide a brief explanatory sentence when the relevance of the added links is not immediately apparent. For example:
- Related person made a similar achievement on April 4, 2005.
Notes, Footnotes, and References
This section, or group of sections, presents the explanatory notes and a list of the references that support the information in this article, sometimes called a bibliography. These items belong in appropriately titled sections at this point in the appendices. The notes and references appear after the See also section (if any) and before the Further reading section (if any) and the External links section (if any). The format of these sections and the specific information in each depends entirely on the citation style chosen by the article's editors. Details can be found on the appropriate pages linked above.
Further reading
This is a bulleted list, usually alphabetized, of any books, articles, or other publications that is recommended to readers as further reading, useful background, or sources of further information. Publications listed in this section are formatted in the same reference style used by the rest of the article.
This section is placed after the References section and before the External links section (if any).
If this section solely contains a list of books or other works authored by the subject of the article, then it may be titled "Bibliography", "Publications", or "Works". It is usually ordered chronologically, and usually precedes the standard appendices. See the guidelines for lists of works for more information.
This section does not include publications that were used as reliable sources in writing this article; these should be cited as references. Websites and online publications should be listed in the "External links" section instead of in this section. To avoid unnecessary duplication of information, publications listed in any other section of the article should not be included in "Further reading".
External links
Place here, in list form, any relevant websites that have not been used as sources and that you recommend for readers of the article.[4] Unlike wikilinks, which are often used within the article's text, external links are normally limited to the "External links" section. Links to external websites used as sources should be listed in the "References" or "Notes" section.
External links may be listed in the section "Further reading", as suggested in Citing sources, instead of having a separate section specifically for external links.
Links to Sister projects should be under the last appendix section. If there is no external links section into which to integrate the templates (e.g. {{commons}}, {{wikibooks}}, {{wikinews}}), inline versions of templates (e.g. {{commons-inline}}, {{wikibooks-inline}}, {{wikiquote-inline}}) are usually available. See Category:Interwiki link templates to check whether an inline template exists.
Navigational footers, categories, interlanguage links etc.
Various navigational aids go at the end of the article, following the last appendix section. The conventional order is:
- Succession boxes and navigational footers
- Categories
- Stub templates. It is usually desirable to leave two blank lines between the first stub template and whatever precedes it.
- Interlanguage links
Formatting
Images
You should always be watchful not to overwhelm an article with images by adding more just because you can. Unless clearly better or more appropriate images are available, the existing images in the article should be left in place.
Images should ideally be spread evenly within the article, and relevant to the sections they are located in. All images should also have an explicative caption. An image should not overwhelm the screen; 300px may be considered a limit, as this is approximately half Wikipedia's text space's width on a 800x600 screen. It is a good idea to try to maintain visual coherence by aligning the width of images and templates on a given page.
When placing images, be careful not to stack too many of them within the lead, or within a single section to avoid bunching up several section edit links in some browsers. Generally, if there are so many images in a section that they strip down into the next section at 1024x768 screen resolution, that probably means either that the section is too short, or that there are too many images.
If an article has many images, so many, in fact, that they lengthen the page beyond the length of the text itself (this also applies if a template like {{taxobox}} or {{Judaism}} is already stretching the page), you can try to use a gallery, but the ideal solution might be to create a page or category combining all of them at Wikimedia Commons and use a relevant template ({{commons}}, {{commonscat}}, {{commons-inline}} or {{commonscat-inline}}) and link to it instead, so that further images are readily found and available when the article is expanded.
Horizontal rule
The use of horizontal rules (----) in articles is deprecated. They were once used to separate multiple meanings of a single article name. However this is now done with disambiguation pages.
They are occasionally used to provide separation inside some templates (e.g. {{politbox}} derivatives), within some discussions, or when needed in some format specialties.
See also
- Help:Editing
- Help:Preferences
- Wikipedia:Talk page guidelines shows how to use headings on talk pages
Notes
If you arrived here from a link on another page then click here to go to the section discussing notes and citations.
- ^ So many articles have the External links section at the end that many people expect that. Some External links and References sections are very long, and when the name of the section is not visible on the screen, it could cause problems if someone meant to delete an external link, and deleted a reference instead. Keeping the External links last is also helpful for editors who patrol external links.
- ^ The Notes or Footnotes section often concerns both kinds of material.
- ^ This of course refers only to links related to the topic, not links that are incidental, e.g. linking to a jargon word in a sentence
- ^ This is an example footnote. The "Notes" section generally only requires a <references/> tag or {{reflist}} template. This is automatically populated with <ref> notes made throughout the article. See Wikipedia:Footnotes for details about this developing practice. The system of presenting notes (as well as "References," "Further reading," and "External links") in a Wikipedia article may change over time; it is more important to have clarity and consistency in an article than to adhere to any particular system.