프레임워크
Hugo로 매뉴얼 만들기 #4 Cloudflare Pages로 배포하고 도메인 연결하기
로컬에서 만든 문서를 세상에 내보냅니다. GitHub에 올리고, Cloudflare Pages에 연결해 빌드 설정을 잡고, 커스텀 도메인을 붙이는 과정을 정리하겠습니다. Hextra의 Go 모듈과 발행일 함정까지 함께 짚습니다.
MkDocs로 매뉴얼 만들기 #3 콘텐츠 작성 — 코드블록, Mermaid, admonition
문서를 읽기 좋게 만드는 세 가지 요소를 다룹니다. 제목, 줄 강조가 붙는 코드블록, 코드로 그리는 Mermaid 다이어그램, 그리고 주의, 경고를 눈에 띄게 보여 주는 admonition까지 MkDocs Material에서 쓰는 법을 정리하겠습니다.
Starlight로 매뉴얼 만들기 #3 콘텐츠 작성 — 코드블록, Mermaid, asides
문서를 읽기 좋게 만드는 세 가지 요소를 다룹니다. 제목, 줄 강조가 붙는 코드블록, 플러그인으로 더하는 Mermaid 다이어그램, 그리고 주의, 경고를 보여 주는 asides까지 Starlight에서 쓰는 법을 정리하겠습니다.
리액트 상태 관리 심화 #2 TanStack Query로 다루는 서버 상태
useEffect와 useState로 짜던 데이터 페칭을 TanStack Query로 옮기면 캐싱, 재요청, 로딩과 에러 처리가 자동으로 따라옵니다. useQuery와 useMutation의 핵심을 정리합니다.
Docusaurus로 매뉴얼 만들기 #2 사이드바와 검색 — 문서의 정보 구조 잡기
문서가 수십 편으로 늘어도 독자가 길을 잃지 않으려면 사이드바와 검색이 핵심입니다. Docusaurus에서 sidebars.js로 사이드바를 자동, 수동으로 구성하고, 검색을 붙이는 선택지를 정리하겠습니다.
Hugo로 매뉴얼 만들기 #3 콘텐츠 작성 — 코드블록, Mermaid, 콜아웃
문서를 읽기 좋게 만드는 세 가지 요소를 다룹니다. 파일명, 줄 강조가 붙는 코드블록, 코드로 그리는 Mermaid 다이어그램, 그리고 주의, 경고를 눈에 띄게 보여 주는 콜아웃까지 Hextra에서 쓰는 법을 정리하겠습니다.
MkDocs로 매뉴얼 만들기 #2 nav와 검색 — 문서의 정보 구조 잡기
문서가 수십 편으로 늘어도 독자가 길을 잃지 않으려면 사이드바와 검색이 핵심입니다. MkDocs에서 nav를 mkdocs.yml에 직접 설계하고, Material의 내비게이션 기능과 내장 검색을 켜는 데까지 정리하겠습니다.
Starlight로 매뉴얼 만들기 #2 사이드바와 검색 — 문서의 정보 구조 잡기
문서가 수십 편으로 늘어도 독자가 길을 잃지 않으려면 사이드바와 검색이 핵심입니다. Starlight에서 사이드바를 자동, 수동으로 구성하고, 기본 내장된 검색을 살펴보겠습니다.
리액트 상태 관리 심화 #1 클라이언트 상태와 서버 상태의 차이
useState만으로 부족해지는 지점을 짚고, 클라이언트 상태와 서버 상태를 구분하는 멘탈 모델을 세웁니다. 상태 관리 도구 선택의 출발점입니다.
Docusaurus로 매뉴얼 만들기 #1 설치부터 첫 문서까지
Docusaurus로 팀 문서, 제품 매뉴얼 사이트의 뼈대를 세웁니다. Node.js 준비부터 create-docusaurus로 사이트를 생성하고, 개발 서버로 첫 문서를 띄우는 데까지 한 번에 진행하겠습니다.
Hugo로 매뉴얼 만들기 #2 사이드바와 검색 — 문서의 정보 구조 잡기
문서가 수십 편으로 늘어도 독자가 길을 잃지 않으려면 사이드바와 검색이 핵심입니다. Hextra에서 폴더 구조로 사이드바 위계를 잡고, weight로 순서를 정하고, 상단 메뉴와 내장 검색을 붙이는 데까지 정리하겠습니다.
MkDocs로 매뉴얼 만들기 #1 설치부터 첫 문서까지
MkDocs와 Material 테마로 팀 문서, 제품 매뉴얼 사이트의 뼈대를 세웁니다. Python 가상환경에 설치하는 것부터 새 사이트 생성, 테마 적용, 로컬 서버로 첫 문서를 띄우는 데까지 한 번에 진행하겠습니다.