Belgeler

Belgeler, daha uzun proje bilgileri için projeye ait Markdown dosyalarıdır. Asıl içerik her zaman .md dosyasıdır ve harici metin düzenleyicileriyle uyumlu kalır.

Sahiplik ve depolama

Tüm Belgeler <Project>/ProjectDocuments/ altında bulunur. Paylaşılan veya Özel Belge kapsamı yoktur. /Game/... altındaki Content Browser klasörleri ProjectDocuments/Content/... altındaki karşılık gelen yollara eşlenir; Developers klasörü de özel sahiplik değil, proje bağlamıdır.

Belgelerin UAsset, paket, yönlendirici, çalışma zamanı nesnesi veya cook edilmiş veri karşılığı yoktur. Markdown her zaman asıl biçim olarak kalır; Locus onu başka bir biçimle sarmalamaz.

Locus Belgeleri ve Content Browser kökleri

Belgeler ağacında tek fiziksel depo üzerinde iki sunum kökü bulunur:

Locus Belgeleri, ayrılmış Content/ alt ağacının dışında saklanan, projeye ait sıradan Belgeleri içerir. Bu Belgeler yalnızca Locus’ta bulunur ve Unreal’ın Content Browser’ına yansıtılmaz.
Content Browser yalnızca göreli yolu Content/ ile başlayan Belgeleri içerir. Locus bu dahili depolama önekini ağaçta gizler; bu nedenle ProjectDocuments/Content/Blueprints/AI/Behavior.md, Content Browser > Blueprints > AI > Behavior olarak görünür ve /Game/Blueprints/AI yoluna yansıtılır.

Content Browser kökü seyrektir ve Belgeler tarafından belirlenir. Yalnızca yansıtılmış bir Locus Belgesini doğrudan içeren klasörleri ve bu klasörlere ulaşmak için gereken üst klasörleri gösterir. İlgisiz /Game klasörlerini yansıtmaz; türetilmiş bir sunum klasörünü kaldırmak karşılık gelen Unreal klasörünü silmez veya değiştirmez.

Yansıtma, dosyayı oluşturmak için kullanılan kullanıcı arayüzünü değil, Belge kimliği olarak kullanılan göreli yolu izler. Başlangıçta keşfedilen, Locus’ta oluşturulan, Ekle > Locus > Locus Belgesi üzerinden oluşturulan, içe aktarılan veya MCP ile oluşturulan eşlenmiş Belgelerin dizinlenmiş kimliği ve yansıtma davranışı aynıdır.

Belge oluşturma ve bulma

Yalnızca Locus’ta bulunan bir Belge için Locus Belgeleri altında oluşturun. Karşılık gelen /Game bağlamına yansıtılan eşlenmiş bir Belge için Content Browser altında oluşturun. Desteklenen bir Content Browser klasöründeki Ekle > Locus > Locus Belgesi de aynı eşlenmiş kimliği oluşturur. Locus gerçek bir harici .md dosyası oluşturur, normal kullanıcı arayüzünde uzantıyı gizler ve özel bir düzenleyici sekmesi açar. Markdown içe aktarımları ve MCP ile oluşturulan Belgeler aynı yerel, İzlenmiyor durumunda oluşturma politikasını izler.

Yeni bir Belgeyi kaynak denetimine eklemeden önce düzenleyin:

Oluştur → yeniden adlandır, taşı ve düzenle → yolu kesinleştiğinde Ekleme İçin İşaretle.

Çalışma alanı fiziksel klasörlere göz atar; başlık/yol aramasını, durum filtrelerini, yenilemeyi, açmayı, yeniden adlandırmayı, taşımayı, silmeyi, kullanıma almayı, ekleme için işaretlemeyi, içe ve dışa aktarmayı destekler. Aynı anda birden fazla Belge sekmesi açık olabilir; zaten açık olan bir yol yeniden açıldığında mevcut sekmesine odaklanılır.

İçe aktarmak için Content Browser Locus eylemini kullanın ve geçerli bir UTF-8 .md dosyası seçin. Locus kaynak baytlarını ve satır sonlarını korur; hedef zaten varsa güvenli, numaralandırılmış bir ad kullanır.

Belgeler araç çubuğu tek satırda kalır. Alan daralınca düşük öncelikli işlemler aşamalı olarak Diğer işlemler menüsüne geçer; Dışa Aktar ve Yenile bu menüde kalır. Yapılandırılmış sağlayıcı yokken kaynak denetimi işlemleri gösterilmez.

Düzenleme ve kaydetme

Yeni veya boş Belgeler Düzenleme Modunda, içerik bulunan Belgeler Okuma Modunda açılır. Düzenleme Modu için Ctrl+E, Okuma Modu için Ctrl+R, kaydetmek için Ctrl+S tuşlarına basın. Belgeler, Not tarzı otomatik kaydetme yerine açık kaydetme kullanır.

