jekyll tipue search

Pencarian Jekyll Tipue

Pencarian teks lengkap di Jekyll dengan Tipue Search. Tidak diperlukan plugin. Sepenuhnya kompatibel dengan Halaman Github.

Indeks pencarian di tipuesearch/tipuesearch_content.js dihasilkan dengan Liquid. Plugin Tipue Search jQuery menggunakan Javascript untuk mencari indeks dan menampilkan daftar hasil.

Lihat demo langsung yang berjalan di Halaman Github. Kode dan konfigurasi untuk demo ada di cabang gh-pages.

Instalasi

1. Tambahkan folder assets/tipuesearch dan semua konten ke situs Anda.

2. Tambahkan skrip & gaya Tipue Search ke kepala tema Anda. Beberapa baris ini bersifat opsional, lihat dokumen untuk info:

 {% 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. Tambahkan formulir pencarian Tipue Search, tampilan hasil, dan skrip ke situs Anda. Gunakan contoh halaman pencarian search.html untuk referensi. Tetapkan tipue_search_active: true di bagian depan setiap halaman atau tata letak tempat Anda ingin menampilkan hasil pencarian. Lihat dokumentasi Tipue Search untuk konfigurasi formulir pencarian dan tampilan hasil pencarian:

 <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>

Penggunaan

Lihat dokumentasi Tipue Search dan telusuri kode untuk memahami cara kerja Tipue Search, dan cara terbaik mengintegrasikannya ke situs Anda.

Termasuk halaman dan koleksi

Secara default, hanya postingan yang dimasukkan dalam indeks pencarian. Halaman dan koleksi tidak disertakan.

Tambahkan yang berikut ini ke _config.yml untuk memasukkan halaman dan koleksi. collections adalah larik yang berisi daftar koleksi yang ingin Anda sertakan.

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

Tidak termasuk dari indeks pencarian

Kecualikan satu dokumen dari indeks pencarian dengan variabel front-matter:

 exclude_from_search: true

Kecualikan beberapa file, tag, atau kategori menggunakan pengaturan di _config.yml . files adalah larik yang berisi daftar jalur file yang akan dikecualikan. tags dan categories adalah array yang berisi daftar tag dan kategori yang ingin Anda kecualikan.

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