ngx fancyindex

وحدة مؤشر Nginx Fancy

محتويات

• متطلبات
  • سينت أو إس، رهيل، فيدورا لينكس
  • ماك
  • منصات أخرى
• مبنى
• مثال
  • المواضيع
• التوجيهات
  • com.fancyindex
  • fancyindex_default_sort
  • fancyindex_case_sensitive
  • fancyindex_directories_first
  • fancyindex_css_href
  • fancyindex_exact_size
  • fancyindex_footer
  • fancyindex_header
  • fancyindex_show_path
  • fancyindex_show_dotfiles
  • fancyindex_ignore
  • fancyindex_hide_symlinks
  • fancyindex_hide_parent_dir
  • fancyindex_localtime
  • Fancyindex_time_format

تتيح وحدة Fancy Index إمكانية إنشاء قوائم الملفات، مثلما تفعل وحدة الفهرس التلقائي المضمنة، ولكنها تضيف لمسة من الأناقة. هذا ممكن لأن الوحدة تسمح بدرجة معينة من تخصيص المحتوى الذي تم إنشاؤه:

• الرؤوس المخصصة، سواء كانت محلية أو مخزنة عن بعد.
• تذييلات مخصصة، سواء كانت محلية أو مخزنة عن بعد.
• أضف قواعد نمط CSS الخاصة بك.
• السماح باختيار فرز العناصر حسب الاسم (الافتراضي)، أو وقت التعديل، أو الحجم؛ كلاهما تصاعدي (افتراضي)، أو تنازلي.

تم تصميم هذه الوحدة للعمل مع Nginx، وهو خادم ويب مفتوح المصدر عالي الأداء كتبه Igor Sysoev.

متطلبات

سينت أو إس، رهيل، فيدورا لينكس

بالنسبة لمستخدمي مستودع Nginx الرسمي المستقر، يتوفر مستودع حزم إضافي بوحدات ديناميكية ويتم تضمين Fancyindex.

قم بتثبيت تكوين المستودع، ثم حزمة الوحدة النمطية:

 يم -y تثبيت https://extras.getpagespeed.com/release-latest.rpm
yum -y تثبيت nginx-module-fancyindex

ثم قم بتحميل الوحدة في /etc/nginx/nginx.conf باستخدام:

 Load_module "modules/ngx_http_fancyindex_module.so";

ماك

يمكن للمستخدمين تثبيت Nginx على نظام macOS باستخدام MacPorts؛ يتم تضمين Fancyindex:

 منفذ سودو تثبيت nginx

منصات أخرى

في معظم الحالات الأخرى، ستحتاج إلى مصادر Nginx. يجب أن يعمل أي إصدار يبدأ من سلسلة 0.8.

من أجل استخدام توجيهات fancyindex_header_ و fancyindex_footer_ ستحتاج أيضًا إلى ngx_http_addition_module المضمن في Nginx.

مبنى

1. قم بفك مصادر Nginx:

    $ gunzip -c nginx-?.?.?.tar.gz | القطران -xvf -
   

2. قم بفك مصادر وحدة الفهرسة الفاخرة:

    $ gunzip -c nginx-fancyindex-?.?.?.tar.gz | القطران -xvf -
   

3. غيّر إلى الدليل الذي يحتوي على مصادر 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"; في ملف التكوين

4. بناء وتثبيت البرنامج:

    $ جعل
   

   وبعد ذلك، root :

    # قم بالتثبيت
   

5. قم بتكوين Nginx باستخدام توجيهات تكوين الوحدات.

مثال

يمكنك اختبار النمط الافتراضي المدمج عن طريق إضافة الأسطر التالية إلى قسم server في ملف تكوين Nginx الخاص بك:

 موقع / {
  يتوهميندكس على؛ # تمكين الفهارس الفاخرة.
  fancyindex_exact_size معطل؛ # إخراج أحجام الملفات التي يمكن قراءتها بواسطة الإنسان.
}

المواضيع

توضح المواضيع التالية مستوى التخصيص الذي يمكن تحقيقه باستخدام الوحدة:

• الموضوع بواسطةTheInsomniac. يستخدم رأس وتذييل مخصصين.
• الموضوع بواسطة @Naereen. يستخدم رأس وتذييل مخصصين. يتضمن الرأس حقل بحث للتصفية حسب اسم الملف باستخدام JavaScript.
• الموضوع بواسطة @fraoustin. موضوع سريع الاستجابة باستخدام عناصر التصميم متعدد الأبعاد.
• الموضوع بواسطة @alehaa. مظهر بسيط ومسطح يعتمد على Bootstrap 4 وFontAwesome.

التوجيهات

com.fancyindex

