Преобразуватели

Вътрешни API Класовете на тази страница не са част от публичния API и не се изнасят от пакета с най-високо ниво aspose.words_foss . Те се използват вътрешно в експортния тръбопровод . Повечето разработчици трябва да използят вместо това ⌒Document.save()`. Вижте Корен управление за публичното API .

Aspose.Words FOSS за Python използва специализирани класове преобразуватели, които трансформират вътрешния модел на документа в изходни формати. ParagraphConverter обработва текста и формата, ̋TableConversor` управлява структурите на таблиците и ∂ListHandler゚ управлява форматът на списъка. Тези класови елементи са детайли от изпълнението и могат да се променят без предизвестие.

Преобразувач на параграфи

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

Method	Description
`ParagraphConverter.get_paragraph_info()`	Extract formatting information from a paragraph
`ParagraphConverter.get_run_formatting()`	Get formatting details for a text run
`ParagraphConverter.format_text()`	Apply formatting to text content

Преобразувател на таблици

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

Method	Description
`TableConverter.convert()`	Convert a table element to the output format

Справящ списък

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

Method	Description
`ListHandler.set_reader()`	Set the document reader for list context
`ListHandler.reset()`	Reset list tracking state
`ListHandler.get_list_info()`	Get list item details for a paragraph
`ListHandler.format_list_item()`	Format a list item with marker and indentation
`ListHandler.break_list()`	Signal end of a list sequence

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

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

Общи проблеми

Issue	Cause	Fix
Misaligned table columns	Input table has merged cells	`TableConverter` handles simple tables; merged cells may produce unexpected output
Broken list numbering	List state not reset between sections	Call `ListHandler.reset()` at section boundaries

Снимка на API референтна информация

Class / Method	Description
`ParagraphConverter.get_paragraph_info()`	Extract paragraph formatting
`ParagraphConverter.get_run_formatting()`	Get run-level formatting
`ParagraphConverter.format_text()`	Apply formatting to text
`TableConverter.convert()`	Convert a table to output format
`ListHandler.set_reader()`	Set document reader context
`ListHandler.get_list_info()`	Get list item details
`ListHandler.format_list_item()`	Format a list item