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