بناء الجملة:	مؤشر الهوى [ على | عن ]
تقصير:	fancyindex معطل
سياق:	http، الخادم، الموقع
وصف:	تمكين أو تعطيل فهارس الدليل الفاخرة.

fancyindex_default_sort

بناء الجملة:	Fancyindex_default_sort [ الاسم | الحجم | التاريخ | name_desc | size_desc | date_desc ]
تقصير:	اسم Fancyindex_default_sort
سياق:	http، الخادم، الموقع
وصف:	يحدد معيار الفرز بشكل افتراضي.

fancyindex_case_sensitive

بناء الجملة:	يتوهم_حالة_حساسة [ على | عن ]
تقصير:	يتوهمindex_case_sensitive على
سياق:	http، الخادم، الموقع
وصف:	إذا تم تمكينه (الإعداد الافتراضي)، فسيكون الفرز حسب الاسم حساسًا لحالة الأحرف. إذا تم تعطيله، فسيتم تجاهل الحالة عند الفرز حسب الاسم.

fancyindex_directories_first

بناء الجملة:	يتوهمindex_directories_first [ على | عن ]
تقصير:	يتوهمindex_directories_first على
سياق:	http، الخادم، الموقع
وصف:	إذا تم تمكينه (الإعداد الافتراضي)، فسيتم تجميع الدلائل معًا وفرزها قبل جميع الملفات العادية. إذا تم تعطيله، فسيتم فرز الدلائل مع الملفات.

fancyindex_css_href

بناء الجملة:	Fancyindex_css_href uri
تقصير:	يتوهم_css_href ""
سياق:	http، الخادم، الموقع
وصف:	يسمح بإدراج رابط إلى ورقة أنماط CSS في القوائم التي تم إنشاؤها. سيتم إدراج معلمة uri المقدمة كما هي في علامة HTML . يتم إدراج الرابط بعد قواعد CSS المضمنة، حتى تتمكن من تجاوز الأنماط الافتراضية.

fancyindex_exact_size

بناء الجملة:	يتوهمindex_exact_size [ على | عن ]
تقصير:	يتوهمindex_exact_size على
سياق:	http، الخادم، الموقع
وصف:	يحدد كيفية تمثيل أحجام الملفات في قائمة الدليل: إما بدقة، أو التقريب إلى الكيلوبايت والميجابايت والجيجابايت.

fancyindex_footer

بناء الجملة:	مسار يتوهمindex_footer [ طلب فرعي | محلي ]
تقصير:	يتوهمindex_footer ""
سياق:	http، الخادم، الموقع
وصف:	يحدد الملف الذي يجب إدراجه أسفل قوائم الدليل. إذا تم التعيين على سلسلة فارغة، فسيتم إرسال التذييل الافتراضي الذي توفره الوحدة. تشير المعلمة الاختيارية إلى ما إذا كان سيتم التعامل مع المسار باعتباره URI للتحميل باستخدام طلب فرعي (الافتراضي)، أو ما إذا كان يشير إلى ملف محلي .

ملحوظة

يتطلب استخدام هذا التوجيه وجود ngx_http_addition_module المضمن في Nginx.

تحذير

عند إدراج رأس/تذييل مخصص، سيتم إصدار طلب فرعي بحيث يمكن استخدام أي عنوان URL كمصدر له. على الرغم من أنه سيعمل مع عناوين URL الخارجية، إلا أنه يتم دعم استخدام العناوين الداخلية فقط. لم يتم اختبار عناوين URL الخارجية تمامًا، وسيؤدي استخدامها إلى حظر Nginx أثناء انتظار اكتمال الطلب الفرعي. إذا كنت تشعر أن الرأس/التذييل الخارجي أمر لا بد منه بالنسبة لك، فيرجى إبلاغي بذلك.

fancyindex_header

بناء الجملة:	مسار يتوهمindex_header [ طلب فرعي | محلي ]
تقصير:	يتوهمindex_header ""
سياق:	http، الخادم، الموقع
وصف:	يحدد الملف الذي يجب إدراجه في رأس قوائم الدليل. إذا تم التعيين على سلسلة فارغة، فسيتم إرسال الرأس الافتراضي الذي توفره الوحدة. تشير المعلمة الاختيارية إلى ما إذا كان سيتم التعامل مع المسار باعتباره URI للتحميل باستخدام طلب فرعي (الافتراضي)، أو ما إذا كان يشير إلى ملف محلي .

ملحوظة

يتطلب استخدام هذا التوجيه وجود ngx_http_addition_module المضمن في Nginx.

fancyindex_show_path

بناء الجملة:	Fancyindex_show_path [ على | عن ]
تقصير:	يتوهمindex_show_path على
سياق:	http، الخادم، الموقع
وصف:	ما إذا كان سيتم إخراج المسار وعلامة الإغلاق بعد الرأس أم لا. يعد هذا مفيدًا عندما تريد التعامل مع المسار الذي يتم عرضه باستخدام برنامج PHP النصي على سبيل المثال.

