Help:Sections

From Shifti
Jump to navigation Jump to search

Headings organize your writing into sections. The Wiki software can automatically generate a table of contents from them. They are useful in long stories to separate parts, possibly complete with chapter names.

Headers are written as a separate line with a number of equals characters (=) at the beginning and end. The number of equals is used to set the "level" of the header, from level 1 to level 6. Note that level 1 headers should almost never actually be used, however; the level 1 header is automatically used by the title of the page.

The following is a simple set of example headers: 

Separator dingbats

Instead of textual section headers, you may wish to use one of the graphical section separator dingbats available on Shifti.



Inter-paragraph divider dingbats



Template code

Without text

With text




{{Separator|d}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}




{{Separator|f}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}




{{Separator|j}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}




{{Separator|k}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}




{{Separator|r}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}




{{Separator|x}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}




{{Separator|stars}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}



To insert one of these images, simply copy the image tag given in the left-hand column of the table and put it on a separate line in your story where you'd like the image to appear. The image's width in pixels is defined in the tag and can be changed if you like. See Help:Templates for more detail.


Separator dingbats

Instead of textual section headers, you may wish to use one of the graphical section separator dingbats available on Shifti.



Inter-paragraph divider dingbats



Template code

Without text

With text




{{Separator|d}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}




{{Separator|f}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}




{{Separator|j}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}




{{Separator|k}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}




{{Separator|r}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}




{{Separator|x}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}




{{Separator|stars}}

{{#if:|
 {{{2}}} 
|
}}|
}}

{{#if:Text|
 Text 
|
}}|
}}



To insert one of these images, simply copy the image tag given in the left-hand column of the table and put it on a separate line in your story where you'd like the image to appear. The image's width in pixels is defined in the tag and can be changed if you like.


Table of contents

A table of contents is automatically generated if there are four or more section headers present in a page, and it is automatically placed right before the first section header. However, you can override this automatic behavior if you want.

To prevent a table of contents from being generated automatically, place the following "magic word" at the top of the page (it can actually be located anywhere but putting it at the top makes it easy to keep track of):

__NOTOC__

Note that there are two underscores at the beginning and two underscores at the end.

To force a table of contents to be generated, place the magic word __TOC__ at the place in the page where you want the table of contents to appear.

It isn't possible to pick and choose which individual section headers appear in the table of contents. Separator dingbats don't count as section headers and so won't appear in the table of contents, though one could place a dingbat image inside a section header if one wanted.
Retrieved from "https://shifti.org/index.php?title=Help:Sections&oldid=547"