[jsshin2022]

Status

Review Required

Description

README 정리, 방문자 분석 연결, 웹북 검색과 탐색 개선을 담았습니다.

용어집

• 용어집 페이지 추가: 번역 가이드 용어표로 빌드할 때마다 자동 생성. 용어마다 원어, 다른 표기(처치군, 통제군, 띄어 쓴 표기 등), 그 용어를 주로 다루는 장 링크를 붙임. 예전 표기나 띄어 쓴 표기(예: 도구 변수)로 검색해도 이 페이지가 걸립니다
• 용어마다 고유 주소(glossary.html#term-실험군 등)가 있어 링크로 공유 가능
• 번역 가이드에 온라인 실험 용어 22개 추가(A/B 테스트, 가드레일 지표, 최소 검출 효과, 표본 비율 불일치, 신기 효과 등). 리뷰 부탁드립니다
• 용어 제안용 이슈 템플릿(.github/ISSUE_TEMPLATE/term-proposal.yml) 추가, 용어집에서 바로 연결
• 들어가며 '이 책의 구성'에 용어집 카드 추가

검색

• 검색 옵션: 결과 50개까지, 문서당 3개 뒤 접기, 결과에 장·절 경로 표시, 단축키 /·k
• 검색 미리보기 정리: \(Y_1 \perp T\) 같은 TeX 원문을 Y_1 ⊥ T로, 경로에 찍히던 <span class='chapter-number'> HTML 제거(book/postrender.py)
• 검색 결과 창을 넓혀 미리보기가 잘리지 않게 함
• 검색엔진: 장마다 첫 문단을 description으로 넣어 검색 결과·공유 카드 설명으로 사용. robots.txt에 사이트맵 연결

목차와 이 장의 내용

• 왼쪽 목차: 태블릿 폭(768~991px)에서도 접지 않고 항상 보이게. 휴대폰에서는 목차 버튼에 '목차' 글자 표시
• 이 장의 내용: 오른쪽 목차가 사라지는 좁은 화면에서는 장 첫머리에 펼친 상태로 표시
• 목차 섹션 기본 펼침(collapse-level: 3)

README

• 배너 이미지(누르면 웹북)와 버튼 4개(웹북에서 1장부터 읽기, 원서, 도서, 강의)를 각각 링크로 분리. README에서는 스크립트가 동작하지 않아 버튼을 이미지 링크로 만들었습니다
• Stars, Forks, PR, Issues, Contributors, 웹북 빌드 상태 배지 추가. 기존 DOI 배지는 원서의 것이라 '원서 DOI'로 표기
• 상단 링크에 용어집 추가

원서 변경 알림 파이프라인

• .github/workflows/upstream-watch.yml: 매월 1일 오전 9시 17분(KST)과 수동 실행, upstream.json 변경 시 동작. 변경이 없으면 알림 없음
• .github/upstream.json: 한국어판이 맞춘 원서 커밋(4df1445, 현재 원서 최신과 같음)과 검토자(jsshin2022)
• 원서에 새 커밋이 생기면 upstream-sync 이슈를 만들어 검토자에게 배정: 새 커밋, 바뀐 장 체크리스트, 장별 본문 변경(바뀐 단어와 앞뒤 문맥), 웹북·원서 비교 링크
• 원서가 다시 바뀌면 같은 이슈를 갱신하고 댓글로 알림. 번역 PR에서 synced_sha를 올려 머지하면 이슈 자동 종료
• 원서 히스토리로 dry-run 검증(예: 2025-09 이후 변경 20개 장 감지), 이슈 생성·갱신·종료 로직은 목 객체로 확인
• 절차는 번역 가이드 5절과 README에 정리

기타

• Google Analytics 4(G-BEBVKYH8HL) 연결, IP 익명화
• actions/checkout, setup-python, upload-artifact를 최신 메이저 버전으로 올려 Node.js 20 경고 해소
• 번역 가이드에 용어표가 웹북에 자동 반영된다는 안내 추가

전 페이지 내부 링크·이미지 깨짐 0건, 모바일 가로 넘침 0건, 수식 렌더링 오류 0건을 확인했습니다.

---

Generated by Claude Code