Hilfe:Erweiterungen/Geshi
Aus Ubuntu-Forum Wiki
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
- Downloadseite » Erweiterung herunterladen
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.
- GeShi » Projektseite mit einer Übersicht aller unterstützter Programmiersprachen
- Downloadseite » GeSHi-Dateien herunterladen
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
- Erweiterungen » eingesetzte Erweiterungen im Wiki und Umgang mit ihnen
- Erweiterungen/Geshi » Syntaxhighlighting im Wiki
- Extern
