Diff for "WikiGuide/PageCreation"


Differences between revisions 1 and 31 (spanning 30 versions)
Revision 1 as of 2006-06-09 18:04:12
Size: 1568
Editor: 85-210-60-78
Comment: creating
Revision 31 as of 2013-12-13 11:36:59
Size: 3997
Editor: knome
Comment: #title doesn't work, so hiding it from this guide
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
This section deals with how to create pages on the Ubuntu wiki. There are two simple steps to creating new guides: <<Include(WikiGuide/Toolkit/MenuBar)>>
Line 3: Line 3:
 1. '''Search'''. First, before adding a guide to the wiki, search for existing guides on the same subject. If an existing document is of poor standard, out of date, or missing something, improve it!! It's better to integrate information on the same subject on the same page than create separate guides which deal with the same subject.
 1. '''Create the page'''. If there are no guides already on the subject, create a page.
  * Think of a name - choosing a good name is very important to ensure that a user who is searching for the page will find it easily. So:
= Introduction =

||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents>>||

This section deals with how to create pages on the Ubuntu wiki.

= Search and Integrate. Don't Duplicate. =

Before adding a page to the wiki, make sure you do a comprehensive search.

== Search ==
 * RecentChanges - See where people are currently working.
 * FindPage - Search or browse the database in various ways.
 * TitleIndex - A list of all pages in the wiki.
 * WordIndex - A list of all words that are part of page titles.
 * [[CategoryCategory|Category List]] - A list of categories that can be selected to list pages in a particlular category. These also list the pages with the category name in the title.

== Integrate ==
 * Don't add '''another''' page if a guide, article, or document already exists on a particular subject.
 * If you think the existing document could be better, is out of date, or missing something, then '''improve''' it!
 * Either add or integrate the material with the existing page in the appropriate place.

= New Pages =

If no such article exists, please feel free to create a new page.

== Choose a Name ==

Choosing a good name is very important to ensure that a user who is searching for the page will find it easily. So:
Line 7: Line 34:
   a. Avoid using the word "Howto" in the page title (everything here is a howto!)
   a. Choose a name with some capital letters (such as WikiName), it will ensure that the page has a similar style of name to the existing pages.
  * Then, to create the page, simply type the address for the new page into the address bar of your browser and then select ''Create new page''. Alternatively, enter the name of your page into the box below.
   a. Choose a name with some capital letters (such as WikiName). This will ensure that the page has a similar style of name to the existing pages.
   a. Avoid using the word "Howto" in the page title. Everything here is a howto!
   a. Do not use spaces or dashes in the name.
Line 11: Line 38:
    [[NewPage(,Create new page,)]] ##By default, the page title is the page name, but you can manually specify a title displayed on the page to make it more descriptive and easier to read. For instance, ''Resizing Your Photos'' would be clearer than ''Photos/ResizingPhotos''. To change the title from the default, insert {{{#title Page Name}}} as the '''first''' line in a document.
Line 13: Line 40:
Deleting and renaming pages - users do not have permission on this wiki to delete or rename pages. This is because doing so can sometimes cause accidental problems. If you need to delete or rename a page, contact the WikiTeam and they will arrange it. ##Try to make it broadly similar to the page's wiki name so that the link between the page URL and its title is more obvious. For example, if you had a page named ''Installing''''''Server''''''Software'', it would be better to use the title ''Installing Server Software'' than ''Adding Server Apps''.
Line 15: Line 42:
## we need a DocumentationTemplate
## we also need to look into the NewPage macro
== Create the Page ==
Line 18: Line 44:
-----
Go back to WikiGuide
There are several ways to create a new page but all of them require that you first '''Log-in'''

=== By visiting the page ===

 1. Type the address for the new page into the address bar of your browser. Since the page does not exist because you performed the searches discussed above, Moin``Moin will suggest to create it.
 1. Select a template from the left side of the page that opens. DocumentationTemplate is a default template you can use for any page. There are also some specialized templates to choose from.

=== Add a link on another page ===

 1. Edit another page
 1. Add a link to the new page, preferably like this: `[[PageName|Page Name]]`
 1. Save the page and click the new link
 1. Click one of the template names
 1. Edit your new page and save it

For more information on linking to other pages, see HelpOnLinking.

=== By using the NewPage macro ===

 1. Enter the page name in the text box and click "<<GetText(Create New Page)>>"
 1. Edit your page and save it

 <<NewPage(HelpTemplate)>>

=== By using the GoTo macro ===

 1. Enter the page name in the text box and click "<<GetText(Go To Page)>>"
 1. Click "Create new page"
 1. Edit your page and save it

 <<GoTo>>

= Advanced =

 * To learn about creating and using template pages see HelpOnTemplates.
 * To learn more how to set variables see HelpOnVariables

## Commenting out because this may overwrite an existing page
## Alternatively, enter the name of your page into the box below.
## [[NewPage(DocumentationTemplate,Create new guide,)]]

----
 * Go back to WikiGuide

Introduction

This section deals with how to create pages on the Ubuntu wiki.

Search and Integrate. Don't Duplicate.

Before adding a page to the wiki, make sure you do a comprehensive search.

  • RecentChanges - See where people are currently working.

  • FindPage - Search or browse the database in various ways.

  • TitleIndex - A list of all pages in the wiki.

  • WordIndex - A list of all words that are part of page titles.

  • Category List - A list of categories that can be selected to list pages in a particlular category. These also list the pages with the category name in the title.

Integrate

  • Don't add another page if a guide, article, or document already exists on a particular subject.

  • If you think the existing document could be better, is out of date, or missing something, then improve it!

  • Either add or integrate the material with the existing page in the appropriate place.

New Pages

If no such article exists, please feel free to create a new page.

Choose a Name

Choosing a good name is very important to ensure that a user who is searching for the page will find it easily. So:

  1. Choose a descriptive name
  2. Choose a name with some capital letters (such as WikiName). This will ensure that the page has a similar style of name to the existing pages.

  3. Avoid using the word "Howto" in the page title. Everything here is a howto!
  4. Do not use spaces or dashes in the name.

Create the Page

There are several ways to create a new page but all of them require that you first Log-in

By visiting the page

  1. Type the address for the new page into the address bar of your browser. Since the page does not exist because you performed the searches discussed above, MoinMoin will suggest to create it.

  2. Select a template from the left side of the page that opens. DocumentationTemplate is a default template you can use for any page. There are also some specialized templates to choose from.

  1. Edit another page
  2. Add a link to the new page, preferably like this: [[PageName|Page Name]]

  3. Save the page and click the new link
  4. Click one of the template names
  5. Edit your new page and save it

For more information on linking to other pages, see HelpOnLinking.

By using the NewPage macro

  1. Enter the page name in the text box and click "Create New Page"

  2. Edit your page and save it

By using the GoTo macro

  1. Enter the page name in the text box and click "Go To Page"

  2. Click "Create new page"
  3. Edit your page and save it

Advanced


WikiGuide/PageCreation (last edited 2013-12-13 11:36:59 by knome)