자사 위키(BizSpring Wiki) — Content Launcher (콘텐츠 런처)
자사 위키(BizSpring Wiki) 개요 — 자사 위키 게시 자사 위키 사이트(예: wiki.bizspring.co.kr)에 콘텐츠를 게시합니다. 방식 : GitHub 저장소의 콘텐츠 디렉토리에 Markdown 파일을 commit → Cloudflare Pages가 자동 빌드·배포
핵심 요약
# 자사 위키(BizSpring Wiki)
개요 — 자사 위키 게시
자사 위키 사이트(예: wiki.bizspring.co.kr)에 콘텐츠를 게시합니다.
방식: GitHub 저장소의 콘텐츠 디렉토리에 Markdown 파일을 commit → Cloudflare Pages가 자동 빌드·배포.
장점: 완전한 통제, B-TCR 측정 가능, Schema.org 마크업 자동 삽입, AI 청중(llms.txt, MCP)도 함께 발사.
필수 필드 — 필수 필드 안내
- GitHub 저장소: 콘텐츠가 저장될 repo (예:
bizspring-inc/wiki-content). - GitHub PAT: 콘텐츠 push 권한 토큰. 권장 권한:
repo만 부여, 만료 90일. - 콘텐츠 디렉토리: repo 내부 경로. 예:
content/faq/또는content/articles/. - 사이트 URL 베이스: 게시된 페이지의 canonical URL 베이스.
토큰/인증 발급 — GitHub PAT 발급 방법
- GitHub 우상단 프로필 → Settings.
- 좌측 하단 Developer settings 클릭.
- Personal access tokens → Fine-grained tokens 선택.
- Generate new token 클릭.
- 이름:
Content Launcher · Wiki, 만료: 90 days. - Resource owner: 본인 또는 조직.
- Repository access: Only select repositories → 콘텐츠 repo 선택.
- Permissions → Repository permissions → Contents: Read and write.
- Generate token → 발급된
ghp_...토큰 복사하여 위 필드에 붙여넣기.
> ⚠️ 토큰은 발급 직후 한 번만 보입니다. 즉시 저장하세요.
자주 발생하는 오류 — 자주 발생하는 오류
403 Resource not accessible by personal access token: PAT 권한 부족 → Contents Read/Write 재확인.404 Not Found: 저장소 경로 오타 또는 PAT가 해당 repo 접근 안 됨.- 빌드는 됐는데 페이지가 안 보임: Cloudflare Pages 빌드 로그 확인. frontmatter 누락 가능.
- 이미지가 깨짐: 이미지 자산이 외부 URL인지 확인. repo 내부 이미지는 별도 commit 필요.
권장 사항 — 권장 사항
- 만료 90일 PAT을 사용하고 만료 14일 전 자동 알림.
- 콘텐츠 디렉토리는 카테고리별로 나눠서:
content/faq/,content/articles/,content/case/. - 페이지 파일명은 영문 슬러그 사용 (한글 URL은 SEO에 불리).
- 최소 1개의 데이터 테이블 + 1개의 차트(SVG)를 포함하면 B-TCR 점수 상승.