نصب

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

نصب پکیج

dotnet add package Doconut.NET6

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

dotnet add package Doconut.NET6 --version 26.7.0

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

شناسایی یکپارچه‌سازی قبل از به‌روزرسانی

شناسهٔ پکیج Doconut.NET6 هم در یکپارچه‌سازی کلاسیک و هم در یکپارچه‌سازی فعلی .NET 6 استفاده شده است. از نام پکیج به‌تنهایی برای انتخاب مستندات استفاده نکنید:

• DocImage.axd، new Viewer(_cache, _accessor, ...)، OpenDocument(...) به‌صورت همزمان، و اسکریپت‌های ویور که به‌صورت دستی کپی شده‌اند، یکپارچه‌سازی کلاسیک را شناسایی می‌کنند؛
• AddDoconut()، UseDoconutResources()، یک Viewer تزریق‌شده، و OpenDocumentAsync(...) یکپارچه‌سازی فعلی مستند شده در اینجا را شناسایی می‌کنند.

راهنمای تنظیم کلاسیک ترجمه‌شده یکپارچه‌سازی کلاسیک در دسترس باقی می‌ماند. از راهنمای مهاجرت برای تغییر نسل‌ها استفاده کنید؛ به‌روزرسانی معمولی پکیج به‌صورت خودکار استارتاپ، طول عمر ویور یا منابع مرورگر را تبدیل نمی‌کند.

ثبت 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 به دنبال فایل لایسنس شما می‌گردد.