User Tools

Site Tools


pmip3:wiki_help_create

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision Both sides next revision
pmip3:wiki_help_create [2009/02/06 17:45]
jypeter created
pmip3:wiki_help_create [2009/02/09 09:45]
jypeter More instructions...
Line 1: Line 1:
 ====== Editing and creating PMIP3 wiki pages ====== ====== Editing and creating PMIP3 wiki pages ======
  
-<note warning>​Thank you for reading these instructions at least once...</​note>​+<note warning>​Thank you for reading these instructions at least once! :-)</​note>​
  
-===== Editing a page =====+===== Editing a(n existing) ​page =====
  
-If you have **write access** to some or all pages, you can change them by clicking on the //Edit this page// button at the top/bottom of each page.\\ +If you have **write access** to some or all pages, you can change them by clicking on the //Edit this page// button at the top/​bottom ​left of each page.
  
-You can use the basic formatting tools at the top of the edit window, or visit the [[wiki:​syntax|Wiki syntax]] page to learn more about formatting ​(you can also get more advanced ​information ​in the [[http://​www.dokuwiki.org/​manual|manual]]).\\ +You can use the basic formatting tools at the top of the edit window, or visit the [[wiki:​syntax|Wiki syntax]] page to learn more about formatting. You can also get information on more advanced ​topics ​in the [[http://​www.dokuwiki.org/​manual|manual]].
  
-Once you are happy with your changes, please make sure that you **write a summary of what you changed** in the Edit summary input zone **before you save** the changes.\\ +Once you are happy with your changes, please make sure that you **write a summary of what you changed** in the //Edit summary// input zone **before you save** the changes.
  
-==== Item lists ====+==== Do not navigate away from the page you are editing... ​====
  
 +You may be tempted to use the //​Backward//​ and //Forward// buttons of your web browser (usually left and right arrows), when navigating on the wiki. Please refrain from using these buttons when you are editing a page and you have not saved your changes, if you do not want to lose your work!
  
-There is a good chance ​you will use lots of **item lists** and need to know more about them:​\\ ​+Luckily for you, pages are //​auto-saved//​ regularly when you edit them. If you navigate away or lose your connection, the wiki will probably offer an //​Edit/​Recover Draft// option when you travel back to the page you were editing.
  
-The lines starting with **''​*''​** will appear as an item list (use **''​-''​** for an //ordered// item list).\\ ​+==== Item lists ====
  
-Make sure that there are **2 spaces** (spaces are shown as '​_'​ below) before the '​*'​ and that the item lines are **not separated by blank lines**. If you want to force a //newline// in an item, use '​**%%\\_%%**'​ (2 backslashes followed by a space).\\ +There is a good chance you will use lots of **item lists** and need to know more about them: 
 + 
 +The lines starting with **''​*''​** will appear as an item list (use **''​-''​** for an //ordered// item list). 
 + 
 +Make sure that there are **2 spaces** (spaces are shown as '​_'​ below) before the '​*'​ and that the item lines are **not separated by blank lines**. If you want to force a //newline// in an item, use '​**%%\\_%%**'​ (2 backslashes followed by a space).
  
 Example: Example:
Line 30: Line 35:
           * and a sub-item           * and a sub-item
  
-==== Use Backward and Forward carefully... ​====+==== Practising ​====
  
- +You can visit the [[playground:​|Playground]] and experiment with the wiki features there, if you want to practise before changing actual PMIP3 pages :-)
-    * You may be tempted to use the //​Backward//​ and //Forward// buttons of your web browser (usually left and right arrows), when navigating on the wiki. Please refrain from using these buttons when you are editing a page and you have not saved your changes, if you do not want to lose your work! +
-    * You can visit the [[playground:​|Playground]] and experiment with the wiki features there, if you want to practise before changing actual PMIP3 pages :-)+
  
 ===== Creating a page ===== ===== Creating a page =====
  
 +==== Pagenames and namespaces ====
 +
 +A page is defined by its name (pagename) and its location in the wiki page hierarchy (aka namespaces). You may want to read the documentation about [[http://​www.dokuwiki.org/​pagename|pagenames]] and [[http://​www.dokuwiki.org/​namespaces|namespaces]].
 +
 +The PMIP3 structure looks like:
 +
 +| ''​pmip3:​index''​ |  home page  |
 +| ''​pmip3:​section:​index''​ |  main page of a section ​ |
 +| ''​pmip3:​section:​my_page''​ |  a page in the same section ​ |
 +| ''​pmip3:​section:​subsection:​index''​ |  main page of the subsection ​ |
 +| ''​pmip3:​section:​subsection:​my_page''​ |  a page in the same subsection ​ |
 +
 +==== Page creation ====
 +
 +You need to have **write access** to a namespace in order to **create a new page** or (sub-)namespace in there. Depending on your [[pmip3:​whoswho#​wiki_users|group]],​ you may or may not have write access to all the PMIP3 wiki. If your page is in a non-existing namespace, the new namespace will also be created.
 +
 +  * You can create a page by clicking on a link to it on an existing page. A link to a non-existing page appears in [[pmip3:​dummy_namespace:​stupid_subspace:​example_page|red]] (you can click on the //''​red''//​ page link but please refrain from creating the [[pmip3:​dummy_namespace:​stupid_subspace:​example_page]] !).
 +
 +  * You can also create a page by typing the //address// of the new page directly in the address bar of your browser.\\ e.g. The [[pmip3:​dummy_namespace:​stupid_subspace:​example_page]] referenced above could also be created by typing directly the following link\\ %%https://​pmip3.lsce.ipsl.fr/​wiki/​doku.php/​pmip3:​dummy_namespace:​stupid_subspace:​example_page%%
 +
 +Once you are on a new page (the wiki will display ''//​This topic does not exist yet//''​),​ click on the //Create this page// button, edit the default page template and save the page.
 +
 +===== Removing a page =====
 +
 +If you want to remove a page, just edit it, remove all its content, and save the empty page.
  
-  * If you have **write access** and want to **create a new page**, please use [[pmip3:​blank_page|this template]]! You will find more help about page creation in the template itself (and the source of the template) 
  
 \\ \\ \\  \\ \\ \\ 
pmip3/wiki_help_create.txt · Last modified: 2009/02/09 14:29 by jypeter