ngx fancyindex
v0.5.2
Inhalt
Das Fancy Index-Modul ermöglicht die Erstellung von Dateilisten, wie es das integrierte Autoindex-Modul tut, fügt jedoch einen Hauch von Stil hinzu. Dies ist möglich, da das Modul einen gewissen Grad an Individualisierung der generierten Inhalte ermöglicht:
Dieses Modul ist für die Verwendung mit Nginx konzipiert, einem leistungsstarken Open-Source-Webserver, der von Igor Sysoev geschrieben wurde.
Für Benutzer des offiziellen stabilen Nginx-Repositorys steht ein zusätzliches Paket-Repository mit dynamischen Modulen zur Verfügung und Fancyindex ist enthalten.
Installieren Sie die Repository-Konfiguration und dann das Modulpaket:
yum -y installiere https://extras.getpagespeed.com/release-latest.rpm yum -y installiere nginx-module-fancyindex
Laden Sie dann das Modul in /etc/nginx/nginx.conf mit:
load_module „modules/ngx_http_fancyindex_module.so“;
Benutzer können Nginx auf macOS mit MacPorts installieren; fancyindex ist enthalten:
Sudo-Port Nginx installieren
In den meisten anderen Fällen benötigen Sie die Quellen für Nginx. Jede Version ab der 0.8-Serie sollte funktionieren.
Um die Direktiven fancyindex_header_ und fancyindex_footer_ verwenden zu können, benötigen Sie außerdem das in Nginx integrierte ngx_http_addition_module.
Entpacken Sie die Nginx-Quellen:
$ gunzip -c nginx-?.?.?.tar.gz | tar -xvf -
Entpacken Sie die Quellen für das ausgefallene Indexierungsmodul:
$ gunzip -c nginx-fancyindex-?.?.?.tar.gz | tar -xvf -
Wechseln Sie in das Verzeichnis, das die Nginx-Quellen enthält, führen Sie das Konfigurationsskript mit den gewünschten Optionen aus und stellen Sie sicher, dass Sie ein Flag --add-module setzen, das auf das Verzeichnis verweist, das die Quelle des ausgefallenen Indexierungsmoduls enthält:
$ cd nginx-?.?.? $ ./configure --add-module=../nginx-fancyindex-?.?.? [--with-http_addition_module] [zusätzliche gewünschte Optionen]
Seit Version 0.4.0 kann das Modul auch als dynamisches Modul erstellt werden, indem stattdessen --add-dynamic-module=… und load_module "modules/ngx_http_fancyindex_module.so"; in der Konfigurationsdatei
Erstellen und installieren Sie die Software:
$ machen
Und dann als root :
# make install
Konfigurieren Sie Nginx mithilfe der Konfigurationsanweisungen der Module.
Sie können den integrierten Standardstil testen, indem Sie die folgenden Zeilen in einen server Ihrer Nginx-Konfigurationsdatei einfügen:
Standort / {
fancyindex on; # Ausgefallene Indizes aktivieren.
fancyindex_exact_size aus; # Für Menschen lesbare Dateigrößen ausgeben.
}
Die folgenden Themen veranschaulichen den Grad der Anpassung, der mit dem Modul erreicht werden kann:
| Syntax: | fancyindex [ auf | aus ] |
|---|---|
| Standard: | fancyindex aus |
| Kontext: | http, Server, Standort |
| Beschreibung: | Aktiviert oder deaktiviert ausgefallene Verzeichnisindizes. |
| Syntax: | fancyindex_default_sort [ Name | Größe | Datum | name_desc | size_desc | date_desc ] |
|---|---|
| Standard: | fancyindex_default_sort-Name |
| Kontext: | http, Server, Standort |
| Beschreibung: | Definiert standardmäßig das Sortierkriterium. |
| Syntax: | fancyindex_case_sensitive [ auf | aus ] |
|---|---|
| Standard: | fancyindex_case_sensitive ein |
| Kontext: | http, Server, Standort |
| Beschreibung: | Wenn diese Option aktiviert ist (Standardeinstellung), wird beim Sortieren nach Namen die Groß-/Kleinschreibung beachtet. Wenn diese Option deaktiviert ist, wird die Groß-/Kleinschreibung beim Sortieren nach Namen ignoriert. |
| Syntax: | fancyindex_directories_first [ auf | aus ] |
|---|---|
| Standard: | fancyindex_directories_first auf |
| Kontext: | http, Server, Standort |
| Beschreibung: | Wenn aktiviert (Standardeinstellung), werden Verzeichnisse gruppiert und vor allen regulären Dateien sortiert. Wenn deaktiviert, werden Verzeichnisse zusammen mit Dateien sortiert. |
| Syntax: | fancyindex_css_href uri |
|---|---|
| Standard: | fancyindex_css_href "" |
| Kontext: | http, Server, Standort |
| Beschreibung: | Ermöglicht das Einfügen eines Links zu einem CSS-Stylesheet in generierte Auflistungen. Der bereitgestellte URI- Parameter wird unverändert in ein |
| Syntax: | fancyindex_exact_size [ auf | aus ] |
|---|---|
| Standard: | fancyindex_exact_size auf |
| Kontext: | http, Server, Standort |
| Beschreibung: | Definiert, wie Dateigrößen in der Verzeichnisliste dargestellt werden: entweder genau oder durch Aufrunden auf Kilobyte, Megabyte und Gigabyte. |
| Syntax: | fancyindex_footer Pfad [ Unteranfrage | lokal ] |
|---|---|
| Standard: | fancyindex_footer "" |
| Kontext: | http, Server, Standort |
| Beschreibung: | Gibt an, welche Datei am Ende der Verzeichnislisten eingefügt werden soll. Bei einer leeren Zeichenfolge wird die vom Modul bereitgestellte Standardfußzeile gesendet. Der optionale Parameter gibt an, ob der Pfad als URI zum Laden mithilfe einer Unteranforderung (Standard) behandelt werden soll oder ob er auf eine lokale Datei verweist. |
Notiz
Für die Verwendung dieser Direktive ist das in Nginx integrierte ngx_http_addition_module erforderlich.
Warnung
Beim Einfügen einer benutzerdefinierten Kopf-/Fußzeile wird eine Unteranfrage ausgegeben, sodass potenziell jede URL als Quelle dafür verwendet werden kann. Obwohl es mit externen URLs funktioniert, wird nur die Verwendung interner URLs unterstützt. Externe URLs sind völlig ungetestet und ihre Verwendung führt dazu, dass Nginx blockiert, während auf den Abschluss der Unteranforderung gewartet wird. Wenn Sie der Meinung sind, dass eine externe Kopf-/Fußzeile ein Muss für Sie ist, lassen Sie es mich bitte wissen.
| Syntax: | fancyindex_header Pfad [ Unteranfrage | lokal ] |
|---|---|
| Standard: | fancyindex_header "" |
| Kontext: | http, Server, Standort |
| Beschreibung: | Gibt an, welche Datei am Anfang der Verzeichnislisten eingefügt werden soll. Bei einer leeren Zeichenfolge wird der vom Modul bereitgestellte Standardheader gesendet. Der optionale Parameter gibt an, ob der Pfad als URI zum Laden mithilfe einer Unteranforderung (Standard) behandelt werden soll oder ob er auf eine lokale Datei verweist. |
Notiz
Für die Verwendung dieser Direktive ist das in Nginx integrierte ngx_http_addition_module erforderlich.
| Syntax: | fancyindex_show_path [ auf | aus ] |
|---|---|
| Standard: | fancyindex_show_path ein |
| Kontext: | http, Server, Standort |
| Beschreibung: | Ob der Pfad und das schließende -Tag nach dem Header ausgegeben werden sollen oder nicht. Dies ist nützlich, wenn Sie die Pfadanzeige beispielsweise mit einem PHP-Skript verwalten möchten. |
Warnung
Diese Direktive kann nur deaktiviert werden, wenn mit fancyindex_header ein benutzerdefinierter Header bereitgestellt wird.
| Syntax: | fancyindex_show_dotfiles [ auf | aus ] |
|---|---|
| Standard: | fancyindex_show_dotfiles aus |
| Kontext: | http, Server, Standort |
| Beschreibung: | Ob Dateien aufgelistet werden sollen, denen ein Punkt vorangestellt ist. Die übliche Konvention besteht darin, diese zu verbergen. |
| Syntax: | fancyindex_ignore string1 [string2 [... stringN]] |
|---|---|
| Standard: | Kein Standard. |
| Kontext: | http, Server, Standort |
| Beschreibung: | Gibt eine Liste von Dateinamen an, die in generierten Listen nicht angezeigt werden. Wenn Nginx mit PCRE-Unterstützung erstellt wurde, werden Zeichenfolgen als reguläre Ausdrücke interpretiert. |
| Syntax: | fancyindex_hide_symlinks [ auf | aus ] |
|---|---|
| Standard: | fancyindex_hide_symlinks aus |
| Kontext: | http, Server, Standort |
| Beschreibung: | Wenn diese Option aktiviert ist, enthalten generierte Einträge keine symbolischen Links. |
| Syntax: | fancyindex_hide_parent_dir [ auf | aus ] |
|---|---|
| Standard: | fancyindex_hide_parent_dir aus |
| Kontext: | http, Server, Standort |
| Beschreibung: | Wenn diese Option aktiviert ist, wird das übergeordnete Verzeichnis nicht angezeigt. |
| Syntax: | fancyindex_localtime [ auf | aus ] |
|---|---|
| Standard: | fancyindex_localtime aus |
| Kontext: | http, Server, Standort |
| Beschreibung: | Ermöglicht die Anzeige der Dateizeiten als Ortszeit. Die Standardeinstellung ist „aus“ (GMT-Zeit). |
| Syntax: | fancyindex_time_format- Zeichenfolge |
|---|---|
| Standard: | fancyindex_time_format „%Y-%b-%d %H:%M“ |
| Kontext: | http, Server, Standort |
| Beschreibung: | Formatzeichenfolge, die für Zeitstempel verwendet wird. Die Formatspezifizierer sind eine Teilmenge derjenigen, die von der strftime-Funktion unterstützt werden, und das Verhalten ist vom Gebietsschema unabhängig (z. B. sind Tages- und Monatsnamen immer in Englisch). Die unterstützten Formate sind:
|
