Mac’te Obsidian’da bir Mermaid durum diyagramını basitleştirmek için geçerli her geçişi açıkça belirtin, etiketleri kısaltın ve okuma yönünü sınayın. Sonucu kabul etmeden önce kaynak, hedef ve geçiş metnini karşılaştırın.

Bu kılavuzda A ile D arasındaki dört sentetik durum kullanılıyor. Amaç, doğrudan geçişleri, dönüş yollarını ve başlangıç ve bitiş işaretçilerini korurken tek bir diyagramı daha kolay okunur hâle getirmek. Geçiş tablosu, okların görselleştirici tarafından nasıl yerleştirildiğinden bağımsız olarak bu korumayı denetlemek için somut bir yöntem sunuyor.

Diyagramı basitleştirirken neler aynı kalmalı?

Önce sunum değişikliklerini modeldeki değişikliklerden ayırın. Daha kısa görünen etiketler ve farklı bir okuma yönü okunabilirliği artırabilir. Başka bir rota aynı hedefe ulaşsa bile bir oku kaldırmak doğrudan geçişler kümesini değiştirir.

Örneğin, A durumundan C durumuna hem doğrudan bir geçiş hem de B üzerinden bir rota bulunduğunu varsayalım. Doğrudan geçişi silmek, okuyucuyu B durumuna uğranıldığını çıkarsamaya zorlar. Hedefe ulaşılabilirlik korunur, ancak geçerli tek adımlı bir geçiş kaybolur. Bu görev için hedefe sonunda ulaşmak yeterli değildir.

Aşağıdaki geçiş envanterini özgün belirtim olarak kullanın. Etiketler sentetik olay adlarıdır; bu örnek kapsamında anlam taşırlar ve özgün oklarına bağlı kalmalıdırlar.

Kaynak Hedef Geçiş metni
Başlangıç A Yok
A B step
A C alternate
B C next
B A reset
C B back
C A reset
C D finish
D Bitiş Yok

Başlangıç ve bitiş dâhil dokuz geçiş vardır. İki okun etiketi reset olsa da farklı durumlardan başlarlar. İkisini de koruyun. Benzer şekilde, B ve C arasındaki okların yönleri ve etiketleri farklıdır; bunlar ayrı geçişlerdir.

Daha büyük bir diyagram için düzenlemeden önce her geçişi kaynak, hedef ve metin birleşimi olarak kaydedin. Özgün metniniz koşullar veya eylemler içeriyorsa bunları da koruyun. Yalnızca toplam ok sayısını eşleştirmek, hedefi veya etiketi değişmiş bir oku saptayamaz.

Yüklü Obsidian sürümünüzün hangi görselleştiriciyi kullandığını kontrol edin

Mac’inizde kenar çubuğundaki dişli simgesinden Settings’i açın, ardından General’ı seçin. Üstte gösterilen uygulama sürümünü ve yükleyici sürümünü kaydedin. İlgili sürüm notlarını ararken uygulama sürümünü kullanın. Bu konumlar Obsidian’ın Settings yardımında belgelenmiştir.

Görselleştirici sınırı önemlidir. Obsidian’ın 1.15.0 Desktop erken erişim sürümü, 22 Ekim 2026 tarihli olarak, diyagram görselleştirmesini Pele’ye geçiriyor ve Mermaid 12.1.0 sözdizimiyle uyumlu olduğunu belirtiyor. Sürüm notlarında ayrıca bu sürümün artık Mermaid kütüphanesini içermediği söyleniyor. Bu ifade adı geçen sürüm için geçerlidir; yüklü her Obsidian sürümündeki görselleştiriciyi belirtmez. Obsidian 1.15.0 Desktop sürüm notlarına bakın.

Sözdizimi uyumluluğunu ve görsel görünümü ayrı ayrı denetleyin. Diyagramı başka bir düzenleyicinin kabul etmesi yararlı bir karşılaştırma sağlar, ancak son sonucu yüklü uygulamanızda doğrulamanız gerekir. Üst projedeki bir düzen ayarının veya daha yeni bir belge örneğinin yerel görselleştiricinizde aynı şekilde çalışacağını varsaymayın.

