Untuk memudahkan rajah keadaan Mermaid dalam Obsidian pada Mac, kekalkan setiap peralihan yang sah secara eksplisit, pendekkan label dan uji arah bacaan. Bandingkan teks sumber, destinasi dan peralihan sebelum menerima hasilnya.

Panduan ini menggunakan empat keadaan sintetik, A hingga D. Tujuannya ialah menjadikan satu rajah lebih mudah dibaca sambil mengekalkan peralihan langsung, laluan kembali serta penanda mula dan tamatnya. Jadual peralihan menyediakan cara yang konkrit untuk menyemak bahawa semuanya dikekalkan, tanpa bergantung pada cara pemapar meletakkan anak panah.

Apakah yang mesti kekal apabila anda memudahkan rajah?

Mulakan dengan membezakan perubahan persembahan daripada perubahan pada model. Label paparan yang lebih pendek dan arah bacaan yang berbeza boleh meningkatkan kebolehbacaan. Membuang anak panah mengubah set peralihan langsung, walaupun laluan lain masih menuju ke destinasi yang sama.

Contohnya, katakan terdapat peralihan langsung daripada A kepada C dan juga laluan melalui B. Memadamkan peralihan langsung itu akan memaksa pembaca membuat andaian bahawa terdapat persinggahan perantaraan di B. Kebolehcapaian masih dikekalkan, tetapi peralihan satu langkah yang sah telah hilang. Untuk tugasan ini, akhirnya sampai ke destinasi yang sama tidak memadai.

Gunakan inventori peralihan berikut sebagai spesifikasi asal. Labelnya ialah nama peristiwa sintetik; label tersebut membawa makna dalam contoh ini dan mesti kekal pada anak panah asalnya.

Sumber Destinasi Teks peralihan
Mula A Tiada
A B step
A C alternate
B C next
B A reset
C B back
C A reset
C D finish
D Tamat Tiada

Terdapat sembilan peralihan, termasuk mula dan tamat. Dua anak panah berkongsi label reset, tetapi berasal daripada keadaan yang berbeza. Kekalkan kedua-duanya. Begitu juga, anak panah antara B dengan C mempunyai arah dan label yang berbeza; kedua-duanya ialah peralihan berasingan.

Untuk rajah yang lebih besar, catat setiap peralihan sebagai gabungan sumber, destinasi dan teks sebelum mengedit. Jika teks asal anda mengandungi syarat atau tindakan, kekalkan juga semuanya. Memadankan jumlah anak panah sahaja tidak dapat mengesan anak panah yang destinasi atau labelnya telah berubah.

Semak pemapar yang digunakan oleh Obsidian terpasang anda

Pada Mac anda, buka Settings menggunakan ikon gear pada bar sisi, kemudian pilih General. Catat versi aplikasi dan versi pemasang semasa yang tertera di bahagian atas. Gunakan versi aplikasi apabila mencari nota keluaran yang berkaitan. Lokasi ini diterangkan dalam bantuan Settings Obsidian.

Perbezaan pemapar penting. Keluaran akses awal Obsidian 1.15.0 Desktop, bertarikh 22 Oktober 2026, menukar pemaparan rajah kepada Pele dan menyatakan keserasian dengan sintaks Mermaid 12.1.0. Nota keluarannya juga menyatakan bahawa pustaka Mermaid tidak lagi disertakan dalam versi ini. Pernyataan itu terpakai pada keluaran yang dinamakan; ia tidak mengenal pasti pemapar dalam setiap versi Obsidian yang dipasang. Lihat nota keluaran Obsidian 1.15.0 Desktop.

Anggap keserasian sintaks dan rupa visual sebagai dua semakan berasingan. Rajah yang diterima oleh editor lain boleh dijadikan perbandingan, tetapi aplikasi terpasang anda tetap menjadi tempat untuk mengesahkan hasil akhir. Jangan anggap tetapan susun atur daripada huluan atau contoh dokumentasi yang lebih baharu akan berfungsi dengan cara yang sama dalam pemapar setempat anda.

