Konfigurasi dan Manajemen Konten Hugo

  Habibi December 23, 2021
  Habibi December 23, 2021

hugo

Di tulisan sebelumnya saya membahas tentang bagaimana cara membuat blog dengan hugo sebagai engine-nya, mulai dari cara menginstall hugo hingga mengakses blog secara lokal.

Nah, sekarang saya akan melanjutkan ke tahapan konfigurasi dan melakukan manajemen konten di hugo.

Konfigurasi

Hugo menggunakan file config.toml, config.yaml atau config.json untuk melakukan konfigurasi blog.

Kalian bisa menyesuaikan ekstensi mana yang ingin diterapkan ke blog kalian.

Saya sendiri menggunakan ekstensi .toml sebagai contoh, oleh karena itu script yang saya gunakan sebagai contoh di tulisan ini akan menyesuaikan ekstensi .toml.

Jika kalian menggunakan ekstensi lain, silahkan sesuaikan dengan mengikuti panduan di halaman dokumentasi hugo.

File config di hugo dapat digunakan untuk melakukan banyak konfigurasi penting seperti baseURL blog, mengatur judul dan deskripsi blog, memilih tema yang diterapkan di blog dan lain sebagainya.

Bagi kalian yang baru mulai menggunakan hugo, berikut script config yang saya sarankan.

baseurl = "/" #kontrol base URL
title = "Afrizal Habibi" #Homepage title
author = "Afrizal Habibi"
theme = "hugo-paper" #nama tema yang digunakan
copyright = "Copyright © 2021, Afrizal Habibi all rights reserved."

[Params]
    github = "https://github.com/XXX"
    twitter = "https://twitter.com/XXX"
    email = "XXX@example.com"
    opengraph = true
    shareTwitter = true
    dateFormat = "Mon, Jan 2, 2006"

[Permalinks]
    posts = "/:title/"

Script diatas adalah konfigurasi dasar untuk blog hugo yang memuat script yang wajib ada di file konfigurasi kalian.

Jika pada saat kalian mengganti tema dan di file konfigurasi bawaan tema tersebut memuat konfigurasi yang tidak ada di script kalian, maka kalian dapat menyesuaikan dengan konfigurasi tema tersebut agar fungsi-fungsi tema tersebut dapat berjalan dengan baik.

Manajemen File Konten

Sebelum mulai membuat konten di hugo, sebaiknya kita memahami struktur direktori konten di hugo.

├── config.toml
├── content 		← direktori utama konten
│   ├── _index.md
│   ├── about.md
│   ├── archives.md
│   ├── homepage
│   │   ├── about.md
│   │   ├── index.md
│   │   └── work.md
│   └── posts		← direktori tempat membuat file untuk postingan blog
│       ├── _index.md
│       ├── emoji-support.md
│       ├── markdown-syntax.md
│       ├── math-typesetting.md
│       ├── placeholder-text.md
│       └── rich-content.md

Semua file artikel blog kalian disimpan ke dalam direktori posts, tetapi kalian juga bisa membuat folder baru untuk postingan dengan kategori berbeda dengan syarat harus dibuat di dalam folder content juga.

Membuat Artikel

Konten blog hugo ditulis dengan menggunakan Markdown, oleh karena itu setiap konten memiliki ekstensi .md.

Setelah masuk ke direktori content/posts, buat file dengan ekstensi .md.

Sebagai contoh, saya membuat file dengan nama tutorial-hugo.md, buka file tersebut dengan text editor kalian.

Di bagian atas biasanya memuat informasi seperti judul, deskripsi, tanggal, tags dan informasi dasar lainnya mengenai artikel yang kalian buat seperti berikut.

+++
title = "Tutorial Hugo"
date = "2021-12-22"
description = "Cara membuat postingan hugo"
tags = [
   "hugo",
]
+++

Informasi tersebut akan dirender menjadi html dan akan masuk ke meta informasi file html dari artikel kalian.

Untuk isi artikelnya hanya perlu di ketik seperti teks biasa, hanya saja kalian perlu mempelajari sedikit tentang penggunaan markdown seperti untuk membuat teks italic, bold, underline, atau memasukkan link dan gambar ke dalam artikel.


Afrizal Habibi - Penulis
Terima kasih sudah membaca, kamu bisa mendukung penulis dengan mentraktir kopi atau bagikan blog ini ke sosial media!



NEWSLETTER

Mau dapat email setiap ada postingan baru?

comments powered by Disqus