تحذير

لا يمكن إيقاف تشغيل هذا التوجيه إلا إذا تم توفير رأس مخصص باستخدام Fancyindex_header.

fancyindex_show_dotfiles

بناء الجملة:	Fancyindex_show_dotfiles [ على | عن ]
تقصير:	Fancyindex_show_dotfiles معطل
سياق:	http، الخادم، الموقع
وصف:	ما إذا كان سيتم إدراج الملفات التي تسبقها نقطة أم لا. التقليد الطبيعي هو إخفاء هذه.

fancyindex_ignore

بناء الجملة:	سلسلة Fantasyindex_ignore 1 [سلسلة 2 [... سلسلة N]]
تقصير:	لا الافتراضي.
سياق:	http، الخادم، الموقع
وصف:	يحدد قائمة بأسماء الملفات التي لن تظهر في القوائم التي تم إنشاؤها. إذا تم إنشاء Nginx بدعم PCRE، فسيتم تفسير السلاسل على أنها تعبيرات عادية.

fancyindex_hide_symlinks

بناء الجملة:	Fantasyindex_hide_symlinks [ على | عن ]
تقصير:	Fantasyindex_hide_symlinks معطل
سياق:	http، الخادم، الموقع
وصف:	عند التمكين، لن تحتوي القوائم التي تم إنشاؤها على روابط رمزية.

fancyindex_hide_parent_dir

بناء الجملة:	Fantasyindex_hide_parent_dir [ على | عن ]
تقصير:	Fancyindex_hide_parent_dir معطل
سياق:	http، الخادم، الموقع
وصف:	عند تمكينه، لن يُظهر الدليل الأصلي.

fancyindex_localtime

بناء الجملة:	يتوهمindex_localtime [ على | عن ]
تقصير:	fancyindex_localtime معطلة
سياق:	http، الخادم، الموقع
وصف:	تمكين عرض أوقات الملف بالتوقيت المحلي. الافتراضي هو "إيقاف" (بتوقيت جرينتش).

Fancyindex_time_format

بناء الجملة:	سلسلة Fancyindex_time_format
تقصير:	يتوهمindex_time_format "%Y-%b-%d %H:%M"
سياق:	http، الخادم، الموقع
وصف:	سلسلة التنسيق المستخدمة للطوابع الزمنية. محددات التنسيق هي مجموعة فرعية من تلك التي تدعمها الدالة strftime، والسلوك مستقل عن اللغة (على سبيل المثال، أسماء اليوم والشهر تكون دائمًا باللغة الإنجليزية). التنسيقات المدعومة هي: %a : الاسم المختصر ليوم الأسبوع. %A : الاسم الكامل ليوم الأسبوع. %b : اسم الشهر المختصر. %B : اسم الشهر بالكامل. %d : يوم الشهر كرقم عشري (النطاق من 01 إلى 31). %e : مثل %d ، يوم من الشهر كرقم عشري، ولكن يتم استبدال الصفر البادئ بمسافة. %F : يعادل %Y-%m-%d (تنسيق التاريخ ISO 8601). %H : الساعة كرقم عشري باستخدام نظام 24 ساعة (النطاق من 00 إلى 23). %I : الساعة كرقم عشري باستخدام ساعة بنظام 12 ساعة (النطاق من 01 إلى 12). %k : الساعة (نظام 24 ساعة) كرقم عشري (النطاق من 0 إلى 23)؛ الأرقام المفردة مسبوقة بفراغ. %l : الساعة (12 ساعة) كرقم عشري (النطاق من 1 إلى 12)؛ الأرقام المفردة مسبوقة بفراغ. %m : الشهر كرقم عشري (النطاق من 01 إلى 12). %M : الدقيقة كرقم عشري (النطاق من 00 إلى 59). %p : إما "AM" أو "PM" حسب قيمة الوقت المحددة. %P : مثل %p ولكن بأحرف صغيرة: "am" أو "pm". %r : الوقت بالتدوين صباحًا أو مساءً. يعادل %I:%M:%S %p . %R : الوقت بصيغة 24 ساعة ( %H:%M ). %S : الثاني كرقم عشري (النطاق من 00 إلى 60). %T : الوقت بصيغة 24 ساعة ( %H:%M:%S ). %u : يوم الأسبوع كعلامة عشرية، النطاق من 1 إلى 7، يوم الاثنين هو 1. %w : يوم الأسبوع كعلامة عشرية، يتراوح من 0 إلى 6، يوم الاثنين هو 0. %y : السنة كرقم عشري بدون قرن (النطاق من 00 إلى 99). %Y : السنة كرقم عشري بما في ذلك القرن.