Differences between revisions 1 and 22 (spanning 21 versions)

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 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".

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 <kai AT aplteam DOT com> 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:

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

The easiest way

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

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 this is called an orphan. However, one of the administrator will care about this sooner or later. If you are not sure where you newly created page should go that it the right way to create it.

The recommended way

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 <kai AT aplteam DOT com>

-  ⇤ ← Revision 1 as of 2007-01-14 10:11:36 → 
  Size: 2994
  Editor: KaiJaeger
  Comment:
+   ← Revision 22 as of 2008-08-27 06:43:23 → ⇥
  Size: 2094
  Editor: KaiJaeger
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 9:
-In a browser window, navigate to the page [WWW] http://s176276151.online.de/testwiki/, then select menu item Show Raw Text 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.
+It is strongly recommended that you start with 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 11:
-For a more complex example, navigate to Essays/The Ball Clock Problem. The route from the front page is Code Workshop | Essays | Ball Clock Problem. Again, select menu item Show Raw Text to see the text.
+== Want to contribute to the wiki but not willing to learn the wiki syntax? ==
 Line 13:
-Next, navigate to the wiki front page [WWW] http://www.jsoftware.com/jwiki/FrontPage and select menu item Show Raw Text. Note the line #acl All:read at the top. This specifies access control, and indicates that everyone has read-only access to this page. This is one of the few pages on the wiki that is not editable by all users.
Useful Pages
+In that case you can prepare your document in your preferred text editor and email it to <<MailTo(kai AT aplteam DOT com)>> when ready. I am willing to put it on the wiki for you. However, I must be able to open your document in Word.
-Line 16:
+Line 15:
-In another browser window, navigate to the wiki front page [WWW] http://www.jsoftware.com/jwiki/FrontPage and then to the About page. 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.
+== Preconditions for changing/adding pages ==
-Line 18:
+Line 17:
-It will be helpful to bring up the Syntax Reference in another browser window.
Experiment
+Note that you '''must''' create a user account and log into the wiki before you can change or add a page.
-Line 21:
+Line 19:
-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 [WWW] http://www.jsoftware.com/testwiki in another browser window. Select Login, and either create a new user identity, or use the existing one:
+== Creating a New Page ==
-Line 23:
+Line 21:
-    *
+To add a new page to the Wiki follow these steps:
-Line 25:
+Line 23:
-      Name         PeterSimple
      Password     psimple
+Note that there are two ways to create a new page:
-Line 28:
+Line 25:
-Once you are logged in, return to the FrontPage (on the test wiki site) and select this page Testing 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.
+=== The easiest way ===
-Line 30:
+Line 27:
-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
+Select the "!CreateNewPage" command from the "More Actions" combo box displayed on top and at the bottom of each page.
-Line 33:
+Line 29:
-Edit the Testing page 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:
+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 this is called an orphan. However, one of the administrator will care about this sooner or later. If you are not sure where you newly created page should go that it the right way to create it.
-Line 35:
+Line 31:
-    *
+=== The recommended way ===
-Line 37:
+Line 33:
-      [:Testing/MyNewPage:This is my new page]
+. 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.
-Line 39:
+Line 37:
-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.
Next Steps
+== Next Steps ==
-Line 42:
+Line 39:
-You should now be ready to edit the main J wiki pages. See EditingGuidelines for more details. If you need further help, email either to the General mailing list, see [WWW] forums, or to [MAILTO]wiki@jsoftware.com.

last edited 2006-12-07 06:51:47 by OlegKobchenko
+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 aplteam DOT com)>>