Cara Membuat Postingan Baru dengan Benar dan Aman di Astro

Sekarang saatnya kita berkenalan dengan framework modern, yaitu Astro. Sebagai framework web modern yang mengutamakan kecepatan, Astro memiliki pendekatan yang sedikit berbeda namun sangat aman dalam mengelola artikel, yaitu menggunakan fitur Content Collections.

Dengan metode yang benar, artikel Anda tidak hanya rapi secara struktur kode dan ramah SEO, tetapi juga terhindar dari risiko kesalahan (error) saat proses pembangunan (build) di server deployment seperti Vercel.

Berikut adalah panduan lengkap cara membuat postingan baru di Astro dari awal, baik melalui komputer lokal maupun langsung via GitHub.

---

Langkah 1: Memahami Struktur Folder Artikel di Astro

Di dalam proyek Astro, artikel idealnya disimpan di dalam folder Content Collections.

Struktur foldernya di komputer lokal Anda akan terlihat seperti ini:

astroku/
├── src/
│   ├── content/
│   │   └── blog/  <-- Tempat Anda menaruh file artikel
│   │       ├── artikel-pertama.md
│   │       └── tutorial-kedua.mdx

Catatan: Anda bebas menamai folder di dalam src/content/ tersebut (misalnya blog, posts, atau artikel), namun pastikan nama folder tersebut sudah didaftarkan di file konfigurasi src/content/config.ts.

---

Langkah 2: Membuat File Konten (.md atau .mdx)

Di dalam folder koleksi tersebut (misalnya folder blog), buat file baru dengan huruf kecil semua dan gunakan tanda hubung (-) sebagai pemisah kata, contohnya:
cara-membuat-postingan-baru-benar-aman-astro.md

Astro secara bawaan mendukung dua format file konten:

• Gunakan .md jika artikel Anda hanya berisi tulisan tutorial standar dan gambar pasif (sangat direkomendasikan karena lebih ringan).
• Gunakan .mdx jika di tengah-tengah artikel Anda ingin menyisipkan komponen interaktif buatan sendiri (seperti tombol interaktif, formulir, atau kalkulator).

---

Langkah 3: Mengisi Front Matter di Bagian Atas

Di dalam proyek Astro, Anda wajib menggunakan Front Matter yang diapit oleh tanda hubung tiga (---) dengan format YAML. Sebagai catatan penting, Astro tidak mendukung format tanda plus (+++ atau TOML). Jika Anda menggunakan format tersebut, proses build di server akan mengalami kegagalan.

Berikut adalah contoh struktur Front Matter standar Astro yang lengkap, aman, dan sudah lolos validasi skema SEO:

---
title: 'Judul Artikel Astro Anda yang Menarik'
slug: 'kustom-slug-pilihan-anda'
pubDate: 2026-09-08
draft: false
description: 'Deskripsi pendek isi artikel untuk kebutuhan pencarian Google.'
tags: ['Astro', 'Tutorial']
author: 'Admin'
---

Aturan Ketat Front Matter Astro:

1. Validasi Skema (Schema): Astro akan memverifikasi apakah data yang Anda masukkan (seperti title atau pubDate) sudah sesuai dengan aturan yang didaftarkan pada file src/content/config.ts. Kesalahan pengetikan format atau tipe data akan menyebabkan situs gagal diperbarui.
2. Kustom slug: Secara default, Astro membuat URL berdasarkan nama file .md Anda. Dengan memasang kustom slug di atas, Anda bisa memotong URL agar langsung berada di belakang domain utama Anda tanpa embel-embel nama file yang panjang.

---

Langkah 4: Pilihan Cara Membuat dan Menerbitkan Artikel

Tulis isi artikel Anda tepat di bawah baris penutup Front Matter menggunakan simbol Markdown murni. Berbeda dengan Hugo, Astro secara bawaan sudah aman dalam merender konten teks, sehingga Anda tidak perlu mengaktifkan pengaturan keamanan tambahan seperti unsafe HTML.

Untuk menerbitkan artikel, Anda bisa memilih salah satu dari dua metode berikut:

Metode A: Melalui Komputer Lokal (Local Development)

Jika Anda terbiasa menulis di text editor lokal seperti VS Code, ikuti langkah berikut:

1. Simpan file artikel yang telah Anda buat di folder proyek lokal.
2. Buka terminal, lalu jalankan perintah Git standar berikut untuk mengunggah perubahan:

   git add .
   git commit -m "menambah artikel tutorial astro"
   git push origin main

Metode B: Langsung Melalui GitHub (Tanpa Buka Komputer Lokal)

Jika Anda sedang bepergian atau ingin menulis cepat tanpa perlu membuka aplikasi editor di komputer, Anda bisa langsung membuatnya melalui situs web GitHub:

1. Buka repositori proyek Astro Anda di GitHub.
2. Masuk ke folder src/content/blog/ (atau nama folder koleksi artikel Anda).
3. Klik tombol Add file di sudut kanan atas, lalu pilih Create new file.
4. Beri nama file pada kolom yang tersedia (misalnya: artikel-baru-github.md).
5. Isi Front Matter beserta seluruh konten artikel Anda pada kolom teks yang disediakan.
6. Jika sudah selesai, klik tombol Commit changes di kanan atas.
7. Tulis pesan komit singkat, pastikan opsi terpilih adalah Commit directly to the main branch, lalu klik Commit changes.

---

Kesimpulan

Setelah Anda melakukan git push dari komputer lokal atau melakukan Commit langsung di GitHub, server Vercel atau penyedia hosting Anda akan otomatis mendeteksi perubahan tersebut. Sistem akan langsung membaca koleksi konten Astro Anda, memproses kustom slug, melakukan build ulang, dan memperbarui situs web aktif Anda dalam hitungan detik secara otomatis.

Membuat postingan baru di Astro memberikan rasa aman ekstra berkat fitur Content Collections yang menjaga agar struktur data artikel tidak berantakan. Cukup pastikan penempatan file berada di folder yang benar, isi Front Matter dengan teliti, dan biarkan sistem otomatisasi bekerja untuk Anda.