Instructions

From ejolts
Jump to: navigation, search

Building the EJOLTs 10th anniversary wiki site

Gaining access to the EJOLTs wiki

The main entry page to the EJOLTs wiki is at http://ejolts-wiki.mattrink.co.uk/index.php/Main_Page Add this web address to your Bookmarks folder for easy access.

You will be invited to register the first time that you press the Edit tab at the top of the page. Register with a username and password if you wish to edit the wiki pages.

When registered, your username will appear at the top of each wiki page.

Clicking on your username links you to a profile page that you can edit. Note that others will only be able to view your profile page if you link to it from a wiki page. Click here to view a sample profile page.

Navigating Wiki pages

All wiki pages include two navigation areas: one in a vertical column down the left-hand side (underneath the EJOLTs logo) and the other in a horizontal strip along the top.

In the vertical column, there are two links of interest (for the time being, ignore all the others).

  • The link Main page takes you to the main entry page of the wiki.
  • The link Upload file takes you to a repository that contains pictures and other media. You must upload media to this repository before you can view it in the wiki page you are editing.

In the horizontal strip along the top of the page, there are three links of interest: your Username, the Read tab and the Edit tab.

Read mode and Edit mode

  • Read mode is the standard view used when reading wiki pages and clicking links to move between pages.
  • Edit mode must be used when making changes to a wiki page.

You cannot edit a page when in Read mode; you must press the Edit tab (on the Read-Edit-View History bar at the top of the page) which takes you to an editable text version of the page. To return to the Read mode, press the Read tab at the top of the page.

Simple formatting

When in Edit mode, text may be simply formatted by highlighting a word or phrase and clicking one of seven options (icons) on the nine-option formatting toolbar

EditingToolbar.jpg

as follows.

'Hover over' the items on the formatting toolbar to see short explanations. Items from left to right on the formatting toolbar are:

  1. Bold text
  2. Italic text
  3. Internal link (to another page in this wiki)
  4. External link (e.g. to an external website)
  5. Level 2 headline (as at the top of this page: Building the EJOLTs 10th Anniversary . . . etc. - includes a full horizontal underlining)
  6. Embedded file (inserts media - e.g. a picture, video or audio)
  7. File link (inserts a link to an external file - e.g. 'Click here to download the pdf')
  8. Ignore wiki formatting (wiki 'tags' appear in read mode as you type them; they do not modify the text)
  9. Horizontal line (ruled across the full width of the text column)

When in Edit mode, note that formatting 'tags' are applied either side of the formatted text.

When in Read mode, note how the tags affect the way the text is displayed, as follows:

  1. '''Bold text''' becomes Bold text
  2. ''Italic text'' becomes Italic text
  3. [[Link title]] becomes Link title
  4. [http://www.example.com link title] becomes link title

etc.

When you have finished your editing, press the blue Save Changes button at the foot of the page. If you do not want to save your changes but see what your edited text looks like, press Show Preview (next to the Save Changes button) or press the Read tab at the top of the page.

Now spend some time moving back and forth between the Read and Edit modes for this page. Note the tagging styles that are used in Edit mode to create the different formatting styles in Read mode.

You should have spotted that sequentially numbered, indented lists are formed simply by putting the symbol # at the beginning of each of the list items.

Creating a new page

  1. Put an existing page into Edit mode.
  2. Highlight the word or phrase to which you want the new page to link.
  3. Click the 'Ab' option (Internal link - third icon from the left on the formatting toolbar).
  4. Press the blue Save Changes button.
  5. In Read mode, you will see that the word or phrase that you highlighted is now displayed in red. Put the cursor on the red highlight and an 'advice box' appears that says: "This page does not exist".
  6. Click the red highlight; this action will take you to a new empty page that you can populate in the usual manner. Note that the title of this new page is the same as the word or phrase that you highlighted in order to create this new page.

Now have a look at the editing help page and its links which contain a useful summary of many of the points covered so far.

Creating a tintbox

A tintbox is a single-cell table that expands to accommodate the text you put into it. You preface the text with the tag {|class="wikitable", start the text on the next line with the | symbol, and then close the text with the tag |}. Press the edit button next to this sub-section's heading above - "Creating a tintbox" - to see how to achieve this effect.

Advanced formatting

If you have followed and understood the instructions above, you will have a basic understanding of how to create, edit and view wiki pages. Further formatting tags are available but they must be applied manually rather than via icons. For this information, you should now turn to the WikiHelp page. This page and its associated links will help you to further develop your ability to format wiki pages and make them attractive and easy to read and use.

Adding media to wiki pages

Media includes images (pictures), audio clips and video files. These files are stored either in the wiki site (repository) or externally in media sites such as Youtube, Flickr etc. Media is incorporated into wiki pages by linking to these stored files.


Uploading files to the Wiki repository

  1. In the left-hand side bar, click the Upload file link.
  2. Click the Browse button to find the media file you require.
  3. Highlight the file and then click the Upload file button.


External media sites

Note that the maximum filesize is 32 MB - sufficient for images and most audio files but not sufficient for more than a minute or two of video (host videos in Youtube etc. and link to it as an external website - Option 4 in the toolbar).


Adding images to a wiki page

  1. In the left-hand sidebar, click the Special pages link.
  2. Scroll down to Media reports and uploads and click the link File list.
  3. Locate the image you wish to add to the page; copy the link name as it appears on the screen.
  4. Return to the page you are editing and select the Embedded file option (Option 6) in the toolbar.
  5. Copy the image link location (e.g. 100_3255a.JPG) into the embedded file tag to replace the phrase 'Example.jpg' (e.g. [[File:100_3255a.JPG]])
  6. Add |left and |350px and |caption to the file tag so that it reads [[File:100 3255a.JPG|left|350px|caption]]. These additions will register the image left, reduce its size to about 8 x 6 cm and wrap the accompanying text around the image. Note that the symbol | is not the letter l (i.e. the letter between k and m) - it is a vertical bar, whose key you will find outside the alphabet area of your keyboard.

You now need to practice! Have a look at the MediawikiHelp page if you have problems and to also see how to modify the embedded file tag to alter the image size and position and its relationship to the main text.


Adding audio to a wiki page

... to be completed later ...


Adding video to a wiki page

... to be completed later ...