Panduan Sintaks Diagram Timeline Mermaid.js

Apa itu Diagram Timeline?

Sebuah Diagram Timeline adalah alat visualisasi kronologis yang digunakan untuk memetakan peristiwa atau tonggak proyek sepanjang jalur waktu linier. Sementara diagram Gantt menangani ketergantungan tugas yang kompleks dan durasi, diagram Timeline berfokus pada kapan—memberikan narasi yang jelas dan mudah dibaca mengenai perkembangan proyek atau siklus rilis sistem.

Dengan Mermaid.js, Anda dapat mendefinisikan timeline Anda menggunakan format teks sederhana dan hierarkis. Mesin secara otomatis menangani jarak, format tanggal atau label periode, serta penataan penanda peristiwa sepanjang sumbu waktu pusat.

Panduan Sintaks Inti

Untuk merancang timeline yang valid dan dapat dijalankan, Anda harus menentukan periode sumbu dan memetakan peristiwa ke bagian-bagian tertentu.

1. Menginisialisasi Timeline

Anda menginisialisasi kanvas menggunakan timelinekata kunci. Struktur dibangun dengan mendefinisikan bagian-bagian (yang berfungsi sebagai pengelompokan) dan memetakan peristiwa (atau tanggal) ke bagian-bagian tersebut.

timeline
    judul Sejarah Pengembangan Sistem
    bagian 2025
        Q1 : Peluncuran Alpha
    bagian 2026
        Q2 : Rilis Beta

2. Menambahkan Detail ke Peristiwa

Anda dapat menambahkan beberapa detail ke satu penanda waktu dengan menggunakan daftar yang dipisahkan tanda titik dua. Ini berguna untuk merangkum hasil utama atau nomor versi yang terkait dengan tanggal atau periode tertentu.

timeline
    bagian Q3 2026
        Rilis : v1.0.0
                : Peningkatan Kinerja
                : Pemutakhiran Keamanan

Contoh Diagram Waktu Mermaid.js Dunia Nyata: Peta Jalan Rilis Produk

Rancangan ini memodelkan peta jalan produk multi-tahun, mengelompokkan rilis berdasarkan tahun fiskal dan menyoroti hasil penting untuk setiap siklus.

timeline
    title Rencana Produk 2026-2027
    section 2026
        Q1 : Fase Penemuan
           : Wawancara dengan Pemangku Kepentingan
        Q2 : Pengembangan MVP
           : Desain API Inti
        Q3 : Rilis Beta
           : Putaran Umpan Balik Pengguna
    section 2027
        Q1 : Peluncuran Penuh
           : Skalabilitas Global

Praktik Terbaik untuk Timeline

  • Buat Kategori Singkat: Gunakan bagianuntuk menandai pengelompokan tingkat tinggi (seperti tahun atau fase utama), menjaga peristiwa sebenarnya di bawahnya spesifik dan dapat diambil tindakan.
  • Format Tanggal yang Konsisten:Pastikan peristiwa timeline Anda berurutan secara kronologis dalam kode, karena mesin Mermaid mengikuti urutan skrip Anda untuk menentukan penempatan tata letak.
  • Gunakan Detail untuk Konteks:Jangan memenuhi sumbu pusat dengan terlalu banyak teks. Gunakan format peristiwa multi-baris untuk memecah ‘apa yang terjadi’ alih-alih membuat label tanggal menjadi terlalu panjang.
Scroll to Top