Differences between revisions 27 and 28

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 TestPage to learn the general wiki syntax and to gain some experience. You will find special beginners advice on this page and all other pages with names starting with "TestPage".

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 27 as of 2009-06-02 08:41:30 → 
  Size: 2214
  Editor: SimonMarsden
  Comment: Typo correction
+   ← Revision 28 as of 2009-06-14 06:49:48 → ⇥
  Size: 2323
  Editor: KaiJaeger
  Comment: Improved
-Deletions are marked like this.
+Additions are marked like this.
 Line 2:
+<<TableOfContents>>
-Line 7:
+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 8:
+Line 12:
+It is recommended that you start on the TestPage to learn the general wiki syntax and to gain some experience. You will find special beginners advice on this page and all other pages with names starting with "!TestPage".
-Line 9:
+Line 14:
-It is strongly recommended that you start on the TestPage to learn the general wiki syntax and to gain some experience. You will find special beginners advice on this page and all other pages with names starting with "!TestPage".
+Another good place to start is to create or polish your personal home page.
-Line 12:
+Line 17:
-Line 15:
+Line 19:
-== Preconditions for changing/adding pages ==
+== How to create a new page ==
You can add a new page in two different ways.
-Line 17:
+Line 22:
-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.

== Creating a New Page ==

To add a new page to the Wiki follow these steps:

Note that there are two ways to create a new page:

=== The easiest way ===
+=== The "CreateNewPage" command ===
-Line 29:
+Line 25:
-Although this certainly is the easiest way to create a page, it leaves that page unconnected to the rest of the wiki: that is why such a page is called an orphan. However, one of the administrators will care about this sooner or later. If you are not sure where to put your newly created page, this is the right way to create it.
+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 31:
+Line 27:
-Note that even orphaned pages can be found by the search tool, and that they might be found via Categories as well.
+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 33:
+Line 29:
-=== The recommended way ===

 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.
+=== 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 40:
+Line 35: