开源软件名称：

开源软件地址：

开源软件介绍：

Nginx Fancy Index module

The Fancy Index module makes possible the generation of file listings, likethe built-in autoindexmodule does, but adding a touch of style. This is possible because the moduleallows a certain degree of customization of the generated content:

• Custom headers. Either local or stored remotely.
• Custom footers. Either local or stored remotely.
• Add you own CSS style rules.
• Allow choosing to sort elements by name (default), modification time, orsize; both ascending (default), or descending.

This module is designed to work with Nginx, a high performance open source webserver written by Igor Sysoev.

Requirements

CentOS 7

For users of the official stable Nginx repository, extra packages repository with dynamic modules is available and fancyindex is included.

Install directly:

yum install https://extras.getpagespeed.com/redhat/7/x86_64/RPMS/nginx-module-fancyindex-1.12.0.0.4.1-1.el7.gps.x86_64.rpm

Alternatively, add extras repository first (for future updates) and install the module:

yum install nginx-module-fancyindex

Then load the module in /etc/nginx/nginx.conf using:

load_module "modules/ngx_http_fancyindex_module.so";

Other platforms

In most other cases you will need the sources for Nginx. Any version starting from the 0.7series onwards will work. Note that the modules might compile withversions in the 0.6 series by applying nginx-0.6-support.patch, but thisis unsupported (YMMV).

In order to use the fancyindex_header_ and fancyindex_footer_ directivesyou will also need the ngx_http_addition_modulebuilt into Nginx.

Building

1. Unpack the Nginx sources:

   $ gunzip -c nginx-?.?.?.tar.gz | tar -xvf -

2. Unpack the sources for the fancy indexing module:

   $ gunzip -c nginx-fancyindex-?.?.?.tar.gz | tar -xvf -

3. Change to the directory which contains the Nginx sources, run theconfiguration script with the desired options and be sure to put an--add-module flag pointing to the directory which contains the sourceof the fancy indexing module:

   $ cd nginx-?.?.?$ ./configure --add-module=../nginx-fancyindex-?.?.? \   [--with-http_addition_module] [extra desired options]

   Since version 0.4.0, the module can also be built as adynamic module,using --add-dynamic-module=… instead andload_module "modules/ngx_http_fancyindex_module.so";in the configuration file

4. Build and install the software:

   $ make

   And then, as root:

   # make install

5. Configure Nginx by using the modules' configuration directives.

Example

You can test the default built-in style by adding the following lines intoa server section in your Nginx configuration file:

location / {  fancyindex on;              # Enable fancy indexes.  fancyindex_exact_size off;  # Output human-readable file sizes.}

Themes

The following themes demonstrate the level of customization which can beachieved using the module:

• Theme by@TheInsomniac. Uses custom header andfooter.
• Theme by@Naereen. Uses custom header and footer, theheader includes search field to filter by filename using JavaScript.
• Theme by@fraoustin. Responsive theme usingMaterial Design elements.
• Theme by@alehaa. Simple, flat theme based onBootstrap 4 and FontAwesome.

Directives

fancyindex

fancyindex_default_sort

fancyindex_directories_first

fancyindex_css_href

fancyindex_exact_size

fancyindex_name_length

fancyindex_footer

fancyindex_header

fancyindex_show_path

fancyindex_ignore

fancyindex_hide_symlinks

fancyindex_hide_parent_dir

fancyindex_localtime

fancyindex_time_format