Aşağıdaki örnekte görselleştirici yapılandırması, tema ayarları ve biçimlendirme özellikle kullanılmıyor. Zaten çalışan bir diyagramınız varsa mevcut diyagram bildirimiyle başlayın ve her seferinde tek bir sunum ayrıntısını değiştirin. Burada anlatılan geçiş envanterini çıkarma ve etiket düzenlemelerini yapmak için yükseltme gerekmez.

Açık geçişler içeren kompakt bir sürüm oluşturun

Aşağıdaki eksiksiz örnek, envanterin dokuz satırının tümünü uygular. Görünen durum adları bilerek kısa tutulmuştur. A başlangıç noktasıdır, B ve C dönüş yollarına sahiptir ve yalnızca D bitiş işaretçisine geçiş yapar.

Mermaid; durum takma adlarını, etiketli geçişleri, başlangıç ve bitiş işaretçilerini ve yön bildirimini durum diyagramı başvurusunda belgeliyor. Obsidian’ın belgelediği ekleme yöntemi, Gelişmiş biçimlendirme sözdizimi bölümünde açıklandığı gibi mermaid dil tanımlayıcısına sahip çitlenmiş bir kod bloğudur.

```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 --> [*]
```

Açılış ve kapanış üçlü ters tırnak satırları dâhil Markdown örneğinin tamamını bir nota yapıştırın. Burada örneği göstermek için kullanılan dıştaki dört ters tırnaklı çit bu makalenin parçasıdır; not içeriğine dâhil değildir.

Tam metni incelemek için Source mode’u kullanın. Görselleştirilmiş sonucu incelemek için Reading view’a geçin; macOS’ta Cmd+E, okuma ve düzenleme görünümleri arasında geçiş yapar. Obsidian bu denetimleri Görünümler ve düzenleme modu bölümünde açıklıyor.

Geçiş ifadeleri kaynak durumlarına göre gruplandırılmıştır; böylece her durumun çıkış seçenekleri birlikte incelenebilir. Bu düzenleme kaynak metni korumaya yardımcı olur; görselleştiricinin her durumu nereye yerleştireceğini garanti etmez.

Örneği normalde kullandığınız not genişliğinde deneyin. Ardından yalnızca direction LR satırını kaldırıp sonucu karşılaştırın. Dallanma ve dönüş yollarını izlemeyi hangisi kolaylaştırıyorsa o sunumu kullanın. Soldan sağa bir diyagram daha fazla yatay alan gerektirebilir; bu yüzden sonucu gerçek not bölmesinde değerlendirin.

Etiketleri yalnızca anlamlarının izin verdiği ölçüde kısaltın. Bu sentetik örnekte Stage B için başka açıklama gerekmez. Kendi diyagramınızda iki durumu birbirinden ayıran ifadeleri koruyun. Uzun bir açıklama gerekiyorsa onu bitişik bir metin paragrafına koyun ve durum tanımlayıcısıyla bağlantısını açık tutun.

Hangi kestirme yollar modeli değiştirebilir?

Tekrarlanan oklar, ortak bir ara düğüm eklemeye yöneltebilir. Bunu yapmadan önce o düğümün neyi temsil ettiğini ve özgün doğrudan geçişlerin hâlâ var olup olmadığını sorun.

Ortak bir sıfırlama düğümü doğrudan yolları değiştirir

Envanterde B ve C durumlarının her ikisi de reset olayında doğrudan A durumuna geçer. Bu okları R adlı yeni bir durum üzerinden geçen yollarla değiştirmek bir ara durum oluşturur ve özgün doğrudan kenarları kaldırır. Okuyucu yine de A durumuna giden bir yolu izleyebilir, ancak diyagram artık farklı adımları anlatır.

Bu makaledeki tam sonucu elde etmek için iki sıfırlama okunu da koruyun. Tekrarlanmaları, aynı olay için geçerli iki başlangıç koşulunu kaydeder. Görsel karmaşayı azaltmak ancak anlamları korunuyorsa işe yarar.

Bir seçimin veya çatallanmanın modelde gerekçesi olmalı

Mermaid, yollar arasında dallanma için <<choice>>, çatallanma ve birleşme yapıları için <<fork>> ve <<join>> belgelerini sunuyor. Bunlar durum diyagramı başvurusunda ayrı diyagram yapılarıdır.

