Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Page Tree
root@self

Table of Contents

Log In

1. Go to http://wiki.nus.edu.sg/ or directly to any wiki space (if you know the URL).

2. Click Log In, on the top right hand corner, next to the search box.

Image Removed

3. Log in with your NUSNET ID and password. Omit the domain.

Image Removed

4. You are now logged in. Instead of the Log In link, you will see your name.

Image Removed

Create a wiki space

  1. On the front page of Wiki.nus, click Create Space or Create a wiki.

Image Removed

2. Give your space a Space Name. This is the wiki space's title. It can be changed later.

3. Give your space a Space Key. This forms part of the URL (web address) of your wiki space.

Note
titleSpace Key
  1. The Space Key cannot be changed after it has been created.
  2. Alphanumeric (a-z, A-Z, 0-9) characters only. No spaces.
  3. It must be unique within Wiki.nus. You will be prompted if it is not.

4. Choose whether to make the wiki space private or public. This can be modified later.

5. Click Create.

Image Removed

Add a Page

Note
  • When you add a page, the new page will be created one level below the current page.
  • Page titles must be unique within the wiki.

1. Go to the page where you want to add a new subordinate page (known here as a Child page). Click Add > Page.

Image Removed

2. Click in the title field, indicated by the grey New Page title. Type the page name/title.

Image Removed

Image Removed

3. Put in content in the text field. Click Save (bottom right corner of text field) when ready.

Image Removed

4. Done! View your handiwork.

Info
  • Refer to Organise Pages to learn more about the page structure of the wiki and rearranging pages
  • You can always rectify page placement later, so do not be unduly worried about adding a page incorrectly.
Tip

It is good practice to:

  • Use the What did you change? field below the text editor to document the changes you have made.
  • Uncheck Notify watchers if your edit is minor or does not warrant an automatic email notification to those who are tracking changes on the page or wiki.

Edit a Page

1. To edit a page, click the Edit button on the top right of the page.

Image Removed

Info

If you do not see an edit button, you are either not logged in to Wiki.nus or you do not have permission to edit that page.

2. Edit the page. Click Save (bottom right of the text box) when you are done.

Note

Image Removed

Warning

If you see a warning that someone else is editing the page, such as the one below, do not continue editing. You should click Cancel and come back to edit the page another time. If you proceed, one of your edits may be overwritten without being saved.

Image Removed

Organise Pages

Understanding Page hierarchy

The diagram below shows the hierarchy of pages in an example wiki.

Image Removed

You can see that there are three levels. When you click Add Page, you are adding a new page one level down.

So, if you add a page from Example Wiki (Level 1), you will create a page on Level 2.

If you add a page from Understanding Pages or Formatting (Level 2 pages), you will create a page on Level 3, and so on.

Rearranging Pages

Sometimes, you may accidentally create a page on the wrong level. If you have done so, you can easily rearrange the hierarchy and order of pages.

Go to Browse > Pages.

Image Removed

For View, click Tree. Continuing the example above, click the plus icons to open the branches. You will see the following:

Image Removed

Info

By default, pages at each level are ordered alphabetically.

You can click and drag individual pages to any part of the wiki.

In this example, we want the Basic page to be above the Advanced page.

To do this, drag Basic between Formatting and Advanced until you see a thin grey line. Drop Basic above Advanced.

Image Removed

You will now see that Basic appears before Advanced. If you want to return to alphabetical display, click the "A" icon.

Warning
Any pages on the same level as Home will not be visible when using the pagetree macro or the sidebar of the Documentation theme.

Page Title/Name Conventions

  1. Page titles must be unique throughout the wiki.
  2. If possible, Page titles should make sense on their own. E.g. The Basic and Advanced pages in the example above should be renamed Basic Formatting and Advanced Formatting respectively.

Format Pages

Generally, you can use the WYSIWYG (Rich Text) editor to format your content.

While this may seem limited, there are ways to add variety to your wiki pages.

Insert Formatting Macros

  • You can access formatting functions through macros. In the text editor, type  {  to bring up the macro auto suggest, then click Open Macro Browser.
    Image Removed
  • Alternatively, on the editor toolbar, click Insert, then Other Macros.
    Image Removed

...

  • There are several formatting macros to choose from. You can also explore other types of macros, which may come in handy.

You can create links to:

Type  [  in the text editor. The link auto-suggest will pop up.

If none of the suggested wiki pages are listed, or you want to link to other content, click the Link icon on the text editor toolbar.

Image Removed

...

Search is the best way to link to another Wiki.nus wiki.

  • Click the Search tab. You can search all wiki spaces or your wiki space.
  • Enter your search term in the text box.
  • Click Search.
  • Click the link of the page you want to link to.
  • Enter the link text if necessary.
  • Click Insert.

Image Removed

Recently Viewed

Recently Viewed is a list of Wiki.nus pages which you have recently viewed. Many times, this will have the page that you want to link to.

  • Click the Recently Viewed tab. You will be shown a list of the most recent pages you have viewed.
  • Click the page that you want to link to.
  • Enter the link text if necessary.
  • Click Insert.

Image Removed

...

Attachments allows you to upload a file and create a download link for your readers. You can attach files up to 20MB per attachment.

  • Click the Attachments tab.
  • Click Browse. Use the file explorer to find the file which you want to attach, then click Open.
  • Click Attach. The file you want to attach now appears on the list.
  • Click the file's link.
  • Fill in the link text. e.g. If you type "Download the lecture slides", this text will become the link: Download the lecture slides.
  • Click Insert.

Image Removed

...

Web links allows you to create links to web sites outside of Wiki.nus.

  • Click the Web links tab.
  • Type or paste the URL of the web site you want to link to.
  • Click Insert.

Image Removed

Insert an image

There are two ways of inserting images into a wiki page: drag-and-drop and using the insert menu.

Drag-and-drop an image

While in edit mode on any wiki page, drag the image from its folder on your computer and drop it into the page which you are editing, in the place where it should appear.

Image Removed

Use the insert menu

On the menu, click Insert > Image.

Browse for the image on your computer, then click Insert.

Image Removed

Add Comments

If you are using the wiki to come up with a collaborative document, you may want to use the comments function which is available on each page or blog post (if you have been provided permission to add comments).

  • To comment, mouseover Add, then click Comment. Alternatively, scroll to the bottom of the page and click the Add comment text link.

Image Removed

  • Write your comment, then click Post.

Image Removed

  • If you want to reply to a previous comment, click Reply. Otherwise, you can start a discussion on another topic by clicking Add Comment. Otherwise, you can start a discussion on another topic by clicking Add Comment.

Image Removed

Note

If you are watching the page or blog post, click the link in the email and reply in the wiki. Do not click reply in your email to respond. (Notification emails originate from a do-not-reply email address.)

startDepth2