Plugin dalam Jekyll

24 Apr 2025

Jekyll mendukung sistem plugin yang memungkinkan pengguna memperluas dan menyesuaikan perilaku situs statis mereka. Plugin sangat berguna bagi pengembang yang ingin menambahkan fitur tambahan, seperti pagination otomatis, integrasi feed, SEO, sitemap, dan lainnya.

1. Apa Itu Plugin?

Plugin adalah ekstensi atau skrip Ruby yang ditambahkan ke dalam proyek Jekyll untuk menambahkan fungsionalitas yang tidak tersedia secara default. Anda dapat menggunakan plugin yang telah tersedia di RubyGems atau membuat plugin sendiri untuk kebutuhan spesifik.

2. Jenis Plugin dalam Jekyll

Plugin resmi (whitelisted): Dapat digunakan langsung di GitHub Pages.
Plugin pihak ketiga: Plugin dari luar yang harus diinstal secara manual.
Plugin lokal: Plugin buatan sendiri yang diletakkan dalam folder _plugins.

3. Contoh Plugin Populer

jekyll-feed – Menghasilkan RSS feed otomatis.
jekyll-seo-tag – Menambahkan tag SEO secara otomatis ke setiap halaman.
jekyll-sitemap – Membuat file sitemap.xml secara otomatis.
jekyll-paginate – Menambahkan navigasi pagination untuk daftar post.
jekyll-archives – Menyediakan arsip berdasarkan tag, kategori, atau tahun.

4. Cara Menambahkan Plugin

4.1. Melalui Gemfile dan _config.yml

Plugin dari RubyGems dapat ditambahkan dengan mengedit Gemfile dan _config.yml.

A. Tambahkan ke dalam Gemfile

gem 'jekyll-feed'
gem 'jekyll-seo-tag'

B. Tambahkan ke dalam _config.yml

plugins:
  - jekyll-feed
  - jekyll-seo-tag

C. Instal plugin dengan bundler

bundle install

D. Jalankan situs

bundle exec jekyll serve

4.2. Menggunakan Plugin Lokal

Anda bisa menaruh file Ruby dengan ekstensi .rb di dalam folder _plugins/. Contoh: membuat filter untuk memformat tanggal ke Bahasa Indonesia.

# _plugins/tanggal_indo.rb
module Jekyll
  module TanggalIndo
    def tanggal_indo(date)
      bulan = ["Januari", "Februari", "Maret", "April", "Mei", "Juni",
               "Juli", "Agustus", "September", "Oktober", "November", "Desember"]
      "#{date.strftime('%-d')} #{bulan[date.strftime('%-m').to_i - 1]} #{date.strftime('%Y')}"
    end
  end
end

Liquid::Template.register_filter(Jekyll::TanggalIndo)

Gunakan di template:

{{ page.date | tanggal_indo }}

5. Keterbatasan di GitHub Pages

GitHub Pages tidak mengizinkan semua plugin. Hanya plugin yang telah di-*whitelist* (diizinkan resmi) yang bisa digunakan langsung. Untuk menggunakan plugin kustom atau tidak resmi, Anda perlu melakukan build Jekyll secara lokal dan hanya mengupload hasilnya (folder _site) ke GitHub.

Solusi alternatif:

Build secara lokal, lalu push ke branch gh-pages atau gunakan GitHub Actions.
Gunakan layanan hosting alternatif seperti Netlify atau Vercel yang mendukung semua plugin.

6. Tips Penggunaan Plugin

Gunakan plugin resmi terlebih dahulu untuk menjaga kompatibilitas.
Dokumentasikan plugin tambahan agar tidak membingungkan contributor proyek.
Gunakan plugin hanya jika memang dibutuhkan — terlalu banyak plugin bisa memperlambat build.
Selalu periksa versi plugin dan dukungan Jekyll yang sesuai.

7. Kesimpulan

Plugin adalah cara terbaik untuk menambah fitur dan fleksibilitas pada situs Jekyll Anda. Baik plugin resmi maupun kustom dapat membantu menghemat waktu, menambahkan fungsi otomatisasi, dan meningkatkan kualitas situs. Namun, penggunaannya perlu diperhatikan terutama jika Anda menggunakan GitHub Pages sebagai host.