Difference between revisions of "Wiki editing tips"

From TRCCompSci - AQA Computer Science
Jump to: navigation, search
(Programming Language Tabs)
Line 50: Line 50:
  
 
   <tabber>
 
   <tabber>
 
  
 
   CSharp=
 
   CSharp=
 
  
 
   <syntaxhighlight lang="csharp" line>
 
   <syntaxhighlight lang="csharp" line>
 
   
 
   
 
+
  ...
  
 
   </syntaxhighlight>
 
   </syntaxhighlight>
 
  
 
   |-|
 
   |-|
 
  
 
   VB=
 
   VB=
 
  
 
   <syntaxhighlight lang="vbnet" line>
 
   <syntaxhighlight lang="vbnet" line>
  
 +
  ...
 
   
 
   
 
   </syntaxhighlight>
 
   </syntaxhighlight>
 
  
 
   </tabber>
 
   </tabber>
 
  
 
</nowiki>
 
</nowiki>
  
 
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.
 
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.

Revision as of 22:32, 30 November 2016

Wiki Editor

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

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> CSharp= <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.