꿀팁

[꿀팁] Overleaf paper 작성법

도도걸만단 2025. 10. 16. 21:00
반응형

Overleaf에서 CVPR (혹은 유사 학회) 템플릿을 이용해 리포트를 작성하는 절차는 다음과 같다. (LaTeX 처음 써본 사람도 따라 할 수 있게 단계별로 정리함.)

 

 

내가 나중에 보려고 기록해둠.

 


준비물 / 전제 조건

  • Overleaf 계정 (무료 계정이면 충분)
  • CVPR 템플릿 파일 (보통 .tex, .sty, .cls, 예시 파일, .bib 등이 포함된 ZIP)
  • 너의 리포트용 그림들, 표 파일, 결과 수치 등
  • (선택) BibTeX 참조 파일 .bib (참고문헌을 관리하려면)

1단계: CVPR 템플릿 가져오기

  1. Overleaf 홈페이지에 로그인
  2. “New Project → Upload Project”를 선택
  3. 너가 다운받은 CVPR Author Kit ZIP 또는 템플릿 파일들을 업로드
    • 예: cvpr2022-author_kit.zip 또는 최신 버전
    • 혹은 Overleaf 내부 템플릿 갤러리에서 “CVPR 2022 Author Kit” (또는 해당 연도 템플릿) 선택 후 “Use this template” 클릭 (overleaf.com)
  4. 프로젝트가 생성되면 Overleaf 상단에 .tex 파일들이 보일 것이다 (main.tex 또는 paper.tex 등)
    • 이 중 가장 처음 컴파일할 파일(main file)을 지정해야 한다 (보통 main.tex)
    • Settings → Main document에서 메인 파일 지정

2단계: 템플릿 구조 이해하기

템플릿에는 보통 다음 파일들/구조가 있다:

  • .tex (메인 문서)
  • .sty 또는 .cls (스타일 파일)
  • figures/ 폴더: 그림 파일 저장
  • bib/ 폴더 또는 .bib 파일: 참고문헌
  • 예시 파일 (예: egpaper_for_review.tex, egpaper_final.tex)

템플릿의 preamble (머리말)에 저자명/타이틀/초록 등 설정 부분이 있다.
예:

\documentclass[10pt,twocolumn,letterpaper]{article}
\usepackage{cvpr}
\cvprfinalcopy  % 본문 모드 사용
\def\cvprPaperID{****}  % 제출용 ID
\title{제목}
\author{이름 \\ 소속 \\ 이메일}

너는 이 부분을 네 과제 제목/이름/소속 등으로 바꾸면 된다.


3단계: 리포트 내용 채우기

  • \begin{document} 이후 \maketitle, \begin{abstract} 등 기본 구조가 있다.
  • 너의 리포트 초안을 Introduction / Methods / Results / Discussion / Conclusion 구조로 나눠서 \section{Introduction}, \section{Methods} 등으로 채운다.
  • 그림 삽입 예시:
  • \begin{figure}[t] \centering \includegraphics[width=\linewidth]{figures/degraded_vs_restored.png} \caption{입력 이미지와 복원 이미지 비교} \label{fig:degraded_restored} \end{figure}
  • 표는 tabular 환경 또는 table 환경 사용:
  • \begin{table}[t] \centering \begin{tabular}{c|cc} 파이프라인 & PSNR & SSIM \\ \hline A & <결과 입력 바람> & <결과 입력 바람> \\ B & ... \end{tabular} \caption{복원 성능 비교} \label{tab:performance} \end{table}
  • 참고문헌 삽입 (BibTeX 사용 시):
  • \bibliographystyle{ieee_fullname} \bibliography{yourbibfile}

4단계: 컴파일 및 오류 수정

  • Overleaf 상단의 “Recompile” 버튼을 눌러 PDF로 결과를 본다.
  • 에러가 나면 로그 창(Log) 내용을 보고 어느 줄에서 문제가 있는지 확인하고 수정한다.
  • 패키지 충돌, 없는 파일 참조, 그림 경로 오류 등이 자주 나는 문제다.

