====== Syntaxhighlighting ======


Für das Hervorheben von Quellcode ist die [[MediaWiki]]-Extension [[http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi|SyntaxHighlight_GeSHi]] geeignet.

===== Installation =====

Die Extension kann mit dem [[http://www.mediawiki.org/wiki/Special:ExtensionDistributor|ExtensionDistributor]] für die korrekte Mediawiki Installation heruntergeladen werden. Anschließend muss der Inhalt des Archives in das Verzeichnis //extensions// der Mediawiki-Installation entpackt werden.

Nun muss noch die folgende Zeile am Ende der [[MediaWiki Konfiguration|Konfigurationsdatei]] //LocalSettings.php// hinzugefügt werden:

<code php>
  require_once("$IP/extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php");
</code>

===== Verwendung =====

Quellcode kann mit dem ''<syntaxhighlight>''-Tag formatiert werden. Hierbei muss mit dem Attribut ''lang'' die Programmiersprache angegeben werden. Ein Beispiel für C#:

  <syntaxhighlight lang="csharp">
  using System; // Der System-Namespace beinhaltet nützliche Klassen zur Programmierung
  
  class Program // Deklarierung der Klasse "Programm"
  {
    public static void Main() // Deklarierung der Statischen-Funktion "Main", diese dient als Startpunkt des Programmes
    {
      Console.WriteLine("Hallo Welt!"); // Ausgabe von "Hello Welt!" in der Konsole
    }
  }
  </syntaxhighlight>

Über [[http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi#Parameters|weitere Parameter]] kann man die Zeilennummerierung einschalten oder eine bestimmte Zeile hervorheben.

==== Toolbar um neuen Button erweitern ====

Damit die Verwendung des Plugins leicht von der Hand geht, kann die Toolbar um einen Button erweitert werden. Dazu muss die Seite ''MediaWiki:Common.js'' um ein wenig Javascript-Code erweitert werden.

<code javascript>
/* Erweitert die Standard-Toolbar um einen Button für C#-Quelltext */
if ( mw.toolbar ) {
    mw.toolbar.addButton( {
        imageFile: '//upload.wikimedia.org/wikipedia/commons/4/46/CSHARP.jpg',
        speedTip: 'C# Code einfügen',
        tagOpen: '<source lang="csharp">',
        tagClose: '</source>',
        sampleText: '',
        imageId: 'button-csharp'
    } );
}
</code>

Wird der neue WikiEditor und nicht die alte Version der Toolbar verwendet, sieht die Anpassung etwas anders aus. Sie ist ausführlich in der [[https://www.mediawiki.org/wiki/Extension:WikiEditor/Toolbar_customization|MediaWiki-Dokumentation]] beschrieben.


----
<< [[Wikieinsatz im Unterricht]]