Help:Sections - Revision history

ShadowWolf: flag with {{help}}

2009-02-15T23:44:39Z

flag with {{help}}

← Older revision		Revision as of 18:44, 15 February 2009
Line 1:		Line 1:
	''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.		''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.		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.{{help}}

	The following is a simple set of example headers:		The following is a simple set of example headers:

Bryan: removing paragraph on {{part}}, template is deprecated

2007-08-06T08:44:35Z

removing paragraph on {{part}}, template is deprecated

← Older revision		Revision as of 03:44, 6 August 2007
Line 20:		Line 20:

	One should avoid skipping levels. For example, one should not follow a level 2 header with a level 4 header. Most stories will probably only need simple level 2 headers in any event, without multiple levels of header.		One should avoid skipping levels. For example, one should not follow a level 2 header with a level 4 header. Most stories will probably only need simple level 2 headers in any event, without multiple levels of header.

	As an alternative that may simplify matters see also [[Template:Part]], a template useful for marking parts of a story. The template page contains documentation on how to use it. The template uses the same section headers described here but wraps it in some additional functions and standardizes their format.

	If a page is divided up into sections using headers it becomes possible to edit just the contents of one section rather than editing the entire page. Section edit links will appear next to the section headers as "[edit]". This is particularly useful when dealing with extremely long stories, making the edit form quicker to load and easier to scroll through. In a few rare cases older browsers may not be able to handle more than around 32 kilobytes of text in an edit form and section editing becomes necessary for editing pages longer than that.		If a page is divided up into sections using headers it becomes possible to edit just the contents of one section rather than editing the entire page. Section edit links will appear next to the section headers as "[edit]". This is particularly useful when dealing with extremely long stories, making the edit form quicker to load and easier to scroll through. In a few rare cases older browsers may not be able to handle more than around 32 kilobytes of text in an edit form and section editing becomes necessary for editing pages longer than that.

Bryan: very weird, the page got messed up on save again.

2007-07-25T03:44:11Z

very weird, the page got messed up on save again.

← Older revision		Revision as of 22:44, 24 July 2007
Line 6:		Line 6:

	<pre>		<pre>
	== ~~Separator dingbats~~==		==Header level 2==

			This is the content of the first section.

			=== First header level 3 ===

			Using more equals signs creates a subsection.

			=== Second header level 3 ===

			And so on.
			</pre>

	~~Instead of textual section~~ headers, ~~you may wish to use one~~ of ~~the graphical section separator dingbats available on Shifti~~.		One should avoid skipping levels. For example, one should not follow a level 2 header with a level 4 header. Most stories will probably only need simple level 2 headers in any event, without multiple levels of header.

	~~{{Separator dingbats}}~~		As an alternative that may simplify matters see also [[Template:Part]], a template useful for marking parts of a story. The template page contains documentation on how to use it. The template uses the same section headers described here but wraps it in some additional functions and standardizes their format.

	~~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#Decorative dingbats]]~~ for ~~more detail~~.		If a page is divided up into sections using headers it becomes possible to edit just the contents of one section rather than editing the entire page. Section edit links will appear next to the section headers as "[edit]". This is particularly useful when dealing with extremely long stories, making the edit form quicker to load and easier to scroll through. In a few rare cases older browsers may not be able to handle more than around 32 kilobytes of text in an edit form and section editing becomes necessary for editing pages longer than that.

	== Separator dingbats==		== Separator dingbats==
Line 20:		Line 31:
	{{Separator dingbats}}		{{Separator dingbats}}

	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.		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#Decorative dingbats]] for more detail.

	==Table of contents==		==Table of contents==

Bryan: /* Separator dingbats */ link to specific section of Help:Templates

2007-07-25T03:43:10Z

Separator dingbats: link to specific section of Help:Templates

