Difference between revisions of "Wiki Team/Guide/Page Creation"

From Sugar Labs
Jump to navigation Jump to search
Line 1: Line 1:
=Introduction=
+
{{TOCright}}
 +
==Introduction==
 
This section deals with how to create pages on the Sugar Labs wiki.
 
This section deals with how to create pages on the Sugar Labs wiki.
  
=Search and Integrate. Don't Duplicate.=
+
==Search and Integrate. Don't Duplicate.==
 
Before adding a page to the wiki, make sure you do a comprehensive search.
 
Before adding a page to the wiki, make sure you do a comprehensive search.
  
==Search==
+
===Search===
 
*[[Special:RecentChanges|Recent Changes]] - See where people are currently working.
 
*[[Special:RecentChanges|Recent Changes]] - See where people are currently working.
 
*[[Special:Search|Search]] - Search or browse the database in various ways.
 
*[[Special:Search|Search]] - Search or browse the database in various ways.
 
*[[Special:AllPages|All Pages]] - A list of all pages in the wiki.
 
*[[Special:AllPages|All Pages]] - A list of all pages in the wiki.
  
==Integrate==
+
===Integrate===
 
* Don't add another page if a guide, article, or document already exists on a particular subject.
 
* 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!
 
* 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.
 
* Either add or integrate the material with the existing page in the appropriate place.
  
=Create the Page=
+
==Create the Page==
 
There are several ways to create a new page but all of them require that you first Log-in
 
There are several ways to create a new page but all of them require that you first Log-in
  
==By visiting the page==
+
===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, MediaWiki will suggest to create it.
 
# 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, MediaWiki 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.  
 
# 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==
+
===Add a link on another page===
 
# Edit another page
 
# Edit another page
 
# Add a link to the new page as <nowiki>[[Name With Spaces]]</nowiki>
 
# Add a link to the new page as <nowiki>[[Name With Spaces]]</nowiki>
Line 29: Line 30:
 
# Edit your new page and save it
 
# Edit your new page and save it
  
==Page structure==
+
===Page structure===
  
=== Consistency ===
+
====Consistency ====
 
Try to reuse the markup from a sibling page or another page at the same level.
 
Try to reuse the markup from a sibling page or another page at the same level.
  
=== Categorize ===
+
==== Categorize ====
 
We make extensive use of category tags in the wiki. Please add an appropriate tag to any new page you create. It is simply a matter of adding a category at the end of the page, e.g., <tt><nowiki>[[Category:Wiki]]</nowiki></tt> will add the [[:Category:Wiki|Wiki category]] to a page.  See [[Special:Categories]] for all categories.
 
We make extensive use of category tags in the wiki. Please add an appropriate tag to any new page you create. It is simply a matter of adding a category at the end of the page, e.g., <tt><nowiki>[[Category:Wiki]]</nowiki></tt> will add the [[:Category:Wiki|Wiki category]] to a page.  See [[Special:Categories]] for all categories.
  
 
[[Category:Wiki]]
 
[[Category:Wiki]]
 +
[[Category:HowTo]]

Revision as of 00:59, 15 April 2009

Introduction

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

Search and Integrate. Don't Duplicate.

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

Search

  • Recent Changes - See where people are currently working.
  • Search - Search or browse the database in various ways.
  • All Pages - A list of all pages in the wiki.

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.

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 exists because you performed the searches discussed above, MediaWiki 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.

Add a link on another page

  1. Edit another page
  2. Add a link to the new page as [[Name With Spaces]]
  3. Save the page and click the new link
  4. Click one of the template names
  5. Edit your new page and save it

Page structure

Consistency

Try to reuse the markup from a sibling page or another page at the same level.

Categorize

We make extensive use of category tags in the wiki. Please add an appropriate tag to any new page you create. It is simply a matter of adding a category at the end of the page, e.g., [[Category:Wiki]] will add the Wiki category to a page. See Special:Categories for all categories.