Diagram Kanban
Diagram kanban Mermaid memungkinkan Anda membuat representasi visual dari perpindahan tugas melalui berbagai tahap alur kerja; berikut dijelaskan cara menggunakan sintaks diagram kanban dengan benar.
Dasar
Diagram kanban diawali dengan sintaks kanban, lalu mendefinisikan kolom serta tugas-tugas dalam kolom tersebut.
Salin
Sematkan
kanban
column1[Column Title]
task1[Task Description]
Mendefinisikan kolom
Kolom merepresentasikan berbagai tahap dalam alur kerja, misalnya "Tugas yang harus dilakukan", "Sedang dikerjakan", "Selesai", dan lain-lain. Setiap kolom didefinisikan menggunakan pengenal unik dan judul yang dibungkus dengan tanda kurung siku.
Sintaks:
Salin
Sematkan
columnId[Column Title]
- columnId: pengenal unik kolom.
- [Column Title]: judul yang ditampilkan di bagian kepala kolom.
比如 id1[Todo]
Menambahkan tugas ke kolom
Tugas ditampilkan pada kolomnya masing-masing, dengan indentasi. Setiap tugas mencakup pengenal unik dan deskripsi yang dibungkus dengan tanda kurung siku.
Sintaks:
Salin
Sematkan
taskId[Task Description]
taskId: pengenal unik tugas.,[Task Description]: deskripsi tugas.
Contoh:
Salin
Sematkan
docs[Create Documentation]
Menambahkan metadata ke tugas
Anda dapat menggunakan sintaks @{ ... } untuk menambahkan metadata tambahan pada setiap tugas. Metadata dapat berisi pasangan kunci-nilai seperti assigned, ticket, priority, dan lain-lain, yang akan ditampilkan dalam rendering simpul.
Kunci metadata yang didukung
Ditugaskan kepada: menentukan siapa yang bertanggung jawab atas tugas tersebut.,Tiket: menautkan tugas ke nomor tiket atau masalah.,Prioritas: menunjukkan tingkat urgensi tugas. Nilai yang diperbolehkan: sangat tinggi, tinggi, rendah, dan sangat rendah.
Salin
Sematkan
kanban
todo[Todo]
id3[Update Database Function]@{ ticket: MC-2037, assigned: 'knsv', priority: 'High' }
Opsi konfigurasi
Anda dapat menyesuaikan diagram kanban menggunakan blok konfigurasi di awal berkas markdown. Hal ini berguna untuk mengatur pengaturan global (misalnya URL dasar tiket). Saat ini, diagram kanban <code>ticketBaseUrl</code> ini sangat berguna untuk mengatur pengaturan global, misalnya URL dasar tiket. Saat ini diagram kanban memiliki satu opsi konfigurasi, yaitu ticketBaseUrl. Dapat diatur sesuai contoh berikut:
Salin
Sematkan
---
config:
kanban:
ticketBaseUrl: 'https://yourproject.atlassian.net/browse/#TICKET#'
---
Ketika entri kanban memiliki nomor tiket yang ditentukan, nomor tiket pada diagram akan menyertakan tautan menuju sistem eksternal yang mendefinisikan tiket tersebut. ticketBaseUrl menetapkan URL dasar yang menunjuk ke sistem eksternal, sedangkan #TICKET# akan digantikan oleh nilai tiket dalam metadata tugas, untuk membuat tautan yang valid.
Contoh lengkap
Berikut adalah contoh kode diagram kanban yang lengkap:
Salin
Sematkan
---
config:
kanban:
ticketBaseUrl: 'https://mermaidchart.atlassian.net/browse/#TICKET#'
---
kanban
Todo
[Create Documentation]
docs[Create Blog about the new diagram]
[In progress]
id6[Create renderer so that it works in all cases. We also add some extra text here for testing purposes. And some more just for the extra flare.]
id9[Ready for deploy]
id8[Design grammar]@{ assigned: 'knsv' }
id10[Ready for test]
id4[Create parsing tests]@{ ticket: MC-2038, assigned: 'K.Sveidqvist', priority: 'High' }
id66[last item]@{ priority: 'Very Low', assigned: 'knsv' }
id11[Done]
id5[define getData]
id2[Title of diagram is more than 100 chars when user duplicates diagram with 100 char]@{ ticket: MC-2036, priority: 'Very High'}
id3[Update DB function]@{ ticket: MC-2037, assigned: knsv, priority: 'High' }
id12[Can't reproduce]
id3[Weird flickering in Firefox]
Singkatnya, membuat diagram kanban di Mermaid adalah proses yang sederhana, yang dapat secara efektif memvisualisasikan alur kerja Anda.
Anda dapat menggunakan sintaks @{ ... } untuk menambahkan metadata opsional pada tugas guna memperkaya diagram Anda; sintaks ini memungkinkan Anda menyertakan informasi konteks tambahan, seperti penanggung jawab, nomor tiket, dan prioritas. Untuk penyesuaian lebih lanjut, gunakan blok konfigurasi di bagian atas berkas untuk mengatur opsi global, misalnya ticketBaseUrl, agar dapat menautkan tiket langsung dari diagram.
Dengan mengikuti panduan ini, memastikan pengenal yang unik, indentasi yang benar, serta memanfaatkan metadata dan opsi konfigurasi, Anda dapat membuat diagram kanban yang komprehensif dan terkustomisasi, yang secara efektif memetakan alur kerja proyek.
