NixOS Manual (로컬 사본)

NixOS 25.11 stable("Xantusia") 매뉴얼의 CommonMark 소스. nixpkgs nixos-25.11 브랜치의 nixos/doc/manual/ 디렉토리를 그대로 복사한 것.

온라인 렌더링: https://nixos.org/manual/nixos/stable/
상위: https://github.com/NixOS/nixpkgs/tree/nixos-25.11/nixos/doc/manual
가져온 날짜: 2026-04-08
로컬 위치: ~/obsidian/reference/nixos-manual/

구조

디렉토리 / 파일	내용
`manual.md`	매뉴얼 루트(목차)
`preface.md`	머리말
`installation/`	설치(하드웨어, 부트로더, 프로비저닝)
`configuration/`	시스템 설정(모듈, 옵션, 사용자, 네트워킹, 부트, X11, Wayland 등)
`administration/`	운영(서비스 관리, 컨테이너, 업그레이드, 트러블슈팅)
`development/`	개발(모듈 작성, 옵션 정의, 테스트, 패키지 추가, 빌드 시스템)
`release-notes/`	릴리스 노트 (각 NixOS 버전별 변경)
`nixos-options.md`	옵션 카탈로그 안내
`contributing-to-this-manual.chapter.md`	매뉴얼 자체 기여 가이드
`redirects.json`	매뉴얼 URL 리다이렉트 매핑
`default.nix`, `common.nix`, `shell.nix`, `README.md`	매뉴얼 빌드 인프라 (참고용, NixOS 사용에는 직접 필요 없음)

빠른 진입

처음 NixOS를 보는 사람: manual.md → installation/ → configuration/
운영 중인 노드 다루는 사람: administration/ + release-notes/rl-2511.section.md
모듈 만들고 싶은 사람: development/writing-nixos-modules.section.md
옵션 검색은 온라인이 더 빠름: https://search.nixos.org/options?channel=25.11

갱신 방법

새 stable 출시 시 (예: 26.05) 같은 방식으로 sparse clone 후 덮어쓰기:

cd /tmp && rm -rf nixpkgs-manual-fetch
git clone --depth=1 --filter=blob:none --sparse \
  --branch nixos-26.05 https://github.com/NixOS/nixpkgs.git nixpkgs-manual-fetch
cd nixpkgs-manual-fetch && git sparse-checkout set nixos/doc/manual
rm -rf ~/obsidian/reference/nixos-manual/{administration,configuration,development,installation,release-notes,*.md,*.nix,*.json}
cp -R /tmp/nixpkgs-manual-fetch/nixos/doc/manual/. ~/obsidian/reference/nixos-manual/
# _index.md(이 파일)는 보존

주의

파일은 CommonMark + MyST 확장이라 일반 markdown 렌더러는 일부 directive({.note}, :::, {=include})를 제대로 보여주지 않을 수 있음. Obsidian 기본 뷰에서는 코드블럭처럼 보일 수 있음.
옵션 카탈로그(nixos-options.md)는 빌드 시 자동 생성되는 placeholder. 실제 옵션 검색은 https://search.nixos.org/options 사용.
빌드 인프라 파일(default.nix, common.nix, shell.nix)은 manual을 PDF/HTML로 빌드할 때만 필요.
향후 zlambda 같은 NixOS 노드 운영 시 빠른 참조용.

3.2 KiB Raw Blame History

NixOS Manual (로컬 사본)

구조

빠른 진입

갱신 방법

주의

관련 문서

3.2 KiB

Raw Blame History