← Older revision		Revision as of 22:43, 24 July 2007
Line 6:		Line 6:

	<pre>		<pre>
	==~~Header level 2~~==		== Separator dingbats==

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

	~~=== First header level 3 ===~~		{{Separator dingbats}}

	~~Using more equals signs creates a subsection.~~		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#Decorative dingbats]] for more detail.

	~~=== Second header level 3 ===~~

	~~And so on.~~
	~~</pre>~~

	~~One should avoid skipping levels. For example,~~ one ~~should not follow a level 2 header with a level 4 header. Most stories will probably only need simple level 2 headers in any event, without multiple levels~~ of ~~header.~~

	~~As an alternative that may simplify matters see also [[Template:Part]]~~, ~~a template useful for marking parts~~ of a story~~. The template page contains documentation on how~~ to ~~use it~~. The ~~template uses the same section headers described here but wraps it~~ in ~~some additional functions and standardizes their format.~~

	~~If a page~~ is ~~divided up into sections using headers it becomes possible to edit just~~ the ~~contents of one section rather than editing the entire page~~. ~~Section edit links will appear next to the section headers as "~~[~~edit~~]~~". This is particularly useful when dealing with extremely long stories, making the edit form quicker to load and easier to scroll through. In a few rare cases older browsers may not be able to handle~~ more ~~than around 32 kilobytes of text in an edit form and section editing becomes necessary for editing pages longer than that~~.

	== Separator dingbats==		== Separator dingbats==

Bryan: Something went a little wonky there

2007-07-25T03:18:13Z

Something went a little wonky there

← Older revision		Revision as of 22:18, 24 July 2007
Line 6:		Line 6:

	<pre>		<pre>
	== ~~Separator dingbats~~==		==Header level 2==

			This is the content of the first section.

			=== First header level 3 ===

			Using more equals signs creates a subsection.

			=== Second header level 3 ===

			And so on.
			</pre>

	~~Instead of textual section~~ headers, ~~you may wish to use one~~ of ~~the graphical section separator dingbats available on Shifti~~.		One should avoid skipping levels. For example, one should not follow a level 2 header with a level 4 header. Most stories will probably only need simple level 2 headers in any event, without multiple levels of header.

	~~{{Separator dingbats}}~~		As an alternative that may simplify matters see also [[Template:Part]], a template useful for marking parts of a story. The template page contains documentation on how to use it. The template uses the same section headers described here but wraps it in some additional functions and standardizes their format.

	~~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~~.		If a page is divided up into sections using headers it becomes possible to edit just the contents of one section rather than editing the entire page. Section edit links will appear next to the section headers as "[edit]". This is particularly useful when dealing with extremely long stories, making the edit form quicker to load and easier to scroll through. In a few rare cases older browsers may not be able to handle more than around 32 kilobytes of text in an edit form and section editing becomes necessary for editing pages longer than that.

	== Separator dingbats==		== Separator dingbats==
Line 20:		Line 31:
	{{Separator dingbats}}		{{Separator dingbats}}

	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.		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.

	==Table of contents==		==Table of contents==

Bryan: /* Separator dingbats */ Help:Templates

2007-07-25T03:17:31Z

Separator dingbats: Help:Templates

← Older revision		Revision as of 22:17, 24 July 2007
Line 6:		Line 6:

	<pre>		<pre>
	==~~Header level 2~~==		== Separator dingbats==

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

	~~=== First header level 3 ===~~		{{Separator dingbats}}

	~~Using more equals signs creates a subsection.~~		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.

	~~=== Second header level 3 ===~~

	~~And so on.~~
	~~</pre>~~

	~~One should avoid skipping levels. For example,~~ one ~~should not follow a level 2 header with a level 4 header. Most stories will probably only need simple level 2 headers in any event, without multiple levels~~ of ~~header.~~

	~~As an alternative that may simplify matters see also [[Template:Part]]~~, ~~a template useful for marking parts~~ of a story~~. The template page contains documentation on how~~ to ~~use it~~. The ~~template uses the same section headers described here but wraps it~~ in ~~some additional functions and standardizes their format.~~

	~~If a page~~ is ~~divided up into sections using headers it becomes possible to edit just~~ the ~~contents of one section rather than editing the entire page~~. ~~Section edit links will appear next to the section headers as "~~[~~edit~~]~~". This is particularly useful when dealing with extremely long stories, making the edit form quicker to load and easier to scroll through. In a few rare cases older browsers may not be able to handle~~ more ~~than around 32 kilobytes of text in an edit form and section editing becomes necessary for editing pages longer than that~~.

	== Separator dingbats==		== Separator dingbats==

