View source for Development/Tutorials/Quickstart Guide to the Wikitext syntax used in KDE Techbase

<br> '''Notice''': Undefined index: title in '''/home/wikis/public/mediawiki_src/LocalSettings.php''' on line '''40''' 

<br> '''Notice''': Undefined index: title in '''/home/wikis/public/mediawiki_src/LocalSettings.php''' on line '''40''' 

= Introduction  =

One of the first hurdles to overcome when contributing documentation to any project is getting used markup that may be used in such documentation systems. KDE Techbase uses MediaWiki's syntax which is user friendly to newbie documenters when it comes to simple editing. But as add more content to your articles you often want to be able to use things like separate boxes on the page to highlight Tips or code segments. Here is a W.I.P. list of these things and a gotcha here and there. 

<br> 

= Displaying a Tip box or Note box  =

KDE&nbsp;Techbase uses templates in order to display things like Tip boxes and Note boxes. Templates use the same format as MediaWiki's templates - and is pretty simple when you know how. You can use the Rich editor or the regular editor in order to create these types of items.This guide only covers using the regular editor (it's easier!). So if you are used the Rich editor, click the Wikitext icon so that you see the raw markup in your editor. 

*To create a Tip box enter <syntaxhighlight lang="text">
{{Tip|Content goes here}} 
</syntaxhighlight>

This should give you {{Tip|Content goes here}}<br> 

*To create a Note box enter <syntaxhighlight lang="text">
{{Note|Content goes here}} 
</syntaxhighlight>

This should give you {{Note|Content goes here}} 

*One particular gotcha is that if you want to put some code like <syntaxhighlight lang="text">x = 0</syntaxhighlight> in a Tip or Note box the equals sign will give problems. If this happens just use a HTML Numeric Character Reference instead such as <syntaxhighlight lang="text">&#x3D;</syntaxhighlight> instead of the equals sign<br> 
*(Note: A HTML&nbsp;Character Reference convertor is available at http://www.kadifeli.com/fedon/utf.htm )

<br>