APL Wiki|
Size: 3357
Comment:
|
Size: 1534
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 8: | Line 8: |
| == Wiki Markup == It is strongly recommended that you start with the test wiki: http://testwiki.aplteam.com/ to learn the general wiki syntax and to gain some experience. You will find special beginners advice in the test wiki. |
|
| Line 12: | Line 16: |
| == Wiki Markup == | == Preconditions for changing/adding pages == |
| Line 14: | Line 18: |
| In a browser window, navigate to the page [WWW] http://aplteam2.com/testwiki/, then select menu item "Show Raw Text" from the combo box menu to see the source text. Lines beginning ## are comments, lines beginning with a single # are instructions (none are needed for most pages), and the rest is wiki markup. Note the line #acl Admins:read,write,delete,revert,admin All:read at the top. This specifies access control, and indicates that admins hold all rights while anybody else has read-only access to this page. The !FrontPage! as well as the three "Example" pages are not editable by ordinary users, while the !TestPages are. This is to ensure a working starting point for the test wiki. For a more complex example, navigate to !ExampleNumber. The route from the front page is http://aplteam2.com/testwiki/moin.cgi/ExampleNumber1. Again, select menu item "Show Raw Text" to see the text. == Useful Pages == In another browser window, navigate to the wiki front page http://aplwiki.aplteam.com/ and then click at "About". Take a look at each of the main links on this page, and especially note that you need to login to edit the wiki, and read the editing guidelines and policy on attachments. It will be helpful to bring up the Syntax Reference in another browser window. == Experiment == Now that you have some idea of the wiki markup, it is time to try editing a page. You can do this by opening the test wiki site, at http://aplteam2.com/testwiki/ in another browser window. Select Login, and either create a new user identity, or use the existing one: ||Name||!TestUser|| ||Password||!TestUser|| This user really exists and can therefore be used in the test wiki to gain experience. Once you are logged in, return to the !FrontPage (on the test wiki site) and select the !TestPage for testing. Then click Edit to get the edit screen. If someone else is editing it right now, just enter a page name like Testing1, Testing2 etc. in the page url - this will give you a new page for testing. Make any changes you like, and click the Preview button towards the bottom of the screen. Next enter any comments in the Optional comment edit box, and click Save Changes. Your changes are now saved in the wiki. |
Note that you '''must''' create a user account and log into the wiki before you can change or add a page. |
| Line 41: | Line 22: |
| Edit the !TestPage again, and enter a new page link, as a line of the form below. Don't use !MyNewPage, but instead make up your own new page name: | To add a new page to the Wiki follow these steps: |
| Line 43: | Line 24: |
| * `[:Testing/MyNewPage:This is my new page]` Save Changes as before and click on the link. This gives another page with a link Create new empty page. Click this and your new page is created. |
1. Look for an appropriate page you want to put a link on. 1. Change that page by adding the link. Using !CamelCase is the easiest way to do so, but you can also use more sophisticated links; Refere to HelpOnLinking for details. 1. Click at the link you have just created. This gives you the opportunity to created a new page from scratch. |
Beginner's Introduction
This is a beginner's guide to editing wiki pages.
It will be helpful to open up several browser windows when first experimenting with the wiki.
Wiki Markup
It is strongly recommended that you start with the test wiki: http://testwiki.aplteam.com/ to learn the general wiki syntax and to gain some experience. You will find special beginners advice in the test wiki.
Want to contribute to the wiki but not willing to learn the wiki syntax?
In that case you can prepare your document in your preferred text editor and email it to KaiJaeger when ready. I am willing to put it on the wiki for you. However, I must be able to open your document in Word.
Preconditions for changing/adding pages
Note that you must create a user account and log into the wiki before you can change or add a page.
Creating a New Page
To add a new page to the Wiki follow these steps:
- Look for an appropriate page you want to put a link on.
Change that page by adding the link. Using CamelCase is the easiest way to do so, but you can also use more sophisticated links; Refere to HelpOnLinking for details.
- Click at the link you have just created. This gives you the opportunity to created a new page from scratch.
Next Steps
You should now be ready to edit pages on the APL wiki. See EditingGuidelines for more details. If you need further help, email to [MAILTO]kai@aplteam.com