Düzensiz görünen birkaç oku ortak bir kavşakta toplamak için bunlardan birini eklemeyin. Bu örnekte amaç, durumlar arasındaki doğrudan geçişleri korumaktır. Araya bir yapı eklemek, yollarının özgün modelle nasıl örtüştüğünü ayrıca açıklamayı gerektirir. Açık oklar bu eşleşmeyi hemen görünür kılar.

Bileşik durumların belgelenmiş bir sınırı vardır

Mermaid bileşik durumları destekler, ancak farklı bileşik durumlara ait iç durumlar arasında geçiş yapılmasına belgelerinde açıkça izin verilmez. Bileşik durumlar bölümüne bakın.

Düğümlerinizi gruplamak böyle bir durum oluşturuyorsa bu görev için bağlantılı durumları düz tutun. Bir oku dış bileşik duruma taşımak uç noktasını değiştirir; bu otomatik olarak eşdeğer bir çözüm değildir. Hiyerarşiyi, modelin gerçek yapısını temsil ettiği ve giriş ve çıkış davranışını açıklayabildiğiniz durumlarda kullanın.

Dört durumlu örnekte iç içe geçirme pek bir şey kazandırmaz. Yararlı basitleştirme, geçiş yapısını bozmadan etiketleri kısaltmak ve sunumu netleştirmektir.

Hem geçişleri hem de görselleştirilmiş sonucu doğrulayın

Özgün diyagramı değiştirmeden önce iki tur kontrol yapın. İlk tur modeli, ikincisi seçilen sunumun kullanışlı olup olmadığını denetler.

  1. Envanterin her satırını bir geçiş ifadesiyle karşılaştırın. Her iki uç noktayı ve etiketin tamamını doğrulayın.
  2. Her geçiş ifadesini envantere göre de kontrol edin. Bu, eksik okların yanı sıra fazladan okları da yakalar.
  3. Başlangıç ve bitişi ayrı ayrı kontrol edin. Burada başlangıç yalnızca A durumuna gider ve bitişe yalnızca D durumu gider.
  4. Etiketlerin okunabilir ve ok uçlarının birbirinden ayırt edilebilir olup olmadığını görmek için görselleştirilmiş diyagramı inceleyin.
  5. Yalnızca ileri akışı gözden geçirirken kolayca gözden kaçabilecek B ve C durumlarından dönüş yollarını izleyin.

Bu örnek için üç okuma kontrolü deneyin: başlangıçtan A durumuna, ardından C durumuna, sonra D durumuna ve bitişe; başlangıçtan A durumuna, ardından B durumuna ve sonra sıfırlanarak A durumuna; başlangıçtan A durumuna, ardından C durumuna ve oradan B durumuna geri. Bu kontroller alternatif rotayı, sıfırlamayı ve ters yönlü bağlantıyı sınar. Satır karşılaştırmasını tamamlar, onun yerini almaz.

Deterministik bir metin karşılaştırması, örnekteki dokuz geçiş ifadesinin etiketleri de dâhil envanterle eşleştiğini doğruladı. Hazırlık sırasında örnek yüklü bir Obsidian uygulamasında görselleştirilmedi; bu nedenle son boşlukları ve ok yönlendirmelerini yerel sürümünüzde kontrol etmeniz gerekiyor.

Notta kod düz metin olarak görünüyorsa önce Reading view’da olduğunuzu ve açılış çitinde mermaid yazdığını doğrulayın. Düzenlemeden sonra ayrıştırma hatası alırsanız eksiksiz örneğe dönüp değişiklikleri teker teker yeniden uygulayın. Yalnızca düzen sorunluysa geçişleri koruyarak etiket uzunluğunu, yönü ve kullanılabilir bölme genişliğini karşılaştırın.

Envanter karşılaştırması başarılı olduktan sonra etiketleri ve yolları okuması en kolay olan sürümü kullanın. Başarılı bir basitleştirme, okuyucunun aynı geçerli geçişleri daha az çabayla izlemesini sağlarken kaynak metnin incelenmesini ve bakımını da kolaylaştırır.

Kaynaklar