단락 추가 및 텍스트 서식 설정하기
이전 수업에서 문서에 제목과 단락을 추가하는 방법을 알아보았습니다.
일반적으로 문서를 작성할 때 가장 기본적인 요소는 본문에 가장 많이 활용되는 단락(Paragraph)입니다.
python-docx를 사용하면 대규모의 텍스트 콘텐츠를 간편하게 추가하거나, 조건에 따른 서식을 프로그래밍적으로 적용할 수 있습니다.
단락 추가하기
단락을 추가할 때는 add_paragraph() 메서드를 사용합니다.
add_paragraph의 인자로는 단락에 추가할 텍스트를 전달합니다.
doc.add_paragraph('첫 번째 단락입니다.')
위 코드는 "첫 번째 단락입니다."라는 텍스트가 포함된 새로운 단락을 문서에 추가합니다.
여러 단락 추가하기
add_paragraph 메서드와 반복문을 함께 사용하면, 여러 단락을 한 번에 추가할 수 있습니다.
texts = ['첫 번째 단락입니다.', '두 번째 단락입니다.', '세 번째 단락입니다.']
for text in texts:
doc.add_paragraph(text)
첫 번째 단락입니다.
두 번째 단락입니다.
세 번째 단락입니다.
이를 응용하면 엑셀 파일 등에서 읽어온 대량의 데이터를 문서에 간편하게 추가할 수 있습니다.
텍스트 서식 설정하기
run 객체를 사용하면 단락에 추가된 텍스트를 다양한 서식으로 꾸밀 수 있습니다.
이 객체는 Paragraph 객체의 일부로, 단락 내에서 특정 텍스트에 서식을 적용할 수 있는 단위입니다.
run 객체는 동일한 서식을 공유하는 텍스트의 연속을 나타내며, 여러 개의 Run으로 하나의 단락을 구성할 수 있습니다.
# 새로운 문서 생성
doc = Document()
# 문서에 단락 추가
paragraph = doc.add_paragraph('이 텍스트는 ')
run = paragraph.add_run('1. 굵게 ')
run.bold = True # 굵게 설정
run = paragraph.add_run('2. 그리고 ')
run.italic = True # 기울임꼴 설정
run = paragraph.add_run('3. 크게')
run.font.size = Pt(24) # 글자 크기 설정
이 코드는 하나의 단락 내에서 굵게, 그리고, 크게라는 텍스트에 각각
-
run.bold: 굵게 -
run.italic: 기울임꼴 -
run.font.size: 글자 크기 24pt
속성을 적용하여 다양한 텍스트 서식을 설정합니다.
단락의 스타일 지정하기
아래와 같이 단락에 워드 문서의 'Title' 스타일과 'Subtitle' 스타일을 적용할 수 있습니다.
doc.add_paragraph('문서 제목', style='Title')
doc.add_paragraph('부제목', style='Subtitle')
이번 수업을 통해 문서에 단락을 추가하고 텍스트 서식을 설정하는 방법을 알아보았습니다.
다음 수업에서는 문서 내 목록(List)을 추가하는 방법을 알아보겠습니다.
다음 내용이 궁금하다면?
코드프렌즈 PLUS 멤버십 가입 or 강의를 등록해 주 세요!