Help:Contents/Editing: Difference between revisions

m
m (→‎Creating Sections: add note about editing section advantage)
 
(5 intermediate revisions by the same user not shown)
*Keep pages to a reasonable length
**Split documentation into separate pages whenever possible to identify break points
**It is possible to name Wiki pages hierarchically, for example this page is '''Editing''', but its URL places it under the '''Help:Contents''' page, giving an option at the top of this page to move up hierarchy.
*Within pages use short paragraphs or bullet points to aid readability
**Short sentences also aid readability, try to minimise use of "and", by either splitting sentence or expressing each clause as a numbered bullet point
 
'''Be careful''' a reference to (for example) <nowiki>[[webTags]]</nowiki> would create a new page, as that capital '''T''' in the middle is different to the name of the existing '''Webtags''' page.
 
==Templates==
 
When you create a new page, you can reference templates that will add standard predetermined content to your page.
 
* Type '''<nowiki>{{Template:WorkInProgressBanner}}</nowiki>''' to add a banner to that point in the page saying "Work In Progress". The coloured background makes this content stand out.
* Type '''<nowiki>{{Template:Version badge Mx}}</nowiki>''' to put your page into '''<nowiki>Category: Cumulus MX</nowiki>''' and display a MX symbol.
* (For legacy cumulus) type '''<nowiki>{{Version badge 1}}</nowiki>''' to put the page into '''<nowiki>Category: Cumulus 1</nowiki>''' and display a "v1" symbol.
 
Other templates are available, and you can create a new template if there is a standard piece of text you want to be able to insert in multiple places.
 
==Renaming and Redirect==
 
If links to the old page exist, a standard logged-in user needs to manually edit each link individually. If redirect exists, the old links will get to the correct page by first opening the redirect page. If redirect does not exist, the old links will turn red, to indicate they now link to a non-existent page. A logged-in administrator can do a global edit, '''search for'' <nowiki>[[old-page-name</nowiki> and '''replace with''' <nowiki>[[new-page-name</nowiki>.
 
 
=Editing a page=
**Only those with administrative access can edit this page, so standard users do not see an "Edit" tab for this page
*WikiText will then automatically create the sections, deal with all the formatting of headings, and make the page look good.
**If you create more than three sections, the Wiki will automatically generate a contents page ''just before your first heading.''
before your first heading.''
**If you want some text to be seen before the table of contents, don't use a heading before that text.
 
Examples: <nowiki>[[Webtags]]</nowiki> and <nowiki>[[Webtags|Cumulus web tags]]</nowiki>
 
:In the first example, if the reader clicks on the word Webtags they will be taken to the page of the same name. In the second case, the user will see the words '''Cumulus web tags''' but when they click it will take them to the '''Webtags''' page. '''Be careful with the case of the page name when linking in Wiki.''' The case of the first letter does not matter, so linking to <nowiki>[[webtags]]</nowiki> or <nowiki>[[Webtags]]</nowiki> is the same as Wiki will always uppercase the first letter.
 
Remember, the case of all letters except the first does matter, and if you do not match the original page name, the Wiki will think you want to link to a page that does not yet exist.
 
 
==Creating a link to an external page ==
 
The reader will see the word '''Google''' but on clicking that they will be taken to an external page.
 
If you are happy for the URL to be seen, without descriptive text, then just type the URL.
 
The chain links icon can be used to enter an external link as well as any internal one.
 
==Using images==
If you wish to include an image in your page, you must first upload the image to the Wiki. You can then refer to it with your text.
 
To upload the image, use the [[Special:Upload|Upload file]] option in the toolbox in the navigation bar on the left. Once uploaded you may insert your image on your page using the thedouble square brackets, the word 'file:' and the filename. Example <nowiki>[[File:map.jpg]]</nowiki>
5,838

edits