#Static Site

25 편의 글

Docusaurus로 매뉴얼 만들기 #3 콘텐츠 작성 — 코드블록, Mermaid, admonition
3 분 소요

Docusaurus로 매뉴얼 만들기 #3 콘텐츠 작성 — 코드블록, Mermaid, admonition

문서를 읽기 좋게 만드는 세 가지 요소를 다룹니다. 제목, 줄 강조가 붙는 코드블록, 코드로 그리는 Mermaid 다이어그램, 그리고 주의, 경고를 보여 주는 admonition까지 Docusaurus에서 쓰는 법을 정리하겠습니다.

Hugo로 매뉴얼 만들기 #4 Cloudflare Pages로 배포하고 도메인 연결하기
4 분 소요

Hugo로 매뉴얼 만들기 #4 Cloudflare Pages로 배포하고 도메인 연결하기

로컬에서 만든 문서를 세상에 내보냅니다. GitHub에 올리고, Cloudflare Pages에 연결해 빌드 설정을 잡고, 커스텀 도메인을 붙이는 과정을 정리하겠습니다. Hextra의 Go 모듈과 발행일 함정까지 함께 짚습니다.

MkDocs로 매뉴얼 만들기 #3 콘텐츠 작성 — 코드블록, Mermaid, admonition
3 분 소요

MkDocs로 매뉴얼 만들기 #3 콘텐츠 작성 — 코드블록, Mermaid, admonition

문서를 읽기 좋게 만드는 세 가지 요소를 다룹니다. 제목, 줄 강조가 붙는 코드블록, 코드로 그리는 Mermaid 다이어그램, 그리고 주의, 경고를 눈에 띄게 보여 주는 admonition까지 MkDocs Material에서 쓰는 법을 정리하겠습니다.

Starlight로 매뉴얼 만들기 #3 콘텐츠 작성 — 코드블록, Mermaid, asides
3 분 소요

Starlight로 매뉴얼 만들기 #3 콘텐츠 작성 — 코드블록, Mermaid, asides

문서를 읽기 좋게 만드는 세 가지 요소를 다룹니다. 제목, 줄 강조가 붙는 코드블록, 플러그인으로 더하는 Mermaid 다이어그램, 그리고 주의, 경고를 보여 주는 asides까지 Starlight에서 쓰는 법을 정리하겠습니다.

Docusaurus로 매뉴얼 만들기 #2 사이드바와 검색 — 문서의 정보 구조 잡기
3 분 소요

Docusaurus로 매뉴얼 만들기 #2 사이드바와 검색 — 문서의 정보 구조 잡기

문서가 수십 편으로 늘어도 독자가 길을 잃지 않으려면 사이드바와 검색이 핵심입니다. Docusaurus에서 sidebars.js로 사이드바를 자동, 수동으로 구성하고, 검색을 붙이는 선택지를 정리하겠습니다.

Hugo로 매뉴얼 만들기 #3 콘텐츠 작성 — 코드블록, Mermaid, 콜아웃
3 분 소요

Hugo로 매뉴얼 만들기 #3 콘텐츠 작성 — 코드블록, Mermaid, 콜아웃

문서를 읽기 좋게 만드는 세 가지 요소를 다룹니다. 파일명, 줄 강조가 붙는 코드블록, 코드로 그리는 Mermaid 다이어그램, 그리고 주의, 경고를 눈에 띄게 보여 주는 콜아웃까지 Hextra에서 쓰는 법을 정리하겠습니다.

MkDocs로 매뉴얼 만들기 #2 nav와 검색 — 문서의 정보 구조 잡기
3 분 소요

MkDocs로 매뉴얼 만들기 #2 nav와 검색 — 문서의 정보 구조 잡기

문서가 수십 편으로 늘어도 독자가 길을 잃지 않으려면 사이드바와 검색이 핵심입니다. MkDocs에서 nav를 mkdocs.yml에 직접 설계하고, Material의 내비게이션 기능과 내장 검색을 켜는 데까지 정리하겠습니다.

Starlight로 매뉴얼 만들기 #2 사이드바와 검색 — 문서의 정보 구조 잡기
2 분 소요

Starlight로 매뉴얼 만들기 #2 사이드바와 검색 — 문서의 정보 구조 잡기

문서가 수십 편으로 늘어도 독자가 길을 잃지 않으려면 사이드바와 검색이 핵심입니다. Starlight에서 사이드바를 자동, 수동으로 구성하고, 기본 내장된 검색을 살펴보겠습니다.

Docusaurus로 매뉴얼 만들기 #1 설치부터 첫 문서까지
3 분 소요

Docusaurus로 매뉴얼 만들기 #1 설치부터 첫 문서까지

Docusaurus로 팀 문서, 제품 매뉴얼 사이트의 뼈대를 세웁니다. Node.js 준비부터 create-docusaurus로 사이트를 생성하고, 개발 서버로 첫 문서를 띄우는 데까지 한 번에 진행하겠습니다.

Hugo로 매뉴얼 만들기 #2 사이드바와 검색 — 문서의 정보 구조 잡기
4 분 소요

Hugo로 매뉴얼 만들기 #2 사이드바와 검색 — 문서의 정보 구조 잡기

문서가 수십 편으로 늘어도 독자가 길을 잃지 않으려면 사이드바와 검색이 핵심입니다. Hextra에서 폴더 구조로 사이드바 위계를 잡고, weight로 순서를 정하고, 상단 메뉴와 내장 검색을 붙이는 데까지 정리하겠습니다.

MkDocs로 매뉴얼 만들기 #1 설치부터 첫 문서까지
4 분 소요

MkDocs로 매뉴얼 만들기 #1 설치부터 첫 문서까지

MkDocs와 Material 테마로 팀 문서, 제품 매뉴얼 사이트의 뼈대를 세웁니다. Python 가상환경에 설치하는 것부터 새 사이트 생성, 테마 적용, 로컬 서버로 첫 문서를 띄우는 데까지 한 번에 진행하겠습니다.

Starlight로 매뉴얼 만들기 #1 설치부터 첫 문서까지
3 분 소요

Starlight로 매뉴얼 만들기 #1 설치부터 첫 문서까지

Astro의 Starlight로 팀 문서, 제품 매뉴얼 사이트의 뼈대를 세웁니다. Node.js 준비부터 create astro로 사이트를 생성하고, 개발 서버로 첫 문서를 띄우는 데까지 한 번에 진행하겠습니다.