wikidocs-mirror

name	wikidocs-mirror
description	가든 퍼블리시 때 위키독스 라이브 URL을 스냅샷으로 거둬 WikiDocs ↗ 를 붙인다. 정본은 가든, garden2wikidocs는 서브. 서브를 열어 링크를 만들지 않는다. Triggers: '위키독스 링크', 'WikiDocs ↗', '스냅샷 가져와', 'wikidocs-map', '어쏠로그 버튼', 'mapping import'.

가든 ↔ WikiDocs (가든 면)

정책 SSOT는 docs/WIKIDOCS_MIRROR.md. 이 스킬은 다음 가든 퍼블리시 손잡이다.

가든이 정본이다. 서브(garden2wikidocs)가 가든을 가져가 위키독스 페이지와 page_id를 만들어 둔다. 가든은 그 리포를 열어 링크를 만들지 않는다. 다음 텀에 퍼블리시할 때 「만들어 놨네」 하고 스냅샷만 거둬 붙인다.

이번 사이클에 버튼이 없어도 정상이다. 회수·위키독스 동기화는 서브의 다음 판이 한다.

퍼블리시 텀에서 하는 일

형제 체크아웃 ~/repos/gh/garden2wikidocs 의 mapping.json + TOC.md 를 읽는다. Netlify는 이 스크립트를 안 돌린다.

node scripts/sync-wikidocs-map.mjs
node scripts/sync-wikidocs-map.mjs --check

확인:

• _meta.schemaVersion 이 2
• 라이브 TOC만 들어 있다 (본문 + 표지 6). 2238행 풀미러가 다시 오면 실패다
• 표본이 서브의 라이브 URL과 같다. 예: 20230725T102900 → https://wikidocs.net/419348

스냅샷이 바뀌었으면 커밋은 GLG 승인 뒤에. 본문 MD는 안 건드린다. run.sh 는 GLG가 본다. 요청 없이 export/빌드 검증을 하지 않는다.

버튼이 없어도 가든을 막지 않는다

코어는 autholog ∪ botlog 다. 저널·서지 개별 글은 위키독스 페이지가 없다.

• 코어가 아니면 버튼 없음이 맞다
• 코어인데 스냅샷에 없으면 서브가 아직 회수하지 않은 것이다. 여기서 회수하지 않는다. 다음 퍼블리시 텀에 import 하면 붙는다
• 스냅샷 URL과 사이트가 다르면 import가 낡은 것이다. 다시 거두면 된다

JSON-LD sameAs 는 달지 않는다. Org/content/ 를 미러 때문에 고치지 않는다.

하지 말 것

• garden2wikidocs 를 열어 pages/ 를 고치거나 링크를 만들기
• 이 리포에서 recover.py / status.py / build.py / WIKIDOCS_TOKEN
• mapping.json 전체(죽은 page_id 포함)를 스냅샷에 넣기
• 위키독스 HTTP HEAD (가든 빌드·Netlify 금지)
• 버튼 없다고 가든 배포를 멈추기