User Tools

Site Tools


pmip3:wiki_help

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
pmip3:wiki_help [2009/01/30 17:46]
jypeter added note about discussion and r/o access
pmip3:wiki_help [2009/02/06 15:19]
jypeter Added link to the official manual
Line 1: Line 1:
 +~~ODT~~
 +
 ====== Using the PMIP3 wiki ====== ====== Using the PMIP3 wiki ======
  
 ===== The basics ===== ===== The basics =====
  
-  * If you have a **read-only** access to the pages, you can navigate ​this site as you would any other site.\\ You may want to click on the //Old revisions// button ​at the top/bottom of each page, if you want to see who changed what (in the current ​page).\\ Note that you can use the Discussion sections of the pages (when available) even if you have only **read-only** access+  ​* **If you are lost** in the pages, ​remember that you can navigate ​back up to the [[pmip3:​index|main page]] by clicking ​on the links in the **//You are here//** line just above the page's title.\\ You can also use the links at the bottom of each page to go back to this or the main page, and use the **//Index//** button at the bottom right to list all the sections/​pages you are allowed to access, and go directly to a specific 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.\\ You can use the basic formatting tools at the top of edit window, or visit the [[wiki:​syntax|Wiki syntax]] page to learn more about formatting.\\ \\ 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.+  * If you have a **read-only access** to the pages, you can navigate this site as you would any other site.\\ You may want to click on the //Old revisions// button at the top/bottom of each page, if you want to see who changed what (in the current page).\\ Note that you can use the Discussion sections of the pages (when available) even if you have only **read-only** access 
 + 
 +  * 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.\\ \\ 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]]).\\ \\ 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.\\ \\ Notes: 
 +    * 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: <​code>​__* An item on \\_2 lines...\\_with a bonus 3rd line 
 +____* and a sub_item</​code>​ will appear as: 
 +        * An item on \\ 2 lines...\\ with a bonus 3rd line 
 +          * and a sub-item 
 +    * 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 :-) 
 + 
 +  * 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)
  
 ===== Non standard wiki features ===== ===== Non standard wiki features =====
Line 11: Line 23:
 We have added the following features to this wiki. They are documented only here (and **not** in the [[wiki:​syntax|Wiki syntax]] page) We have added the following features to this wiki. They are documented only here (and **not** in the [[wiki:​syntax|Wiki syntax]] page)
  
-==== Open Office ​export ​====+==== Exporting to the Open Office ​format ​====
  
 Some pages can be exported in the //''​.odt''​ Open Document// format. Some pages can be exported in the //''​.odt''​ Open Document// format.
Line 17: Line 29:
 Look for the special icon at the top of the concerned pages! Look for the special icon at the top of the concerned pages!
  
