Biocrawler:Section
From Biocrawler, the free encyclopedia.
| Biocrawler: Guidance on style |
| Main Manual of Style |
|---|
| Supplementary Manuals of Style |
| Biographies |
| China-related articles |
| Dashes |
| Dates and numbers |
| Disambiguation pages |
| Headings |
| Japan-related articles |
| Links |
| Mathematics |
| Pronunciation |
| Sister projects |
| Titles |
| Trademarks |
| Other guidance |
| How to edit a page |
| Guide to layout |
| Captions |
| Categories |
| Categories of people |
| Cite sources |
| Explain jargon |
| Guide to writing better articles |
| Lists |
| Naming conventions |
| Picture tutorial |
| Proper names |
| Section |
| Technical terms and definitions |
(For general information about sections in the MediaWiki software, see m:Help:Section. This page is for aspects which are specific for Biocrawler.)
Preferably, articles are divided into sections, using the section header syntax; this is often but not always better than just using bolded text for headers, see below.
| Contents |
Creation of sections
Sections are created by creating their headers as follows (see also Biocrawler:How to edit a page):
==Section== ===Subsection=== ====Sub-subsection====
Table of contents (TOC)
For each article with more than three headings, a table of contents (TOC) is automatically generated from the section headings, unless:
- (for a user) preferences are set to turn it off
- (for an article) in the edit box the code __NOTOC__ is added
The TOC is put before the first section header unless it is placed manually with the code __TOC__. Thus there may be some introductory text before it, known as the "lead". See Biocrawler:Guide to writing better articles#Lead section for recommendations on the length of that section.
Preferences can be set to number the sections automatically.
Compact TOC
Where you have a large number of very short headings (such as letters of the alphabet) you can get a very long table of contents. An alternative is a compact table of contents, which you can achieve by inserting the following text:
{{compactTOC}}
which looks like this:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
You can do similar things with years or decades, for example:
1900s - 1910s - 1920s - 1930s - 1940s - 1950s - 1960s - 1970s - 1980s - 1990s - 2000s
Both of the above make use of section linking (see below). Several different compact TOCs can be found at Biocrawler:Template messages/Compact table of contents.
Non-automatic TOC
If the automatic TOC is not suitable, one can specify __NOTOC__ and make one manually. For an example see [1] (http://en.wikipedia.org/w/wiki.phtml?title=Biocrawler:How_to_edit_a_page&oldid=2360888); it is applied for that page because the page contains examples of headers, which the automatic TOC would take as actual section headers. Later versions of the page removed the need for the manual TOC.
Turning off the TOC numbers
Currently you cannot turn off the numbering of sections in the TOC.
Section linking
You can use section linking to link to a section within the same page (using [[#section name|displayed text]], and if another section with the same name exists a _(sequential number) is appended as in [[#section name_2|displayed text]]), or to a section within another page (using [[page name#section name|displayed text]]).
Section linking does not work in a redirect. One can use it anyway in a redirect as a clarification, and at least it works when clicking on the link from the redirect page.
Editing of individual sections
Sections can be separately edited ("section editing feature") by right clicking on the section header (in the case of text before the first section header: on the article header), or on special edit links, depending on the preferences set. This is convenient if the edit is not related to the content in other sections. Inserting a section can be done by editing either the section before or after it, merging with the previous section by deleting the header. Unlike what one may assume, an edit conflict may still occur if two users edit different sections at the same time.
See also section title as automatic edit summary.
Opening a link in a header in a new window
When right click editing is enabled, you cannot right click a link in a header to open it in a new window, etc. However most browsers have an alternative way of doing that (Mozilla: middle click, ctrl+left click, type ahead find, TAB navigation; Opera: middle click, shift+left click, ctrl+shift+left click; IE: shift+left click).
Horizontal dividing line
A horizontal dividing line has a conventional use, as a division demarcation to isolate sections that logically could stand on their own as main sections with a disambiguating category in parentheses: Orion (mythology) and Orion (constellation). Horizontal dividing lines set apart the distinct meanings of a term.
When such sections contain only a few sentences in a single paragraph, this is a good way for readers to find your information. But if your article on a secondary meaning contains more than one paragraph, it may become confusing to the eye.
Note that these lines are not taken into account in the section numbering and TOC. As a result, the explanation of the second meaning of the word is treated as part of the previous section of the text written for the first meaning. To avoid this, use appropriate headers in addition to dividing lines.
See also: wikipedia:disambiguation
"See also" line or section
If an article consists of sections and a "see also" refers to the whole article, then make it a separate section. This is to avoid it becoming part of the prior section, to make it visible in the TOC, and to make it easily accessible through the TOC.
Alternatively, a "see also" 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 "see also" a section. In such cases, the see also should be italicized and indented. A horizontal line should not be placed under this "see also".
A "see also" belonging to just one section can be put in that section: within a paragraph, as a separate paragraph, or as a subsection.
See also
- Biocrawler:Manual of Style (headings)
- Biocrawler:User preferences help
- Biocrawler:Guide to writing better articles#Headings
- Biocrawler:Talk page guidelines (for how to use headings on talk pages)ja:Biocrawler:節