Bryan: finish a sentance I left dangling

2007-07-24T08:16:13Z

finish a sentance I left dangling

← Older revision		Revision as of 03:16, 24 July 2007
Line 23:		Line 23:
	As an alternative that may simplify matters see also [[Template:Part]], a template useful for marking parts of a story. The template page contains documentation on how to use it. The template uses the same section headers described here but wraps it in some additional functions and standardizes their format.		As an alternative that may simplify matters see also [[Template:Part]], a template useful for marking parts of a story. The template page contains documentation on how to use it. The template uses the same section headers described here but wraps it in some additional functions and standardizes their format.

	If a page is divided up into sections using headers it becomes possible to edit just the contents of one section rather than editing the entire page. Section edit links will appear next to the section headers as "[edit]". This is particularly useful when dealing with extremely long stories, making the edit form quicker to load and easier to scroll through. In a few rare cases older browsers may not be able to handle more than around 32 kilobytes of text in an edit form and section editing becomes necessary.		If a page is divided up into sections using headers it becomes possible to edit just the contents of one section rather than editing the entire page. Section edit links will appear next to the section headers as "[edit]". This is particularly useful when dealing with extremely long stories, making the edit form quicker to load and easier to scroll through. In a few rare cases older browsers may not be able to handle more than around 32 kilobytes of text in an edit form and section editing becomes necessary for editing pages longer than that.

	== Separator dingbats==		== Separator dingbats==

Bryan at 08:15, 24 July 2007

2007-07-24T08:15:13Z

← Older revision		Revision as of 03:15, 24 July 2007
Line 10:		Line 10:
	This is the content of the first section.		This is the content of the first section.

	=== ~~Header~~ level 3 ===		=== First header level 3 ===

	Using more equals signs creates a subsection.		Using more equals signs creates a subsection.

Bryan: mention section editing

2007-07-24T07:58:42Z

mention section editing

← Older revision		Revision as of 02:58, 24 July 2007
Line 21:		Line 21:
	One should avoid skipping levels. For example, one should not follow a level 2 header with a level 4 header. Most stories will probably only need simple level 2 headers in any event, without multiple levels of header.		One should avoid skipping levels. For example, one should not follow a level 2 header with a level 4 header. Most stories will probably only need simple level 2 headers in any event, without multiple levels of header.

	As an alternative that may simplify matters see also [[Template:Part]], a template useful for marking parts of a story. The template page contains documentation on how to use it.		As an alternative that may simplify matters see also [[Template:Part]], a template useful for marking parts of a story. The template page contains documentation on how to use it. The template uses the same section headers described here but wraps it in some additional functions and standardizes their format.

			If a page is divided up into sections using headers it becomes possible to edit just the contents of one section rather than editing the entire page. Section edit links will appear next to the section headers as "[edit]". This is particularly useful when dealing with extremely long stories, making the edit form quicker to load and easier to scroll through. In a few rare cases older browsers may not be able to handle more than around 32 kilobytes of text in an edit form and section editing becomes necessary.

	== Separator dingbats==		== Separator dingbats==

Bryan: new help page

2007-07-24T07:54:00Z

new help page

New page

''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:

<pre>
==Header level 2==

This is the content of the first section.

=== Header level 3 ===

Using more equals signs creates a subsection.

=== Second header level 3 ===

And so on.
</pre>

One should avoid skipping levels. For example, one should not follow a level 2 header with a level 4 header. Most stories will probably only need simple level 2 headers in any event, without multiple levels of header.

As an alternative that may simplify matters see also [[Template:Part]], a template useful for marking parts of a story. The template page contains documentation on how to use it.

== Separator dingbats==

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

{{Separator dingbats}}

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):

<nowiki>__NOTOC__</nowiki>

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 <nowiki>__TOC__</nowiki> 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.