Difference between revisions of "Add a page to the wiki"

From LinuxMCE
Jump to: navigation, search
(Creating a page via search)
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
{| align="right"
 
  | __TOC__
 
  |}
 
 
[[Category:Tutorials]]
 
 
[[Category: Wiki administration]]
 
[[Category: Wiki administration]]
  
  
== Introduction ==
+
This wiki is community driven. If you don't add information about the hardware with which you have experience, there is little chance that somebody else is going to do it (unless they happen to have the same device). Please don't be shy about adding a wiki page to this guide -- we really need your help! If a page already exists for the hardware you are using, feel free to add your experience to it. You can use the "discussion" tab at the top of the page to discuss with others, or use the [http://forum.linuxmce.org/ forum] if you have any questions.
 
+
This wiki is community driven. If you don't add information about the hardware with which you have experience, there is little chance that somebody else is going to do it (unless they happen to have the same device). Please don't be shy about adding a wiki page to this guide -- we really need your help! If a page already exists for the hardware you are using, feel free to add your experience to it. You can use the "discussion" tab at the top of the page to discuss with others, or use the [http://forum.linuxmce.org/ forum] is you have any questions.
+
  
 +
{{p}}
  
 
== How to add a new page==
 
== How to add a new page==
Line 23: Line 17:
  
 
* Searching for the article: the Wiki engine will perform a [[Special:Search | search]] for the new title <br> and create the article when the search finds nothing matching.
 
* Searching for the article: the Wiki engine will perform a [[Special:Search | search]] for the new title <br> and create the article when the search finds nothing matching.
* Following a link to a non-existent page: non-existent pages are indicated by page names highlighted in read like this: [[help:non-existent page|non-existent page]]
+
* Following a link to a non-existent page: non-existent pages are indicated by page names highlighted in read like this: [[help:color of a non-existent page|color of a non-existent page]]
 
* Follow the link to the new page
 
* Follow the link to the new page
 
Your new page will be created when you save the article.  
 
Your new page will be created when you save the article.  
Line 31: Line 25:
 
==== Using the template <nowiki>{{SERVER}}{{localurl:Name of the new page to create}}</nowiki>====
 
==== Using the template <nowiki>{{SERVER}}{{localurl:Name of the new page to create}}</nowiki>====
 
Typing a URL to a new page and editing the page name part of an existing page's URL will both start the page creation process.
 
Typing a URL to a new page and editing the page name part of an existing page's URL will both start the page creation process.
* Use the root of the wiki and append the name of the new article you want to create. You can use the template <nowiki> '''{{SERVER}}{{localurl:Name of the new page to create}}'''</nowiki> <br>The above template creates the link "{{SERVER}}{{localurl:Name of the new page to create}}".
+
* Use the root of the wiki and append the name of the new article you want to create. You can use the template '''<nowiki> {{SERVER}}{{localurl:Name of the new page to create}}</nowiki>'''
* Copy the template, paste it on you user page or any page in edit mode, and replace the "'''New page to create'''" part with the name/title of the page you want to create.  
+
* The above template creates the following link: {{SERVER}}{{localurl:Name of the new page to create}} <br>To use it, copy the template, paste it on you user page (or any other page) in edit mode, and replace the "'''New page to create'''" part with the name/title of the page you want to create.
* Click on the "Show preview button at the bottom of the page. The template will turn into a link when the preview is loaded.
+
* Click on the "Show preview button at the bottom of the page. <br>The template will turn into a link when the preview is loaded.
 
* Follow the resulting link to the new page.
 
* Follow the resulting link to the new page.
 
* Click on the '''Create''' tab on top of the page.
 
* Click on the '''Create''' tab on top of the page.
Line 42: Line 36:
 
==== Creating a page via URL ====
 
==== Creating a page via URL ====
 
To add a new page, just type in a new URL into your browser like this:
 
To add a new page, just type in a new URL into your browser like this:
 +
''<nowiki>http://wiki.linuxmce.org/index.php/Name of the page you want to add</nowiki>''
  
: ''<nowiki>http://wiki.linuxmce.org/index.php/Name of the page you want to add</nowiki>''
+
Simply go to this URL with your browser and start editing the newly created webpage.
 +
{{p}}
  
The preferred URL naming convention for hardware, for example, is:
+
;Note: '''The wiki will replace any spaces with underscores automatically'''.
  
: ''<nowiki>http://wiki.linuxmce.org/index.php/Manufacturer Model-Type-Etcetera</nowiki>''
+
Please follow the naming standards when adding information. The preferred URL naming convention for hardware related pages is "Manufacturer Model-Type-Etcetera". The resulting URL from the example above would be: ''<nowiki>http://wiki.linuxmce.org/index.php/Manufacturer Model-Type-Etcetera</nowiki>''
  
The URL of this page is:
+
{{p}}
+
:''<nowiki>http://wiki.linuxmce.org/index.php/Add_a_page_to_the_wiki</nowiki>''
+
 
+
'''The wiki will replace any spaces with underscores automatically'''. Simply go to this URL with your browser and start editing the newly created webpage.
+
  
 
== Categorize your new page==
 
== Categorize your new page==
To categorize your new page, add tags like these at the top:
+
When adding a new page, it is important to position it in the proper place in the table of contents. To place your article in the right location, add it to the proper category.
 +
 
 +
To categorize your new page, add tags like these anywhere in the document:
  
 
: <nowiki>[[Category: Automation]]</nowiki>
 
: <nowiki>[[Category: Automation]]</nowiki>
 
: <nowiki>[[Category: Mainboards]]</nowiki>
 
: <nowiki>[[Category: Mainboards]]</nowiki>
  
That way the page will automatically be listed in these categories, making it easier to find.
+
This will automatically list the page in the specified categories, making it easier to find.
See: [[Special:Categories]] for a list of all available categories. Also check out subcategories, such as the subcategories of the [[:Category: Hardware|Hardware category]], to find the appropriate subcategory.
+
  
== Add content==
+
The list of all available categories is [[Special:Categories|available here]]. Consult it to pick the right categories for the page you creating. <br>
Add anything you feel is relevant.  See [[Help:Editing|Editing help]] for some tips and examples on the markup you can use.
+
Look for subcategories, such as the subcategories of the [[:Category: Hardware|Hardware category]], to find an appropriate subcategory. Always use a subcategory whenever possible to keep the top of the category tree clean.
  
==Add hyperlinks ('wikification')==
+
{{p}}
  
*For links to Categories, use the format  <nowiki>[[:Category: Hardware]]</nowiki>.  
+
== Add content==
 +
Add anything you feel is relevant.
  
*To use the actual text of a hyperlink, use this format: <nowiki>[[Actual Name of Webpage]]</nowiki>, which will be displayed as [[Actual Name of Webpage]].
+
==== Editing and syntax help ====
 +
For help  on how to create and edit pages in this wiki, read [[Add a page to the wiki]], [[:help:editing advanced|editing articles]], [[:help:editing|editing]], and [[Short Howto on Wiki]]. Be sure to take note of the standard [[LinuxMCE wiki:Community Portal#Handy templates|templates]] and [[UsageTemplateVersionInfo|Versioninfo]]. The list of available templates is [http://wiki.linuxmce.org/index.php?title=Special%3AAllPages&from=0&to=Z&namespace=10 here]
  
*To use alternate text for the hyperlink, use this format:  <nowiki>[[Actual_Name_of_webpage|What I Want It to Say]]</nowiki>, which will be displayed as 
+
{{p}}
[[Actual_Name_of_webpage|What I Want It to Say]].
+
  
 
==Move the Table of Contents to the right==
 
==Move the Table of Contents to the right==
Line 83: Line 77:
 
   | __TOC__
 
   | __TOC__
 
   |}</nowiki>
 
   |}</nowiki>
 +
 +
{{p}}
 +
 +
== Reference ==
 +
The old version of this page can be found at [[Help:Adding pages to the wiki - archive|Adding pages to the wiki - archive]]
 +
 +
{{p}}

Latest revision as of 15:22, 19 October 2012


This wiki is community driven. If you don't add information about the hardware with which you have experience, there is little chance that somebody else is going to do it (unless they happen to have the same device). Please don't be shy about adding a wiki page to this guide -- we really need your help! If a page already exists for the hardware you are using, feel free to add your experience to it. You can use the "discussion" tab at the top of the page to discuss with others, or use the forum if you have any questions.



How to add a new page

Please take the time search through the existing articles before creating a new one. To avoid duplications and confusion, add to existing pages. Only create a new page if the subject does not exist.



Creating a page via search

A request for a page is all it takes to create it.

You can create a new page by:

  • Searching for the article: the Wiki engine will perform a search for the new title
    and create the article when the search finds nothing matching.
  • Following a link to a non-existent page: non-existent pages are indicated by page names highlighted in read like this: color of a non-existent page
  • Follow the link to the new page

Your new page will be created when you save the article.



Using the template {{SERVER}}{{localurl:Name of the new page to create}}

Typing a URL to a new page and editing the page name part of an existing page's URL will both start the page creation process.

  • Use the root of the wiki and append the name of the new article you want to create. You can use the template {{SERVER}}{{localurl:Name of the new page to create}}
  • The above template creates the following link: http://wiki.linuxmce.org/index.php/Name_of_the_new_page_to_create
    To use it, copy the template, paste it on you user page (or any other page) in edit mode, and replace the "New page to create" part with the name/title of the page you want to create.
  • Click on the "Show preview button at the bottom of the page.
    The template will turn into a link when the preview is loaded.
  • Follow the resulting link to the new page.
  • Click on the Create tab on top of the page.

Your new page will be created when you save the article.



Creating a page via URL

To add a new page, just type in a new URL into your browser like this: http://wiki.linuxmce.org/index.php/Name of the page you want to add

Simply go to this URL with your browser and start editing the newly created webpage.

Note
The wiki will replace any spaces with underscores automatically.

Please follow the naming standards when adding information. The preferred URL naming convention for hardware related pages is "Manufacturer Model-Type-Etcetera". The resulting URL from the example above would be: http://wiki.linuxmce.org/index.php/Manufacturer Model-Type-Etcetera



Categorize your new page

When adding a new page, it is important to position it in the proper place in the table of contents. To place your article in the right location, add it to the proper category.

To categorize your new page, add tags like these anywhere in the document:

[[Category: Automation]]
[[Category: Mainboards]]

This will automatically list the page in the specified categories, making it easier to find.

The list of all available categories is available here. Consult it to pick the right categories for the page you creating.
Look for subcategories, such as the subcategories of the Hardware category, to find an appropriate subcategory. Always use a subcategory whenever possible to keep the top of the category tree clean.



Add content

Add anything you feel is relevant.

Editing and syntax help

For help on how to create and edit pages in this wiki, read Add a page to the wiki, editing articles, editing, and Short Howto on Wiki. Be sure to take note of the standard templates and Versioninfo. The list of available templates is here



Move the Table of Contents to the right

Whenever you have more than four subdivisions in a page, a Table of Contents is automatically added. It you would like this table of contents to be moved to the right side of the screen (at the top), add the following code to the top of your web page:

{| align="right"
  | __TOC__
  |}



Reference

The old version of this page can be found at Adding pages to the wiki - archive