Mammoth .docx converter v1.21.0

Mammoth предназначен для преобразования документов .docx, например, созданных Microsoft Word, Google Docs и LibreOffice, и преобразования их в HTML. Цель Mammoth - создать простой и понятный HTML, используя семантическую информацию в документе и игнорируя другие детали. Например, Mammoth преобразует любой абзац со стилем Heading1 в элементы h1, а не пытается точно скопировать стиль (шрифт, размер текста, цвет и т. д.) заголовка. Это позволяет вставлять документы Word без обычного беспорядка.

Между структурой, используемой в .docx, и структурой HTML существует большое несоответствие, а это означает, что преобразование вряд ли будет идеальным для более сложных документов. Mammoth работает лучше всего, если вы используете стили только для семантической разметки документа.

В настоящее время поддерживаются следующие функции:

- Заголовки.

- Списки.

- Таблицы. Форматирование самой таблицы, например границ, в настоящее время игнорируется, но форматирование текста обрабатывается так же, как и в остальной части документа.

- Сноски и концевые сноски.

- Изображения.

- Жирный, курсив, надстрочный и подстрочный индекс.

- Ссылки.

- Текстовые поля. Содержимое текстового поля рассматривается как отдельный абзац, который появляется после абзаца, содержащего текстовое поле.

Встроенные карты стилей

По умолчанию Mammoth сопоставляет некоторые распространенные стили .docx с элементами HTML. Например, абзац со стилем "Заголовок 1" преобразуется в элемент h1. Если у вас есть документ с вашими собственными стилями, вы можете использовать встроенную карту стилей, чтобы сообщить Mammoth, как следует сопоставлять эти стили. Например, вы можете преобразовать абзацы со стилем WarningHeading в элементы h1 с class="warning" с помощью сопоставления стилей:

p[style-name="WarningHeading"] => h1.warning:fresh

Онлайн-инструмент можно использовать для встраивания карт стилей в существующий документ. Подробности о написании карт стилей можно найти в документации mammoth.js.

Карту стилей, которая будет использоваться для всех документов, можно установить путем настройки Mammoth (см. ниже).

Конфигурация

Mammoth можно настроить, написав отдельный плагин. Например, этот пример плагина добавляет пользовательскую карту стилей и использует преобразование документа для обнаружения абзацев моноширинного текста и преобразует их в абзацы со стилем "Блок кода".

В качестве плагина WordPress Mammoth использует библиотеку JavaScript mammoth.js для преобразования документов. Mammoth будет использовать глобальный MAMMOTH_OPTIONS JavaScript при каждом вызове mammoth.js, что позволяет выполнить некоторую настройку. MAMMOTH_OPTIONS следует определять как функцию, возвращающую объект параметров. Этот объект параметров затем будет передан в качестве аргумента параметров для ConvertToHtml. Документы mammoth.js описывают различные доступные варианты.

Глобальная MAMMOTH_OPTIONS будет вызываться с mammoth в качестве первого аргумента. Это может быть полезно, если вам нужно использовать функцию из mammoth.js, например mammoth.transforms.getDescendantsOfType.

Часто задаваемые вопросы

Ответы на некоторые часто задаваемые вопросы о Мамонте.

Пожертвования

Если вы хотите сказать спасибо, сделайте пожертвование через Ko-fi.

Если вы используете Mammoth в рамках своего бизнеса, рассмотрите возможность поддержки текущего обслуживания Mammoth, делая еженедельное пожертвование через Liberapay.