5단계: 스타일 맞추기 / 제출 준비

  • 작성이 끝나면 페이지 수, 여백, 폰트 크기 등이 템플릿 요구사항에 맞는지 확인한다.
  • “final” 모드 vs “review” 모드 설정이 있다면, 리뷰용 모드가 아닌 “final” 모드로 컴파일한다 (리뷰용 라인 넘버 제거 등).
  • PDF 다운로드 → 제출 또는 공유
  • (선택) 보충자료가 있다면 supplementary.tex 등을 템플릿 내 제공하는 모드로 추가한다.

6단계: 팁 & 주의사항

  • 그림/표 파일은 보통 .png 또는 .pdf 형식이 안정적이다.
  • 한글을 쓸 경우엔 XeLaTeX 또는 LuaLaTeX 모드를 써야 할 수 있다. 템플릿이 허락하는지 확인하라.
  • tikz 등 고급 그래프 패키지 쓰는 경우, CVPR 템플릿과 충돌이 있을 수 있으므로 미리 테스트하라. (TeX - LaTeX Stack Exchange)
  • 라벨(\label)과 \ref, \cite 명령은 정확히 붙여 써야 하며, 참조 누락이 없게 확인하라.
  • Overleaf는 자동 백업되고 팀원과 공유 가능하니 협업이 쉽다.


PNG 이미지를 논문에 첨부하는 방법

은 간단하지만, 폴더 구조 / 경로 / 패키지 설정을 잘못하면 바로 오류가 나기 때문에, 아래 순서대로 하면 확실히 된다.


1. PNG 파일 업로드하기

  1. Overleaf 왼쪽 파일 트리에서 → “📁 Files” 버튼 클릭
  2. “Upload” 눌러서
    fft_magnitude.png, frequency_filtered.png, wiener_restored.png, final_restored.png
    같은 이미지를 직접 업로드
  3. 업로드 후 파일 트리에서 images/ 폴더를 만들어 넣으면 깔끔함
    (예: images/final_restored.png)

2. LaTeX 패키지 불러오기

논문의 preamble (\documentclass 바로 아래)에 다음 코드 추가:

\usepackage{graphicx}
\graphicspath{{images/}}  % <- 이미지 폴더 경로

💡 \graphicspath{{images/}} 는 LaTeX이 이미지를 자동으로 images/ 폴더 안에서 찾게 해줌.
만약 이미지가 프로젝트 루트에 있다면, 이 줄은 생략 가능.


3. 이미지 삽입 문법

(1) 기본 형태

\begin{figure}[h!]
    \centering
    \includegraphics[width=0.8\linewidth]{final_restored.png}
    \caption{Final restored image after CLAHE enhancement.}
    \label{fig:final_restored}
\end{figure}
  • width=0.8\linewidth : 이미지 크기를 조정 (0.5~1.0 사이 값 사용)
  • \caption{...} : 그림 설명
  • \label{fig:...} : 본문에서 참조 가능하게 태그 붙이기

(2) 여러 이미지를 나란히 붙이고 싶을 때

(예: Before/After 비교)

\begin{figure}[h!]
    \centering
    \includegraphics[width=0.45\linewidth]{degraded.png}
    \includegraphics[width=0.45\linewidth]{restored.png}
    \caption{Comparison of degraded (left) and restored (right) images.}
    \label{fig:compare}
\end{figure}

💡 두 이미지를 같은 줄에 놓으려면 width 값을 각각 0.45 정도로 맞추면 된다.


(3) 여러 개를 세로로 붙이고 싶을 때

\begin{figure}[h!]
    \centering
    \includegraphics[width=\linewidth]{fft_magnitude.png}
    \includegraphics[width=\linewidth]{wiener_restored.png}
    \caption{(Top) FFT magnitude spectrum. (Bottom) Wiener restored result.}
    \label{fig:fft_wiener}
