Taxonomy Variable Di Hugo

Disini kita akan belajar semua hal tentang taksonomi, mulai dari mengenal apa itu taksonomi, fungsinya untuk apa, cara membuat taksonomi, dan variabel taksonomi.

Taxonomy atau taksonomi adalah cara untuk menghubungkan atau mengelompokkan satu artikel dengan artikel lainnya.

Fungsi taksonomi adalah untuk membuat artikel atau konten dengan topik yang sama menjadi saling terhubung.

Sebenarnya kita sudah bisa langsung menggunakan sebuah taksonomi tanpa harus mengatur apa-apa.

Lewati pembelajaran ini jika kamu tidak ingin membuat taksonomi kustom (taksonomi khusus buatan sendiri) atau jika tidak ingin mengubah apapun yang terdapat di taksonomi.

Taxonomy Default Hugo

Terdapat dua taksonomi default dari hugo, diantaranya yaitu:

1. categories
2. tags

Kedua taksonomi ini dapat digunakan secara langsung di front matter artikel.

Contoh penggunaan kedua taksonomi (categories, dan tags) di front matter:

Versi yaml:

 1---
 2title: "Variable Hugo"
 3date: 2022-11-20T22:26:12+08:00
 4categories:
 5- hugo
 6tags:
 7- framework
 8- hugo
 9- variable hugo
10---
11Variable Hugo adalah ...

Versi toml:

1+++
2title = "Variable Hugo"
3date = 2022-11-20T22:26:12+08:00
4categories = ["hugo"]
5tags = ["framework", "hugo", "variable hugo"]
6+++
7Variable Hugo adalah ...

Halaman taxonomy

Secara default, taksonomi di hugo sudah dapat digunakan tanpa perlu mengatur nilai khusus.

Kamu dapat melihat halaman taksonomi (categories, dan tags) di:

1. domain.com/categories/
2. domain.com/tags/

Mengatur taxonomy kustom

Tampilan default atau bawaan dari kedua halaman taksonomi mengikuti apa yang terdapat di file list.html.

Kita memerlukan folder dan file khusus untuk mengatur nilai kustom ke halaman taksonomi (categories, atau tags).

Berikut ini adalah folder dan file yang mengatur taksonomi:

Untuk taksonomi categories:

1. layouts/categories/terms.html
2. layouts/categories/taxonomy.html

Untuk taksonomi tags:

1. layouts/tags/terms.html
2. layouts/tags/taxonomy.html

1. terms.html digunakan untuk mengatur semua daftar taksonomi yang sudah dibuat di front matter.

   Lebih tepatnya untuk mengatur halaman /tags/

2. taxonomy.html digunakan untuk mengatur halaman dari taksonomi itu sendiri.

   Lebih tepatnya untuk mengatur halaman /tags/nama-tag/

Ilustrasi letak folder dan file taksonomi:

 1layouts
 2    ├── _default
 3    ├── partials
 4    ├── shortcodes
 5    ├── categories
 6    |        ├── terms.html
 7    |        ├── taxonomy.html
 8    |
 9    ├── tags
10          ├── terms.html
11          ├── taxonomy.html

Contoh isi file taxonomy

Saya akan memberikan contoh isi file terms.html dan taxonomy.html untuk taksonomi tags.

terms.html:

1{{ define "main" }}
2<ul>
3    {{ range .Data.Terms.Alphabetical }}
4            <li><a href="{{ .Page.Permalink }}">{{ .Page.Title }}</a> {{ .Count }}</li>
5    {{ end }}
6</ul>
7{{ end }}

taxonomy.html:

1{{ define "main" }}
2<ul>
3    {{ range .Pages }}
4    <li>
5      <a href="{{.RelPermalink}}">{{ .Title }}</a>
6    </li>
7    {{ end }}
8</ul>
9{{ end }}

Taxonomy Variable

Perlu kamu ketahui, bahwa kita dapat menggunakan site variable, dan page variable di halaman taksonomi (categories, dan tags).

Selain itu, hugo juga sudah menyiapkan beberapa variable khusus untuk taksonomi.

Dibawah ini adalah beberapa variabel taksonomi yang dapat kita gunakan:

Taksonomi variabel untuk nilai global

Gunakan variabel taksonomi dibawah ini untuk menjangkau taksonomi tanpa terbatas aturan tertentu.

.Site.Taxonomies

Berisi semua data tentang taksonomi. Termasuk taksonomi categories, dan taksonomi tags.

.Site.Taxonomies.categories

Berisi semua data tentang taksonomi categories. Ini digunakan untuk menargetkan taksonomi categories.

.Site.Taxonomies.tags

Berisi semua data tentang taksonomi tags. Ini digunakan untuk menargetkan taksonomi tags.

Taksonomi terms page variable

Taksonomi dibawah ini digunakan untuk file terms.html (yaitu untuk mengatur semua taksonomi yamg dibuat).

.Data.Singular

Mereferensikan nama tunggal dari taksonomi.

Contohnya seperti nama tunggal dari taksonomi categories yaitu => category.

Atau nama tunggal dari taksonomi tags yaitu => tag

.Data.Plural

Mereferensikan nama jamak dari taksonomi.

Taksonomi categories => categories.

Taksonomi tags => tags.

.Data.Pages

Mereferensikan semua daftar halaman dari taksonomi yang sudah dibuat.

.Data.Terms

Mereferensikan semua daftar taksonomi yang sudah dibuat dan sekaligus daftar artikel/konten yang menggunakan taksonomi tersebut.

.Data.Terms.Alphabetical

Memiliki data yang sama seperti .Data.Terms. Tetapi, diurutkan berdasarkan huruf, contohnya a, b, c, dst…

.Data.Terms.Alphabetical.Reverse

Ini sama seperti .Data.Terms.Alphabetical. Tetapi urutannya dibalik, contohnya …, c, b, a.

.Data.Terms.ByCount

Memiliki data yang sama seperti .Data.Terms. Tetapi, diurutkan berdasarkan banyaknya artikel/konten yang menggunakan taksonomi tersebut.

Penggambarannya:

1. Kucing 5
2. Ikan 3
3. Sapi 2

.Data.Terms.ByCount.Reverse

Ini sama seperti .Data.Terms.ByCount. Tetapi, urutannya dibalik, dimulai dari taksonomi yang paling sedikit digunakan.

Penggambarannya:

1. Sapi 2
2. Ikan 3
3. Kucing 5