نصب

نمایشگر پایه Doconut برای .NET 8 به‌صورت یک بسته NuGet ارائه می‌شود که می‌تواند در هر برنامه ASP.NET Core وارد شود. افزونه‌های اختیاری از بسته‌های جداگانه استفاده می‌کنند. این صفحه بسته پایه را نصب کرده و میدلور را ثبت می‌کند — حداقل موارد مورد نیاز قبل از اولین رندر شما.

نصب بسته

dotnet add package Doconut.NET8

دستور بدون نسخه، آخرین نسخه پایدار را نصب می‌کند. برای بازتولید دقیق نسخهٔ فعلی ۲۶.۷.۰، نسخه را به‌عنوان گزینه‌ای جداگانه پاس دهید:

dotnet add package Doconut.NET8 --version 26.7.0

Doconut.NET8 شناسهٔ بسته است. پسوند .26.7.0 به نام فایل دانلود شدهٔ Doconut.NET8.26.7.0.nupkg تعلق دارد و بخشی از شناسه نیست.

ثبت Doconut

AddDoconut() تنها نقطهٔ ورودی ثبت است — یک overload واحد دارد و سرویس Viewer، سرویس لایسنس و زیرساخت رندرینگ را به کانتینر DI متصل می‌کند.

دو فراخوانی میدلور تنظیمات را کامل می‌کنند و ترتیب آن‌ها مهم است: UseDoconutResources() باید قبل از UseDoconut() اجرا شود. UseDoconut() یک میدلور انتهایی است، بنابراین فراخوانی آن ابتدا باعث می‌شود هر درخواست به منبع /doconut-res هرگز به هندلر منابع نرسد و خطای ۴۰۴ دریافت شود. اتصال سشن نیز ضروری است — امنیت پیش‌فرض سند Doconut هر درخواست صفحه را نسبت به وضعیت سشن ASP.NET اعتبارسنجی می‌کند.

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddSession(); // Doconut document security rides on ASP.NET session state

app.UseSession();          // call UseSession() before UseDoconut()
app.UseDoconutResources(); // must be registered before UseDoconut()
app.UseDoconut();

تمام گزینه‌ها

DoconutOptions ویژگی‌های قابل تنظیم زیر را می‌پذیرد. هر یک اختیاری هستند — مقادیر پیش‌فرض زیر زمانی اعمال می‌شوند که ویژگی‌ای تنظیم نشده باشد.

اولویت لایسنس هنگام تنظیم بیش از یک منبع: LicenseStream بر LicenseContent، LicenseContent بر LicensePath، و LicensePath بر جستجوی خودکار ارجحیت دارد — به راه‌اندازی لایسنس مراجعه کنید.

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // coordinate with app mapping and client BasePath
    options.ResourcesPath   = "/doconut-res"; // where the viewer's JS/CSS/images are served from
    options.UnsafeMode      = false;          // keep session security on
    options.ShowDoconutInfo = false;
});

گام‌های بعدی

• شروع سریع — سند اول خود را باز کنید و در مرورگر رندر کنید.
• راه‌اندازی لایسنس — جایی که Doconut به دنبال فایل لایسنس شما می‌گردد.