-==== Notes ====+[[http://​www.dokuwiki.org/​plugin:​odt|More info]] on the //odt// plugin 
 + 
 +==== Adding fancy boxes ==== 
 + 
 +You can use many kind of boxes! Note that if the boxes seem to //float and mix// with the regular text of the page, you should add a ''​%%~~CLEARFLOAT~~%%''​ or ''​%%~~CL~~%%''​ directive after your %%<​box>​...</​box>​%% directive 
 + 
 +<​code><​box>​Basic box</​box></​code>​ 
 +<​box>​Basic box</​box>​ 
 +~~CLEARFLOAT~~ 
 + 
 +<​code><​box red left>Red left-justified box</​box></​code>​ 
 +<box red left>Red left-justified box</​box>​ 
 +~~CLEARFLOAT~~ 
 + 
 +<​code><​box blue right round>​Blue right-justified //round// box</​box></​code>​ 
 +<box blue right round>​Blue right-justified //round// box</​box>​ 
 +~~CLEARFLOAT~~ 
 + 
 +<​code><​box rgb(200,​255,​200)>​Light green box</​box></​code>​ 
 +<box rgb(200,​255,​200)>​Light green box</​box>​ 
 +~~CLEARFLOAT~~ 
 + 
 +[[http://​wiki.jalakai.co.uk/​dokuwiki/​doku.php/​tutorial/​boxes|More info]] and [[http://​wiki.jalakai.co.uk/​dokuwiki/​doku.php/​test/​boxes|many examples]] on the //box// plugin 
 + 
 +==== Adding notes ====
  
 It is possible to insert 3 types of note in the pages: It is possible to insert 3 types of note in the pages:
 +
  
 <​note>​%%<​note>​My note</​note>​%%</​note>​ <​note>​%%<​note>​My note</​note>​%%</​note>​
Line 28: Line 65:
  
 <note warning>​%%<​note warning>​My note</​note>​%%</​note>​ <note warning>​%%<​note warning>​My note</​note>​%%</​note>​
 +
 +[[http://​wiki.splitbrain.org/​plugin:​note|More info]] on the //note// plugin
 +
 +===== More advanced stuff... =====
 +
 +If you **really** want to know more, or if you get stuck...
 +
 +==== Creating a new 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).
 +
 +==== Page locks ====
 +
 +  * When you edit a page on this wiki, you are the temporary //owner// of the page (i.e. you have a //lock// on the page) during 15 minutes, which should give you plenty of time to validate your changes. Anyway, the //lock// is renewed for 15 minutes each time you click on the //Preview// button, and the wiki will even warn you when your lock is about to expire with the following popup message:\\ <​code>​Your lock for editing this page is about to expire in a minute.
 +To avoid conflicts use the preview button to reset the locktimer.</​code>​
 +
 +  * There is a (very) slight chance that somebody else will already be editing the page you want to update... You will then get an error message looking like:\\ <​code>​This page is currently locked for editing by another user.
 +You have to wait until this user finishes editing or the lock expires. ​
 +
 +  * Currently locked by: jypeter
 +  * Lock expires at: 2009/02/03 10:10 (6 min)</​code>​ In that case, just try again a few minutes later, when the other person is done editing.
 +
 +==== Questions and Answers ====
 +
 +  * **Q:** How can I see what pages have been changed recently
 +    * **A:** Click on the //Recent changes// button at the top right of any page, click [[https://​pmip3.lsce.ipsl.fr/​wiki/​doku.php?​do=recent|here]] (you can bookmark this link) or look at the [[pmip3:​whoswho#​recent_changes|recent changes page]]
 +
 +  * **Q:** What has changed in the current page since the last time I visited it?
 +    * **A:** Just click on the **Old revisions** button at the top/bottom left of the page. It will show when the page has been changed and by whom. It will also show a change summary message if the person who did the change did not forget to supply it!
 +
 +  * **Q:** Why am I getting an **Edit Draft** button instead of the expected **Edit this page** button?
 +    * **A:** The page was not properly saved by the previous person. It is probably safer to //discard// the draft and start with a fresh  version of the page. Click on //Edit Draft// then //Delete Draft//...
 +
 +  * **Q:** Something must have gone really wrong, because the page that I edited and saved does not look at all correct. Help! :-(
 +    * **A:** It is always possible (though highly unlikely) that something you do drastically alters the appearance of a page, but this is not a major problem.
 +      - Exit your browser, restart it and go back to the page you were editing. If clearing the cache of your browser this way did not help, try the next step.
 +      - On the //bad// page, click on the **Old revisions** button at the top/bottom left of the page. This will show you all the changes that were done to the page. The topmost line (most recent change) should be the change **you** just made, with the //Edit summary// **you** wrote.
 +        * Click on the next (second) line, on the green ''​pmip3://​wiki_path//''​ link. This will display the page how it was //before// you started editing it.
 +        * You can then edit this //old// version of the page, without making mistakes and save it.
 +        * Or you can just edit it and save it without modifications,​ with an Edit summary looking like\\ //Page reverted to its old state of 2009/02/02 16:19//.
 +      - If nothing above worked, get in touch with the [[pmip2web@lsce.ipsl.fr|Jean-Yves Peterschmitt]].
  
  
pmip3/wiki_help.txt · Last modified: 2009/02/09 14:28 by jypeter