Contoh di bawah sengaja tidak menggunakan konfigurasi pemapar, tetapan tema atau penggayaan. Jika anda sudah mempunyai rajah yang berfungsi, mulakan dengan pengisytiharan rajah sedia ada dan ubah satu butiran persembahan pada satu masa. Anda tidak perlu menaik taraf semata-mata untuk membuat inventori peralihan dan mengedit label seperti yang diterangkan di sini.

Bina versi ringkas dengan peralihan yang jelas

Contoh lengkap di bawah melaksanakan kesemua sembilan baris inventori. Nama keadaan yang dipaparkan sengaja dipendekkan. Keadaan A ialah titik mula, B dan C mempunyai laluan kembali, dan hanya D mempunyai peralihan ke penanda tamat.

Mermaid mendokumentasikan alias keadaan, peralihan berlabel, penanda mula dan tamat serta pernyataan arah dalam rujukan rajah keadaan. Kaedah sisipan yang didokumenkan oleh Obsidian ialah blok kod berpagar dengan pengecam bahasa mermaid, seperti yang diterangkan dalam Sintaks pemformatan lanjutan.

```mermaid
stateDiagram-v2
    direction LR

    state "Stage A" as A
    state "Stage B" as B
    state "Stage C" as C
    state "Stage D" as D

    [*] --> A

    A --> B : step
    A --> C : alternate

    B --> A : reset
    B --> C : next

    C --> A : reset
    C --> B : back
    C --> D : finish

    D --> [*]
```

Tampal keseluruhan contoh Markdown itu, termasuk baris pagar tiga aksara backtick pembuka dan penutupnya, ke dalam nota. Pagar empat backtick di luar yang memaparkan contoh ini dalam artikel bukan sebahagian daripada kandungan nota.

Untuk memeriksa teks yang tepat, gunakan Source mode. Untuk memeriksa hasil yang dipaparkan, beralih ke Reading view; pada macOS, Cmd+E menogol antara paparan membaca dan mengedit. Obsidian menerangkan kawalan ini dalam Paparan dan mod pengeditan.

Pernyataan peralihan dikumpulkan mengikut keadaan sumbernya supaya pilihan keluar bagi setiap keadaan boleh disemak bersama. Susunan ini membantu mengekalkan teks sumber; ia tidak menjamin kedudukan setiap keadaan oleh pemapar.

Cuba contoh itu pada lebar nota yang biasa anda gunakan. Kemudian buang baris direction LR sahaja dan bandingkan hasilnya. Kekalkan persembahan yang memudahkan anda mengikuti cabang dan laluan kembali. Rajah dari kiri ke kanan mungkin memerlukan ruang mendatar yang lebih luas, jadi nilaikan hasilnya dalam anak tetingkap nota sebenar.

Pendekkan label setakat yang dibenarkan oleh maknanya. Dalam contoh sintetik ini, Stage B tidak memerlukan penjelasan lanjut. Dalam rajah anda sendiri, kekalkan sebarang perkataan yang membezakan dua keadaan. Jika penjelasan panjang diperlukan, letakkannya dalam perenggan prosa bersebelahan dan pastikan pemetaan kepada pengecam keadaan jelas.

Jalan pintas manakah yang boleh mengubah model?

Anak panah berulang mungkin menggoda anda untuk memperkenalkan nod perantaraan bersama. Sebelum berbuat demikian, tanyakan apakah yang diwakili oleh nod itu dan sama ada peralihan langsung asal masih wujud.

Nod set semula bersama mengubah laluan langsung

Dalam inventori, B dan C masing-masing beralih secara langsung ke A apabila reset. Menggantikan anak panah tersebut dengan laluan melalui keadaan baharu bernama R mewujudkan keadaan perantaraan dan membuang sisi langsung asal. Pembaca masih boleh menjejaki laluan ke A, tetapi rajah itu kini menerangkan langkah yang berbeza.

Untuk mengekalkan hasil yang tepat dalam artikel ini, kekalkan kedua-dua anak panah set semula. Pengulangan itu merekodkan dua syarat mula yang sah untuk peristiwa yang sama. Mengurangkan ruang visual yang digunakan hanya berguna jika maknanya kekal.

