Kecualikan File Tertentu Di Hugo

Disini kamu akan belajar cara untuk mengecualikan file di hugo. Kamu dapat mengecualikan file secara spesifik atau secara massal.

Di hugo kita juga bisa mengecualikan file yang tidak ingin dirender (ditampilkan).

Caranya sangat mudah, kita dapat menggunakan parameter ignoreFiles dengan nilai berupa nama file atau ekstensi file tersebut.

Kita dapat menggunakan jalur file relatif atau jalur file absolut untuk mengecualikan file.

Berdasarkan dokumentasi hugo, file yang dapat dikecualikan adalah file dari folder content dan folder data.

Namun, jika kamu masih ingin mencoba mengecualikan file diluar kedua folder tersebut, silahkan gunakan metode jalur file absolut yang akan saya jelaskan.

1. Kecualikan File Dengan Jalur File Relatif

Maksud dari jalur file relatif adalah kita tidak perlu memberikan jalur file secara detail atau spesifik untuk satu file tertentu.

Cukup gunakan nama file atau bahkan hanya ekstensi file.

Jika nilai dari ignoreFiles hanya nama file tertentu maka hanya akan menargetkan file tersebut.

Namun jika nilai dari ignoreFiles berupa ekstensi file, maka yang ditargetkan semua file dengan ekstensi tersebut.

Lihat contoh dibawah ini:

File config.toml:

1ignoreFiles = ['\.json$', 'artikel10\.md$']

Contoh diatas akan mengecualikan semua file berekstensi .json dan file artikel10.md.

Selalu gunakan \ untuk memberi tahu hugo bahwa kata setelahnya merupakan format atau ekstensi dari file.

Selalu gunakan $ diakhir jalur file relatif.

2. Kecualikan File Dengan Jalur File Absolut

Selain mengecualikan file dengan jalur file relatif. Kita juga dapat mengecualikan file secara spesifik dengan memberikan nilai berupa jalur file absolut.

Maksud dari jalur file absolut adalah nilai dari parameter ignoreFiles berupa jalur yang lengkap dari file terebut.

Untuk dapat mengetahui jalur file absolut di vscode (visual studio code), klik kanan pada mouse di file yang ditargetkan, kemudian klik Copy Path.

Cara alternatif adalah dengan menggunakan file manager bawaan (windows, mac, atau linux).

Cari file yang ingin dikecualikan di file manager, kemudian copy jalur file pada kolom jalur file atau klik setting atau properties dan cari location.

Lihat contoh pada gambar dibawah ini:

Setelah mengetahui jalur file absolut dari file yang ingin dikecualikan, isi nilai parameter ignoreFiles, dengan jalur file absolut tersebut.

Lihat contohnya dibawah ini:

File config.toml:

1ignoreFiles = ['^/home/doni/Project/doni/content/hugo/arikel1\.md$']

Gunakan ^ diawal jalur file absolut.

Gunakan juga \ dan $ seperti yang saya contohkan di jalur file relatif.

Kesimpulan

Menggunakan jalur file relatif atau jalur file absolut tergantung dari kondisi kalian masing-masing.

Ada saatnya kita menggunakan jalur file relatif untuk mengecualikan file dan ada juga saatnya kita perlu menggunakan jalur file absolut.

Jika terdapat nama file yang sama pada folder yang berbeda, kemungkinan lebih baik menggunakan metode jalur file absolut.

Walaupun dengan metode jalur file relatif juga memungkinkan.

Saya sendiri lebih suka menggunakan metode jalur file relatif karena lebih simpel dan mudah.