Skip to main content
Luthfi Syamsiar Luthfi Syamsiar
ID

Ikhtisar: Struktur Direktori & Alur Update

Panduan Update Website

Panduan ini menjelaskan cara memperbarui setiap jenis konten di website. Mulailah dari halaman ini, lalu buka panduan sesuai jenis konten yang ingin Anda ubah (daftar ada di bagian akhir).

Susunan direktori

sashi/
├─ src/
│  ├─ content/        ← semua isi tulisan (yang paling sering diedit)
│  │  ├─ posts/         artikel blog       → /posts/<nama-file>
│  │  ├─ projects/      portofolio         → /projects/<nama-file>
│  │  ├─ docs/          dokumentasi        → /docs/<nama-file>
│  │  ├─ publications/  publikasi ilmiah   → /publications/<nama-file>
│  │  ├─ courses/       kursus             → /courses/<nama-file>
│  │  ├─ pages/         halaman statis     → /<nama-file>
│  │  └─ special/       pengantar halaman arsip
│  ├─ data/           data JSON: cv.json, profiles.json
│  ├─ pages/          kode halaman (.astro)
│  ├─ components/     potongan tampilan
│  ├─ layouts/        kerangka halaman detail
│  ├─ config.ts       pengaturan situs (nama, menu, sosial, beranda)
│  └─ content.config.ts  skema: field apa saja yang boleh dipakai
├─ public/
│  ├─ assets/         gambar konten → ditulis /assets/nama.png
│  └─ admin/          Sveltia CMS
└─ md/                catatan kerja (tidak dipakai situs)

Folder dist/, .astro/, dan public/posts|pages|docs|projects|special|graph/ dibuat otomatis oleh proses build. Jangan diedit.

Aturan umum file Markdown

  • Nama file adalah alamat URL. apik-aplikasi-ujian.md di folder posts menjadi /posts/apik-aplikasi-ujian. Pakai huruf kecil, tanda hubung, tanpa spasi.
  • File dimulai dengan blok --- berisi data (frontmatter), lalu isi tulisan dalam Markdown.
  • Tanggal ditulis 2026-09-27.
  • Angka (year, order, citations) ditulis tanpa tanda kutip.
  • Teks yang mengandung tanda titik dua wajib diberi tanda kutip, misalnya title: "Studi Kasus: Migrasi Sistem".
  • draft: true menyembunyikan konten di situs yang sudah tayang, tetapi masih terlihat saat pengembangan lokal.
  • Gambar disimpan di public/assets/ dan ditulis /assets/nama-file.png (huruf kecil dan tanpa spasi lebih aman).
  • aliases (opsional) mengalihkan alamat lama ke halaman ini.

Tiga cara memperbarui

  1. Lewat CMS di alamat /admin. Login dengan token GitHub, pilih koleksi, isi formulir, lalu simpan. Setiap simpan menjadi commit ke branch main dan memicu build otomatis di Netlify.
  2. Edit file langsung. Buat atau ubah file, jalankan pnpm dev untuk melihat hasilnya di komputer, lalu git commit dan git push.
  3. Ubah tampilan atau pengaturan. Edit config.ts atau file di components/, pages/, styles/.

Sebelum menayangkan, jalankan pnpm build untuk memastikan tidak ada error penulisan.

Kesalahan yang sering terjadi

  • Judul mengandung titik dua tanpa tanda kutip, sehingga build gagal membaca data.
  • year atau order ditulis dalam tanda kutip.
  • Format tanggal salah.
  • Gambar tidak muncul karena path tidak diawali /assets/ atau nama file mengandung spasi.
  • draft: true terlupa dihapus.
  • Nama file diganti setelah tayang sehingga URL lama mati. Gunakan aliases untuk mengalihkan.

Daftar panduan per jenis konten