ngx fancyindex
v0.5.2
Contenido
El módulo Fancy Index hace posible la generación de listados de archivos, como lo hace el módulo autoindex incorporado, pero agregando un toque de estilo. Esto es posible porque el módulo permite cierto grado de personalización del contenido generado:
Este módulo está diseñado para funcionar con Nginx, un servidor web de código abierto de alto rendimiento escrito por Igor Sysoev.
Para los usuarios del repositorio estable oficial de Nginx, está disponible un repositorio de paquetes adicionales con módulos dinámicos y se incluye fancyindex.
Instale la configuración del repositorio, luego el paquete del módulo:
yum -y instalar https://extras.getpagespeed.com/release-latest.rpm yum -y instalar nginx-module-fancyindex
Luego cargue el módulo en /etc/nginx/nginx.conf usando:
load_module "módulos/ngx_http_fancyindex_module.so";
Los usuarios pueden instalar Nginx en macOS con MacPorts; Se incluye el índice de fantasía:
puerto sudo instalar nginx
En la mayoría de los demás casos necesitarás las fuentes de Nginx. Cualquier versión a partir de la serie 0.8 debería funcionar.
Para utilizar las directivas fancyindex_header_ y fancyindex_footer_ también necesitará el ngx_http_addition_module integrado en Nginx.
Desempaquete las fuentes de Nginx:
$ gunzip -c nginx-?.?.?.tar.gz | alquitrán -xvf -
Desempaquete las fuentes del sofisticado módulo de indexación:
$ gunzip -c nginx-fancyindex-?.?.?.tar.gz | alquitrán -xvf -
Cambie al directorio que contiene las fuentes de Nginx, ejecute el script de configuración con las opciones deseadas y asegúrese de colocar un indicador --add-module que apunte al directorio que contiene la fuente del sofisticado módulo de indexación:
$ cd nginx-?.?.? $ ./configure --add-module=../nginx-fancyindex-?.?.? [--with-http_addition_module] [opciones adicionales deseadas]
Desde la versión 0.4.0, el módulo también se puede construir como un módulo dinámico, usando --add-dynamic-module=… en su lugar y load_module "modules/ngx_http_fancyindex_module.so"; en el archivo de configuración
Construya e instale el software:
$ hacer
Y luego, como root :
# hacer instalación
Configure Nginx utilizando las directivas de configuración de los módulos.
Puede probar el estilo integrado predeterminado agregando las siguientes líneas en una sección server en su archivo de configuración de Nginx:
ubicación / {
índice de fantasía activado; # Habilite índices elegantes.
fancyindex_exact_size desactivado; # Generar tamaños de archivos legibles por humanos.
}
Los siguientes temas demuestran el nivel de personalización que se puede lograr utilizando el módulo:
| Sintaxis: | índice de fantasía [ en | apagado ] |
|---|---|
| Por defecto: | índice elegante desactivado |
| Contexto: | http, servidor, ubicación |
| Descripción: | Habilita o deshabilita los índices de directorios sofisticados. |
| Sintaxis: | fancyindex_default_sort [ nombre | tamaño | fecha | nombre_desc | tamaño_desc | fecha_desc ] |
|---|---|
| Por defecto: | nombre fancyindex_default_sort |
| Contexto: | http, servidor, ubicación |
| Descripción: | Define el criterio de clasificación por defecto. |
| Sintaxis: | fancyindex_case_SENSITIVE [ en | apagado ] |
|---|---|
| Por defecto: | fancyindex_case_SENSITIVE activado |
| Contexto: | http, servidor, ubicación |
| Descripción: | Si está habilitado (configuración predeterminada), la clasificación por nombre distinguirá entre mayúsculas y minúsculas. Si está deshabilitado, se ignorarán las mayúsculas y minúsculas al ordenar por nombre. |
| Sintaxis: | fancyindex_directories_first [ en | apagado ] |
|---|---|
| Por defecto: | fancyindex_directories_first en |
| Contexto: | http, servidor, ubicación |
| Descripción: | Si está habilitado (configuración predeterminada), agrupa los directorios y los ordena antes que todos los archivos normales. Si está deshabilitado, los directorios se ordenan junto con los archivos. |
| Sintaxis: | fancyindex_css_href uri |
|---|---|
| Por defecto: | fancyindex_css_href "" |
| Contexto: | http, servidor, ubicación |
| Descripción: | Permite insertar un enlace a una hoja de estilos CSS en los listados generados. El parámetro uri proporcionado se insertará tal cual en una etiqueta HTML |
| Sintaxis: | fancyindex_exact_size [ en | apagado ] |
|---|---|
| Por defecto: | fancyindex_exact_size en |
| Contexto: | http, servidor, ubicación |
| Descripción: | Define cómo representar los tamaños de archivos en la lista de directorios: ya sea con precisión o redondeando al kilobyte, el megabyte y el gigabyte. |
| Sintaxis: | ruta fancyindex_footer [ subsolicitud | local ] |
|---|---|
| Por defecto: | fancyindex_pie de página "" |
| Contexto: | http, servidor, ubicación |
| Descripción: | Especifica qué archivo debe insertarse al pie de los listados de directorios. Si se establece en una cadena vacía, se enviará el pie de página predeterminado proporcionado por el módulo. El parámetro opcional indica si la ruta se debe tratar como un URI para cargar mediante una subsolicitud (el valor predeterminado) o si hace referencia a un archivo local . |
Nota
El uso de esta directiva necesita el ngx_http_addition_module integrado en Nginx.
Advertencia
Al insertar un encabezado/pie de página personalizado, se emitirá una subsolicitud para que potencialmente se pueda utilizar cualquier URL como fuente para ellos. Aunque funcionará con URL externas, solo se admite el uso de URL internas. Las URL externas no han sido probadas en absoluto y su uso hará que Nginx se bloquee mientras espera que se complete la subsolicitud. Si cree que el encabezado/pie de página externo es imprescindible para usted, hágamelo saber.
| Sintaxis: | ruta fancyindex_header [ subsolicitud | local ] |
|---|---|
| Por defecto: | fancyindex_header "" |
| Contexto: | http, servidor, ubicación |
| Descripción: | Especifica qué archivo debe insertarse al principio de los listados de directorios. Si se establece en una cadena vacía, se enviará el encabezado predeterminado proporcionado por el módulo. El parámetro opcional indica si la ruta se debe tratar como un URI para cargar mediante una subsolicitud (el valor predeterminado) o si hace referencia a un archivo local . |
Nota
El uso de esta directiva necesita el ngx_http_addition_module integrado en Nginx.
| Sintaxis: | fancyindex_show_path [ en | apagado ] |
|---|---|
| Por defecto: | fancyindex_show_path en |
| Contexto: | http, servidor, ubicación |
| Descripción: | Si se debe generar o no la ruta y la etiqueta de cierre después del encabezado. Esto es útil cuando desea manejar la ruta que se muestra con un script PHP, por ejemplo. |
Advertencia
Esta directiva se puede desactivar solo si se proporciona un encabezado personalizado utilizando fancyindex_header.
| Sintaxis: | fancyindex_show_dotfiles [ en | apagado ] |
|---|---|
| Por defecto: | fancyindex_show_dotfiles desactivado |
| Contexto: | http, servidor, ubicación |
| Descripción: | Si se enumeran los archivos precedidos por un punto. La convención normal es ocultarlos. |
| Sintaxis: | fancyindex_ignore cadena1 [cadena2 [... cadenaN]] |
|---|---|
| Por defecto: | Sin incumplimiento. |
| Contexto: | http, servidor, ubicación |
| Descripción: | Especifica una lista de nombres de archivos que no se mostrarán en los listados generados. Si Nginx se creó con soporte PCRE, las cadenas se interpretan como expresiones regulares. |
| Sintaxis: | fancyindex_hide_symlinks [ en | apagado ] |
|---|---|
| Por defecto: | fancyindex_hide_symlinks desactivados |
| Contexto: | http, servidor, ubicación |
| Descripción: | Cuando esté habilitado, los listados generados no contendrán enlaces simbólicos. |
| Sintaxis: | fancyindex_hide_parent_dir [ en | apagado ] |
|---|---|
| Por defecto: | fancyindex_hide_parent_dir desactivado |
| Contexto: | http, servidor, ubicación |
| Descripción: | Cuando está habilitado, no mostrará el directorio principal. |
| Sintaxis: | fancyindex_localtime [ en | apagado ] |
|---|---|
| Por defecto: | fancyindex_localtime desactivado |
| Contexto: | http, servidor, ubicación |
| Descripción: | Permite mostrar las horas de los archivos como hora local. El valor predeterminado es “apagado” (hora GMT). |
| Sintaxis: | cadena fancyindex_time_format |
|---|---|
| Por defecto: | fancyindex_time_format "%Y-%b-%d %H:%M" |
| Contexto: | http, servidor, ubicación |
| Descripción: | Cadena de formato utilizada para las marcas de tiempo. Los especificadores de formato son un subconjunto de los admitidos por la función strftime y el comportamiento es independiente de la configuración regional (por ejemplo, los nombres de día y mes siempre están en inglés). Los formatos soportados son:
|
