Plugins

24 Apr 2025 -

ini adalah penjelasan detail semua bagian dokumentasi Jekyll Plugins dalam format Markdown..

Panduan Lengkap Materi Jekyll Plugins

1. Installation

Deskripsi:
Menjelaskan cara menginstal plugin pada proyek Jekyll.

Detail:

• Plugin bisa diinstal dengan menambahkannya ke file Gemfile dan menjalankan bundle install.
• Contoh menambah plugin:

  gem "jekyll-sitemap"
  

• Setelah itu, plugin perlu didaftarkan di _config.yml: ```yaml plugins:
  • jekyll-sitemap ```
• Untuk GitHub Pages, hanya plugin tertentu yang didukung.

Referensi:
Installing Plugins

2. Your First Plugin

Deskripsi:
Panduan membuat plugin sederhana pertama untuk Jekyll.

Detail:

• Plugin dapat dibuat dengan menambah file Ruby di folder _plugins.
• Contoh plugin sederhana:

  # _plugins/hello.rb
  Jekyll::Hooks.register :posts, :post_init do |post|
    puts "Hello from plugin! Processing: #{post.data['title']}"
  end
  

• Plugin di folder _plugins otomatis dijalankan saat build.

Referensi:
Your First Plugin

3. Generators

Deskripsi:
Plugin yang digunakan untuk membuat konten baru secara otomatis saat proses build.

Detail:

• Generator digunakan untuk membuat halaman baru, koleksi, atau data tambahan.
• Contoh membuat generator:

  class MyGenerator #{content}"
    end
  end
  

Referensi:
Converters

5. Tags

Deskripsi:
Plugin untuk membuat custom Liquid tags yang bisa digunakan di konten.

Detail:

• Berguna jika ingin menambah fitur khusus di dalam post/page.
• Contoh tag:

  module Jekyll
    class ExampleTag 
  

Referensi:
Filters

7. Commands

Deskripsi:
Plugin untuk menambah subcommand baru pada perintah jekyll di command line.

Detail:

• Cocok jika ingin memperluas CLI Jekyll.
• Contoh command:

  module Jekyll
    class MyCommand < Command
      def self.init_with_program(prog)
        prog.command(:my_command) do |c|
          c.action do |args, options|
            puts "Ini custom command Jekyll!"
          end
        end
      end
    end
  end
  

Referensi:
Commands

8. Hooks

Deskripsi:
Plugin untuk menjalankan kode pada titik tertentu di proses build Jekyll.

Detail:

• Hooks sangat berguna untuk automasi dan kustomisasi tingkat lanjut.
• Contoh penggunaan hook:

  Jekyll::Hooks.register :site, :after_init do |site|
    puts "Site sudah diinisialisasi!"
  end
  

• Daftar hooks tersedia untuk berbagai objek seperti :site, :pages, :posts, dll.

Referensi:
Hooks

Urutan Belajar yang Disarankan

1. Installation
2. Your First Plugin
3. Generators
4. Converters
5. Tags
6. Filters
7. Commands
8. Hooks

Catatan:
Mulailah dari instalasi dan plugin sederhana, lalu lanjutkan ke fitur lanjutan sesuai kebutuhan proyek. Jika ingin eksplorasi lebih lanjut, baca dokumentasi resmi Jekyll Plugins untuk referensi terbaru.