Kurulum
Doconut'u .NET 6 projenize ekleyin
.NET 6 için temel Doconut görüntüleyicisi, herhangi bir ASP.NET Core uygulamasına bağlanan tek bir NuGet paketi olarak gelir. İsteğe bağlı eklentiler ayrı paketler kullanır. Bu sayfa temel paketi kurar ve ara katmanı (middleware) kaydeder — ilk render'ınızdan önce gereken minimum şey.
Gereksinimler
Paket aşağıdaki platformlarda çalışır:
| Platform | Destekleniyor |
|---|---|
| Windows x64 / x86 | Evet |
Linux x64, glibc tabanlı (Debian, Ubuntu, resmi mcr.microsoft.com/dotnet/aspnet:6.0-bookworm-slim görüntüsü) | Evet |
| Alpine ve diğer musl tabanlı dağıtımlar | Hayır |
| macOS | Hayır |
Linux'ta, ilk belge açılmadan önce font yapılandırma kütüphanesini kurun:
apt-get update && apt-get install -y libfontconfig1RHEL, Fedora ve benzeri dağıtımlarda paket fontconfig (dnf install -y fontconfig) şeklindedir. Bu, Doconut'un ihtiyaç duyduğu tek sistem paketidir: kullandığı yerel kütüphaneler NuGet paketinin içinde gelir ve libgdiplus gerekli değildir. Docker'da, aspnet:6.0-bookworm-slim (Debian 12) tercih edin: varsayılan aspnet:6.0 etiketi Debian 11'dir ve paket aynaları libfontconfig1 kurulumunda başarısız olabilir. Sayfalar sunucuda kurulu fontlarla çizilir, bu yüzden fontlar ve Linux hata mesajları için Sorun Giderme bölümüne bakın.
Paketi Kurun
dotnet add package Doconut.NET6Versiyonsuz komut en son kararlı sürümü kurar. Bu belgede açıklanan sürümü sabitlemek için, sürümü ayrı bir seçenek olarak geçin:
dotnet add package Doconut.NET6 --version 26.10.0Doconut.NET6 paket kimliğidir. Sürüm soneki, indirilen Doconut.NET6.<version>.nupkg dosya adının bir parçasıdır ve kimliğin bir bölümü değildir.
Yükseltmeden Önce Entegrasyonu Belirleyin
Doconut.NET6 paket kimliği, klasik ve mevcut .NET 6 entegrasyonları tarafından kullanılmıştır. Belgeleri yalnızca paket adından seçmeyin:
DocImage.axd,new Viewer(_cache, _accessor, ...), eşzamanlıOpenDocument(...)ve manuel olarak kopyalanmış görüntüleyici betikleri, klasik entegrasyonu tanımlar;AddDoconut(),UseDoconutResources(), bir enjekte edilmişViewerveOpenDocumentAsync(...), burada belgelenen mevcut entegrasyonu tanımlar.
Çevrilmiş klasik kurulum kılavuzu hâlâ mevcuttur. Nesilleri değiştirmek için göç rehberini kullanın; normal bir paket güncellemesi başlangıcı, görüntüleyici ömrünü veya tarayıcı kaynaklarını otomatik olarak dönüştürmez.
Doconut'u Kaydedin
AddDoconut() tek kayıt giriş noktasıdır — tek bir aşırı yükleme vardır ve Viewer servisini, lisans servisini ve render altyapısını DI konteynerine bağlar.
Kurulumu tamamlamak için iki ara katman (middleware) çağrısı vardır ve sıraları önemlidir: UseDoconutResources(), UseDoconut()'den önce çalışmalıdır. UseDoconut() terminal bir ara katmandır, bu yüzden onu önce çağırmak, bir /doconut-res varlığına yapılan her isteğin kaynak işleyicisine ulaşamamasına ve 404 hatası almasına neden olur. UseDoconut() ona ulaşan her isteğe yanıt verir, bu yüzden kendi dalında app.Map ile monte edin. Oturum bağlaması da gereklidir — Doconut'un varsayılan belge güvenliği, her sayfa isteğini ASP.NET oturum durumuna göre doğrular.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // session state bir önbellek gerektirir (MVC/Razor Pages zaten bir tane ekler)
builder.Services.AddSession(); // Doconut belge güvenliği ASP.NET session state üzerine kuruludur
app.UseSession(); // UseDoconut()'dan önce UseSession() çağırın
app.UseDoconutResources(); // UseDoconut()'dan önce kaydedilmelidir
app.Map("/doconut", branch => branch.UseDoconut());Tüm Seçenekler
DoconutOptions aşağıdaki ayarlanabilir özellikleri kabul eder. Hepsi isteğe bağlıdır — bir özellik ayarlanmamışsa aşağıdaki varsayılanlar uygulanır.
| Özellik | Varsayılan | Açıklama |
|---|---|---|
ShowDoconutInfo | false | true olduğunda, token içermeyen bir istek 404 yerine bir sürüm banner'ı döndürür. Bir test kontrolü olarak faydalıdır; üretimde kapalı bırakın. |
UnsafeMode | false | true olduğunda, sayfa isteklerinde ASP.NET-oturum güvenlik kontrolünü atlar. Üretimde kapalı bırakın. |
MiddlewarePath | "/doconut" | Sayfa-görsel uç noktası için koordinasyon değeri. Doğrulanır, ancak tek başına bir dal oluşturmaz; gerçek UseDoconut() eşlemesi ve istemci BasePath ile uyumlu tutun. |
ResourcesPath | "/doconut-res" | Gömülü JS/CSS/görsel kaynakların nereden sunulduğu. |
LicensePath | "" (empty string) | Lisans dosyasının yolu. Boş ise bir sonraki kaynağa geçilir, ardından otomatik arama yapılır. |
LicenseContent | "" (empty string) | Ham lisans içeriği — bir ortam değişkeni, gizli yönetici veya veritabanından. |
LicenseStream | null | Lisans bir akış olarak, başlangıçta bir kez okunur. |
ResetLicense | false | Ayrılmış uyumluluk bayrağı. Mevcut .NET 6 servisleri lisansı AddDoconut() sırasında okur; bir lisans değiştirildikten sonra uygulamayı yeniden başlatın. |
MaxConcurrentEditorSessions | 200 | Canlı editör oturumlarının (DocOptions.EditMode ile açılan belgeler) maksimum sayısı. Bu sayı aşılırsa, en az kullanılan boşta kalan editör oturumu kapatılır. Normal görüntüleyici oturumları sayılmaz. 0 veya negatif bir değer sınırlama olmadığı anlamına gelir. |
EditorSnapshotEveryOps | 50 | Editör kalıcılığı etkinleştirildiğinde (AddDoconutEditorPersistence), canlı belgeyi her N kaydedilen değişiklikte bir anlık görüntü alır. 0 veya negatif bir değer oturum ortasında anlık görüntü almaz. Kalıcılık devre dışı bırakıldığında etkisi yoktur. |
Birden fazla kaynak ayarlandığında lisans önceliği: LicenseStream, LicenseContent, LicensePath ve otomatik arama sırasıyla önceliklidir — Lisans Kurulumu bölümüne bakın.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.MiddlewarePath = "/doconut"; // app haritalaması ve istemci BasePath'i ile koordine edin
options.ResourcesPath = "/doconut-res"; // görüntüleyicinin JS/CSS/görsellerinin nereden sunulduğu
options.UnsafeMode = false; // session güvenliğini açık tutun
options.ShowDoconutInfo = false;
});Sonraki Adımlar
- Hızlı Başlangıç — ilk belgenizi açın ve tarayıcıda render edin.
- Lisans Kurulumu — Doconut'un lisans dosyanızı nerede aradığını gösterir.
Bu sayfa yardımcı oldu mu?