\end{figure}

4. PDF 변환 시 이미지가 안 뜨는 경우

다음 체크리스트를 확인해야 한다.

문제 원인 해결

“File not found” 경로 오타 graphicspath 확인 ({images/} 뒤에 / 꼭 있어야 함)
“Unknown graphics extension” 파일 확장자 잘못됨 .png는 지원됨 (JPEG, PDF, EPS도 OK)
이미지가 너무 큼 고해상도 파일 그대로 삽입 width=0.5\linewidth 등으로 축소
깨져보임 PNG의 색공간 이슈 PNG를 RGB로 다시 저장 (convert image.png -colorspace RGB new.png)

5. CVPR 템플릿 안에서의 권장 예시

CVPR 템플릿(cvpr.sty)은 자동으로 figure 환경을 인식하므로,
그냥 다음처럼 쓰면 된다:

\begin{figure}[t]
\centering
\includegraphics[width=\linewidth]{images/final_restored.png}
\caption{Final restored image result using the proposed pipeline.}
\label{fig:final_result}
\end{figure}

[t], [b], [h!] 은 이미지 위치 제어 옵션임.

  • t: top (페이지 상단)
  • b: bottom
  • h!: 현재 위치 (강제)

 

PNG 파일 Overleaf에 업로드 (images/ 폴더 권장)
\usepackage{graphicx} 추가
\graphicspath{{images/}} 지정
\includegraphics[width=...] 사용
\caption과 \label 추가
[h!] 또는 [t] 옵션으로 위치 조정


Overleaf 프로젝트를 ZIP 파일로 내보내는 방법


방법 1. Overleaf 웹 인터페이스에서 직접 내보내기 (가장 일반적)

  1. Overleaf에서 보고 있는 프로젝트를 연다.
  2. 좌측 상단 메뉴에서 “Menu” 버튼(☰ 아이콘)을 클릭한다.
  3. 아래로 스크롤하면 “Download” 섹션이 있다.
  4. 그 아래에서
    • “Download as ZIP” → 클릭
    • 자동으로 project.zip 파일이 다운로드됨

📦 이 ZIP에는 다음이 포함된다:

  • .tex 파일 (본문)
  • 이미지 폴더(images/)
  • bibliography 파일(.bib)
  • Overleaf 설정파일(.cls, .sty, etc.)

 


방법 2. PDF만 받고 싶을 때

  1. 같은 메뉴(Menu → Download PDF) 클릭
  2. PDF만 단독 다운로드 가능

⚠️ PDF만 받으면 .tex, .bib, .png 등은 포함되지 않는다.
제출용(보고서 zip)이라면 꼭 Download as ZIP 으로 받아야 함.


방법 3. GitHub 백업(고급)

Overleaf Premium 계정이라면
Menu → Sync → GitHub / GitLab / Dropbox 연결 메뉴에서
자동으로 .zip 구조 동기화도 가능하다.
(연결 후 “Sync now” 클릭 시 동일 구조의 ZIP 백업 생성)


권장 구조 (ZIP 압축 시 포함되어야 하는 파일들)

report/
├── main.tex
├── cvpr.sty
├── references.bib
├── images/
│   ├── pair_comparison_main.png
│   ├── pair_comparison_lines.png
│   └── ...
└── output.pdf

주의사항

  • 이미지 이름에 공백이 있으면 Overleaf 내보내기 시 깨질 수 있다.
    → 항상 snake_case (_) 형태로 저장
  • ZIP 다운로드 후 압축을 풀면 output.pdf 는 포함 안 되어 있을 수도 있다.
    → Overleaf에서 “Recompile → Download PDF”로 따로 받는 게 안전함.
  • 과제 제출이라면 ZIP + PDF 둘 다 제출하는 게 가장 확실하다.

 

반응형