Pilihan atau cabang memerlukan sebab dalam model

Mermaid mendokumentasikan <<choice>> untuk membuat cabang antara laluan serta <<fork>> dan <<join>> untuk struktur cabang dan cantuman. Semua ini ialah binaan rajah yang berbeza dalam rujukan rajah keadaan.

Jangan perkenalkannya semata-mata untuk mengumpulkan beberapa anak panah yang berselerak pada satu persimpangan bersama. Dalam contoh ini, tugasan tersebut adalah untuk mengekalkan peralihan langsung antara keadaan. Menambah binaan perantaraan memerlukan penjelasan berasingan tentang hubungan laluannya dengan model asal. Anak panah yang jelas menjadikan hubungan itu serta-merta.

Keadaan komposit mempunyai batas yang didokumenkan

Mermaid menyokong keadaan komposit, tetapi dokumentasinya secara jelas tidak membenarkan peralihan antara keadaan dalaman yang tergolong dalam keadaan komposit yang berbeza. Lihat Keadaan komposit.

Jika pengelompokan nod anda menghasilkan situasi itu, kekalkan keadaan yang bersambung pada aras yang sama untuk tugasan ini. Mengalihkan anak panah ke komposit luaran mengubah titik hujungnya; tindakan itu tidak semestinya setara. Gunakan hierarki apabila ia mewakili struktur sebenar model dan anda boleh menerangkan tingkah laku masuk dan keluarnya.

Untuk contoh empat keadaan ini, pensarangannya tidak banyak membantu. Penyederhanaan yang berguna ialah label yang lebih pendek dan persembahan yang lebih jelas sambil mengekalkan struktur peralihan.

Sahkan peralihan dan hasil yang dipaparkan

Lakukan dua semakan sebelum menggantikan rajah asal. Semakan pertama menguji model; semakan kedua menilai sama ada persembahan yang dipilih berguna.

  1. Bandingkan setiap baris inventori dengan pernyataan peralihan. Sahkan kedua-dua titik hujung dan label penuh.
  2. Bandingkan setiap pernyataan peralihan dengan inventori. Ini mengesan anak panah tambahan dan juga yang hilang.
  3. Semak mula dan tamat secara berasingan. Di sini, mula hanya menuju ke A, dan hanya D menuju ke tamat.
  4. Periksa rajah yang dipaparkan untuk memastikan label boleh dibaca dan kepala anak panah dapat dibezakan.
  5. Jejaki laluan kembali dari B dan C, kerana laluan ini mudah terlepas pandang apabila hanya kemajuan ke hadapan yang disemak.

Untuk contoh ini, cuba tiga semakan bacaan: mula ke A, kemudian C, kemudian D, kemudian tamat; mula ke A, kemudian B, kemudian set semula ke A; dan mula ke A, kemudian C, kemudian kembali ke B. Semakan ini menguji laluan alternatif, set semula dan sambungan songsang. Semakan tersebut melengkapi perbandingan baris, bukannya menggantikannya.

Perbandingan teks deterministik mengesahkan bahawa sembilan pernyataan peralihan dalam contoh sepadan dengan inventori, termasuk labelnya. Contoh ini tidak dipaparkan dalam aplikasi Obsidian yang terpasang semasa penyediaannya, jadi jarak akhir dan laluan anak panah masih perlu disemak dalam versi setempat anda.

Jika nota memaparkan kod sebagai teks biasa, pastikan dahulu anda melihatnya dalam Reading view dan pagar pembukanya menyatakan mermaid. Jika berlaku ralat penghuraian selepas pengeditan, kembali kepada contoh lengkap dan terapkan semula satu perubahan pada satu masa. Jika hanya susun aturnya yang janggal, kekalkan peralihan sambil membandingkan panjang label, arah dan lebar anak tetingkap yang tersedia.

Kekalkan versi yang label dan laluannya paling mudah dibaca selepas lulus perbandingan inventori. Penyederhanaan yang berjaya membolehkan pembaca mengikuti peralihan sah yang sama dengan lebih mudah, sementara teks sumber kekal mudah diperiksa dan diselenggara.

Sumber