Kaynak düzenleyici; başlıklar, vurgu, satır içi kod ve kod blokları, sıralı ve sırasız listeler, görev listeleri, blok alıntıları, bağlantılar, tablolar, yatay çizgiler, Varlık Referansları ve Pin Referansları için komutlar sunar. Bölünmüş Önizleme, kısa bir güncelleme gecikmesinin ardından kaydedilmemiş geçerli arabelleği kaynağın yanında gösterir; Önizlemeyi açmak veya güncellemek dosyayı kaydetmez.

Düzenle modundaki kompakt araç çubuğunda Başlık, Kalın, İtalik, Satır İçi Kod, Sırasız Liste, Sıralı Liste, Harici Bağlantı, Varlık Referansı ve Pin Referansı bulunur; kalan komutlar Biçimlendir menüsündedir. Önizlemeyi Böl, kaydetmeden mevcut tamponu kısa gecikmeyle sağda işler; bölücü yeniden boyutlandırılabilir ve açık durum ile oran kişisel tercih olarak saklanır.

Okuma Modu ve Markdown desteği

Okuma Modu yerel Unreal kullanıcı arayüzünü kullanır. Başlıklar, paragraflar, vurgu, kalın metin, listeler, yalnızca görüntülenen görev öğeleri, blok alıntıları, kod, bağlantılar, hizalamalı tablolar, yatay çizgiler ve üstü çizili metin dahil, düzenleyici araç çubuğunun gerektirdiği Markdown yapılarını destekler.

Locus tarayıcıyla eşdeğer veya eksiksiz Markdown işleme iddiasında bulunmaz. Ham HTML etkisiz kaynak metni olarak kalır, JavaScript hiçbir zaman çalışmaz, güvenli olmayan URL şemaları etkinleştirilmez ve uzak içerik otomatik olarak getirilmez. HTTP ve HTTPS bağlantıları yalnızca açık bir kullanıcı eyleminden sonra işletim sistemi tarayıcısında açılır.

Başlık, liste ve tablo içeren bir proje Markdown belgesini Okuma Modunda gösteren Locus Belge Düzenleyicisi — Belgeler Markdown'ı kaynak olarak korurken Okuma Modu desteklenen yapıyı yerel Editor kullanıcı arayüzünde sunar.

Asset ve Pin referansları sunumda okunabilir etiketler kullanır. Geçerli haritadaki bir Pine odaklanılabilir; farklı haritadaki bir Pin, haritası otomatik yüklenmeden ait olduğu seviyeyi bulabilir. Eksik referanslar etkisiz ve tanılanabilir kalır.

Çözümlenen Varlık, Pin, Not, Belge ve Actor referansları okunabilir etiketlerle gösterilir. Actor referansı yalnızca World Outliner’dan tek bir uygun yüklü Actor’ın Düzenle modundaki Belgeye sürüklenmesiyle yazılır; Referans ekle veya @ içinde sunulmaz. Ham HTML ve JavaScript hiçbir zaman çalıştırılmaz, uzak içerik otomatik alınmaz.

Yeniden adlandırma, taşıma ve silme

Yeniden adlandırma ve taşıma Belgeler kökünün içinde kalır. İzlenmiyor durumundaki uygun bir Belgede araç çubuğu veya bağlam menüsündeki Yeniden Adlandır’ı, F2 tuşunu, araç çubuğundaki Taşı eylemini ya da geçerli, mevcut bir klasöre sürüklemeyi kullanın. Yeniden adlandırma ve taşıma işlemleri Locus Belgeler çalışma alanından yapılır; Content Browser öğesi yalnızca bir yansıtmadır ve doğrudan Content Browser üzerinden yeniden adlandırma desteklenmez.

Ekleme İçin İşaretle sonrasında Yeniden Adlandır ve Taşı bilerek kullanılamaz. Locus, tüm Kaynak Denetimi sağlayıcılarında güvenli ve işlemsel bir taşıma işlemini garanti edemediği için denetlenen Belgelerde de kullanılamaz. Bu güvenlik sınırı, dosya sistemi değişikliğinin Belge ile kaynak denetimindeki dosyanın birbiriyle tutarsız hale gelmesini önler. Kaydedilmemiş değişiklikleri veya çakışması olan açık Belgeler de çalışma alanından yeniden adlandırmayı, taşımayı ve silmeyi engeller.

Silme kalıcıdır, onay gerektirir ve Unreal üzerinden geri alınamaz. Locus, izlenen dosyalarda yerel temizlemeden önce silme işlemini etkin sağlayıcı üzerinden doğrular ve yönlendirir.

Yol değişikliği yalnızca yerel veya İzlenmeyen Belgelerde kullanılabilir. Ekleme İçin İşaretle sonrasında ya da sağlayıcı denetimine girdikten sonra yeniden adlandırma ve taşıma kapatılır; Locus sağlayıcıdan bağımsız depot taşıması veya açık durumu yollar arasında aktarma işlemi yapmaz.

