ngx fancyindex
v0.5.2
内容
Fancy Index 模块可以生成文件列表，就像内置的自动索引模块一样，但增加了一些风格。这是可能的，因为该模块允许对生成的内容进行一定程度的定制：
该模块旨在与 Nginx 配合使用，Nginx 是由 Igor Sysoev 编写的高性能开源 Web 服务器。
对于官方稳定 Nginx 存储库的用户，可以使用带有动态模块的额外软件包存储库，并且包含 fancyindex。
安装存储库配置，然后安装模块包：
yum -y 安装 https://extras.getpagespeed.com/release-latest.rpm yum -y 安装 nginx-module-fancyindex
然后使用以下命令加载 /etc/nginx/nginx.conf 中的模块：
load_module“模块/ngx_http_fancyindex_module.so”；
用户可以通过 MacPorts 在 macOS 上安装 Nginx； fancyindex 包含在内：
sudo 端口安装 nginx
在大多数其他情况下，您将需要 Nginx 的源。从 0.8 系列开始的任何版本都应该可以工作。
为了使用fancyindex_header_和fancyindex_footer_指令，您还需要 Nginx 中内置的 ngx_http_addition_module 。
解压 Nginx 源：
$gunzip -c nginx-?.?.?.tar.gz |焦油-xvf-
解压精美索引模块的源代码：
$gunzip -c nginx-fancyindex-?.?.?.tar.gz |焦油-xvf-
切换到包含 Nginx 源的目录，使用所需的选项运行配置脚本，并确保放置一个--add-module标志指向包含精美索引模块源的目录：
$ cd nginx-??.??.? $ ./configure --add-module=../nginx-fancyindex-?.?.? [--with-http_addition_module] [额外所需的选项]
从 0.4.0 版本开始，该模块也可以构建为动态模块，使用--add-dynamic-module=…代替，并使用load_module "modules/ngx_http_fancyindex_module.so";在配置文件中
构建并安装软件：
$ 制作
然后，以root身份：
# 进行安装
使用模块的配置指令配置 Nginx。
您可以通过将以下行添加到 Nginx 配置文件的server部分来测试默认的内置样式：
地点 / {
花式索引； # 启用花式索引。
fancyindex_exact_size 关闭； # 输出人类可读的文件大小。
}
以下主题演示了使用该模块可以实现的定制级别：
| 句法： | fancyindex [上|离开] |
|---|---|
| 默认： | 幻想索引关闭 |
| 语境： | http、服务器、位置 |
| 描述： | 启用或禁用奇特的目录索引。 |
| 句法： | fancyindex_default_sort [名称|尺寸|日期|名称_描述|尺寸描述|日期描述] |
|---|---|
| 默认： | fancyindex_default_sort名称 |
| 语境： | http、服务器、位置 |
| 描述： | 默认定义排序标准。 |
| 句法： | fancyindex_case_sensitive [上|离开] |
|---|---|
| 默认： | fancyindex_case_sensitive 开启 |
| 语境： | http、服务器、位置 |
| 描述： | 如果启用（默认设置），按名称排序将区分大小写。如果禁用，按名称排序时将忽略大小写。 |
| 句法： | fancyindex_directories_first [上|离开] |
|---|---|
| 默认： | fancyindex_directories_first 上 |
| 语境： | http、服务器、位置 |
| 描述： | 如果启用（默认设置），则将目录分组在一起并将它们排序在所有常规文件之前。如果禁用，目录将与文件一起排序。 |
| 句法： | fancyindex_css_href URI |
|---|---|
| 默认： | fancyindex_css_href“” |
| 语境： | http、服务器、位置 |
| 描述： | 允许在生成的列表中插入 CSS 样式表的链接。提供的uri参数将按原样插入到 |
| 句法： | fancyindex_exact_size [上|离开] |
|---|---|
| 默认： | fancyindex_exact_size 开启 |
| 语境： | http、服务器、位置 |
| 描述： | 定义如何在目录列表中表示文件大小：精确地或四舍五入到千字节、兆字节和千兆字节。 |
| 句法： | fancyindex_footer 路径[子请求|当地的] |
|---|---|
| 默认： | fancyindex_footer“” |
| 语境： | http、服务器、位置 |
| 描述： | 指定应将哪个文件插入到目录列表的底部。如果设置为空字符串，则将发送模块提供的默认页脚。可选参数指示是否将路径视为使用子请求（默认）加载的 URI，或者是否引用本地文件。 |
笔记
使用该指令需要 Nginx 内置的 ngx_http_addition_module。
警告
插入自定义页眉/页脚时，将发出子请求，因此任何 URL 都可以用作它们的源。尽管它可以使用外部 URL，但仅支持使用内部 URL。外部 URL 完全未经测试，使用它们将使 Nginx 在等待子请求完成时阻塞。如果您觉得外部页眉/页脚是您的必备品，请告诉我。
| 句法： | fancyindex_header路径[子请求|当地的] |
|---|---|
| 默认： | fancyindex_header“” |
| 语境： | http、服务器、位置 |
| 描述： | 指定应将哪个文件插入到目录列表的头部。如果设置为空字符串，则将发送模块提供的默认标头。可选参数指示是否将路径视为使用子请求（默认）加载的 URI，或者是否引用本地文件。 |
笔记
使用该指令需要 Nginx 内置的 ngx_http_addition_module。
| 句法： | fancyindex_show_path [上|离开] |
|---|---|
| 默认： | fancyindex_show_path 上 |
| 语境： | http、服务器、位置 |
| 描述： | 是否在 header 之后输出路径和结束 标记。例如，当您想要处理使用 PHP 脚本显示的路径时，这非常有用。 |
警告
仅当使用 fancyindex_header 提供自定义标头时才能关闭此指令。
| 句法： | fancyindex_show_dotfiles [上|离开] |
|---|---|
| 默认： | fancyindex_show_dotfiles 关闭 |
| 语境： | http、服务器、位置 |
| 描述： | 是否列出前面带有点的文件。正常惯例是隐藏这些。 |
| 句法： | fancyindex_ignore string1 [string2 [... stringN]] |
|---|---|
| 默认： | 无默认值。 |
| 语境： | http、服务器、位置 |
| 描述： | 指定不会在生成的列表中显示的文件名列表。如果 Nginx 是使用 PCRE 支持构建的，则字符串将被解释为正则表达式。 |
| 句法： | fancyindex_hide_symlinks [上|离开] |
|---|---|
| 默认： | fancyindex_hide_symlinks 关闭 |
| 语境： | http、服务器、位置 |
| 描述： | 启用后，生成的列表将不包含符号链接。 |
| 句法： | fancyindex_hide_parent_dir [上|离开] |
|---|---|
| 默认： | fancyindex_hide_parent_dir 关闭 |
| 语境： | http、服务器、位置 |
| 描述： | 启用后，不会显示父目录。 |
| 句法： | fancyindex_localtime [上|离开] |
|---|---|
| 默认： | fancyindex_localtime 关闭 |
| 语境： | http、服务器、位置 |
| 描述： | 允许将文件时间显示为本地时间。默认为“关闭”（GMT 时间）。 |
| 句法： | fancyindex_time_format字符串 |
|---|---|
| 默认： | fancyindex_time_format "%Y-%b-%d %H:%M" |
| 语境： | http、服务器、位置 |
| 描述： | 用于时间戳的格式字符串。格式说明符是 strftime 函数支持的格式说明符的子集，并且行为与区域设置无关（例如，日期和月份名称始终为英文）。支持的格式有：
|
