Differences between revisions 12 and 30 (spanning 18 versions)

Beginner's Introduction

Contents

Beginner's Introduction

This is a beginner's guide to editing wiki pages in the APL wiki. For general advice how to use MoinMoin-based wikis, see WikiCourse

It will be helpful to open up several browser windows when first experimenting with the wiki.

Preconditions for changing/adding pages

Note that you must create a user account and log into the wiki before you can do anything potentially harmful like changing, deleting or adding a page.

Wiki Markup

It is recommended that you start on the sandbox to learn the general wiki syntax and to gain some experience: http://sandbox.aplwiki.com

Another good place to start is to create or polish your personal home page.

Want to contribute to the wiki but not willing to learn the wiki syntax?

Ask for help on comp.lang.apl - there is a good chance that someone will volunteer.

How to create a new page

You can add a new page in two different ways.

The "CreateNewPage" command

Select the "CreateNewPage" command from the "More Actions" combo box displayed on top and at the bottom of each page.

Keep in mind that this leaves that page unconnected to the rest of the wiki: that is why such a page is called an orphan. If you are not sure where to put your newly created page, this is the right way to create it. Others will probably add links to the new page on other pages sooner or later when it makes sense to do so.

Note that even orphaned pages can be found by the search tool. Since any page should belong to at least one Category, orphaned pages can also be found via the Categories theu belong to.

Create a link on an existing page

Look for an appropriate page you want to put the 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; Refer to HelpOnLinking for details.
Click at the link you've just created. This gives you the opportunity to creat 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 <kai AT VERY SPAMFREE aplteam DOT com>

-  ⇤ ← Revision 12 as of 2007-01-14 22:51:25 → 
  Size: 3095
  Editor: KaiJaeger
  Comment:
+   ← Revision 30 as of 2010-01-24 07:46:41 → ⇥
  Size: 2239
  Editor: KaiJaeger
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-#acl AutoAdminGroup:read,write,delete,revert,admin All:read
-Line 3:
+Line 2:
+<<TableOfContents>>
 Line 4:
-This is a beginner's guide to editing wiki pages.
+This is a beginner's guide to editing wiki pages in the APL wiki. For general advice how to use !MoinMoin-based wikis, see WikiCourse
 Line 8:
+== Preconditions for changing/adding pages ==
Note that you '''must''' create a user account and log into the wiki before you can do anything potentially harmful like changing, deleting or adding a page.
-Line 9:
+Line 12:
+It is recommended that you start on the sandbox to learn the general wiki syntax and to gain some experience: http://sandbox.aplwiki.com
-Line 10:
+Line 14:
-In a browser window, navigate to the page [WWW] http://s176276151.online.de/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.
+Another good place to start is to create or polish your personal home page.
-Line 12:
+Line 16:
-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.
+== Want to contribute to the wiki but not willing to learn the wiki syntax? ==
Ask for help on comp.lang.apl - there is a good chance that someone will volunteer.
-Line 14:
+Line 19:
-For a more complex example, navigate to !ExampleNumber. The route from the front page is http://s176276151.online.de/testwiki/moin.cgi/ExampleNumber1. Again, select menu item "Show Raw Text" to see the text.
+== How to create a new page ==
You can add a new page in two different ways.
-Line 16:
+Line 22:
-== Useful Pages ==
+=== The "CreateNewPage" command ===
Select the "!CreateNewPage" command from the "More Actions" combo box displayed on top and at the bottom of each page.
-Line 18:
+Line 25:
-In another browser window, navigate to the wiki front page http://s176276151.online.de/aplwiki/ 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.
+Keep in mind that this leaves that page unconnected to the rest of the wiki: that is why such a page is called an orphan. If you are not sure where to put your newly created page, this is the right way to create it. Others will probably add links to the new page on other pages sooner or later when it makes sense to do so.
-Line 20:
+Line 27:
-It will be helpful to bring up the Syntax Reference in another browser window.
+Note that even orphaned pages can be found by the search tool. Since any page should belong to at least one Category, orphaned pages can also be found via the Categories theu belong to.
-Line 22:
+Line 29:
-== 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://s176276151.online.de/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.

== Creating a New Page ==

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:

 * `[: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.
+=== Create a link on an existing page ===
 1. Look for an appropriate page you want to put the 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; Refer to HelpOnLinking for details.
 1. Click at the link you've just created. This gives you the opportunity to creat a new page from scratch.
-Line 44:
+Line 35:
-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
+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 AT VERY SPAMFREE aplteam DOT com)>>