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 函數支援的格式說明符的子集，且行為與區域設定無關（例如，日期和月份名稱始終為英文）。支援的格式有：
|
