Содержание с кратким описанием:
Модуль python-docx предназначен для создания и обновления файлов с расширением .docx - Microsoft Word. Показывается на примере основы работы с модулем.
Объект документа имеет свойство Document.sections - это последовательность объектов секции/раздела Section. Объект Section предоставляет доступ к настройкам макета этой секции/раздела, а именно размера листа, ориентации, отступам, колонтитулам и т.д.
В материале рассказывается как работать с основными объектами, содержащими текст документа - это абзацы и его прогоны. В частности, показана на примерах настройка абзацев: отступы, межстрочный интервал и т.д., а так же управление стилями шрифта.
В материале рассматриваются на примерах способы добавления таблиц в документ DOCX при помощи модуля python-docx, а так же работа с объектом таблицы Table.
Каждый из объектов документа DOCX: абзац Paragraph, прогон Run и таблица Table имеет атрибут стиля .style (например Paragraph.style). Назначение этому атрибуту объекта стиля Style или имени стиля, применяет этот стиль соответствующему объекту.
Изображение - это фигура, которая может появляться либо на текстовом, либо на графическом слое. Если она добавлена в текстовой слой, то она называется встроенной формой или, более конкретно, встроенным изображением. Модуль python-docx поддерживает только встроенные изображения.
Объект Document() представляет собой загруженный документ, переданный docx, где аргумент docx может быть либо путем к файлу .docx (строка), либо к файловым объектом.
Объект Section представляет собой раздел документа, обеспечивающий доступ к настройкам раздела и страницы. Он также обеспечивает доступ к верхним и нижним колонтитулам.
Объект Paragraph модуля python-docx представляет собой прокси-объект, который оборачивает XML-элемент <w:p> MS Word документа.
Объект Run представляет собой прокси-объект, оборачивающий XML элемент <w:r> документа MS Word. Прогоны в основном используются для пользовательского форматирования/стилизации текста внутри абзаца.
Объект Table модуля python-docx представляет собой прокси-объект, который оборачивает элемент WordprocessingML <w:tbl>. Объект Table не создается вручную, а возвращается в результате вызова метода Document.add_table().
Объект Font - прокси-объект, оборачивающий XML элемент <w:rPr>, который предоставляет доступ к свойствам символов, таким как имя шрифта, его размер, цвет, стиль (жирный, курсив) и т.д. Объект Font не создается вручную, а возвращается в результате вызова свойства Run.font.
Объект ParagraphFormat модуля python-docx предоставляет доступ к форматированию абзацев, например выравниванию, отступу, межстрочному интервалу, пробелам до и после, отступу первого предложения абзаца ("Красная строка") и т.д.
Объекты длинны Length ведет себя как целое число int английских метрических единиц: 914400 в дюймах, 36000 в мм. Предоставляет собой удобные методы преобразования единиц измерения в виде свойств, доступных только для чтения.
Приведенные ниже константы имеют аналогичное значение в редакторе MS Word, что обеспечивает полную поддержку форматирования модулем python-docx.
Идея состоит в том, чтобы создать нужный пример/шаблон документа с помощью Microsoft Word. Затем вставить теги в документ, применяемые модулем применяемые модулем jinja2, непосредственно там где ожидаются изменения и сохранить полученный документ как файл-шаблона .docx.