This shows you the differences between two versions of the page.
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) | ||
\\ \\ \\ | \\ \\ \\ |