jekyll tipue search

بحث جيكل تيبو

البحث عن النص الكامل في Jekyll باستخدام بحث Tipue. لا البرنامج المساعد اللازمة. متوافق تمامًا مع صفحات جيثب.

يتم إنشاء فهرس البحث على tipuesearch/tipuesearch_content.js باستخدام Liquid. يستخدم البرنامج المساعد Tipue Search jQuery Javascript للبحث في الفهرس وعرض قائمة النتائج.

شاهد عرضًا توضيحيًا مباشرًا يتم تشغيله على صفحات Github. الكود والتكوين الخاص بالعرض التوضيحي موجود في فرع gh-pages.

تثبيت

1. أضف مجلد assets/tipuesearch وجميع محتوياته إلى موقعك.

2. أضف نصوص وأنماط بحث Tipue إلى رأس السمة الخاصة بك. بعض هذه الأسطر اختيارية، راجع المستندات للحصول على معلومات:

 {% if page.tipue_search_active or layout.tipue_search_active %}
<link rel="stylesheet" href="{{ "/assets/tipuesearch/css/normalize.css" | relative_url }}">
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.1.1/jquery.min.js"></script>
<script src="{{ "/assets/tipuesearch/tipuesearch_content.js" | relative_url }}"></script>
<link rel="stylesheet" href="{{ "/assets/tipuesearch/css/tipuesearch.css" | relative_url }}">
<script src="{{ "/assets/tipuesearch/tipuesearch_set.js" | relative_url }}"></script>
<script src="{{ "/assets/tipuesearch/tipuesearch.min.js" | relative_url }}"></script>
{% endif %}

3. قم بإضافة نموذج بحث Tipue Search وعرض النتائج والبرنامج النصي إلى موقعك. استخدم مثال صفحة البحث search.html كمرجع. قم بتعيين tipue_search_active: true في المقدمة لكل صفحة أو تخطيط حيث تريد عرض نتائج البحث. راجع وثائق Tipue Search لتكوين نموذج البحث وعرض نتائج البحث:

 <form action="{{ page.url | relative_url }}">
  <div class="tipue_search_left"><img src="{{ "/assets/tipuesearch/search.png" | relative_url }}" class="tipue_search_icon"></div>
  <div class="tipue_search_right"><input type="text" name="q" id="tipue_search_input" pattern=".{3,}" title="At least 3 characters" required></div>
  <div style="clear: both;"></div>
</form>

<div id="tipue_search_content"></div>

<script>
$(document).ready(function() {
  $('#tipue_search_input').tipuesearch();
});
</script>

الاستخدام

ارجع إلى وثائق Tipue Search وتصفح الكود لفهم كيفية عمل Tipue Search وكيفية دمجه بشكل أفضل في موقعك.

بما في ذلك الصفحات والمجموعات

افتراضيًا، يتم تضمين المشاركات فقط في فهرس البحث. لا يتم تضمين الصفحات والمجموعات.

أضف ما يلي إلى _config.yml لتضمين الصفحات والمجموعات. collections عبارة عن مصفوفة تحتوي على قائمة بالمجموعات التي تريد تضمينها.

 tipue_search:
  include:
    pages: true
    collections: [apples, oranges]

استبعاد من فهرس البحث

استبعاد المستندات المفردة من فهرس البحث باستخدام متغير الواجهة:

 exclude_from_search: true

استبعاد ملفات أو علامات أو فئات متعددة باستخدام الإعداد الموجود في _config.yml . files عبارة عن مصفوفة تحتوي على قائمة بمسارات الملفات التي سيتم استبعادها. tags categories عبارة عن صفائف تحتوي على قوائم بالعلامات والفئات التي تريد استبعادها.

 tipue_search:
  exclude:
    files: [search.html, _apples/gragg.md, _oranges/valencia.md]
    tags: [tag1, tag2]
    categories: [category1, category2]