ngx fancyindex
v0.5.2
Isi
Modul Fancy Index memungkinkan pembuatan daftar file, seperti modul autoindex bawaan, tetapi menambahkan sentuhan gaya. Hal ini dimungkinkan karena modul memungkinkan penyesuaian tingkat tertentu pada konten yang dihasilkan:
Modul ini dirancang untuk bekerja dengan Nginx, server web sumber terbuka berkinerja tinggi yang ditulis oleh Igor Sysoev.
Untuk pengguna repositori resmi Nginx stabil, repositori paket tambahan dengan modul dinamis tersedia dan fancyindex disertakan.
Instal konfigurasi repositori, lalu paket modul:
enak -y instal https://extras.getpagespeed.com/release-latest.rpm yum -y instal nginx-module-fancyindex
Kemudian muat modul di /etc/nginx/nginx.conf menggunakan:
load_module "modul/ngx_http_fancyindex_module.so";
Pengguna dapat menginstal Nginx di macOS dengan MacPorts; fancyindex disertakan:
sudo port instal nginx
Dalam sebagian besar kasus lain, Anda memerlukan sumber untuk Nginx. Versi apa pun yang dimulai dari seri 0.8 akan berfungsi.
Untuk menggunakan direktif fancyindex_header_ dan fancyindex_footer_ Anda juga memerlukan ngx_http_addition_module yang terpasang di Nginx.
Buka paket sumber Nginx:
$ gunzip -c nginx-?.?.?.tar.gz | ter -xvf -
Buka paket sumber untuk modul pengindeksan mewah:
$ gunzip -c nginx-fancyindex-?.?.?.tar.gz | ter -xvf -
Ubah ke direktori yang berisi sumber Nginx, jalankan skrip konfigurasi dengan opsi yang diinginkan dan pastikan untuk meletakkan tanda --add-module yang menunjuk ke direktori yang berisi sumber modul pengindeksan mewah:
$cd nginx-?.?.? $ ./configure --add-module=../nginx-fancyindex-?.?.? [--with-http_addition_module] [opsi tambahan yang diinginkan]
Sejak versi 0.4.0, modul juga dapat dibuat sebagai modul dinamis, menggunakan --add-dynamic-module=… dan load_module "modules/ngx_http_fancyindex_module.so"; dalam file konfigurasi
Bangun dan instal perangkat lunak:
$ membuat
Dan kemudian, sebagai root :
# buat instal
Konfigurasikan Nginx dengan menggunakan arahan konfigurasi modul.
Anda dapat menguji gaya bawaan default dengan menambahkan baris berikut ke bagian server di file konfigurasi Nginx Anda:
lokasi / {
indeks mewah aktif; # Aktifkan indeks mewah.
fancyindex_exact_size mati; # Output ukuran file yang dapat dibaca manusia.
}
Tema berikut menunjukkan tingkat penyesuaian yang dapat dicapai dengan menggunakan modul:
| Sintaksis: | indeks mewah [ pada | mati ] |
|---|---|
| Bawaan: | indeks mewah tidak aktif |
| Konteks: | http, server, lokasi |
| Keterangan: | Mengaktifkan atau menonaktifkan indeks direktori mewah. |
| Sintaksis: | fancyindex_default_sort [ nama | ukuran | tanggal | nama_desc | ukuran_desc | tanggal_desc ] |
|---|---|
| Bawaan: | nama fancyindex_default_sort |
| Konteks: | http, server, lokasi |
| Keterangan: | Mendefinisikan kriteria penyortiran secara default. |
| Sintaksis: | fancyindex_case_sensitive [ pada | mati ] |
|---|---|
| Bawaan: | fancyindex_case_sensitive aktif |
| Konteks: | http, server, lokasi |
| Keterangan: | Jika diaktifkan (pengaturan default), pengurutan berdasarkan nama akan peka huruf besar-kecil. Jika dinonaktifkan, huruf besar/kecil akan diabaikan saat mengurutkan berdasarkan nama. |
| Sintaksis: | fancyindex_directories_first [ pada | mati ] |
|---|---|
| Bawaan: | fancyindex_directories_first aktif |
| Konteks: | http, server, lokasi |
| Keterangan: | Jika diaktifkan (pengaturan default), kelompokkan direktori dan urutkan sebelum semua file biasa. Jika dinonaktifkan, direktori akan diurutkan bersama dengan file. |
| Sintaksis: | fancyindex_css_href uri |
|---|---|
| Bawaan: | fancyindex_css_href "" |
| Konteks: | http, server, lokasi |
| Keterangan: | Memungkinkan menyisipkan link ke style sheet CSS dalam daftar yang dihasilkan. Parameter uri yang disediakan akan dimasukkan apa adanya dalam tag HTML |
| Sintaksis: | fancyindex_exact_size [ pada | mati ] |
|---|---|
| Bawaan: | fancyindex_exact_size aktif |
| Konteks: | http, server, lokasi |
| Keterangan: | Menentukan cara mewakili ukuran file dalam daftar direktori: akurat, atau dibulatkan ke kilobyte, megabyte, dan gigabyte. |
| Sintaksis: | jalur fancyindex_footer [ subpermintaan | lokal ] |
|---|---|
| Bawaan: | fancyindex_footer "" |
| Konteks: | http, server, lokasi |
| Keterangan: | Menentukan file mana yang harus disisipkan di bagian bawah daftar direktori. Jika disetel ke string kosong, footer default yang disediakan oleh modul akan dikirim. Parameter opsional menunjukkan apakah jalur akan diperlakukan sebagai URI untuk dimuat menggunakan subpermintaan (default), atau apakah jalur tersebut merujuk ke file lokal . |
Catatan
Menggunakan arahan ini memerlukan ngx_http_addition_module yang dibangun di Nginx.
Peringatan
Saat memasukkan header/footer khusus, subpermintaan akan dikeluarkan sehingga kemungkinan URL apa pun dapat digunakan sebagai sumbernya. Meskipun dapat digunakan dengan URL eksternal, hanya penggunaan URL internal yang didukung. URL eksternal sama sekali belum teruji dan penggunaannya akan membuat Nginx terblokir sambil menunggu subpermintaan selesai. Jika Anda merasa header/footer eksternal harus dimiliki, beri tahu saya.
| Sintaksis: | jalur fancyindex_header [ subpermintaan | lokal ] |
|---|---|
| Bawaan: | fancyindex_header "" |
| Konteks: | http, server, lokasi |
| Keterangan: | Menentukan file mana yang harus disisipkan di bagian atas daftar direktori. Jika disetel ke string kosong, header default yang disediakan oleh modul akan dikirim. Parameter opsional menunjukkan apakah jalur akan diperlakukan sebagai URI untuk dimuat menggunakan subpermintaan (default), atau apakah jalur tersebut merujuk ke file lokal . |
Catatan
Menggunakan arahan ini memerlukan ngx_http_addition_module yang dibangun di Nginx.
| Sintaksis: | fancyindex_show_path [ pada | mati ] |
|---|---|
| Bawaan: | fancyindex_show_path aktif |
| Konteks: | http, server, lokasi |
| Keterangan: | Apakah akan menampilkan path dan tag penutup setelah header atau tidak. Ini berguna ketika Anda ingin menangani tampilan jalur dengan skrip PHP misalnya. |
Peringatan
Arahan ini dapat dimatikan hanya jika header khusus disediakan menggunakan fancyindex_header.
| Sintaksis: | fancyindex_show_dotfiles [ pada | mati ] |
|---|---|
| Bawaan: | fancyindex_show_dotfiles tidak aktif |
| Konteks: | http, server, lokasi |
| Keterangan: | Apakah akan mencantumkan file yang diawali dengan titik. Konvensi normalnya adalah menyembunyikan ini. |
| Sintaksis: | fancyindex_ignore string1 [string2 [... stringN]] |
|---|---|
| Bawaan: | Tidak ada bawaan. |
| Konteks: | http, server, lokasi |
| Keterangan: | Menentukan daftar nama file yang tidak akan ditampilkan dalam daftar yang dihasilkan. Jika Nginx dibangun dengan dukungan PCRE, string diinterpretasikan sebagai ekspresi reguler. |
| Sintaksis: | fancyindex_hide_symlinks [ pada | mati ] |
|---|---|
| Bawaan: | fancyindex_hide_symlinks tidak aktif |
| Konteks: | http, server, lokasi |
| Keterangan: | Jika diaktifkan, daftar yang dihasilkan tidak akan berisi tautan simbolis. |
| Sintaksis: | fancyindex_hide_parent_dir [ pada | mati ] |
|---|---|
| Bawaan: | fancyindex_hide_parent_dir tidak aktif |
| Konteks: | http, server, lokasi |
| Keterangan: | Jika diaktifkan, direktori induk tidak akan ditampilkan. |
| Sintaksis: | fancyindex_localtime [ pada | mati ] |
|---|---|
| Bawaan: | fancyindex_localtime nonaktif |
| Konteks: | http, server, lokasi |
| Keterangan: | Memungkinkan menampilkan waktu file sebagai waktu lokal. Standarnya adalah "mati" (waktu GMT). |
| Sintaksis: | string fancyindex_time_format |
|---|---|
| Bawaan: | fancyindex_time_format "%Y-%b-%d %H:%M" |
| Konteks: | http, server, lokasi |
| Keterangan: | Format string yang digunakan untuk stempel waktu. Penentu format adalah bagian dari yang didukung oleh fungsi strftime, dan perilakunya tidak bergantung pada lokal (misalnya, nama hari dan bulan selalu dalam bahasa Inggris). Format yang didukung adalah:
|