Dışa aktarma

Seçili Belgeyi, klasörü, tüm Belgeleri veya bir düzenleyici kopyasını dışa aktarın. Dışa aktarma; kopya dışa aktarılırken kaydedilmemiş düzenleyici arabelleği dahil geçerli kaynağı korur ve klasör yapısını koruyabilir. Hedef ProjectDocuments içinde olamaz; çakışma seçenekleri üzerine yazmayı, atlamayı veya numaralandırılmış kopyayı içerir. Dışa aktarma kaynak Belgeyi, sekmesini veya kaynak denetimi durumunu değiştirmez.

Kurtarma ve harici düzenleme

Locus, Belge kurtarma verilerini <Project>/Saved/Locus/Recovery/Documents/ altında saklar. Başarılı kaydetme ilgili kurtarma kopyasını kaldırır. Yerel düzenlemesi olmayan harici değişiklikler yeniden yüklenir; kaydedilmemiş yerel metinle çakışan harici değişiklik, güvenli bir çözüm seçene kadar kaydetmeyi engeller.

Asıl içerik .md dosyasında bulunduğundan harici düzenleyiciler desteklenir. Harici dosya işlemlerinden sonra çalışma alanı hemen güncellenmezse keşfi yenileyin. Unreal Editor yeniden başlatıldığında düzenleyici sekmeleri otomatik olarak geri yüklenmez.

Yeni bir Locus Belgesi, etkin veya en son etkin Locus Belgesi sekme grubunu tercih eder; aynı normalleştirilmiş yol mevcut sekmeye odaklanır. Sekmeler serbestçe dock edilebilir ancak Editor yeniden başlatıldığında geri yüklenmez.

Seçili Belge önizlemesi

Bir Belge seçildiğinde çalışma alanı ayrıntı panelinde salt okunur Markdown önizlemesi gösterilir. Kaydedilmiş asıl dosyayı sunar; içeriği okumak veya düzenlemek için özel Belge düzenleyicisini kullanın. Normal, kısa bir seçim geçişinde seçili içerik hazır olana kadar önizleme nötr kalır. Yalnızca yaklaşık bir saniyeden uzun beklemelerde güncel olmayan içerik yerine kısa bir yerel yükleme açıklaması gösterilir.

Belge dosya adı ve yolu çalışma alanı kimliğini sağlar. Markdown başlığı içeriktir; dolayısıyla dosyayı yeniden adlandırmak # My Title gibi bir başlığı yeniden yazmadan görünen dosya adını günceller.

Belge Düzenleyicisi Görünüm menüsündeki Kaynak Yazı Tipi Boyutu yalnızca kaynak editörünü, Okuma Yazı Tipi Boyutu ise tam Okuma ve bölünmüş Önizlemeyi etkiler. Ctrl+fare tekerleği imlecin bulunduğu görünümün boyutunu değiştirir.

Kaynak denetimi

Belgeler projeye aittir. Yeni oluşturulan Belge, açıkça Ekleme İçin İşaretle seçeneğini kullanana kadar İzlenmiyor olarak kalır; böylece yolu hâlâ değişirken düzenlenebilir. Yerel veya izlenmeyen Belgeler Yerel Modda düzenlenebilir. Ekleme İçin İşaretle başarısız olursa geçerli Markdown yerinde kalır ve işlem yeniden denenebilir.

Depoda denetlenen mevcut Belge okunabilir kalır ancak Kullanıma Al işlemi başarılı olana kadar Düzenleme Moduna geçemez veya Kaydet kullanamaz. Belge temiz ancak kullanıma alınmamışsa, başka bir kullanıcı veya istemci tarafından kullanıma alınmışsa, güncel değilse ya da sağlayıcısıyla bağlantısı kesilmişse Locus bu eylemleri kullanılamaz tutar. Yazılabilir Yap geçici çözümü sunmaz; uygun olduğunda Okuma Modu ve Kopyayı Dışa Aktar kullanılabilir kalır.

Kaynak denetimine yeniden bağlandıktan sonra yenileme, denetlenen durumu geri yükler. Belge kullanıma alma başarılı olana kadar salt okunur kalır. Locus gönderim yapmaz, eşitlemez, değişiklik listelerini yönetmez veya typemap’leri değiştirmez. Kaynak Denetimi, Proje Etkisi ve Bağımlılıklar ve Sorun Giderme sayfalarına bakın.

Yapılandırılmış sağlayıcı yokken Belgeler kaynak denetimine özgü durum, yönlendirme, ipucu veya işlem göstermez. Sağlayıcı yapılandırılmış ancak kullanılamıyorsa bilinen denetimli dosyalar korunur.