Hilfe:Erweiterungen/Geshi

Aus Ubuntu-Forum Wiki

Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

1 Allgemeines

Die Erweiterung ermöglicht die farbliche Hervorhebung im Quellcode. Dabei kann es auf eine Vielzahl von Programmiersprachen angewendet werden. Ziel und Zweck dieses sogenannten Syntax Highlightings ist es, den Code besser strukturiert und somit lesbarer darzustellen. Das erhöht zudem dessen Verständlichkeit und erleichtert eine Fehlersuche. Gerade im Wiki-Bereich sind Lesbar- & Verständlichkeit zwei wichtige Faktoren.

2 Installation

Download der Extension

Auf dieser Seite muss jede der drei SyntaxHighlight-xxx.php-Dateien angeklickt und auf der sich öffnenden Seite per Download-Link heruntergeladen werden.

Als nächstes muss die aktuelle (stabile) Version von GeSHi (Generic Syntax Highlighter) heruntergeladen werden.

Das heruntergeladene Paket muss dann entpackt entpackt werden:

unp geshi*.tar.tar

Das entstandene Ordner geshi muss in das Verzeichnis für die Wiki-Erweiterungen /wiki/extensions/ kopiert werden. Dieses Unterverzeichnis befindet sich schon im Wiki-Hauptverzeichnis. Dort hinein werden dann ebenfalls die drei zuvor heruntergeladenen php-Dateien kopiert. Auf diese Weise liegen dann alle für die Extension notwendigen Dateien sauber in einem Verzeichnis.

Im letzten Schritt müssen noch einige Dateien angepasst werden.

LocalSettings.php

Hier muss folgende Zeile eingetragen werden:

require_once("extensions/geshi/SyntaxHighlight_GeSHi.php");
SyntaxHighlight_GeSHi.class.php

Hier muss der Pfad zur geshi.php angepasst werden:

require_once( 'geshi.php' );

3 Anwendung

Um die Syntax-Hervorhebung nun nutzen zu können, muss der Code an sich in entsprechende Tags gepackt werden. Die Tags werden mit <source lang="sprache"> begonnen. sprache muss mit der jeweiligen Programmiersprache ersetzt werden. Nach dem Start-Tag folgt der eigentliche Quellcode, an dessen Ende die Code-Erkennung mit </source> beendet wird.

Syntax
<source lang="php">
<?php
  echo 'Nice Job, Developers!';
?>
</source>

Hinter den Parameter lang="xxx" kann man noch den Parameter line setzen. Damit schaltet man die Zeilennummerierung für den Quellcode ein.

Anzeige
<?php
  echo 'Nice Job, Developers!';
?>

4 Links

Intern
Extern
Meine Werkzeuge
Namensräume
Varianten
Aktionen
Forum
Navigation
Internes
Bearbeitungshilfen
Werkzeuge