Wiki editing tips

From TRCCompSci - AQA Computer Science
Revision as of 15:16, 20 February 2017 by Admin (talk | contribs) (True or False)
Jump to: navigation, search

Wiki Editor

To get the best editor you need to change your preferences on the link in the top right. If you click on the editing tab, and click the boxes shown below: EditOption.GIF

when you edit a page you will see a basic editing app, this has standard icons for Bold, Italics, Embed File etc. Also look at the options under Advanced, this includes bullets & numbering, NoWiki tags, icons for the text size and so on:

Wiki Editor 1.PNG

Check the help section for guidance on how to edit / format a wiki:

Wiki Editor help.PNG

Images & Documents

Any files will need to be uploaded using the Upload File link in the tools section of the sidebar. Remember the files for the wiki are stored in a single location for all pages, so appropriately naming the file is essential. Once you have uploaded the file use the Embedded File icon and enter the name of the file uploaded.

Syntax Highlighting

This wiki will include many fragments of code. Syntax Highlighting will make the code easier to read and understand, most IDE's do this as standard and this wiki can also do it.

You can wrap your code in the following tags:


<syntaxhighlight lang="python"> ... </syntaxhighlight>


or if you want line numbers:


<syntaxhighlight lang="python" line> ... </syntaxhighlight>


The lang can be "csharp" , "vb" , or "vbnet". Many other languages are selectable, but students at TRC are doing the exam in C# therefore they should use the "csharp" option.

Programming Language Tabs

I have installed an extension called Tabber which can create interactive tabs within the content. I want this to be used to provide alternative languages.

The code below is an example of how to use it:

<tabber>

C#=

<syntaxhighlight lang="csharp" line> ... </syntaxhighlight>

|-|

VB=

<syntaxhighlight lang="vbnet" line> ... </syntaxhighlight>

</tabber>


the tabber tags define the extent of the tabs and the |-| is the split between tabs. CSharp= will give this name to the tab and anything after the equals will be within the tab.

Wiki Quiz Example

A quiz is started using the quiz tag, and closes with the closing tag:

<quiz display=simple>       </quiz>

Each question starts with:

{ your question text | type="()" } 

This will create a multiple choice question. Then you need to idenify the correct and incorrect answers (using + or -), and feedback can also be added (using || for the feedback):

 + The correct answer.
 ||feedback for correct answer
 - Distractor.
 ||feedback for distractor
 - Distractor.
 ||feedback for distractor
 - Distractor.
 ||feedback for distractor

Example Question

1. your question text

The correct answer.
feedback for correct answer
Distractor.
feedback for distractor
Distractor.
feedback for distractor
Distractor.
feedback for distractor

Your score is 0 / 0


True or False

You could use this method to create a true or false question:

 <quiz display=simple>
 {Bulgaria and Rumania joined the European Union in 2007. |type="()"}
 + TRUE.
 - FALSE.

This will create the following question:

1. Bulgaria and Rumania joined the European Union in 2007.|type="()"

TRUE.
Feedback for true
FALSE.
Feedback for false

2. |type="{}"


3. How far is the earth from the sun?

million miles.

Your score is 0 / 0