단락 추가 및 텍스트 서식 설정하기

이전 수업에서 문서에 제목과 단락을 추가하는 방법을 알아보았습니다.

일반적으로 문서를 작성할 때 가장 기본적인 요소는 본문에 가장 많이 활용되는 단락(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)을 추가하는 방법을 알아보겠습니다.