docs: 2장부터 소단원별 페이지 분리 정리 구조 규칙 추가

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013TQnRZruUBDaE8iFeipBr5
This commit is contained in:
songyc macbook 2026-07-20 15:58:43 +09:00
parent 150f64ca69
commit 855bb64efa

View File

@ -10,7 +10,7 @@ disable-anki-sync:: true
1. **사용자 선행 학습** — 사용자가 그 단원을 먼저 혼자 공부한다 (PDF 원자료 기준). 1. **사용자 선행 학습** — 사용자가 그 단원을 먼저 혼자 공부한다 (PDF 원자료 기준).
2. **사용자 1차 하이라이트** — 공부한 내용을 바탕으로 사용자가 Logseq에서 그 단원 PDF에 하이라이트한다. **영역(area) 하이라이트와 텍스트 하이라이트가 섞여 있을 수 있다.** 본문 핵심 부분과 함께, **풀어볼 가치가 있다고 판단한 연습문제에도 하이라이트**한다 (2장부터 적용). 2. **사용자 1차 하이라이트** — 공부한 내용을 바탕으로 사용자가 Logseq에서 그 단원 PDF에 하이라이트한다. **영역(area) 하이라이트와 텍스트 하이라이트가 섞여 있을 수 있다.** 본문 핵심 부분과 함께, **풀어볼 가치가 있다고 판단한 연습문제에도 하이라이트**한다 (2장부터 적용).
3. **Claude 정리** — 책 내용과 사용자의 하이라이트를 바탕으로 단원 페이지에 정리를 작성한다. 사용자가 만든 하이라이트는 종류별 형식으로 정리 본문의 해당 위치에 포함한다 — **영역 하이라이트는 링크 + 추출 이미지, 텍스트 하이라이트는 `((uuid))` 참조 + 정리 비중 반영** (아래 「PDF 하이라이트·이미지 활용」 참고). **하이라이트된 연습문제는 절별 「✏️ 연습문제 풀이」에 포함**하고 해답집(solution PDF)을 참고해 해설을 단다. **문제가 그림·도표를 참조하면 그 이미지를 PDF에서 캡처(추출)해 문제 블록에 함께 임베드한다** (2장부터 적용, 파일명·추출 방법은 아래 「PDF 이미지 추출·임베드」 규칙을 따름). 3. **Claude 정리** — 책 내용과 사용자의 하이라이트를 바탕으로 정리를 작성한다. **2장부터는 단원 페이지에 서론 정리 + 소단원 페이지 링크만 두고, 각 소단원(x.y절)은 별도 페이지에 정리한다** (아래 「정리 스타일」 참고). 사용자가 만든 하이라이트는 종류별 형식으로 정리 본문의 해당 위치에 포함한다 — **영역 하이라이트는 링크 + 추출 이미지, 텍스트 하이라이트는 `((uuid))` 참조 + 정리 비중 반영** (아래 「PDF 하이라이트·이미지 활용」 참고). **하이라이트된 연습문제는 절별 「✏️ 연습문제 풀이」에 포함**하고 해답집(solution PDF)을 참고해 해설을 단다. **문제가 그림·도표를 참조하면 그 이미지를 PDF에서 캡처(추출)해 문제 블록에 함께 임베드한다** (2장부터 적용, 파일명·추출 방법은 아래 「PDF 이미지 추출·임베드」 규칙을 따름).
4. **추가 하이라이트 제안** — 정리하면서 Claude 판단에 원문 링크가 더 필요한 부분이 있으면, 정리 완료 보고에 **하이라이트 요청 목록**(쪽 번호 + 부분)을 담아 제안한다. 사용자가 고른 것 외에 **추가로 추천할 연습문제가 있으면 "x.y절 문제 n번 — 추천 이유"** 형식으로 이 목록에 함께 담는다. 4. **추가 하이라이트 제안** — 정리하면서 Claude 판단에 원문 링크가 더 필요한 부분이 있으면, 정리 완료 보고에 **하이라이트 요청 목록**(쪽 번호 + 부분)을 담아 제안한다. 사용자가 고른 것 외에 **추가로 추천할 연습문제가 있으면 "x.y절 문제 n번 — 추천 이유"** 형식으로 이 목록에 함께 담는다.
5. **사용자 2차 하이라이트 → Claude 다듬기** — 사용자가 제안을 (자기 판단으로 취사선택하여) 하이라이트하고 알려주면, Claude가 hls 페이지에서 새 uuid를 읽어 참조를 채워 정리를 다듬는다. 5. **사용자 2차 하이라이트 → Claude 다듬기** — 사용자가 제안을 (자기 판단으로 취사선택하여) 하이라이트하고 알려주면, Claude가 hls 페이지에서 새 uuid를 읽어 참조를 채워 정리를 다듬는다.
6. **사용자 마무리** — 사용자가 직접 Anki 카드화하고 자기 방식으로 세부 수정하여 그 단원 정리를 마무리한다. 6. **사용자 마무리** — 사용자가 직접 Anki 카드화하고 자기 방식으로 세부 수정하여 그 단원 정리를 마무리한다.
@ -43,7 +43,13 @@ disable-anki-sync:: true
- 언어는 한국어. 수학·전문 용어는 필요시 영어 병기. - 언어는 한국어. 수학·전문 용어는 필요시 영어 병기.
- ## 정리 스타일 (기존 노트 기준) - ## 정리 스타일 (기존 노트 기준)
**단원(챕터) 페이지**는 `1장 벡터와 행렬` 이 기준 예시다: `# n장 제목 — 정리` 아래에 절(x.y)별로 `## x.y 절 제목``### 핵심 개념` / `### ❓ 스스로 점검` / `### ✏️ 연습문제 풀이 (솔루션 참고)` 구조, 마지막에 `## n장에 대한 고찰`. **단원(챕터) 정리 구조는 2장부터 소단원 분리 방식이다** (1장은 기존 단일 페이지 그대로 둔다):
- **단원 페이지** (예: `2장 선형방정식 풀기`) — PDF 임베드 아래에 **챕터 서론(도입부) 정리**만 쓰고, 이어서 각 소단원 페이지 링크 목록(`- [[2.1 절 제목]]` 형식)을 둔다. 마지막에 `## n장에 대한 고찰`.
- **소단원 페이지** (예: `2.1 소거법`) — 소단원마다 별도 md 페이지를 만들어 그 절의 정리를 담는다: `### 핵심 개념` / `### ❓ 스스로 점검` / `### ✏️ 연습문제 풀이 (솔루션 참고)` 구조. 페이지명은 `x.y 절 제목` 형식, 최상단에 단원 페이지와 동일한 `deck::` 속성을 넣는다.
- 소단원 페이지를 만들면 단원 페이지에 링크를 추가한다 (허브 규칙과 동일).
(참고: 1장 방식 — `1장 벡터와 행렬` 한 페이지 안에 `## x.y 절 제목``### 핵심 개념` / `### ❓ 스스로 점검` / `### ✏️ 연습문제 풀이 (솔루션 참고)`, 마지막에 `## n장에 대한 고찰`.)
**개념 단위 페이지**는 `다익스트라 알고리즘` 페이지가 대표 예시. 다음 형식을 따른다: **개념 단위 페이지**는 `다익스트라 알고리즘` 페이지가 대표 예시. 다음 형식을 따른다:
@ -91,7 +97,7 @@ disable-anki-sync:: true
- **해답집**: `assets/solution_1784335983942_0.pdf` — 스트랭 6판 공식 영문 솔루션 (전 챕터). 문제 번호는 한국어판과 동일하다. 각 챕터의 "Problem Set x.y" 헤더로 위치를 찾는다 (1장 해답: PDF 2~18쪽). - **해답집**: `assets/solution_1784335983942_0.pdf` — 스트랭 6판 공식 영문 솔루션 (전 챕터). 문제 번호는 한국어판과 동일하다. 각 챕터의 "Problem Set x.y" 헤더로 위치를 찾는다 (1장 해답: PDF 2~18쪽).
- **PDF 읽는 법**: 단원 PDF는 스캔+OCR본이라 텍스트 레이어의 수식이 깨져 있다. 정리할 때는 **Read 도구로 페이지를 시각적으로 읽는다** (pdftoppm/poppler 설치됨). 이미지 추출·edn 좌표 파싱은 PyMuPDF(`import fitz`, 설치됨)를 쓴다. - **PDF 읽는 법**: 단원 PDF는 스캔+OCR본이라 텍스트 레이어의 수식이 깨져 있다. 정리할 때는 **Read 도구로 페이지를 시각적으로 읽는다** (pdftoppm/poppler 설치됨). 이미지 추출·edn 좌표 파싱은 PyMuPDF(`import fitz`, 설치됨)를 쓴다.
- **쪽번호 오프셋**: 1장 PDF는 책 쪽번호 = PDF 쪽번호 + 18. 단원 PDF마다 오프셋이 다를 수 있으니 첫 몇 쪽으로 확인할 것. - **쪽번호 오프셋**: 1장 PDF는 책 쪽번호 = PDF 쪽번호 + 18. 단원 PDF마다 오프셋이 다를 수 있으니 첫 몇 쪽으로 확인할 것.
- **진행 상황**: 1장 완료 — 정리 작성 + 사용자 area 하이라이트 11개를 「링크 + 추출 이미지」 형식으로 연결 (모바일 렌더링 문제로 `((uuid))` 임베드에서 전환). 카드화는 사용자 진행 중. 다음은 2장 (사용자 학습·하이라이트 후 요청 예정, 연습문제 하이라이트 방식 적용 첫 단원). - **진행 상황**: 1장 완료 — 정리 작성 + 사용자 area 하이라이트 11개를 「링크 + 추출 이미지」 형식으로 연결 (모바일 렌더링 문제로 `((uuid))` 임베드에서 전환). 카드화는 사용자 진행 중. 다음은 2장 (사용자 학습·하이라이트 후 요청 예정) — 연습문제 하이라이트, 문제 그림 캡처, **소단원별 페이지 분리** 방식을 처음 적용하는 단원.
- ## Logseq 앱 동기화 주의 - ## Logseq 앱 동기화 주의
- Logseq 앱이 페이지를 열어둔 상태에서 파일을 밖에서 수정하면, 앱이 캐시된 옛 블록을 표시하다가 **옛 내용을 파일에 되써버릴 수 있다** (부분 롤백 발생). - Logseq 앱이 페이지를 열어둔 상태에서 파일을 밖에서 수정하면, 앱이 캐시된 옛 블록을 표시하다가 **옛 내용을 파일에 되써버릴 수 있다** (부분 롤백 발생).
- 페이지 파일을 수정한 후에는 사용자에게 **Logseq 재색인(Re-index)** 을 안내한다. 수정 직후 "고쳤는데 그대로다"라는 피드백이 오면 파일을 다시 읽어 롤백 여부부터 확인한다. - 페이지 파일을 수정한 후에는 사용자에게 **Logseq 재색인(Re-index)** 을 안내한다. 수정 직후 "고쳤는데 그대로다"라는 피드백이 오면 파일을 다시 읽어 롤백 여부부터 확인한다.