paper-summary-wordlisted
Install: claude install-skill zoo3323/paper-summary
# paper-summary-word
논문에 등장하는 **전문 용어·약어·고유명사**(모델명·데이터셋·평가지표·수학 기호 포함)를 한국어 정의와 함께 정리한 **용어 사전 HTML 1개**(`용어사전.html`)를 만든다. 실시간 검색 필터가 내장돼 있다.
`paper-summary` 스킬의 동반 스킬이다. 보통 `paper-summary` 로 번역본·요약본을 먼저 만든 뒤 실행하지만, 단독으로도(PDF만 있어도) 동작한다.
## 폴더 구조 (현재 폴더 기준)
```
./korean/ ← 결과물 폴더 (paper-summary 와 공유)
├─ 번역본.html ← (있으면) 네비게이션에 용어사전 탭을 끼워 넣는다
├─ 요약본.html ← (���으면) 네비게이션에 용어사전 탭을 끼워 넣는다
├─ 용어사전.html ← ★ 조립기가 생성 (직접 쓰지 않는다)
├─ images/
└─ .work/ ← 숨김. 지워도 되는 찌꺼기가 아니다 (원고가 여기 있다)
├─ fulltext.txt
└─ src/ ← ★ 네가 직접 쓰는 원고
├─ meta.json
└─ glossary.html
```
---
## 번역 원칙 — 음차(발음만 한글로 옮기기) 금지 ★
동반 스킬 `paper-summary` 와 같은 원칙을 따른다. 용어 사전은 **뜻을 알려주는 문서**이므로
음차 표제어는 특히 치명적이다 — "하네스: 하네스는 …" 같은 항목은 아무것도 설명하지 못한다.
1. **표제어(`<dt>`)는 뜻이 드러나는 한국어**로 짓고, 영어 원어는 `<span class="en">` 으로 병기한다.
발음만 한글로 옮긴 표제어를 쓰지 않는다.
- 나쁨: `<dt>하네스 <span class="en">Harness</span></dt>`
- 좋음: `<dt>제어 장치 <span class="en">Harness</span></dt>`
2. **정의문(`<dd>`)에도 같은 원칙을 적용한다.** 정의 안에서 다른 음차를 끌어다 쓰면
설명이 되지 않는다. (예: "궤적" 이라고 쓰고 "트래젝토리" 라고 쓰지 않는다)
3. **마땅한 한국어가 없으면 음차 대신 영어 원문을 그대로 둔다.**
우선순위는 `한국어 번역 > 영어 원문 유지 > 음차`.
4. **고유명사는 번역하지 않는다.** 모델명(GPT-5, DeepSeek-V3), 데이터셋·벤치마크명(SWE-bench, MMLU),
기법 고유명(LoRA, Transformer)은 영문 그대로 표제어로 쓰고 정의만 한국어로 쓴다.
5. **음차형은 검색 키워드로만 살린다.** 독자가 "하네스"로 검색할 수 있으므로,
`data-terms` 에는 음차형을 **포함**시킨다. 보이는 표제어에는 쓰지 않는다.
```html
<div class="term