기술 보고서나 교재에서는 계산 방법이나 유도 과정을 수식으로 보여주는 경우가 있습니다. 자바(Java)로 워드 문서를 생성할 때 수식까지 함께 작성하면, 분수나 근호, 위첨자·아래첨자의 구조를 유지한 채 출력할 수 있으며, 생성 후에도 Word에서 편집이 가능합니다.
본 기사에서는 모델 평가 보고서를 예시로 들어 LaTeX와 MathML로부터 Word의 수식을 만드는 방법을 다룹니다. 수식을 독립된 단락에 배치하는 방법 외에도, 본문 한 문장에 포함시키는 방법과 기존 문서의 끝 부분에 추가하는 방법도 소개합니다.
JDK 1.6 (Java 6) 이상 버전이 필요합니다. Maven을 사용하는 경우, Maven 자체와 빌드 플러그인이 요구하는 JDK 버전을 확인해 주세요. -
수식 삽입 기능을 지원하는 Word 문서 처리 라이브러리를 사용해야 합니다. 본 기사에서는 무료 버전인 Free Spire.Doc for Java를 사용하여 워드 문서를 생성하고 편집 가능한 수식을 삽입합니다. 프로그램 실행에 Microsoft Office는 필요하지 않습니다. 무료 버전의 경우, 워드 문서 읽기 및 저장 시 1 문서당 500 단락과 25개의 표까지 처리할 수 있습니다.
Maven 프로젝트의 pom.xml 파일에 다음 리포지토리와 의존성을 추가합니다. <repositories>나 <dependencies>가 이미 존재하는 경우, 해당 요소 안에 <repository>나 <dependency>를 추가해 주세요.
<repositories>
<repository>
<id>com.e-iceblue</id>
...
자바 코드 내에서 수식을 정의할 때는 LaTeX로 작성하면 분수나 근호를 짧은 문자열로 표현할 수 있습니다. 여기서는 샘플 수를 n, i번째 샘플의 잔차를 r_i라고 가정하고, 제곱 평균 제곱근 오차(RMSE)를 나타냅니다.
RMSE = \sqrt{\frac{1}{n}\sum_{i=1}^{n} r_i^{2}}
\sqrt{...}의 중괄호로 묶인 전체 범위가 근호 안에 들어갑니다. -
\frac{1}{n}은 분자가 1, 분모가 n인 분수입니다. -
\sum_{i=1}^{n}은 i=1부터 n까지의 총합을 의미하며, r_i^{2}는 i번째 잔차의 제곱을 나타냅니다.
자바 문자열 리터럴에서는 LaTeX의 백슬래시를 \로 작성합니다. 예를 들어, 소스 코드에 `
이것이 생성됩니다. 데스크톱 버전 Word에서 파일을 열고 분수나 첨자 표시를 확인합니다.
짧은 수식을 본문 중간에 배치하려면, 수식의 앞뒤 텍스트를 같은 단락에 추가합니다. 위의 코드 중, “각 샘플의 잔차는 실측값에서 예측값을 뺀 값입니다.”를 추가하는 줄부터 residualParagraph.getItems().add(residual);까지를 다음 코드로 대체합니다.
Paragraph residualParagraph = section.addParagraph();
residualParagraph.appendText("잔차는 ");
OfficeMath residual = new OfficeMath(doc);
...
Paragraph에 추가한 순서대로, 앞 텍스트, 수식, 뒤 텍스트가 나열됩니다. LaTeX를 사용하는 경우에도 배치 절차는 동일합니다. 수식을 구성하는 부분에서는 fromLatexMathCode()를 사용합니다.
기존 보고서를 사용할 경우에는, try 블록으로 파일을 읽어 들인 후 마지막 섹션을 가져옵니다. 위의 코드에 있는 Section section = doc.addSection();을 다음 2줄로 대체해 주세요.
doc.loadFromFile("기존보고서.docx");
Section section = doc.getSections().get(doc.getSections().getCount() - 1);
이렇게 하면, 후속 section.addParagraph()가 마지막 섹션에 단락을 추가합니다.
| 증상 | 확인 사항 |
|---|
\sqrt{...}나 XML이 그대로 표시됨 | 소스를 appendText()로 작성했는지 확인합니다. 수식은 OfficeMath로 변환한 후에 단락에 추가해야 합니다. |
| 긴 LaTeX 수식이 깨져서 표시됨 | 분수, 근호, 총합을 개별적으로 변환한 후 조합합니다. Java 측의 백슬래시 이스케이프와 LaTeX 측의 중괄호 대응도 확인합니다. |
| MathML에서 변환된 수식에 아래 첨자가 붙지 않음 | <msub>의 자식 요소가 “첨자를 붙일 대상, 첨자” 순서로 배열되어 있는지, 그리고 <math>에 네임스페이스 선언이 포함되어 있는지 확인합니다. |