Starlight
Starlight로 매뉴얼 만들기 #6 유지보수 — 검색, 접근성, 문서 문화
시리즈의 마지막 편입니다. 기본 내장된 Starlight 검색을 짚고, 모두가 읽을 수 있게 하는 접근성, 그리고 문서를 오래 살아 있게 하는 Docs as Code 문화까지 운영 관점을 정리하며 시리즈를 닫겠습니다.
문서 사이트 생성기 비교 — Hugo, MkDocs, Docusaurus, Starlight 중 무엇을 고를까
팀 문서를 정적 사이트로 만들기로 했다면, 다음 질문은 어떤 도구로 만들 것인가입니다. Hugo, MkDocs, Docusaurus, Starlight 네 가지를 런타임, 검색, 버전 관리, 확장성 기준으로 비교하고, 상황별로 무엇을 고르면 되는지 정리하겠습니다.
Starlight로 매뉴얼 만들기 #5 다국어와 버전 관리
하나의 문서를 여러 언어로 제공하고, 제품 버전이 올라갈 때 옛 문서를 함께 유지하는 법을 다룹니다. 다국어는 Starlight가 기본 내장하고, 버전 관리는 플러그인으로 더합니다.
Starlight로 매뉴얼 만들기 #4 Cloudflare Pages로 배포하고 도메인 연결하기
로컬에서 만든 문서를 세상에 내보냅니다. GitHub에 올리고, Cloudflare Pages에 연결해 Astro 빌드를 잡고, 커스텀 도메인을 붙이는 과정을 정리하겠습니다.
Starlight로 매뉴얼 만들기 #3 콘텐츠 작성 — 코드블록, Mermaid, asides
문서를 읽기 좋게 만드는 세 가지 요소를 다룹니다. 제목, 줄 강조가 붙는 코드블록, 플러그인으로 더하는 Mermaid 다이어그램, 그리고 주의, 경고를 보여 주는 asides까지 Starlight에서 쓰는 법을 정리하겠습니다.
Starlight로 매뉴얼 만들기 #2 사이드바와 검색 — 문서의 정보 구조 잡기
문서가 수십 편으로 늘어도 독자가 길을 잃지 않으려면 사이드바와 검색이 핵심입니다. Starlight에서 사이드바를 자동, 수동으로 구성하고, 기본 내장된 검색을 살펴보겠습니다.
Starlight로 매뉴얼 만들기 #1 설치부터 첫 문서까지
Astro의 Starlight로 팀 문서, 제품 매뉴얼 사이트의 뼈대를 세웁니다. Node.js 준비부터 create astro로 사이트를 생성하고, 개발 서버로 첫 문서를 띄우는 데까지 한 번에 진행하겠습니다.