2026-10-25 사이트의 태그 링크, 표와 그림 손보기

(← 2026-10-25-01-site-titles-mvp) 메인테이너가 “잠깐 들렸어요”로 시작한 짧은 세션이다. inbox의 네 항목만 처리했다.

inbox 원문

메인테이너가 결과를 보고 “이대로 됐어요”라고 해서 원문을 그대로 옮기고 inbox에서 지웠다.

5. 질문/요청

  • Quartz 퍼블리싱 페이지는 P0 같은 태그는 링크를 안 만드나요?

6. 기타

  • 결정 패키지 설명을 표로
  • 여러 블록 선택 자동 확장 예시를 클릭해서 펼치기로 만들 필요가 있나요? 그리고 예시 자체도 텍스트라 잘 이해가 안 갑니다.
  • 셸 (shell) 다이어그램을 텍스트로 그리면 독자 환경에 따라 헝클어져서 알아보기 힘든 경우도 있습니다. 혹시 mermaid로 좋은 방법이 있나요? 없다면 svg로라도 해주세요.

한 일

  1. 본문 태그를 링크로. 2026-10-18에 사이트를 펴낼 때 본문의 #P0을 일부러 글자로 두었다. 켜고 빌드해 보니 두 겹 아래 폴더(docs/01-requirements/)에서 링크가 ../.././../tags/P0로 사이트 밖을 가리켰다. 원인: Quartz가 태그 링크를 지금 문서 기준 주소로 만드는데, 뒤의 CrawlLinks가 그것을 사이트 맨 위 기준으로 보고 ../..를 또 붙인다. 태그 링크를 맨 위 기준(tags/P0)으로 만들게 site/patch-quartz.mjs에 패치를 더하고 켰다. 조사가 붙는 문제(#P0은)는 글 속의 우선순위를 코드 표기로 쓰는 규칙(CLAUDE.md, 2026-10-25)으로 이미 사라져 있었다(남은 것은 모두 코드 표기 안). → DR-0013 이후 변경, [[github-pages-site#본문의 #P0이 링크가 되기까지]]
  2. ADR-0002의 패키지 목록을 표로. 승인된 ADR이지만 메인테이너의 요청이고 글은 그대로라 모양만 바꾸고, 이후 변경 콜아웃에 적었다.
  3. 자동 확장 예시를 그림으로. 프로토타입에 예시 문서를 넣고 찍었다(journal/assets/2026-10-25-multiselect-shots.mjs, 그림 docs/02-ux-design/assets/interaction-multiselect-1.png · -2.png). 그림이 있으면 짧아서 접지 않고 펼쳤다. 메인테이너의 요청으로 두 번 고쳤다.
    • “while 안에 c외에 블록을 하나 더 넣고 c를 shift+클릭하는 것으로” → While 안을 C · D로. 클릭하지 않은 D도 함께 골라짐이 보인다
    • “왼쪽 다이어그램에서 C를 선택했음을 표시 해주면 좋겠어요 마우스 포인터라든지” → 포인터와 “Shift+클릭” 딱지를 얹음. 딱지 바탕은 고른 표시의 주황과 헷갈리지 않게 짙은 회색
  4. 셸 그림을 Mermaid로. flowchart TB에 셸마다 subgraph(안은 direction TB, 두 상자를 보이지 않는 선 ~~~로 이음). 처음 flowchart LR로 그렸을 때는 세 셸이 위아래로 쌓였고, 셸 이름에 할 일을 붙였을 때는 이름이 잘렸다. 그려진 순서는 웹 · 데스크톱 · Obsidian이다.

발견한 것

  • 지난 세션에 띄운 quartz build --serve가 아직 돌며 site/.quartz/public을 지운다. 이번에는 임시 폴더(QUARTZ_DIR)에서 따로 빌드했다. 메인테이너에게 꺼도 된다고 알렸다.
  • Quartz 사이트의 그림은 화면 밖에 있으면 늦게 읽혀(lazy), 헤드리스로 찍을 때는 그 자리로 스크롤해야 보인다.
  • (#P1)처럼 괄호 바로 뒤의 태그는 Quartz가 태그로 읽지 않는다(앞에 빈칸이 있어야 함).

마무리 뒤: 문서 태그 ariadne-nsd를 지움

메인테이너: “#ariadne-nsd 태그는 왜 필요한가요? 모든 문서에 다 붙어있는 것 같은데요?”

2026-10-07 첫 커밋에서 Claude가 nsdrawing으로 붙였고(이름을 바꿀 때 따라 바뀜), 까닭은 적지 않았다. 여러 프로젝트가 섞인 볼트에서 이 프로젝트의 문서를 골라내는 쓰임인데, 볼트가 이 저장소 하나라 쓸모가 없고, 121개 문서 가운데 78개에만 붙어 있었으며, 쓰는 곳도 없었다. 사이트에서는 거의 모든 페이지에 딱지가 붙었다. 고르는 창에서 “모든 문서에서 지움(추천)“을 골라 78개 문서의 속성에서 지웠다(docs/README.md는 태그가 이것뿐이라 tags:도 지움). CLAUDE.md의 규칙을 고치고, DR-0005 · DR-0011에는 이후 변경을 달았다. 세션 기록과 타임라인 속의 옛 언급은 그때의 기록이라 두었다.

마무리 뒤: 레이아웃 설계를 어떻게 하나

메인테이너: “레이아웃 설계는 어떻게 진행하나요?” Claude가 네 단계를 제안했다: 프로토타입의 레이아웃 코드를 글로 옮김 → 빈 곳을 시안으로 하나씩 물음 → 폭 표 · 서브셋 글꼴 · 성능 스파이크 → 문서와 ADR. 메인테이너: “네, 다음 세션에 1부터 시작해 주세요”

마무리 뒤: 프로토타입은 어디까지 따라왔나, 목록에서 j k

메인테이너: “지금 프로토타입이 그동안 협의한 동작들이 다 반영됐나요?” 아니다. 정해 놓고 아직 넣지 못한 것에 2026-10-18의 결정 일곱(If 갈래 이름 고치기, Case default 오른쪽, ∅, 머리 “제목처럼”, 두 키 안내, MD1 · MD2 · MD3)과 2026-10-10~11부터 미룬 것(새 다이어그램 배치, 호출 블록의 고치는 칸 둘, 순서 바꾸기, 끌어 옮기기)이 남아 있다. Claude는 레이아웃 설계를 프로토타입의 동작이 아니라 합의한 규칙으로 쓰고, 프로토타입은 레이아웃 설계와 나란히 레이아웃에 닿는 것부터 맞추자고 추천했다.

메인테이너: “그전에 ux동작 한가지 정합시다. a, c 하면 호출 메소드 메뉴가 나오는데 j/k 로 선택을 옮기는 것으로 합시다. 그 외에는 추천을 수용합니다.”

  • 목록에서 j / k로 옮김 → K2, 03-keymap. 프로토타입에서 목록의 키 처리가 한 곳이라 r의 목록과 오른쪽 클릭 메뉴에도 넓혔다(→ 확인해 주세요)
  • 프로토타입 61번째 판: 시험 179개 통과(새로 다섯: 첫 줄, j, k로 돎, 고른 블록이 그대로, j 뒤 Enter로 둘째 Method). claude.ai의 M01도 올림(올리기 전에 살아 있는 판이 저장소의 60번째 판과 같음을 확인)
  • 추천 수용은 이번과 다음 세션에 할 것에 적음

다음 할 일

상세 설계 02-layout을 1단계(프로토타입의 규칙을 글로 옮기기)부터 → 이번과 다음 세션에 할 것