ПоддержкаSupportПідтримка
Вопросы, ошибки и идеи приветствуются. Есть два пути: публичное обращение на GitHub или личное письмо автору.
Questions, bugs and ideas are welcome. There are two routes: a public issue on GitHub, or a private mail to the author.
Питання, помилки та ідеї вітаються. Є два шляхи: публічне звернення на GitHub або особистий лист авторові.
Куда обратитьсяWhere to askКуди звернутися
- Обращения на GitHub - для вопросов, ошибок и идей. Публичное обращение помогает следующему человеку с той же проблемой.
- sza@ukr.net - единственный адрес автора: для всего личного, включая вопрос безопасности, и для архива диагностики (см. ниже).
- GitHub issues - for questions, bugs and ideas. A public issue helps the next person who meets the same problem.
- sza@ukr.net - the author's one contact address: for anything private, including a security problem, and for a diagnostics archive (see below).
- Звернення на GitHub - для питань, помилок та ідей. Публічне звернення допомагає наступній людині з тією самою проблемою.
- sza@ukr.net - єдина адреса автора: для всього особистого, зокрема питання безпеки, і для архіву діагностики (див. нижче).
Что указать в сообщенииWhat to include in a reportЩо вказати в повідомленні
- Что вы делали по шагам и что ожидали увидеть.
- Что произошло вместо этого, с точным текстом сообщения об ошибке.
- Какой вариант вы используете - Настольное приложение, Приложение из Microsoft Store или Расширение для браузера - и его версию.
- Версию Windows либо браузер и его версию, если это расширение.
- Формат документа (EPUB, PDF, ..) и, если это важно, его размер и то, скан ли это. Документ, который вы не стали бы публиковать, не прикладывайте - опишите его.
- Для неудачной конвертации - архив диагностики (следующий раздел): он надёжнее любого описания по памяти.
- What you did, step by step, and what you expected to happen.
- What happened instead, with the exact text of any error message.
- The edition you use - Desktop app, Microsoft Store app or Browser extension - and its version.
- Your Windows version, or the browser and its version for the extension.
- The format of the document (EPUB, PDF, ..) and, if it matters, its size and whether it is a scan. Do not attach a document you would not publish - describe it instead.
- For a failed conversion, the diagnostics archive (next section): it is more reliable than any description from memory.
- Що ви робили по кроках і що очікували побачити.
- Що сталося натомість, з точним текстом повідомлення про помилку.
- Який варіант ви використовуєте - Настільний застосунок, Застосунок із Microsoft Store або Розширення для браузера - і його версію.
- Версію Windows або браузер і його версію, якщо це розширення.
- Формат документа (EPUB, PDF, ..) і, якщо це важливо, його розмір та чи це скан. Документ, який ви б не стали публікувати, не додавайте - опишіть його.
- Для невдалої конвертації - архів діагностики (наступний розділ): він надійніший за будь-який опис з пам'яті.
Диагностика, которую можно отправитьDiagnostics you can sendДіагностика, яку можна надіслати
Неудачную конвертацию трудно воспроизвести по описанию. Приложение хранит журналы последних запусков на вашем диске и упаковывает их только по вашей просьбе. Автоматически ничего не отправляется.
- Настольное приложение и Приложение из Microsoft Store. Откройте страницу О программе приложения doc-html-ui, группу Поддержка и диагностика, и нажмите Отправить журналы автору. Одно нажатие собирает один архив, открывает его папку с выделенным файлом, копирует путь к нему в буфер обмена и открывает готовое письмо в вашей почтовой программе. Архив вы прикладываете и отправляете сами.
- Командная строка. Флаг
-reportсобирает тот же архив и печатает, куда он лёг. - Расширение для браузера. В блоке «О расширении» на странице настроек есть кнопка Скопировать диагностику. Она копирует в буфер обмена короткую сводку на английском - версия расширения, браузер, язык интерфейса, ваш набор настроек, а также формат, число страниц и последнюю ошибку последнего документа. Ни текста документов, ни списка ваших сайтов там нет.
Архив пишется в %LOCALAPPDATA%\doc-html-translate\reports\ и содержит ровно три вещи: environment.txt, settings.json и недавние журналы запусков. Значения, похожие на ключ, токен или пароль, заменяются на <redacted>, а ваши папки сворачиваются до %USERPROFILE% и %LOCALAPPDATA%. Имена файлов документов сохраняются намеренно - по журналу, который не с чем сопоставить, обычно ничего не сделать. Откройте архив и загляните внутрь, прежде чем отправлять, и отправляйте его письмом, а не выкладывайте в публичное обращение.
A conversion that went wrong is hard to reproduce from a description. The app keeps its recent run logs on your disk and packs them only when you ask. Nothing is sent automatically.
- Desktop app and Microsoft Store app. Open the About page of the doc-html-ui app, its Support and diagnostics group, and press Send logs to the author. One press builds one archive, opens its folder with the file selected, copies its path to the clipboard and opens a pre-addressed message in your own mail program. You attach the archive and press Send yourself.
- Command line. The
-reportflag builds the same archive and prints where it landed. - Browser extension. The About block of its options page has a Copy diagnostics button. It copies a short English summary - extension version, browser, interface language, your option set, and the format, page count and last error of the most recent document - to the clipboard. It carries no document text and no list of your sites.
The archive is written to %LOCALAPPDATA%\doc-html-translate\reports\ and contains exactly three things: environment.txt, settings.json and the recent run logs. Anything shaped like a key, token or password becomes <redacted>, and your own folders are shortened to %USERPROFILE% and %LOCALAPPDATA%. Document file names are kept on purpose - a log that cannot be matched to a document usually cannot be acted on. Open the archive and look inside before you send it, and send it by mail rather than posting it in a public issue.
Невдалу конвертацію важко відтворити за описом. Застосунок зберігає журнали останніх запусків на вашому диску й пакує їх лише на ваше прохання. Автоматично нічого не надсилається.
- Настільний застосунок і Застосунок із Microsoft Store. Відкрийте сторінку Про програму застосунку doc-html-ui, групу Підтримка та діагностика, і натисніть Надіслати журнали авторові. Одне натискання збирає один архів, відкриває його теку з виділеним файлом, копіює шлях до нього в буфер обміну й відкриває готового листа у вашій поштовій програмі. Архів ви додаєте й надсилаєте самі.
- Командний рядок. Прапорець
-reportзбирає той самий архів і друкує, куди він ліг. - Розширення для браузера. У блоці «Про розширення» на сторінці налаштувань є кнопка Скопіювати діагностику. Вона копіює в буфер обміну коротке зведення англійською - версія розширення, браузер, мова інтерфейсу, ваш набір налаштувань, а також формат, кількість сторінок і останню помилку останнього документа. Ні тексту документів, ні списку ваших сайтів там немає.
Архів пишеться в %LOCALAPPDATA%\doc-html-translate\reports\ і містить рівно три речі: environment.txt, settings.json та нещодавні журнали запусків. Значення, схожі на ключ, токен чи пароль, замінюються на <redacted>, а ваші теки згортаються до %USERPROFILE% і %LOCALAPPDATA%. Імена файлів документів зберігаються навмисно - із журналом, який нема з чим зіставити, зазвичай нічого не вдієш. Відкрийте архів і зазирніть усередину, перш ніж надсилати, і надсилайте його листом, а не викладайте в публічне звернення.
Чего ожидатьWhat to expectЧого очікувати
Отвечает лично автор, когда позволяет время; срок ответа не обещается. Быстрее всего можно действовать по сообщению, где названы версия, шаги и точный текст ошибки, а для конвертации - приложен архив диагностики.
The author replies personally, as time allows, and no reply time is promised. A report that names the version, the steps and the exact error - with the diagnostics archive for a conversion - is the quickest to act on.
Відповідає особисто автор, коли дозволяє час; термін відповіді не обіцяється. Найшвидше можна діяти за повідомленням, де названо версію, кроки й точний текст помилки, а для конвертації - додано архів діагностики.
См. такжеSee alsoДив. також
- Руководство: отправка журналов неудачной конвертации - те же шаги со снимком экрана.
- Политика конфиденциальности - что приложение делает с журналами и чего не делает никогда.
- Предупреждение Windows SmartScreen - почему оно появляется при первом запуске и чего приложение никогда не делает.
- Что нового - возможно, исправление уже вышло в новой версии.
- Manual: send the logs of a failed conversion - the same steps with a screenshot.
- Privacy Policy - what the app does with its logs, and what it never does.
- The Windows SmartScreen warning - why it appears at the first launch and what the app never does.
- Release notes - a fix may already have shipped in a newer version.
- Посібник: надсилання журналів невдалої конвертації - ті самі кроки зі знімком екрана.
- Політика конфіденційності - що застосунок робить із журналами і чого не робить ніколи.
- Попередження Windows SmartScreen - чому воно з'являється під час першого запуску і чого застосунок ніколи не робить.
- Що нового - можливо, виправлення вже вийшло в новій версії.