#프레임워크
129 편의 글
문서 사이트 생성기 비교 — Hugo, MkDocs, Docusaurus, Starlight 중 무엇을 고를까
팀 문서를 정적 사이트로 만들기로 했다면, 다음 질문은 어떤 도구로 만들 것인가입니다. Hugo, MkDocs, Docusaurus, Starlight 네 가지를 런타임, 검색, 버전 관리, 확장성 기준으로 비교하고, 상황별로 무엇을 고르면 되는지 정리하겠습니다.
Docusaurus로 매뉴얼 만들기 #5 다국어와 버전 관리
하나의 문서를 여러 언어로 제공하고, 제품 버전이 올라갈 때 옛 문서를 함께 유지하는 법을 다룹니다. 다국어와 버전 관리를 모두 기본 기능으로 갖춘, Docusaurus가 가장 강한 영역입니다.
Hugo로 매뉴얼 만들기 #6 유지보수 — 검색 색인, 접근성, 문서 문화
시리즈의 마지막 편입니다. 규모가 커진 문서를 위한 Pagefind 검색 색인, 모두가 읽을 수 있게 하는 접근성, 그리고 문서를 오래 살아 있게 하는 Docs as Code 문화까지 운영 관점을 정리하며 시리즈를 닫겠습니다.
MkDocs로 매뉴얼 만들기 #5 다국어와 버전 관리
하나의 문서를 여러 언어로 제공하고, 제품 버전이 올라갈 때 옛 문서를 함께 유지하는 법을 다룹니다. mkdocs-static-i18n 플러그인으로 다국어를, mike로 버전 스냅샷과 버전 선택기를 붙이는 데까지 정리하겠습니다.
Starlight로 매뉴얼 만들기 #5 다국어와 버전 관리
하나의 문서를 여러 언어로 제공하고, 제품 버전이 올라갈 때 옛 문서를 함께 유지하는 법을 다룹니다. 다국어는 Starlight가 기본 내장하고, 버전 관리는 플러그인으로 더합니다.
리액트 상태 관리 심화 #4 Jotai와 원자(atom) 모델
상태를 하나의 스토어가 아니라 작은 원자로 쪼개 조립하는 Jotai의 상향식 모델을 다룹니다. 원자, 파생 원자, useAtom의 동작과 Zustand와의 차이를 정리합니다.
Docusaurus로 매뉴얼 만들기 #4 Cloudflare Pages로 배포하고 도메인 연결하기
로컬에서 만든 문서를 세상에 내보냅니다. GitHub에 올리고, Cloudflare Pages에 연결해 Node 빌드를 잡고, 커스텀 도메인을 붙이는 과정을 정리하겠습니다. Docusaurus 기본 배포인 deploy 명령도 함께 짚습니다.
Hugo로 매뉴얼 만들기 #5 다국어와 버전 관리
하나의 문서를 여러 언어로 제공하고, 제품 버전이 올라갈 때 옛 문서를 함께 유지하는 법을 다룹니다. Hugo의 다국어 설정과 번역 연결, 그리고 Hugo에 기본 기능이 없는 버전 관리를 폴더로 푸는 현실적인 방법을 정리하겠습니다.
MkDocs로 매뉴얼 만들기 #4 Cloudflare Pages로 배포하고 도메인 연결하기
로컬에서 만든 문서를 세상에 내보냅니다. requirements.txt로 의존성을 고정하고, GitHub에 올려 Cloudflare Pages에 연결하고, 커스텀 도메인을 붙이는 과정을 정리하겠습니다. MkDocs 기본 배포인 gh-deploy도 함께 짚습니다.
Starlight로 매뉴얼 만들기 #4 Cloudflare Pages로 배포하고 도메인 연결하기
로컬에서 만든 문서를 세상에 내보냅니다. GitHub에 올리고, Cloudflare Pages에 연결해 Astro 빌드를 잡고, 커스텀 도메인을 붙이는 과정을 정리하겠습니다.
리액트 상태 관리 심화 #3 Zustand로 다루는 가벼운 클라이언트 상태
Provider 없이, 최소한의 보일러플레이트로 전역 클라이언트 상태를 공유하는 Zustand를 다룹니다. 스토어 생성, 셀렉터로 리렌더 최적화, persist 미들웨어까지 정리합니다.
Docusaurus로 매뉴얼 만들기 #3 콘텐츠 작성 — 코드블록, Mermaid, admonition
문서를 읽기 좋게 만드는 세 가지 요소를 다룹니다. 제목, 줄 강조가 붙는 코드블록, 코드로 그리는 Mermaid 다이어그램, 그리고 주의, 경고를 보여 주는 admonition까지 Docusaurus에서 쓰는 법을 정리하겠습니다.