WikiQueer:Manual of Style/Layout



This page is a guide to laying out a typical basic 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 WikiQueer:How to edit a page for that); nor is it about writing style (see Manual of Style for that).

Lead section
As explained in detail at Elements of the lead section, the lead section may contain optional elements presented in the following order:
 * 1) disambiguation links (dablinks)
 * 2) maintenance tags
 * 3) infoboxes
 * 4) images
 * 5) navigational boxes (navigational templates)
 * 6) introductory text
 * 7) table of contents moving to the heading of the first section.

Headings and sections
Sections and subsections are introduced by headings. Very short or very long sections and subsections in an article look cluttered and inhibit the flow of the prose. These headings clarify articles by breaking up text, organizing content, and populating the table of contents that users can choose to view by the default, to collapse by clicking hide, or not to view by changing their Preferences.

Headings follow a six-level hierarchy, starting at 1 and ending at 6. The level of the heading is defined by the number of equal signs on either side of the title. Heading 1 is automatically generated as the title of the article, and is never appropriate within the body of articles. Sections start at the second level, with subsections at the third level , and additional levels of subsections at the fourth level , fifth level, and sixth level. Sections should be consecutive, such that they do not skip levels from sections to sub-subsections; the exact methodology is part of the Accessibility guideline. Between sections, there should be a single blank line; multiple blank lines in the edit window create too much white space in the article.

Section templates and summary style
When a section is a summary of another article that provides a full exposition of the section, a link to that article should appear immediately under the section heading. You can use the Main template to generate a Main article; link.

If one or more articles provide further information or additional details (rather than a full exposition—see above), references to such articles may be placed immediately after the section heading for that section, provided this does not duplicate a wikilink in the text. These additional references should be grouped along with the template (if there is one), for easy selection by the reader, rather than being scattered throughout the text of a section. You can use one of the following templates to generate these links:


 * – this generates For more details on this topic, see:
 * – this generates Further information:
 * – this generates Related terms:
 * – this generates See also:

For example, to generate a "See also" link to the article on WikiQueer:How to edit a page, type, which will generate:

Paragraphs
Sections usually consist of paragraphs of running prose. Bullet points should be minimized in the body of the article, if they are used at all; however, a bulleted list may be useful to break up what would otherwise be a large, grey mass of text, particularly if the topic requires significant effort on the part of readers. Bulleted lists are typical in the reference and reading sections at the bottom. Between paragraphs—as between sections—there should be only a single blank line; bullet points are usually not separated by a blank line.

The number of single-sentence paragraphs should be minimized, since they can inhibit the flow of the text; by the same token, paragraphs that exceed a certain length become hard to read. Short paragraphs and single sentences generally do not warrant their own subheading; in such circumstances, it may be preferable to use bullet points. See also WikiQueer:Writing better articles.

Standard appendices and footers
When certain optional standard appendix sections are used, they should appear at the bottom of an article, with ==level 2 headings==, followed by the various footers. In the rare cases when it is useful to sub-divide these sections (for example, to separate a list of magazine articles from a list of books), most editors prefer to use either definition list headings (Books) or bold-faced text ("Books") instead of level 3 headings (===Books===).

Order of sections
When present, appendix and footer sections are presented in this order.
 * 1) Works or Publications
 * 2) See also
 * 3) Notes and/or References
 * 4) Further reading
 * 5) External links
 * 6) Navigation templates (footer navboxes)
 * 7) Persondata template
 * 8) Defaultsort
 * 9) Categories
 * 10) Stub templates
 * 11) Interlanguage links

Works or Publications
Contents: A bulleted list, usually ordered chronologically, of the works created by the subject of the article.

Title: Many different titles are used, depending on the subject matter. "Works" is preferred when the list includes items that are not written publications (e.g., music, films, paintings, choreography, or architectural designs), or if multiple types of works are included. "Bibliography", "Discography", or "Filmography" are occasionally used where appropriate; however, "Bibliography" is discouraged because it is not clear whether it is limited to the works of the subject of the article. "Works"/"Publications" should be plural, even if it lists only a single item.

See also section
Contents: A bulleted list, preferably alphabetized, of internal links (wikilinks) to related WikiQueer articles. Editors should provide a brief annotation when a link's relevance is not immediately apparent, when the meaning of the term may not be generally known, or when the term is ambiguous. For example:
 * Related person – made a similar achievement on April 4, 2005
 * Ischemia – restriction in blood supply

