Плагин Конвертера
Конвертировать документы в 45 целевых форматов
Плагин Converter превращает Doconut в сервис конвертации документов. Он обеспечивает движок, лежащий в основе публичного фасада DocumentConverter, и — при желании — готовый к использованию виджет со своим HTTP‑контрактом, так что вы можете конвертировать документы из C#, из виджета или из собственного фронтенда.
| Тип | Когда использовать |
|---|---|
DocumentConverter (C#) | Вы конвертируете на сервере, без участия браузера |
Виджет‑вставка (doconutConverter.js) | Вам нужен готовый экран загрузки, конвертации и скачивания на вашей странице |
HTTP‑конечные точки (?convert=open|run|download) | Вы создаёте собственный UI конвертации, используя документированный серверный контракт |
Установить пакет
Установите последнюю стабильную версию плагина Converter:
dotnet add package Doconut.NET8.ConverterЧтобы зафиксировать плагин на версии, описанной в этой документации, укажите версию отдельно:
dotnet add package Doconut.NET8.Converter --version 26.10.0Держите пакет Converter той же версии, что и Doconut.NET8. Идентификатор пакета — Doconut.NET8.Converter; .<version> появляется только в имени загруженного файла .nupkg.
Файл лицензии плагина, Doconut.Viewer.Converter.lic, помещается в ту же папку, что и Doconut.Viewer.lic; он читается вместе с лицензией просмотрщика.
Платформы. Плагин работает везде, где работает Doconut.NET8: Windows и Linux на базе glibc для x64 (не Alpine и другие дистрибутивы на musl). На Linux установите библиотеку конфигурации шрифтов перед открытием первого документа:
apt-get update && apt-get install -y libfontconfig1В дистрибутивах RHEL, Fedora и подобных пакет называется fontconfig. Без него открытие документа завершается ошибкой The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.
Зарегистрировать плагин
Метода AddConverter() не существует — модель плагинов Doconut единообразна. Каждый плагин, включая Converter, регистрируется одинаково: вызовите AddPlugin<TPlugin>() внутри AddDoconut(). ConverterPlugin поставляется в собственном пакете NuGet, Doconut.NET8.Converter, установленном рядом с базовым пакетом просмотрщика.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});Это всё, что требуется фасаду C#. Виджет и его HTTP‑конечные точки — отдельный опциональный компонент, AddConverterWidget() (см. Виджет‑вставка).
Плагину нужна лицензия, предоставляющая возможность Converter. Без неё AddDoconut() генерирует InvalidOperationException при запуске, до того как приложение обслужит запрос:
The Converter plugin is registered via AddPlugin but no active license grants Converter. Remove the AddPlugin<...>() call or install a license (or trial/demo) that includes Converter.Это происходит при отсутствии лицензии, при наличии устаревшего файла TRIAL, лицензии без Converter и платной лицензии, использующейся вне её версии. Принимаются временные лицензии Demo/NFR. Бесплатного «тихого» уровня нет. См. Настройка лицензии для информации о загрузке лицензий.
Лицензирование и водяной знак
| Состояние лицензии | Запуск | Результат конвертации |
|---|---|---|
Платная лицензия просмотрщика, предоставляющая Converter, в пределах её версии | Запускается | Чистый — watermarked: false |
| Активная временная (Demo/NFR) лицензия | Запускается | Конвертирует, с оценочным водяным знаком — watermarked: true |
| Истёкшая временная (Demo/NFR) лицензия | Запускается | Конвертирует, с оценочным водяным знаком — watermarked: true |
Отсутствует лицензия, устаревший файл TRIAL, лицензия без Converter, либо платная лицензия вне её версии | AddDoconut() генерирует | — |
Оба пути вызова вычисляют флаг по одному правилу: C#‑фасад DocumentConverter получает его внутренне из состояния лицензии IsViewerLicensed и IsTemporary, а обработчик ?convert=run виджета выполняет эквивалентную проверку (IsViewerLicensed && !IsTrial && !IsTemporary), чтобы заполнить поле watermarked, которое он возвращает. Интеграцию можно построить и протестировать сквозным способом на оценочной лицензии перед покупкой — меняются только байты вывода.
Источник DICOM (.dcm, .ima) также требует возможности Dicom. Без неё ConvertAsync генерирует LicenseException (Converting '.dcm' requires the Dicom capability license.), а ответ виджета open — 403.
Использование из C#
Каждое преобразование возвращает позиционируемый в 0 seekable MemoryStream, готовый к чтению или копированию сразу. Получайте DocumentConverter из DI там, где он нужен — он без состояния по дизайну, поэтому один экземпляр безопасно переиспользовать между запросами.
// Внедрите DocumentConverter; его конструктор internal, поэтому никогда не `new` его.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);// sourceExtension включает ведущую точку. password равен null, если документ не защищён.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);Stream html = await converter.WordToHtmlAsync("report.docx", ct);// html: Stream, содержащий HTML, который нужно преобразовать обратно в документ Word, например результат WordToHtmlAsync.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);Две детали, которые легко перепутать: sourceExtension в перегрузке stream должен включать ведущую точку (".xlsx", а не "xlsx") — конвертер сопоставляет её с каталогом форматов, и простое расширение не будет найдено. И несмотря на название, WordToHtmlAsync возвращает Task<Stream>, а не Task<string> — вы получаете HTML‑документ (изображения встроены как Base64) в виде потока, так же как любой другой результат преобразования.
Вызывающий код владеет возвращённым потоком и должен освободить его после копирования или возврата содержимого. Сервис DocumentConverter сам разрешается через внедрение зависимостей; не создавайте и не освобождайте его вручную.
Целевые форматы
ConversionTarget (пространство имён Doconut.Configs.Conversion) содержит 45 членов:
Pdf, Docx, Doc, Html, Xlsx, Pptx, Png, Jpeg, Csv, Tiff, Bmp, Gif, Svg, Xml,
Txt, Xls, Jp2, Rtf, Odt, Ods, Odp, Epub, Xps, Webp, Msg, Eml, Emlx, Mhtml,
Xlsm, Xlsb, Ppt, Docm, Dot, Dotx, Dotm, Vsdx, Vssx, Vstx, Vsdm, Vssm, Vstm,
Vdx, Vsx, Vtx, IcoНе каждый источник преобразуется в каждый целевой формат — плагин сопоставляет семейство форматов источника (Word, Excel, PowerPoint, PDF, CAD, Image, Email, Diagram, Project/Task, PSD, web document, DICOM) со своим фиксированным набором разрешённых целей. Преобразование DICOM‑источника (.dcm, .ima) также требует лицензии, предоставляющей возможность Dicom; его целевые форматы: Pdf, Png, Jpeg, Bmp, Tiff и Gif. Не хардкодьте этот enum в список целей вашего UI: ?convert=open возвращает фактический allowedTargets для только что загруженного файла, и именно он должен определять содержимое выбора.
Встраиваемый виджет
Включить конечные точки
Конечные точки виджета ?convert=open|run|download являются опциональными и по умолчанию отключены — безопасно из коробки. Включите их на стороне сервера вместе с регистрацией плагина:
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddConverterWidget(widget =>
{
widget.MaxUploadMb = 25;
});
});AddConverterWidget() без аргументов включает виджет с настройками по умолчанию (MaxUploadMb = 25). Это не предоставляет права на конвертацию само по себе: требуется AddPlugin<ConverterPlugin>(), иначе AddDoconut() бросает исключение:
AddConverterWidget() was called but the Converter plugin is not registered. Add options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() (the widget needs it), or remove the AddConverterWidget() call.Без AddConverterWidget() три конечные точки ?convert= отвечают 404 — но сам JS‑файл всё равно отдается (это обычный встроенный статический ресурс; только конечные точки, к которым он обращается, защищены).
Встроить его
<div id="doconut-convert"></div>
<script src="/doconut-res/js/doconutConverter.js"></script>
<script>
Doconut.convert('#doconut-convert', { basePath: '/doconut', resPath: '/doconut-res', maxUploadMb: 25 });
</script>Doconut.convert(selectorOrElement, options) принимает CSS‑селектор или элемент, бросает исключение, если монтирование не найдено, и возвращает дескриптор. Виджет загружает файл, показывает превью первой страницы, позволяет пользователю выбрать один из allowedTargets, конвертирует, при возможности показывает превью результата и предлагает загрузку.
Параметры
| Параметр | Тип | По умолчанию | Примечания |
|---|---|---|---|
basePath | string | /doconut | Базовый путь для конечных точек ?convert=; он должен соответствовать ветке ASP.NET, где UseDoconut() фактически смонтирован (обычно координируется через MiddlewarePath) |
resPath | string | /doconut-res | Принимается для согласованности конфигурации с другими виджетами Doconut; виджет‑конвертер в настоящее время не формирует из него URL |
maxUploadMb | number | 25 | Только клиентская предварительная проверка — отклоняет файл, превышающий размер, до загрузки. Сервер независимо применяет собственный лимит и отвечает 413, если он превышен |
licenseUrl | string | null | null | Если установлено, превращает уведомление о водяном знаке на экране результата в ссылку на этот URL |
labels | object | {} | Переопределяет любую часть английских строк по умолчанию виджета (текст при перетаскивании, кнопки, объявления aria-live, сообщения об ошибках) |
Обратные вызовы
| Обратный вызов | Срабатывает когда | Данные |
|---|---|---|
onReady() | Виджет отобразил экран ожидания/перетаскивания | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | Успешно завершается ?convert=open | токен сеанса источника, количество страниц, расширение источника (без точки), список разрешённых целей |
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target }) | Успешно завершается ?convert=run | те же поля, что и в ответе выполнения, плюс запрошенный target |
onDownload({ downloadName, downloadToken }) | Пользователь нажимает ссылку Download | срабатывает вместе с нативным скачиванием браузера — не перехватывает и не заменяет его |
onError({ phase, message }) | Запрос open или run завершается ошибкой | phase является 'open' или 'run'; message — это очищенная ошибка сервера (или сообщение клиентской стороны для предварительной проверки размера загрузки) |
Обратный вызов, который генерирует исключение, перехватывается и записывается в журнал; он никогда не нарушает работу виджета.
Императивный дескриптор
Doconut.convert() возвращает сам экземпляр виджета — сохраняйте его, чтобы управлять виджетом программно:
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // Файл из вашего собственного <input type="file" id="picker">
conv.reset(); // возврат к экрану простоя/отбрасывания; не вызывает onReady повторно
conv.loadFile(file); // запускает поток с объектом File; без действия, если сейчас не в простое
conv.destroy(); // удаляет слушатели, очищает mount; после этого экземпляр непригоден для использованияМетки
Каждая строка имеет английский вариант по умолчанию; labels переопределяет любую часть, а остальные остаются английскими. Фрагменты, меняющиеся во время выполнения, используют {placeholders}, такие как uploading: 'Uploading {name}…' и pages: '{n} pages'.
| Ключ | Английский вариант по умолчанию |
|---|---|
dropPrompt | Drag & drop a document here |
dropHint | PDF, Word, Excel, PowerPoint, images and more |
chooseFile | Choose file |
uploading | Uploading {name}… |
page / pages | 1 page / {n} pages |
noTargets | No conversion targets are available for this file. |
convertTo / convert | Convert to / Convert |
converting | Converting to {target}… |
readyToDownload | Ready to download |
download / convertAnother | Download / Convert another |
watermarkNotice | Output is watermarked — get a license to remove it. |
retry | Retry |
genericError | Something went wrong. Please try again. |
sizeLimit | That file is larger than the {mb} MB upload limit. Please choose a smaller file. |
serverError | The server could not process this request. Please try again. |
networkError | Could not reach the server. Please check your connection and try again. |
Дополнительные ключи охватывают aria-label зоны перетаскивания (dropAriaLabel), тексты предварительного просмотра alt (previewAlt, resultAlt), связанную форму уведомления о водяном знаке, используемую с licenseUrl (watermarkNoticePrefix, watermarkNoticeLink, watermarkNoticeSuffix), нечитаемый ответ (badResponse) и объявления aria-live (annReady, annUploading, annLoaded, annLoadedNoTargets, annConverting, annDone, annError).
Ошибка JSON от сервера отображается так, как её выдал сервер; serverError используется только когда неудачный ответ не содержит JSON‑ошибку, например 404 отключённого виджета.
Темизация
Виджет добавляет класс dcw к своему элементу монтирования и считывает его цвета, радиус и шрифт из пользовательских CSS‑свойств, так что вы можете оформить его без изменения внутренностей:
#doconut-convert.dcw {
--dcw-accent: #6b46c1;
--dcw-radius: 12px;
--dcw-font: "Inter", system-ui, sans-serif;
}Значения по умолчанию: --dcw-accent: #2b6cb0, --dcw-bg: #ffffff, --dcw-fg: #1a202c, --dcw-muted: #718096, --dcw-border: #cbd5e0, --dcw-radius: 8px и системный UI‑шрифт для --dcw-font.
Создайте собственный фронтенд
Виджет — это просто клиент для этого HTTP‑контракта — создайте собственный фронтенд, работающий напрямую с ним, для другого пользовательского опыта. Все три маршрута находятся под веткой ASP.NET, где монтируется UseDoconut() (обычно /doconut), и они отвечают 404, пока не будет вызвано AddConverterWidget(). Ошибки содержат тело JSON, { "error": "..." }, за исключением случаев, когда в таблице указано «только статус». Неизвестное значение ?convert= отвечает 400.
| Маршрут | Назначение | Ответ при успехе |
|---|---|---|
POST ?convert=open (multipart, один файл) | Загрузить и открыть исходный документ для предварительного просмотра | 200 — { token, pages, sourceExt, allowedTargets } |
POST ?token=<token>&convert=run&target=<ext> | Преобразовать сохранённый источник в target | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET ?convert=download&token=<downloadToken> | Передать потоком преобразованный файл | 200 — байты файла, Content-Disposition: attachment, Cache-Control: no-store |
sourceExt в ответе open не имеет ведущей точки (например, "docx") — противоположная конвенция параметру sourceExtension в DocumentConverter.ConvertAsync, который требует её. allowedTargets перечисляет имена целей в нижнем регистре ("pdf", "html", …); передайте одно из них как target, сравнение происходит без учёта регистра. open использует первый файл в multipart‑теле.
resultToken — это null, а resultPages — это 0, когда результат нельзя предварительно просмотреть. downloadName — это имя исходного файла с расширением целевого формата.
Изображения предварительного просмотра используют стандартный маршрут изображения просмотрщика, {basePath}?token={token}&page=1&thumb=1&width={px}, с token из open или resultToken из run. Виджет запрашивает width=240.
Загруженные байты исходного файла сохраняются на сервере и хранятся в течение 30 минут после последнего чтения; после истечения этого окна run отвечает 404, и файл необходимо открыть заново. Преобразованный результат находится в том же хранилище — downloadToken получает собственное новое 30‑минутное окно после завершения конвертации — тогда как resultToken является обычным токеном сеанса просмотрщика для предварительного просмотра результата. Когда результат можно предварительно просмотреть, downloadToken и resultToken имеют одинаковое значение. Закрытие результата просмотрщика не удаляет всё ещё действительное хранилище загрузки, и сброс виджета в браузере не продлевает ни одно из окон.
Сценарии отказов, сгруппированные по маршруту:
| Маршрут | Статус | Когда | Тело |
|---|---|---|---|
| любой | 404 | Виджет не включён (AddConverterWidget() никогда не вызывался) — проверяется до обработки любого из трёх маршрутов | только статус |
| любой | 405 | Неправильный HTTP‑метод (open/run требуют POST; download требует GET) | только статус |
open | 400 | Не multipart‑загрузка | Expected a multipart file upload. |
open | 400 | Отсутствует файл или файл пустой | No file uploaded. |
open | 400 | Расширение исходного файла, которое нельзя преобразовать | This file type cannot be converted. |
open | 403 | Тип файла требует возможности, которой лицензия не предоставляет (файл DICOM без Dicom) | Converting this file type requires the Dicom capability license. |
open | 413 | Загруженный файл превышает MaxUploadMb, проверяется против Content-Length и во время чтения загрузки | File is too large. |
run | 400 | Некорректный токен (не GUID) | Invalid token. |
run | 400 | target, который не преобразуется в ConversionTarget | Unknown target format. |
run | 400 | target отсутствует в allowedTargets исходного файла | That target format is not available for this file. |
run | 404 | Сохранённая загрузка истекла или токен никогда не открывался | Upload expired — please re-open the file. |
open, run | 500 | Внутренняя ошибка обработки | Очистленное сообщение — очищено так же, как и все остальные пути ошибок Doconut; никогда не раскрывает внутренние детали |
download | 400 | Некорректный токен (не GUID) | только статус |
download | 404 | Неизвестный или просроченный токен загрузки | только статус |
Полный цикл с fetch:
// file: the File to convert, for example from an <input type="file">.
async function convertFile(file) {
const base = '/doconut';
// 1. open: загрузить файл
const form = new FormData();
form.append('file', file, file.name);
const openResp = await fetch(base + '?convert=open', { method: 'POST', body: form });
if (!openResp.ok) throw new Error((await openResp.json()).error);
const opened = await openResp.json();
// 2. run: конвертировать в PDF, когда это разрешено, иначе в первый доступный целевой формат
const target = opened.allowedTargets.includes('pdf') ? 'pdf' : opened.allowedTargets[0];
const runResp = await fetch(base + '?token=' + encodeURIComponent(opened.token) +
'&convert=run&target=' + target, { method: 'POST' });
if (!runResp.ok) throw new Error((await runResp.json()).error);
const converted = await runResp.json();
// 3. download: простой GET, который может выполнить браузер
window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}Конечные точки являются same-origin: эта версия не поддерживает CORS. Размещайте ваш UI и скрипт виджета с того же источника, что и Doconut, либо используйте reverse‑proxy для обоих путей /doconut (путь промежуточного ПО и путь ресурсов) под вашим UI‑источником.
В продакшн
- Установите плагин рядом с основным пакетом, той же версии:
dotnet add package Doconut.NET8.Converter. - Добавьте файл лицензии. Поместите
Doconut.Viewer.Converter.licв ту же папку, что иDoconut.Viewer.lic. - Установите ограничение сервера.
MaxUploadMbвAddConverterWidget— это лимит, который применяет сервер;maxUploadMbвиджета — лишь проверка на клиенте. Держите их равными. - Обслуживайте UI с того же источника, что и эндпоинты Doconut, либо используйте reverse-proxy (см. Создайте собственный интерфейс).
- Освобождайте результаты конвертации. Поток, который возвращает
ConvertAsync, берётся из пула; его освобождение возвращает буферы в пул.
Веб-фермы
Виджет хранит каждую загрузку и её результат в памяти узла, который обслужил open. За балансировщиком нагрузки без sticky‑сессий последующий запрос run, download или запрос превью может попасть на другой узел и не найти загрузку. Зарегистрируйте общий зашифрованный магазин виджета один раз, после AddDoconut():
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);
builder.Services.AddDoconutDistributedWidgets(store =>
{
store.RootPath = @"\\fileshare\doconut"; // папка, которую каждый узел может читать и записывать
store.FarmKey = farmKey; // не менее 32 байт, одинаково на каждом узле
// store.Ttl = TimeSpan.FromMinutes(30); // как долго хранится загрузка (по умолчанию)
});- Один сервер ничего не требует: без этого вызова используется хранилище в памяти.
- Загрузки и результаты шифруются в состоянии покоя на общем ресурсе (AES-256, encrypt‑then‑MAC), и каждый файл привязан к своему токену, поэтому один токен никогда не может прочитать файл другого.
- На общем ресурсе загрузка или результат хранятся в течение
Ttlпосле записи; чтение не продлевает этот период. FarmKeyдолжен быть не менее 32 байт и одинаковым на всех узлах. Загружайте его из секретного хранилища; никогда не хардкодьте. Регистрация бросаетArgumentException, когдаRootPathотсутствует илиFarmKeyкороче 32 байт.- Укажите
RootPathна то же общее расположение, которое использует распределённый просмотрщик.
Справочник API
Фасад и параметры виджета находятся в пространстве имён Doconut; ConversionTarget находится в Doconut.Configs.Conversion. ConverterPlugin находится в Doconut.Plugins.Converter.
DocumentConverter
public sealed class DocumentConverter
{
public Task<Stream> ConvertAsync(
string filePath, ConversionTarget target,
string? password = null, CancellationToken ct = default);
public Task<Stream> ConvertAsync(
Stream source, string sourceExtension, ConversionTarget target,
string? password = null, CancellationToken ct = default);
public Task<Stream> WordToHtmlAsync(string filePath, CancellationToken ct = default);
public Task<Stream> HtmlToWordAsync(
Stream htmlSource, ConversionTarget outputFormat = ConversionTarget.Docx,
CancellationToken ct = default);
}Получается через внедрение зависимостей; конструктор внутренний. sourceExtension включает ведущую точку. HtmlToWordAsync записывает файл .doc, когда outputFormat равно ConversionTarget.Doc, и файл .docx для любого другого значения.
ConversionTarget
45 форматов вывода, перечисленных в Форматы целей.
ConverterWidgetOptions
public sealed class ConverterWidgetOptions
{
public int MaxUploadMb { get; set; } = 25;
}Устанавливается через DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null), который возвращает DoconutOptions, чтобы вызовы можно было цепочкой.
Устранение неполадок
| Симптом | Причина | Решение |
|---|---|---|
AddDoconut() бросает The Converter plugin is registered via AddPlugin but no active license grants Converter. | Нет лицензии, файл TRIAL, лицензия без Converter, или платная лицензия вне её версии | Установите лицензию, предоставляющую Converter, или удалите AddPlugin<ConverterPlugin>() |
AddDoconut() бросает AddConverterWidget() was called but the Converter plugin is not registered. | Виджет включён без своего плагина | Добавьте options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() |
Разрешение DocumentConverter бросает No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>(). | ConverterPlugin не зарегистрирован | Добавьте AddPlugin<ConverterPlugin>() внутри AddDoconut() |
| Конвертация потока сообщает, что формат не поддерживается | У sourceExtension нет ведущей точки | Передайте ".xlsx", а не "xlsx" |
ConvertAsync бросает Converting '.dcm' requires the Dicom capability license. | Источник DICOM, и лицензия не предоставляет Dicom | Используйте лицензию, предоставляющую Dicom |
| Вывод имеет водяной знак | Лицензия временная (Demo/NFR) | Используйте платную лицензию, предоставляющую Converter |
Виджет загружается, но его запросы отвечают 404 | AddConverterWidget() не был вызван, или basePath не совпадает с веткой, где смонтирован UseDoconut() | Вызовите AddConverterWidget(); исправьте basePath |
open отвечает 403 Converting this file type requires the Dicom capability license. | Загрузка DICOM, и лицензия не предоставляет Dicom | Используйте лицензию, предоставляющую Dicom |
open отвечает 413 File is too large. | Загрузка превышает MaxUploadMb | Поднимите MaxUploadMb в AddConverterWidget; maxUploadMb виджета — лишь проверка на клиенте |
run отвечает 400 That target format is not available for this file. | Цель не является одним из allowedTargets источника | Предлагайте только allowedTargets из open |
run или download отвечают 404 (Upload expired — please re-open the file. из run) | Прошло 30‑минутное окно, или узел веб‑фермы не имеет загрузки | Откройте файл снова; в ферме зарегистрируйте AddDoconutDistributedWidgets |
| Виджет падает, когда UI находится на другом источнике | У эндпоинтов нет поддержки CORS | Обслуживайте UI с того же источника, либо используйте reverse‑proxy для путей Doconut |
| Тема не применяется | Переменные заданы у предка или у элемента внутри монтировки; собственное правило .dcw виджета задаёт их на монтировке | Нацелитесь непосредственно на монтировку: #doconut-convert.dcw или #doconut-convert |
Была ли эта страница полезной?