Create a Page: Difference between revisions

From KDE UserBase Wiki
(Included Structure section)
(Included Deciding section)
Line 4: Line 4:
* [[Toolbox|Tool Box]] shows you wiki markup for the effect you need
* [[Toolbox|Tool Box]] shows you wiki markup for the effect you need
* [[Typographical_Guidelines]] standardizes markup for use in translation, either to official manuals (DocBook) or to other languages.
* [[Typographical_Guidelines]] standardizes markup for use in translation, either to official manuals (DocBook) or to other languages.
==Deciding where to create your page==
Many people choose to draft a page on their own Talk page, then move the result to the desired site.  Sometimes there is a good reason for preferring to do it in the final location.  If that is the case, consider using before your content <nowiki>{{Construction}}</nowiki> which will display
{{Construction}}


==Wiki Structure==
==Wiki Structure==
Line 9: Line 14:
Try to avoid creating a structure more than three levels deep.  For most purposes,  the following guide will suffice:
Try to avoid creating a structure more than three levels deep.  For most purposes,  the following guide will suffice:


<!--T:4-->
Application <br />
Application <br />
Application/Troubleshooting <br />
Application/Troubleshooting <br />

Revision as of 14:55, 24 September 2010

Available Tools

  • Page Layout helps to standardize the look of pages
  • Tool Box shows you wiki markup for the effect you need
  • Typographical_Guidelines standardizes markup for use in translation, either to official manuals (DocBook) or to other languages.

Deciding where to create your page

Many people choose to draft a page on their own Talk page, then move the result to the desired site. Sometimes there is a good reason for preferring to do it in the final location. If that is the case, consider using before your content {{Construction}} which will display

Under Construction

This is a new page, currently under construction!


Wiki Structure

Try to avoid creating a structure more than three levels deep. For most purposes, the following guide will suffice:

Application
Application/Troubleshooting
Application/xxx-How-To
Application/Manual
Application/Manual/Introduction
Application/Manual/Section_1
Application/Manual/Section_xxx

Workflow

  1. Navigate to a page, which will contain a link to your new page
  2. Edit this page and insert a link to a new, not yet existing page like this: [[My New Page]]
  3. Write a one-line summary of what you changed
  4. Hit the Preview button and check your work
  5. Save your edits.

Now the page shows a red colored link to your upcoming page. A click on this link will send you directly to your new page and will open the edit box.

Note

For help about editing existing pages read Modify a Page.