Resolved: Obsidian vault → Quartz4 호환 구조 재구성 (.→_, 개요→index) #3

New Issue

2026-05-05T21:38:28+09:00

ruki commented

2026-05-05 21:38:28 +09:00

문제 (2026-04-27 ~ 2026-05-05)

옵시디언 볼트 → Quartz4 위키 동기화 시 두가지 치명적 오류 반복:

폴더명에 . 포함 → Quartz 빌드 실패: 01.PROJECTS 등 PARA 구조의 점(.)이 파일명으로 인식되어 출력 중단
개요.md 파일명 → 404: Quartz는 폴더 진입점을 index.md로 기대하지만, 볼트 전역에 개요.md가 사용됨
링크 깨짐: 볼트 재구성 후 [[옛경로]] wikilink 가 대량 잔존

해결 (단계별)

Phase 1: 파일명 규칙 통일

모든 폴더 . → _ 치환 (01.PROJECTS → 01_PROJECTS, A.mini-happy → A_mini-happy)
모든 개요.md → index.md (또는 색인.md → index.md)
모든 README.md → 해당 폴더의 index.md 로 통합

Phase 2: PARA → JD+ACE 하이브리드 구조로 재구성

01_PROJECTS(프로젝트) → 20-29 Efforts
02_AREAS(영역) → 40-49 Areas
03_RESOURCES(자료) → 30-39 Resources
04_ARCHIVE → 90-99 Archive
00_INBOX → 00-09 Atlas

Phase 3: 링크 일괄 치환

Python 스크립트로 OLD→NEW 경로 매핑 후 [[...]] wikilink 전체 재작성

결과

폴더명 . 0개, 개요.md 0개 확인
총 .md 파일 2,042개 재구성 완료
위키 빌드/출력 정상화

회고

병렬 subagent 3개 제약으로 NAS 대용량 파일 작업 시 타임아웃 30~40% 발생 → Python stdin pipe SSH 방식으로 회피 필요
괄호 포함 경로는 SSH heredoc(<<)와 충돌 → base64 encode 또는 단일 sed 명령으로 대체

[!note] 수정이력 | 2026-04-27 ~ 2026-05-05, 루키 (hermes/subs)

## 문제 (2026-04-27 ~ 2026-05-05) 옵시디언 볼트 → Quartz4 위키 동기화 시 두가지 치명적 오류 반복: 1. **폴더명에 `.` 포함 → Quartz 빌드 실패**: `01.PROJECTS` 등 PARA 구조의 점(.)이 파일명으로 인식되어 출력 중단 2. **`개요.md` 파일명 → 404**: Quartz는 폴더 진입점을 `index.md`로 기대하지만, 볼트 전역에 `개요.md`가 사용됨 3. **링크 깨짐**: 볼트 재구성 후 `[[옛경로]]` wikilink 가 대량 잔존 ## 해결 (단계별) ### Phase 1: 파일명 규칙 통일 - 모든 폴더 `.` → `_` 치환 (`01.PROJECTS → 01_PROJECTS`, `A.mini-happy → A_mini-happy`) - 모든 `개요.md` → `index.md` (또는 `색인.md` → `index.md`) - 모든 `README.md` → 해당 폴더의 `index.md` 로 통합 ### Phase 2: PARA → JD+ACE 하이브리드 구조로 재구성 - `01_PROJECTS(프로젝트)` → `20-29 Efforts` - `02_AREAS(영역)` → `40-49 Areas` - `03_RESOURCES(자료)` → `30-39 Resources` - `04_ARCHIVE` → `90-99 Archive` - `00_INBOX` → `00-09 Atlas` ### Phase 3: 링크 일괄 치환 - Python 스크립트로 OLD→NEW 경로 매핑 후 `[[...]]` wikilink 전체 재작성 ## 결과 - 폴더명 `.` 0개, `개요.md` 0개 확인 - 총 `.md` 파일 2,042개 재구성 완료 - 위키 빌드/출력 정상화 ## 회고 - 병렬 subagent 3개 제약으로 NAS 대용량 파일 작업 시 **타임아웃 30~40%** 발생 → Python stdin pipe SSH 방식으로 회피 필요 - 괄호 포함 경로는 SSH heredoc(`<<`)와 충돌 → base64 encode 또는 단일 `sed` 명령으로 대체 > [!note] 수정이력 | 2026-04-27 ~ 2026-05-05, 루키 (hermes/subs)

ruki closed this issue

2026-05-05 21:38:28 +09:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: pinksky/minicity-agent#3