A reasonable number of relevant links that would be in the body of a hypothetical perfect article are suitable to add to the "See also" appendix of a less developed one. Links already integrated into the body of the text are generally not repeated in a "See also" section, and navigation boxes at the bottom of articles may substitute for many links (see the bottom of Pathology for example). However, whether a link belongs in the "See also" section is ultimately a matter of editorial judgment and common sense. Indeed, a good article might not require a "See also" section at all. Thus, although some links may not naturally fit into the body of text they may be excluded from the "See also" section due to article size constraints. Links that would be included in the article were it not kept relatively short for other reasons may thus be appropriate, though should be used in moderation, as always. Links included in the "See also" section may be useful for readers seeking to read as much about a topic as possible, including subjects only peripherally related to the one in question. The "See also" section should not link to pages that do not exist (red links) or disambiguation pages. Portal and WikiQueer-Books links are usually placed in this section.

Title: The most common title for this section is "See also".

Notes and References


Contents: This section, or series of sections, may contain (1) explanatory footnotes that give information which is too detailed or awkward to be in the body of the article, (2) citation footnotes that serve to verify specific information in the article, (3) general references (bibliography items) that are not explicitly related to any specific parts of the text.

In a given article, some or all of these three sets may be present. If there are both citation footnotes and explanatory footnotes, then they may be combined in a single section, or separated using the grouped footnotes function. There may therefore be one, two or three sections in all. A general references section should come after any footnotes section(s), and the explanatory footnotes section should precede the citation footnotes (if they are separate).

Title: The title(s) of these sections depend on which of the three types of item are present, and whether the two types of footnote are combined or separated. Possibilities include: With the exception of "Bibliography," the heading should be plural even if it lists only a single item.
 * for a list of explanatory footnotes only: "Notes", "Footnotes"
 * for a list of citation footnotes only: "References", "Notes" ("Citations" may be used but is problematic because it may be confused with official awards)
 * for a list containing both types of footnote: "Notes", "Footnotes" ("References" may be used but is less appropriate)
 * for a list of general references: "References", "Works cited" ("Sources" may be used but may be confused with source code in computer-related articles; "Bibliography" may be used but may be confused with a list of printed works by the subject of a biography).

Navigation templates
Contents: Navigation templates (footer navboxes), including succession boxes and geography boxes such as. Most navboxes do not appear in printed versions of WikiQueer articles.

Images
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 that would otherwise overwhelm the available text space on a 800×600 window should be shrunk or formatted as a panorama. It is a good idea to try to maintain visual coherence by aligning the sizes 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 1024×768 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 —you can use a gallery. Another solution might be to create a page or category combining all of them at Wikimedia Commons and use a relevant template (Commons, Commons category, Commons-inline or Commons category-inline) to link to it instead, so that further images are readily found and available when the article is expanded. Please see WQ:IG for further information on the use of galleries.

As a general rule, images should not be set to a larger fixed size than the 220px default. If an exception to the general rule is warranted, forcing an image size to be either larger or smaller than the 220px default is done by placing a parameter in the image coding in the form .Lead images should usually be no wider than "300px" ("upright=1.35"). Larger images should generally be a maximum of 500 pixels tall and 400 pixels wide, so that they can comfortably be displayed on the smallest displays in common use.

Avoid referring to images as being on the left or right. Image placement is different for viewers of the mobile version of WikiQueer, and is meaningless to people having pages read to them by assistive software. Instead, use captions to identify images.

Links
As part of Wikifying articles, you should link words in this article to other relevant articles. To create an interwiki hyperlink, place two square brackets around important words or phrases, like this:. Normally, the first occurrence of a word is the one chosen for a link. Do not link to the same article more than once in a section. Avoid creating adjacent links to separate articles, because the reader cannot tell whether the link is to one or two articles without pointing to the link.

If the phrase or word in the article you are editing does not match the name of the article you want to link, use a piped link. Type the exact name of the target article followed by a pipe " " (vertical bar, shift backward slash on some keyboards) followed by the phrase you wish to see in the context of the article you are editing. Place two square brackets around this code. This creates a hyperlink that will allow the reader to click through to other WikiQueer articles:

  Lennie and George came to a ranch near Soledad southeast of Salinas, California, to "work up a stake". 

When saved, this produces:

 Lennie and George came to a ranch near Soledad southeast of Salinas, California, to "work up a stake".

Horizontal rule
Horizontal rules—a series of hyphens resulting in a straight line—are deprecated; that is, they are no longer used in articles. Rules were once employed to separate multiple meanings of a single article's name, but this task is now accomplished through disambiguation pages.

Rules can be used to provide separation inside certain templates (for example, politbox derivatives), within discussions, or when needed in some other formats.

Specialized layout

 * Category:Style guidelines of WikiProjects
 * WikiQueer:Stand-alone lists
 * WikiQueer:Talk page layout

Other project pages

 * Help:Editing
 * Help:Preferences
 * Help:Section
 * WikiQueer:Article titles
 * WikiQueer:Disinfoboxes (essay)
 * WikiQueer:Related information (essay) - optional heading for end of article navboxes
 * WikiQueer:Talk page guidelines - shows how to use headings on talk pages