IOES KMOU Report

IOES-Report-Latex는 IOES KMOU Report 한글 LaTeX 보고서 템플릿입니다. 이 템플릿의 문서 작성자는 Choi Woen-Sug (wshoi@kmou.ac.kr)입니다.

구성

• main.tex: 보고서 본문
• tau.bib: 참고문헌 데이터베이스
• tau-class/: IOES KMOU Report 문서 클래스와 사용자 정의 패키지
• figures/: 예제 그림
• example.py: 코드 삽입 예제
• Fonts/: XeLaTeX 컴파일에 필요한 한글 및 영문 글꼴
• .latexmkrc: latexmk 컴파일 설정

설치

1. LaTeX 배포판을 설치합니다.
   • Windows, Linux: MiKTeX
   • macOS: MacTeX
2. 설치한 LaTeX 배포판을 업데이트합니다.
   • Windows, Linux: MiKTeX Console에서 Check for updates
   • macOS: 터미널에서 sudo tlmgr update --self --all
3. Python과 Pygments를 설치합니다. minted 패키지가 코드 강조에 필요합니다.

pip install Pygments

4. Visual Studio Code를 사용하는 경우 다음 확장을 설치합니다.
   • Korean Language Pack
   • LaTeX Workshop

글꼴

이 저장소는 Fonts/ 디렉터리에 필요한 글꼴 파일을 포함합니다. main.tex는 운영체제에 설치된 글꼴 이름을 찾지 않고 파일명을 직접 지정합니다.

사용 중인 주요 글꼴은 다음과 같습니다.

• HANBatang-LVT.ttf, HANBatangB-LVT.ttf
• HANDotum-LVT.ttf, HANDotumB-LVT.ttf
• texgyretermes-*.otf
• texgyreheros-*.otf

컴파일

디렉터리에서 다음 명령을 실행합니다.

latexmk main.tex

이미 빌드된 산출물이 최신이라고 나오지만 처음부터 다시 만들고 싶다면 다음처럼 정리 후 재빌드합니다.

latexmk -C main.tex && latexmk main.tex

minted 캐시까지 지우고 완전히 다시 만들려면 다음 명령을 사용합니다.

latexmk -C main.tex && rm -rf _minted* && latexmk main.tex

settings.json의 xelatex -> biber -> xelatex 레시피와 같은 흐름을 터미널에서 한 줄로 실행하려면 다음 명령을 사용합니다.

xelatex -synctex=1 -interaction=nonstopmode -file-line-error -shell-escape main.tex && biber main && xelatex -synctex=1 -interaction=nonstopmode -file-line-error -shell-escape main.tex

단계별 직접 명령을 실행하려면 다음 순서를 사용합니다.

xelatex -shell-escape -interaction=nonstopmode main.tex
biber main
xelatex -shell-escape -interaction=nonstopmode main.tex
xelatex -shell-escape -interaction=nonstopmode main.tex

LaTeX Workshop에서는 xelatex -> biber -> xelatex 흐름을 쓰면 됩니다. 이 템플릿은 minted를 사용하므로 -shell-escape 옵션이 필요합니다.

오류 대처

• minted 또는 pygmentize 오류가 나오면 Python과 Pygments 설치 여부를 확인합니다.
• 글꼴을 찾지 못한다면 Fonts/ 디렉터리가 저장소 루트에 있는지 확인합니다.
• macOS에서 TeX Live 글꼴 인식 문제가 있으면 MacTeX 설치와 업데이트 상태를 먼저 확인합니다.
• Windows에서 Perl 관련 오류가 나오면 Strawberry Perl을 설치합니다.

원본 클래스

이 프로젝트의 보고서 템플릿 이름은 IOES KMOU Report입니다. 다음 두 저장소를 기반으로 구성되었습니다.

• MemoJimenez/Tau-class: Guillermo Jimenez의 Tau LaTeX 클래스. 문서 레이아웃과 스타일의 기반입니다.
• kungmo/SNU_Dissertation_LaTeX_Korean: 한글 LaTeX 논문 템플릿. 한글 글꼴 설정 및 다국어 지원 구성을 참고했습니다.

현재 저장소 안에서 독립적으로 빌드되도록 조정했습니다. 원본 클래스의 라이선스와 저작권 고지는 tau-class/ 안의 파일 헤더를 유지합니다.