feat: 가상화 문서들 추가

2026-09-10 08:54:05 +09:00
parent e9f6a93327
commit 43e1aadef0
695 changed files with 153404 additions and 12754 deletions
@@ -160,6 +160,28 @@ SVG는 `image/svg+xml`로 올라가고 다른 이미지와 같게 다뤄진다.

 `READY`가 아닌 Asset은 게시 시 거절된다.

+### 저장소의 `.md` 에는 `:::evidence` 를 쓰지 않는다
+
+`:::evidence`는 Studio 렌더러의 구문이다. 저장소의 `.md`를 그 형태로 쓰면 편집기에서 그림이
+보이지 않고 구문이 글자로 남는다. **저장소는 읽는 형태로 쓴다.**
+
+```markdown
+![브라우저 SPA, Keycloak, Resource Server 사이에서 …](../../../final/assets/ap1-browser-bearer-flow/ap1-browser-bearer-flow.svg)
+```
+
+`alt`는 그림의 `alt`를 그대로 쓰고, 경로는 frontmatter `assets`의 `file`과 같아야 한다.
+
+Studio 로 보낼 때만 `:::evidence` 로 바꾼다. 손으로 고치지 않는다.
+
+```bash
+python3 scripts/studio-body.py <기록.md> -o /tmp/x.md      # check_body 는 이 파일에 돌린다
+python3 scripts/studio-body.py <기록.md> --body-only        # Studio 에 붙여넣을 본문
+python3 scripts/studio-body.py <기록.md> --key a=a-1a2b3c4d # 서버가 준 키로
+```
+
+Studio 파서는 상대 경로 이미지를 `unsafe image URL`로 거절하므로 `check_body.mjs`는 **바꾼
+파일**에 돌린다. 저장소 파일에 그대로 돌리면 그림 자리에서 실패한다.
+
 ## 일반 이미지

 Asset이 아닌 그림은 Markdown으로 쓴다.