NagVis 1.3 Sprachdatei-Format

Allgemeines

Ab NagVis 1.x haben wir das Sprachformat von einfachen Textdateien in XML geändert. Die unterschiedlichen Dateien für NagVis, WUI, Bezeichnungen wurden zu einer Datei pro Sprache zusammengefasst.

Die Sprachdateien werden in nagvis/includes/languages abgelegt. Die Dateinamen lauten <Sprache>.xml.

Im Moment gibt es Sprachdateien für die folgenden Sprachen:

Erzeugen Sie Ihre eigene...

Ihre Sprache wird von NagVis nicht unterstützt? Kein Problem! Sie können einfach Ihre eigene Sprachdatei erstellen. Kopieren Sie eine bestehende Datei, benennen Sie sie um und passen Sie alle Werte an, die Sie ändern möchten.

Wenn Sie eine neue Sprachdatei erstellt oder etwas in einer bestehenden korrigiert haben, dann schicken Sie diese bitte an uns, so dass wir sie in die nächste NagVis-Version einbauen oder auf Nagvis.org veröffentlichen können.

XML-Layout-Beispiel

Dies ist nur ein Beispiel, um die Struktur der Sprachdatei zu zeigen. Wenn Sie die komplette Struktur der Sprachdatei sehen möchten, dann werfen Sie einen Blick in die mitgelieferten Dateien in nagvis/includes/languages.

<?xml version="1.0" encoding="UTF-8" ?>
<language>
	<meta>
		<name>language-name</name>
		<desc>language description</desc>
		<version>language file version</version>
	</meta>
	<global>
		<global>
			<labels>
				<!-- All labels which are used in NagVis and WUI //-->
				<key>
					<text>Value</text>
				</key>
			</labels>
			<messages>
				<!-- All messages which are used in NagVis and WUI //-->
				<key>
					<title>Title Value</title>
					<text>Text Value</text>
				</key>
			</messages>
		</global>
	</global>
	<nagvis>
		<global>
			<labels>
				<!-- All labels which are used in NagVis //-->
				<key>
					<text>Value</text>
				</key>
			</labels>
			<messages>
				<!-- All messages which are used in NagVis //-->
				<key>
					<title>Title Value</title>
					<text>Text Value</text>
				</key>
			</messages>
		</global>
	</nagvis>
	<backend>
		<global>
			<messages>
				<!-- All messages which are used in all backends //-->
				<key>
					<title>Title Value</title>
					<text>Text Value</text>
				</key>
			</messages>
		</global>
		<ndomy>
			<messages>
				<!-- All messages which are used in NDO-MySQL backend //-->
				<key>
					<title>Title Value</title>
					<text>Text Value</text>
				</key>
			</messages>
		</ndomy>
		<html>
			<messages>
				<!-- All messages which are used in HTML backend //-->
				<key>
					<title>Title Value</title>
					<text>Text Value</text>
				</key>
			</messages>
		</html>
	</backend>
	<wui>
		<global>
			<labels>
				<!-- All labels which are used in WUI //-->
				<key>
					<text>Value</text>
				</key>
			</labels>
			<messages>
				<!-- All messages which are used WUI //-->
				<key>
					<title>Title Value</title>
					<text>Text Value</text>
				</key>
			</messages>
		</global>
		<editMainCfg>
			<labels>
				<!-- All labels which are used in WUI Main Configuration //-->
				<key>
					<text>Value</text>
				</key>
			</labels>
			<messages>
				<!-- All messages which are used WUI Main Configuration //-->
				<key>
					<title>Title Value</title>
					<text>Text Value</text>
				</key>
			</messages>
		</editMainCfg>
		<mapManagement>
			<labels>
				<!-- All labels which are used in WUI Map Management //-->
				<key>
					<text>Value</text>
				</key>
			</label>
			<messages>
				<!-- All messages which are used WUI Map Management //-->
				<key>
					<title>Title Value</title>
					<text>Text Value</text>
				</key>
			</messages>
		</mapManagement>
		<addModify>
			<labels>
				<!-- All labels which are used in WUI Add/Modify //-->
				<key>
					<text>Value</text>
				</key>
			</label>
			<messages>
				<!-- All messages which are used WUI Add/Modify //-->
				<key>
					<title>Title Value</title>
					<text>Text Value</text>
				</key>
			</messages>
		</addModify>
	</wui>

</language>

Makros

Es gibt Unterstützung für die Ersetzung von vorgegebenen Zeichenketten durch einige Werte.

In der folgenden Sprachdefinition finden Sie zwei Arten von Ersetzungen. Zuerst gibt es eine Zeichenkette ([USER]) und dann zwei Default-Codes ([I] und [/i]), die durch den gleichen HTML-Tag ersetzt werden, ohne beim Aufruf Werte zu übergeben:

<permissionDenied>
	<title>Zugriff verweigert!</title>
	<text>Der Benutzer [I][USER][/I] hat keine Berechtigung, diese Map anzusehen!</text>
</permissionDenied>

Wird die Sprachdefinition wie nachfolgend aufgerufen, wird die Zeichenkette [USER] durch den Wert in $user ersetzt.

$FRONTEND->messageToUser('ERROR','permissionDenied','USER~'.$user);

Default-Makros

Default-Makros sind so etwas wie HTML-Tags, die nicht durch den Benutzer definiert werden müssen. Zur Zeit werden die folgenden Default-Makros unterstützt:

Makro ersetzt durch
[i] <i>
[/i] </i>
[b] <b>
[/b] </b>

Spezielle Zeichen

Spezielle Zeichen wie ä,ö,ü,",',... müssen als HTML-Entities geschrieben werden (z.B. &nbsp;)