논문 → Beamer 슬라이드 파이프라인은(는) 무엇을 하나요?
논문(PDF 또는 TeX 소스)이 주어지면 논문 공유/<학회> - <짧은 제목>/ 아래에 SUSTech 테마의 Beamer 프레젠테이션을 컴파일하여 생성합니다.
테마 변형: \usetheme{sustech}(소문자, 변형 A), 출처:
https://github.com/yhbcode000/sustech-slides-template.git.
\usetheme{SUSTech}(변형 B, MT3에서 사용)를 사용하지 마십시오 — 매크로가 다르고 섹션 구분 페이지가 없습니다.
기본 화면비: aspectratio=1610 (16:10). 169(16:9)를 사용하지 마십시오 —
1610은 노트북/프로젝터 호환성에 더 좋고 밀도 높은 콘텐츠를 위해 약간 더 많은 세로 공간을 제공합니다.
Bash 런타임: 모든 셸 명령은 세션의 bash 도구 아래에서 실행되며,
Windows에서는 Git Bash입니다. Unix 스타일의 rm -rf, cp -r,
mkdir -p를 사용할 수 있습니다. 작업 디렉토리는 cwd를 통해 블록별로 설정됩니다.
요구 사항 (필수)
모든 슬라이드 덱은 다음 규칙을 반드시 충족해야 합니다. 명시된 경우를 제외하고 예외는 없습니다.
- 슬라이드 오버플로우 금지 (엄격) — 모든 슬라이드는
Overfull \hbox또는Overfull \vbox경고 없이 컴파일되어야 합니다.skill://sustech-beamer-overflow를 따를 것: 단일 컬럼만, 최대 3개 블록 + 1개 콜아웃, 5열 이하의 표는\footnotesize사용,\resizebox사용 금지. 유일한 예외는 목차 페이지(\twopane레이아웃)입니다 — 목차 프레임의 약간의 세로 오버플로우(Overfull \vbox)는 허용됩니다.
1단계 — 디렉토리 설정
-
$ARGUMENTS를 입력받습니다 — PDF 경로,.tar.gzTeX 아카이브,.tex파일 (세션 cwd 기준 절대 또는 상대 경로), 또는 arXiv URL / 순수 arXiv ID. -
입력이 arXiv URL 또는 순수 ID인 경우(
^\d{4}\.\d{4,5}(v\d+)?$와 일치하거나arxiv.org/(abs|pdf|e-print)/를 포함하는 경우), 먼저 TeX 소스를 다운로드합니다:uv run --no-project python \ "<SKILLS_DIR>/paper-download-arxiv-paper-source/scripts/download_source.py" \ "<arxiv-ref>" # 기본 출력 = 세션 cwd- 표준 출력이
TEX_SOURCES:로 끝나는 경우:DIR_NAME을 유도합니다 — 추출된paper_src/TeX에서\setsource{Venue}{Year}에서 학회명 (대체\markboth, 그 다음arXiv <year>); 짧은 제목 =\title{...}의 처음 1-3개 중요 단어 (대체: 사용자에게 질문, 기존 규칙). 그런 다음mkdir -p "논문 공유/<DIR_NAME>"을 실행하고mv arXiv-<id>.tar.gz paper_src "논문 공유/<DIR_NAME>/"를 실행합니다. - 표준 출력이
PDF_ONLY: <path>로 끝나는 경우: 해당 논문은 arXiv에 TeX 소스가 없습니다 — 해당 PDF를 아래.pdf분기 (MinerU 경로 적용, 2단계 결정 게이트 변경 없음)에 따라논문 공유/<DIR_NAME>/에 복사합니다. - 명령이 0이 아닌 종료 코드로 종료되면 중지하고 stderr 메시지를 사용자에게 보고합니다.
- 표준 출력이
-
짧은 디렉토리 이름
<VENUE> - <SHORT_TITLE>을 유도합니다 (arXiv 입력 실행은 2단계에서 이미 유도했습니다):.pdf/.tar.gz/.tgz/.tex를 제거하고, 공백/하이픈/특수 문자를 대체합니다.- 파일명에서 학회명과 제목을 추론할 수 없는 경우 사용자에게 이름을 물어봅니다.
- 관례: 기존 예시는
SCIENCE ROBOTICS - HIL SERL,SCIENCE ROBOTICS - MT3입니다.
- 관례: 기존 예시는
-
논문 공유/<DIR_NAME>/을 생성하고 소스를 추출/복사합니다 (arXiv 입력 실행은 2단계에서 이미 아카이브 +paper_src/를 이동했습니다):.tar.gz/.tgz:tar -xzf로paper_src/에 추출합니다..pdf: 논문 디렉토리 루트에 직접 복사합니다..tex: 소스 파일을paper_src/에 복사합니다.
2단계 — 내용 추출
결정 게이트: TeX 소스를 사용할 수 있는 경우(.tar.gz 아카이브에 .tex가 포함되거나 직접 .tex 파일),
MinerU를 완전히 건너뜁니다. read를 사용하여 TeX 소스에서 모든 내용(제목, 저자, 초록, 섹션, 표, 참고 문헌)을 직접 읽습니다 — MinerU 출력보다 정확하고 표 구조를 정확히 보존합니다.
입력이 PDF이고 TeX 소스를 사용할 수 없는 경우에만 MinerU를 실행합니다:
"$MINERU_PYTHON" \
"<SKILLS_DIR>/pdf-to-markdown/convert.py" \
"논문 공유/<DIR_NAME>/<pdf_filename>.pdf" \
"논문 공유/<DIR_NAME>/md_output" \
--lang en
- 영어 논문:
--lang en. 중국어/혼합:--lang ch. - 래퍼는 성공 시
DONE -> ...md를 출력합니다. - 출력은
md_output/<name>/auto/<name>.md에 저장됩니다.
MinerU 환경이 없으면 중지하고 pdf-to-markdown 스킬 사전 점검에 따라 설치하도록 사용자에게 알립니다.
3단계 — 패키지된 템플릿 설치
승격된 paper-to-beamer 패키지가 기본 오프라인 템플릿 소스입니다:
uv run --project "<SKILLS_DIR>/paper-to-beamer" python \
"<SKILLS_DIR>/paper-to-beamer/scripts/copy_template.py" \
--output "논문 공유/<DIR_NAME>/slides-template"
이 명령은 검증된 main_template.tex, latexmkrc, 그리고 sustech-theme/ 번들을 복사합니다. 네트워크 클론은 절대 대체 수단으로 사용되지 않습니다. 사용자가 명시적으로 템플릿 새로 고침을 요청하는 경우에만 업스트림 저장소를 패키지 릴리스 전에 검토를 위해 별도의 임시 디렉토리에 클론할 수 있습니다.
4단계 — 작업 디렉토리 생성 및 필수 파일 복사
# cwd: $PP_ROOT
mkdir -p "논문 공유/<DIR_NAME>/slides-beamer"
cp -r "논문 공유/<DIR_NAME>/slides-template/sustech-theme" \
"논문 공유/<DIR_NAME>/slides-beamer/"
cp "논문 공유/<DIR_NAME>/slides-template/latexmkrc" \
"논문 공유/<DIR_NAME>/slides-beamer/"
cp "논문 공유/<DIR_NAME>/slides-template/main_template.tex" \
"논문 공유/<DIR_NAME>/slides-beamer/main.tex"
mkdir -p "논문 공유/<DIR_NAME>/slides-beamer/figures"
이후 모든 편집은 slides-beamer/만 대상으로 합니다.
slides-template/은 참조용으로 원본 그대로 유지됩니다.
5단계 — 내용 읽기 및 추출
TeX 소스를 사용할 수 있는 경우(권장 — .tar.gz 아카이브 또는 .tex 파일):
read를 사용하여 paper_src/에서 직접 메인 .tex 파일을 읽습니다. 모든 내용
(제목, 저자, 초록, 섹션, 표, 참고 문헌)은 구조화된 LaTeX 소스에서 추출됩니다. 표는
tabular 환경에서 직접 재생성할 수 있습니다 — MinerU가 필요 없습니다.
Markdown만 사용할 수 있는 경우(PDF 전용 입력):
md_output/<name>/auto/<name>.md를 읽습니다. 다음 데이터 포인트를 추출합니다:
6단계 — slides-beamer/main.tex 채우기
이것이 핵심 창의 단계입니다. main.tex(템플릿에서 복사됨)을 읽은 다음,
섹션별로 편집하여 모든 \ph{…} 플레이스홀더와 \phfig를 Markdown의 실제 내용으로
대체합니다.
HIL SERL 예제를 채워진 스타일 참조로 사용하십시오:
논문 공유/SCIENCE ROBOTICS - HIL SERL/slides-beamer/main.tex.
6.0 전문 메타데이터
\title[ACRONYM 논문 공유]{중국어 설명 제목}— 중국어 제목을 메인으로; 짧은 제목에는 "논문 공유" 접미사가 반드시 포함되어야 합니다. HIL SERL을 따르십시오:\title[HIL-SERL 논문 공유]{...}.\subtitle{영어 원본 논문 제목}— 영어 원본을 부제로.\author[short]{…}— 논문의 전체 저자 목록.\institute[short]{…}— 주요 소속 기관.\setsource{Venue}{Year}— 논문 학회.\setdomains{\domaintag{...}\domaintag{...}\domaintag{...}}— 제목 페이지에 색상이 지정된 알약 형태로 표시되는 3-4개의 연구 도메인 태그. 태그는 반드시 중국어여야 합니다 (예:多智能体RL,LLM Agent,RL后训练).Multi-Agent RL,RL Post-Training과 같은 영어 용어는 절대 허용되지 않습니다 — 중국어 텍스트 옆에 일관성이 없어 보이고 SUSTech 테마의 이중 언어 프레젠테이션 스타일을 깨뜨립니다.\setpresenter{$PRESENTER}(기본값) 또는 사용자에게 질문.\setvenue{<venue location>}(기본값: 사용자에게 질문).- 제목 페이지 출처 각주
\creditline(기본값:哔哩哔哩 · 白拾的物理AI组会 · github.com/yhbcode000/sustech-slides-template). 공개 공유/발표 비디오에는 유지하는 것이 좋습니다; 프레젠테이션/논문答辩 시 깔끔한 스타일이 필요한 경우 프리앰블에\hidecredits를 추가하여 숨기거나\setcreditline{}으로 비우거나\setcreditline{...}으로 사용자 정의 문구를 설정합니다.
플레이스홀더 헬퍼 매크로 \ph와 \phfig를 삭제합니다 — 더 이상 필요하지 않습니다.
6.1 홈페이지 (Title page)
\titlepage 프레임은 그대로 둡니다. 프리앰블 메타데이터가 이를 제어합니다.
6.2 📑 목차 페이지 (향상된 TOC)
템플릿은 이제 테마에서 제공하는 두 개의 창 \twopane 레이아웃을 사용합니다. 왼쪽 창에는 {\tocdense\small\tableofcontents[hideallsubsections]}를 통한 간결한 TOC가 포함됩니다. 오른쪽 창에는 세 개의 블록이 포함됩니다:
\block{核心观察}— 논문의 3-5가지 핵심 지표/인사이트\block{附录讨论}— 3-5가지 부록 하이라이트 (Oral 신호, 비교, 방법 설명)\callout[一句话概括]— 한 문장 논문 요약
별도의 논문 정보 프레임은 삭제됩니다. 제목/학회/저자는 이미 프리앰블에 있습니다. 한 문장 요약은 TOC 콜아웃에 있습니다. 별도의 정보 프레임이 필요하지 않습니다.
TOC 간격: {\tocdense\small\tableofcontents[hideallsubsections]} 사용 — \tocdense(테마에서 제공)는 beamer TOC 간격을 압축합니다. \vspace{-0.6em}을 앞에 붙여 내용을 제목 쪽으로 더 가깝게 끌어올립니다.
왼쪽 여백: 테마의 \tocdense는 균형 잡힌 TOC 레이아웃을 위해 \hskip2em 왼쪽 여백을 추가합니다.
6.3 👤 저자 소개 — 쓰기 전에 온라인으로 교차 검증
중요: 이 프레임을 작성하기 전에 반드시 온라인에서 저자 약력을 검색해야 합니다. 논문 PDF는 이름과 소속만 제공합니다 — 중국어 이름, 현재 직위, 주목할 만한 이전 작업, 연구실 이름 및 최근 인정을 받은 내용이 부족합니다. "칭화대학교, 제1 저자"와 같은 일반적인 항목은 허용되지 않습니다.
검색 절차 (프레임 작성 전에 실행):
xd://web_search에{"query": "<제1 저자> <기관> <논문 도메인>", "limit": 5}로 기록합니다 — 중국어 이름, 현재 역할, 이전 작업, 연구실을 얻습니다.xd://web_search에{"query": "<교신 저자 1> <기관>", "limit": 5}로 기록합니다 — 각 교신 저자에 대해 동일하게 수행합니다.- 저자당 최소 2개의 출처를 교차 참조합니다. 개인 홈페이지나 Google Scholar를 선호합니다.
- 또한
xd://web_search에{"query": "<기관> <연구실/교수> <도메인>", "limit": 5}로 연구실 맥락을 검색합니다.
검색 결과에서 추출할 내용:
- 중국어 이름 (논문 PDF에는 종종 한자가 없음)
- 현재 직위 (조교수? 박사 과정 학생? 산업체? 논문 소속은 최신이 아닐 수 있음)
- 주목할 만한 이전 작업 (이 사람이 무엇으로 유명한가? 예: MAPPO, RLinf, GRPO)
- 연구실 / 그룹 이름 (예: EDI Lab, NICS-EFC, RAIL)
- 최근 인정 사항 (주요 학회 논문, 수상, 리더십 역할)
전보 스타일의 출처가 명시된 약력으로 프레임을 채웁니다:
\begin{frame}{作者介绍}
\begin{block}{核心作者}
\begin{itemize}
\item \shl{<제1 저자>}(<중국어 이름>):<학과>, <역할>。\keyword{<이전 작업>}(으)로 유명함. 본 논문에서 <역할>.
\item 공동 저자는 <기관> 출신으로, <설명> 팀을 구성함.
\end{itemize}
\end{block}
\tightgap
\begin{block}{通讯作者}
\begin{itemize}
\item \shl{<교신 1>}(<중국어 이름>):<직위> @ <기관>, <연구실> PI. 연구 방향: \keyword{<f1>}、\keyword{<f2>}. <주목할 작업>. 본 논문 <역할>.
\item \shl{<교신 2>}(<중국어 이름>):<직위> @ <기관>, <연구실>. <주목할 작업>. 본 논문 <역할>.
\end{itemize}
\end{block}
\tightgap
\begin{callout}[研究脉络]
<본 논문으로 이어지는 팀의 궤적>。
\end{callout}
\end{frame}
6.4 📋 배경 및 동기
템플릿의 研究背景与动机 섹션에 매핑합니다:
\section앞에\renewcommand{\secblurb}{…}(한 문장 요약)을 설정합니다.- 초록/서론에서 얻은 전보 스타일의 동기로 글머리 기호 플레이스홀더를 채웁니다.
- 그림을 이 콘텐츠 슬라이드 다음의 전용
[plain,c]슬라이드로 이동합니다:\fitfigure{fig1_overview.jpg}+\figcap{1}{caption}.\begin{columns}래퍼를 제거합니다 — 이 슬라이드는 텍스트 전용으로 유지됩니다. \metric{…}{…}를 논문의 최대 3개 주요 숫자로 채웁니다.
6.5 관련 연구
相关工作 섹션에 매핑합니다:
- 논문의 관련 연구 섹션에서 연구 영역을 채웁니다.
- 실제 기준 방법과 그 관계를 나열합니다.
- 콜아웃에서 핵심 차별점을 명시합니다.
논문에 명확한 "Related Work" 섹션이 있으면 사용합니다. 그렇지 않으면 서론에 흩어져 있는 참조에서 압축합니다.
6.6 🔧 방법
方法 섹션에 매핑합니다 (2개 프레임: 개요 + 핵심 설계).
프레임 1 (개요):
- 논문의 방법 섹션에서 시스템 구성 요소를 나열합니다.
- 그림을 이 콘텐츠 슬라이드 다음의 전용
[plain,c]슬라이드로 이동합니다:\fitfigure{fig2_system.jpg}+\figcap{2}{caption}.\begin{columns}래퍼를 제거합니다.
프레임 2 (핵심 설계):
- 최대 4개의 핵심 설계 요소를 나열합니다.
- 콜아웃에 한 줄 요점을 추가합니다.
6.7 🧪 실험 설계
实验设计 섹션에 매핑합니다:
- 작업 범주/데이터셋을 나열합니다.
- 평가 프로토콜과 기준선을 명시합니다.
- 그림을 이 콘텐츠 슬라이드 다음의 전용
[plain,c]슬라이드로 이동합니다:\fitfigure{fig3_tasks.jpg}+\figcap{3}{caption}.\begin{columns}래퍼를 제거합니다.
6.8 📈 결과 및 분석
实验结果 섹션에 매핑합니다 (2개 프레임: 메인 표 + 분석).
프레임 1 (메인 표):
- 논문의 실제 데이터로 표를 재생성합니다.
- 5열 이하, 6행 이하로 유지합니다.
\shl{…}로 최고 결과를 강조 표시합니다.booktabs와 함께\theadrow,\altrow,\thc{…}를 사용합니다.- 콜아웃에 한 줄 결론을 추가합니다.
프레임 2 (분석):
- 글머리 기호 분석 (3-4개 관찰 사항).
- 분석 글머리 기호 다음의 전용
[plain,c]슬라이드에 분석 그림을 배치합니다.
6.9 💡 요점 요약
要点总结 섹션에 매핑합니다 ("핵심 기여"에 해당):
- 3개의 열거된 핵심 요점.
- 콜아웃에 한 문장 요약.
6.10 ⚠️ 한계 및 논의
局限性 섹션에 매핑합니다:
- 3-4가지 한계.
- 저자가 식별한 미래 방향을 콜아웃에 제시합니다.
6.11 📚 참고 문헌
参考文献 프레임에 매핑합니다:
bibitem항목을 논문의 실제 참고 문헌으로 채웁니다.- 첫 번째
bibitem은 논문 자체여야 합니다 ((本文)로 표시). - 3-5개의 주요 기준선을 포함합니다.
6.12 💬 Q&A
Q&A 프레임의 플레이스홀더 텍스트를 다음으로 대체합니다:
- 발표자 이름, 기관, 연락처 정보.
Q&A스타일을 유지합니다 (\fontsize{40}{44}등).
6.13 그림 처리
그림이 필요한 모든 플레이스홀더에 대해:
- TeX 소스 사용 가능 (권장):
paper_src/figures/에서slides-beamer/figures/로 의미 있는 이름(fig1_overview.pdf,fig2_system.pdf등)으로 그림을 복사합니다. TeX 소스는 벡터.pdf그림을 사용합니다 — 품질이 우수합니다. - Markdown 사용 가능:
md_output/<name>/auto/images/에서 이미지를 나열합니다. 각각은 해시 이름이 붙은.jpg입니다.inspect_image로 검사하거나 markdown의참조에서 관련 그림을 선택합니다. 콘텐츠 프레임에서 그림이 텍스트와 공간을 공유하는 경우에만 해당됩니다. - 그림을 자체 전용 슬라이드에 배치합니다 — 절대
\begin{columns}블록 내부에 배치하지 마십시오:\begin{frame}[plain,c] \centering \includegraphics[height=0.92\textheight,width=\textwidth,keepaspectratio]{filename} \figcap{N}{캡션 텍스트} \end{frame}
그림이 없거나 캡처할 수 없는 경우, 대신 플레이스홀더 콜아웃을 삽입합니다
(\phfig 헬퍼는 6.0에서 삭제되었으므로 참조하지 마십시오)
7단계 — 컴파일
첫 번째 컴파일:
# cwd: 논문 공유/<DIR_NAME>/slides-beamer
latexmk -pdf main.tex
오버플로우 검사: latexmk 출력에서 Overfull \hbox 및 Overfull \vbox를 확인합니다.
발견된 각 오버플로우에 대해 일반적인 수정을 적용합니다:
- 표 너비 오버플로우:
\footnotesize로 스위치하거나\small사용, 또는 열을 하나 제거합니다. - 텍스트 오버플로우: 텍스트를 15-20% 줄이거나 한 항목을 제거합니다. 인라인 수학을
\displaystyle에서 $\textstyle$로 변경합니다. - 블록 오버플로우: 한 블록을 콜아웃으로 변경하거나 제거합니다.
수정한 후 재컴파일합니다:
# cwd: 논문 공유/<DIR_NAME>/slides-beamer
latexmk -pdf main.tex
최종 출력은 논문 공유/<DIR_NAME>/slides-beamer/main.pdf입니다.