|
Size: 1568
Comment: creating
|
Size: 3747
Comment: rewrite link text with spaces as per bug 132879
|
| 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: |
||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents>>|| = 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. == 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. == 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 32: |
| 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 36: |
| [[NewPage(,Create new page,)]] | You can manually specify a page name to make the title displayed on the page more descriptive and easier to read. For instance, compare the title ''Resizing Your Photos'' with ''Photos/Resizing''''''Photos''. To do so, insert {{{#title Page Name}}} as the '''first''' line in a document. |
| Line 13: | Line 38: |
| 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 40: |
| ## we need a DocumentationTemplate ## we also need to look into the NewPage macro |
== Create the Page == |
| Line 18: | Line 42: |
| ----- 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 exists 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.
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.
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:
- Choose a descriptive name
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.
- Avoid using the word "Howto" in the page title. Everything here is a howto!
- Do not use spaces or dashes in the name.
You can manually specify a page name to make the title displayed on the page more descriptive and easier to read. For instance, compare the title Resizing Your Photos with Photos/ResizingPhotos. To do so, insert #title Page Name as the first line in a document.
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 InstallingServerSoftware, it would be better to use the title Installing Server Software than Adding Server Apps.
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
Type the address for the new page into the address bar of your browser. Since the page does not exists because you performed the searches discussed above, MoinMoin will suggest to create it.
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
- Edit another page
Add a link to the new page, preferably like this: [[PageName|Page Name]]
- Save the page and click the new link
- Click one of the template names
- Edit your new page and save it
For more information on linking to other pages, see HelpOnLinking.
By using the NewPage macro
Enter the page name in the text box and click "Create New Page"
- Edit your page and save it
By using the GoTo macro
Enter the page name in the text box and click "Go To Page"
- Click "Create new page"
- Edit your page and save it
Advanced
To learn about creating and using template pages see HelpOnTemplates.
To learn more how to set variables see HelpOnVariables
Go back to WikiGuide