Конвертори

Вътрешен API — Класовете на тази страница се използват вътрешно от експортната тръбопровод. Повечето разработчици взаимодействат с Document.save() вместо. Вижте Core Management за публичния API.

Aspose.Words FOSS for Python използва специализирани класове за конвертиране, за да трансформира вътрешния модел на документа в изходни формати. ParagraphConverter обработва текст и форматиране, TableConverter обработва структури на таблици, а ListHandler управлява форматирането на списъци.

Конвертор на параграфи

ParagraphConverter преобразува абзаците на документа в целевия изходен формат. Той проверява форматирането на абзаците, стилизирането на ниво run и вграденото съдържание.

Метод	Описание
`ParagraphConverter.get_paragraph_info()`	Извличане на информация за форматиране от абзац
`ParagraphConverter.get_run_formatting()`	Получаване на детайли за форматиране на текстов фрагмент
`ParagraphConverter.format_text()`	Прилагане на форматиране към текстово съдържание

Конвертор на таблици

TableConverter преобразува таблиците в документа в целевия формат (например Markdown таблици).

Метод	Описание
`TableConverter.convert()`	Конвертиране на елемент от таблица към изходния формат

Обработчик на списъци

ListHandler управлява състоянието на списъка по време на конвертиране на документа, следейки вложеността на списъка, маркерите и форматирането.

Метод	Описание
`ListHandler.set_reader()`	Задаване на четеца на документа за контекст на списък
`ListHandler.reset()`	Нулиране на състоянието за проследяване на списъка
`ListHandler.get_list_info()`	Получаване на подробности за елемент от списъка за параграф
`ListHandler.format_list_item()`	Форматиране на елемент от списъка с маркер и отстъп
`ListHandler.break_list()`	Сигнализиране за края на последователност от списъци

Съвети и най‑добри практики

Конверторите се използват вътрешно от експортната тръбопровода — повечето разработчици взаимодействат с Document.save() вместо това
ParagraphConverter.format_text() уважава контекста на блоковете код, за да избегне прилагане на вградено форматиране в кодови спанове
ListHandler поддържа състояние през последователни параграфи от списъци — извикайте reset() при започване на нов раздел от документа

Чести проблеми

Проблем	Причина	Поправка
Неправилно подравнени колони на таблицата	Входната таблица има слети клетки	`TableConverter` обработва прости таблици; слетите клетки могат да доведат до неочакван изход
Повредено номериране на списъка	Състоянието на списъка не се нулира между секциите	Извикайте `ListHandler.reset()` на границите на секциите

Обобщение на API справка

Клас / Метод	Описание
`ParagraphConverter.get_paragraph_info()`	Извличане на форматиране на абзац
`ParagraphConverter.get_run_formatting()`	Получаване на форматиране на ниво run
`ParagraphConverter.format_text()`	Прилагане на форматиране към текста
`TableConverter.convert()`	Конвертиране на таблица към изходен формат
`ListHandler.set_reader()`	Задаване на контекст за четене на документа
`ListHandler.get_list_info()`	Получаване на детайли за елемент от списък
`ListHandler.format_list_item()`	Форматиране на елемент от списък