Плагин Конвертера
Конвертировать документы в 45 целевых форматов
Плагин Конвертер превращает Doconut в сервис конвертации документов. Он обеспечивает движок, стоящий за публичным фасадом DocumentConverter, и — при желании — готовый к использованию виджет со своим HTTP‑контрактом, так что вы можете конвертировать документы из C#, из виджета или из собственного фронтенда.
| Компонент | Когда использовать |
|---|---|
DocumentConverter (C#) | Вы конвертируете на сервере, без участия браузера |
Встроенный виджет (doconutConverter.js) | Вам нужен готовый экран загрузки, конвертации и скачивания на странице |
HTTP‑конечные точки (?convert=open|run|download) | Вы создаёте собственный UI конвертации, используя документированный серверный контракт |
Установить пакет
Установите последнюю стабильную версию плагина Конвертер:
dotnet add package Doconut.NET6.ConverterЧтобы зафиксировать плагин на версии, описанной в этой документации, укажите версию отдельно:
dotnet add package Doconut.NET6.Converter --version 26.10.0Сохраняйте пакет Конвертер на той же версии, что и Doconut.NET6. Идентификатор пакета — Doconut.NET6.Converter; .<version> появляется только в имени скачанного файла .nupkg.
Файл лицензии плагина, Doconut.Viewer.Converter.lic, помещается в ту же папку, что и Doconut.Viewer.lic; он читается вместе с лицензией просмотрщика.
Платформы. Плагин работает везде, где работает Doconut.NET6: 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 единообразна. Каждый плагин, включая Конвертер, регистрируется одинаково: вызовите AddPlugin<TPlugin>() внутри AddDoconut(). ConverterPlugin поставляется в собственном пакете NuGet, Doconut.NET6.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 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 в перегрузке потока должен включать ведущую точку (".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 в списке целей вашего интерфейса: ?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 }) | Пользователь нажимает ссылку Скачать | срабатывает одновременно с нативным скачиванием браузера — не перехватывает и не заменяет его |
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, one file) | Загрузить и открыть исходный документ для предварительного просмотра | 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 — file bytes, Content-Disposition: attachment, Cache-Control: no-store |
В ответе open значение sourceExt не имеет ведущей точки (например, "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 имеют одинаковое значение. Закрытие результата просмотрщика не удаляет всё ещё действующее хранилище загрузки, и сброс виджета в браузере не продлевает ни одно из окон.
Сценарии отказов, сгруппированные по маршруту:
| Маршрут | Статус | Когда | Тело |
|---|---|---|---|
| any | 404 | Виджет не включён (AddConverterWidget() никогда не вызывался) — проверяется до обработки любого из трёх маршрутов | только статус |
| any | 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: Файл для конвертации, например из <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);
}Конечные точки находятся в одном источнике: эта версия не поддерживает CORS. Размещайте ваш UI и скрипт виджета из того же источника, что и Doconut, либо используйте reverse‑proxy для обоих путей /doconut (путь посредника и путь ресурсов) под вашим UI‑источником.
В продакшн
- Установите плагин рядом с основным пакетом, той же версии:
dotnet add package Doconut.NET6.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 |
Была ли эта страница полезной?