lesen – Webanwendung zum Veröffentlichen von Literatur

30. Index-Dateien

Der Buch-Index wird erstmal voll automatisch erstellt. Allerdings sieht man dann nur die Kurznamen und hat kaum Kontrolle über die Reihenfolge.

Man kann jedoch im Verzeichnis mit den Textdateien eine Datei namens „index.txt“ erstellen. Diese Datei enthält linksbündig die Kurznamen der aufzulistenden Bücher, oder URLs. Danach kann, nach beliebig vielen Leer- oder Tabulator-Zeichen, der ausführliche Titel folgen. Der Titel kann aber auch einfach weggelassen werden, wenn der Name reicht.

Kurznamen, die mit „index“ beginnen, werden ebenfalls als Indexdateien behandelt. Auf diese Weise kann man Verzeichnisse in beliebig viele Kategorieen unterteilen.

Im Kurznamen muss man eventuell die URL-Kodierung für Sonderzeichen verwenden. Insbesondere müssen Leerzeichen im Dateinamen durch „%20“ ersetzt werden. Ob deutsche Umlaute kodiert werden müssen, hängt vom Dateisystem des Servers ab. Am besten, man verwendet für Dateinamen nur unkritische Zeichen. Unkritische Zeichen sind Buchstaben des Alphabets, Zahlen, Punkte, Minus-Zeichen, Unterstriche, und Tilden.

Wenn im Namen Schrägstriche und/oder Doppelpunkte vorkommen, wird das als URL interpretiert. Wenn die Dateien auf dem selben Server liegen, sollte man nur den Pfad, beginnend mit einem Schrägstrich, angeben.

Leerzeilen werden ignoriert. Zeilen, die mit einem Leerzeichen oder Tabulator anfangen, werden derzeit ebenfalls ignoriert, das könnte sich jedoch in zukünftigen Versionen ändern.

Bücher, die in Index-Dateien nicht erscheinen, werden auch nicht angezeigt. Man kann sie jedoch direkt aufrufen oder verlinken. Auf diese Weise kann man zum Beispiel Bücher erstmal versteckt halten, solange man noch daran arbeitet.