Создание документов DOCX
Встроенный навык создания документов нужен для отчётов, книг, предложений, инструкций, регламентов и других материалов, которые пользователь должен открыть и продолжить редактировать в текстовом редакторе. Навык применяется только тогда, когда DOCX входит в утверждённый набор итоговых форматов. Явно запрошенный PDF, Markdown, HTML, презентация, электронная таблица или другой формат не заменяется на DOCX. Один проект может подготовить несколько итоговых форматов. Содержание, читательская структура и редакторская глубина до сборки файла определяются отдельным навыком Подготовка содержательных отчётов. Навык DOCX отвечает за форматную сборку и проверку редактируемого файла.Чем этот навык отличается от простого преобразования
Простое преобразование Markdown в DOCX переносит заголовки, списки и таблицы, но не отвечает за качество документа. Встроенный навык сначала формирует читательскую структуру, затем собирает настоящий DOCX и проверяет результат. Последовательность выглядит так:- Фиксируются читатель, задача документа, охват, глубина, язык, правила источников и образец оформления.
- Для действительно большого или независимо делимого материала главы либо разделы могут поручаться отдельным исполнителям; короткий связный документ не делится искусственно.
- Редактор полностью читает подготовленные части, устраняет повторы и противоречия, выравнивает термины, числа и переходы.
- Из исходной рукописи создаётся DOCX со стилями, оглавлением, нумерацией, таблицами, ссылками и колонтитулами.
- Машинная проверка ищет незаполненные места, чрезмерное количество списков, слишком широкие таблицы, нарушения структуры и признаки проблем доступности.
- После любого исправления DOCX проверка выполняется заново.
Проверка без Microsoft Word
Велес не открывает Microsoft Word и не управляет рабочим столом. Проверка выполняется непосредственно по структуре DOCX черезpython-docx и содержимое архива Word.
Для готового DOCX должны существовать:
- итоговый редактируемый файл DOCX;
- отчёт
docx-audit.jsonсkind: veles-docx-auditи успешным результатом; - необходимые отчёты проверки фактов, ссылок и расчётов, если они требуются проекту.
docx-audit.json содержит SHA-256 текущего DOCX. Если файл изменён, заменён или перемещён после проверки, отчёт считается устаревшим и создаётся заново. Самостоятельно составленный JSON не заменяет машинную проверку.
Если файл не открывается или проверка обнаружила блокирующий дефект, проект не сообщает о готовности документа.
Как Велес борется с документами из одних списков
Для поясняющего отчёта или книги обычный текст считается основной формой. Списки подходят для коротких наборов условий и действий, а таблицы — для строк с одинаковыми полями. Проверка обращает внимание на:- долю абзацев-списков;
- количество поясняющего текста;
- таблицы шире семи колонок;
- таблицы шире десяти колонок, которые без специального макета считаются блокирующей проблемой;
- исследовательские журналы и исходные реестры, случайно попавшие в основной текст;
- отсутствие объяснения рядом с важной таблицей или схемой.