#Static Site
25 편의 글
Docusaurus로 매뉴얼 만들기 #6 유지보수 — 검색, 접근성, 문서 문화
시리즈의 마지막 편입니다. Docusaurus에 검색을 제대로 붙이고, 모두가 읽을 수 있게 하는 접근성, 그리고 문서를 오래 살아 있게 하는 Docs as Code 문화까지 운영 관점을 정리하며 시리즈를 닫겠습니다.
MkDocs로 매뉴얼 만들기 #6 유지보수 — 검색, 접근성, 문서 문화
시리즈의 마지막 편입니다. Material 내장 검색을 다듬고, 모두가 읽을 수 있게 하는 접근성, 그리고 문서를 오래 살아 있게 하는 Docs as Code 문화까지 운영 관점을 정리하며 시리즈를 닫겠습니다.
Starlight로 매뉴얼 만들기 #6 유지보수 — 검색, 접근성, 문서 문화
시리즈의 마지막 편입니다. 기본 내장된 Starlight 검색을 짚고, 모두가 읽을 수 있게 하는 접근성, 그리고 문서를 오래 살아 있게 하는 Docs as Code 문화까지 운영 관점을 정리하며 시리즈를 닫겠습니다.
문서 사이트 생성기 비교 — 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가 기본 내장하고, 버전 관리는 플러그인으로 더합니다.
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 빌드를 잡고, 커스텀 도메인을 붙이는 과정을 정리하겠습니다.