Konfigurationsdirektive: IndexOptions
Ausführliche Beschreibung:
Mit Hilfe der Direktive IndexOptions wird das grundlegende Aussehen des automatisch generierten Indexes eingestellt.
Wenn Sie eine Option ohne eines der Vorzeichen + oder - verwenden, werden alle Optionen aus dem übergeordneten Kontext ersetzt.
Deshalb sollten Sie Optionen in einem Unterkontext üblicherweise mit +OPTION hinzufügen oder mit -OPTION entfernen.
Das Verfahren entspricht der Direktive Options.
Sie können jede der folgenden Indexoptionen miteinander kombinieren:
- FancyIndexing Diese Option aktiviert grundsätzlich den Fancy-Index (mehrspaltiger Index mit Icons).
Wenn Sie -FancyIndexing schreiben, wird dagegen der einfache Index verwendet.
- XHTML Seit Version 2.0.49. Statt dem üblicherweise verwendeten HTML 3.2 wird XHTML 1.0 verwendet.
- IgnoreCase Bei der Sortierung nach Dateinamen wird die Groß- und Kleinschreibung nicht beachtet, wenn Sie diese Option angeben.
Angenommen, Sie haben Dateien mit den folgenden Namen: A-Datei, a-Datei, b-Datei und C-Datei.
Wenn die Option IgnoreCase gesetzt ist, werden die Dateien genau in dieser Reihenfolge aufgelistet.
Andernfalls erhalten Sie eine Sortierung in Zeichensatzreihenfolge: A-Datei, C-Datei, a-Datei, b-Datei.
- IgnoreClient Seit Version 2.0.23. Ein eventueller Query-String der Client-Anfrage kann normalerweise dazu genutzt werden,
eine Reihe von Sortiervorgaben mitzuliefern. Wenn IgnoreClient gesetzt ist,
wird diese benutzerdefinierte Sortierung abgeschaltet.
Die folgenden Optionen sind nur für Fancy-Indizes geeignet:
- DescriptionWidth[=n|*] Verfügbar seit Version 2.0.23. Dies gibt die Zeichenbreite für die Beschreibung in einem Fancy-Index an.
Wenn Sie die Option weglassen oder DescriptionWidth ohne Wert verwenden, entscheidet mod_autoindex automatisch über die beste Breite.
Alternativ können Sie einen numerischen Wert angegeben, um die Anzahl der Zeichen verbindlich festzulegen, oder * für eine beliebige Breite.
Wenn Sie etwas anderes als DescriptionWidth=* angeben, beachten Sie bitte Folgendes: Die Beschreibung darf HTML-Code enthalten.
Das kann problematisch werden, wenn Apache sie nach einer bestimmten Zeichenzahl abschneidet – möglicherweise bleibt
ein bestimmtes HTML-Tag geöffnet, das Auswirkungen auf den Rest der Liste hat.
- FoldersFirst Seit Version 2.0.23. In einem Fancy-Index wird die normale Sortierreihenfolge geändert: Zunächst werden alle Unterverzeichnisse
nach dem aktuellen Kriterium sortiert und angezeigt, anschließend alle normalen Dateien.
Wenn Sie diese Option weglassen, werden Dateien und Verzeichnisse identisch behandelt und können beim Sortieren vermischt werden.
- HTMLTable Seit Version 2.0.23. Diese Option zeigt die Fancy-Index-Liste nicht als <pre>...</pre>-Block an, sondern als einfache HTML-Tabelle.
- IconsAreLinks Dies macht die angezeigten Icons zusätzlich zu den Dateinamen zum Teil des jeweiligen Hyperlinks.
- IconHeight[=Pixel] Mit dieser Option können Sie eine Höhenangabe für Icons hinzufügen – das HTML-Tag <img> erhält das Attribut height.
Wenn Sie keinen Pixelwert angeben, wird die Höhe der mit Apache gelieferten Icons eingetragen, was meistens die vernünftigste Einstellung ist.
Es ist sehr empfehlenswert, diese Option und die als Nächste beschriebene Option width anzugeben: Genau wie bei selbst erstellten
HTML-Dokumenten kann ein Browser die Seite sofort korrekt formatieren, wenn er schon vor dem Laden der Bilder weiß, welche Größe dafür
freigehalten werden soll.
- IconWidth[=Pixel] Diese Option fügt eine Breitenangabe für die Icons ein, also das HTML-Attribut width. Genau wie bei height wird die Höhe der Standard-Icons
eingetragen, wenn Sie keinen Wert angeben.
- NameWidth[=n|*] Dies ist die Breite für die Anzeige der Dateinamen in Zeichen. Wie bei DescriptionWidth wird der Wert automatisch festgelegt,
wenn Sie ihn weglassen. Eine numerische Angabe legt die entsprechende Breite fest; * lässt beliebige Breiten zu.
- ScanHTMLTitles Bei HTML-Dokumenten ohne Beschreibung wird das <title>-Element ausgelesen und verwendet. Dieser Vorgang ist sehr arbeitsintensiv und sollte
mit viel Bedacht (am besten gar nicht) eingesetzt werden.
- SuppressColumnSorting Bei FancyIndexing sollen die Spaltentitel nicht zu Hyperlinks für die Sortierung gemacht werden. Vor Version 2.0.23 wurden durch diese
Option auch die Query-Strings in Client-Anfragen deaktiviert. Dafür ist nun IgnoreClient (siehe oben) zuständig.
- SuppressDescription Die Beschreibungsspalte in einem FancyIndex soll weggelassen werden. Dies spart 23 Zeichen, wenn Sie ansonsten die
Standardeinstellungen beibehalten.
- SuppressHTMLPreamble Der HTML-Startabschnitt (<html> bis <body>) wird weggelassen. Sie sollten diese Option aktivieren, wenn Sie mit HeaderName (siehe unten)
ein eigenes Kopfdokument einbinden.
- SuppressIcon Seit Version 2.0.23. Beim FancyIndexing wird durch diese Option die Anzeige der Icons deaktiviert.
- SuppressLastModified Die Spalte mit Datum und Uhrzeit der letzten Änderung wird nicht angezeigt.
- SuppressRules In einem Fancy-Index werden die Trennbalken (<hr>-Tags) weggelassen.
- SuppressSize Die Spalte mit der Dateigröße wird nicht angezeigt.
- TrackModified Seit Version 2.0.23. Die HTTP-Antwort wird mit Last-Modified- und ETag-Headern für das Verzeichnis ausgestattet, falls diese
Informationen verfügbar sind.
- VersionSort Seit Version 2.0a3. Dateinamen mit Versionsnummern sollen korrekt numerisch sortiert werden (ansonstenandernfalls werden sie
falsch „alphabetisch“ geordnet). Wenn das Verzeichnis beispielsweise mytool-1.0.1, mytool-1.0.9 und mytool-1.0.10 enthält, werden
sie mit VersionSort in dieser Reihenfolge angezeigt. Ist die Option dagegen nicht aktiv, erhalten Sie die folgende
falsche Anordnung: mytool-1.0.1, mytool-1.0.10, mytool-1.0.9.