컨버터 – Aspose FOSS Documentation

컨버터

Aspose.Words FOSS for Python은 내부 문서 모델을 출력 형식으로 변환하기 위해 특수 변환기 클래스를 사용합니다. ParagraphConverter은 텍스트와 서식을 처리하고, TableConverter은 표 구조를 처리하며, ListHandler은 목록 서식을 관리합니다.

단락 변환기

ParagraphConverter는 문서 단락을 대상 출력 형식으로 변환합니다. 단락 서식, 실행 수준 스타일링 및 인라인 콘텐츠를 검사합니다.

메서드	설명
`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()`	목록 시퀀스 종료 신호

팁 및 모범 사례

Converters are used internally by the export pipeline — most developers interact with Document.save() instead
ParagraphConverter.format_text() respects code block context to avoid applying inline formatting inside code spans
ListHandler maintains state across consecutive list paragraphs — call reset() when starting a new document section

일반적인 문제

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()`	단락 서식 추출
`ParagraphConverter.get_run_formatting()`	런 수준 서식 가져오기
`ParagraphConverter.format_text()`	텍스트에 서식 적용
`TableConverter.convert()`	표를 출력 형식으로 변환
`ListHandler.set_reader()`	문서 리더 컨텍스트 설정
`ListHandler.get_list_info()`	목록 항목 세부 정보 가져오기
`ListHandler.format_list_item()`	목록 항목 서식 지정