for humanity

Settings

문서 폴더의 for-humanity.config.mjs. 제목, 소개, 문서 묶음 순서, status badge 설정. 설정 파일과 각 항목 모두 선택. 생략한 값은 기본값 적용.

Overview

export default {
    title: "for humanity",
    description: "사람이 읽는 문서를 위한 Markdown 문서 도구",
    navigation: ["Getting started", "Guide", "Reference", "Examples"],
    status: [
        {phrase: "확인됨", kind: "verified", date: true},
        {phrase: "확인되지 않았다", kind: "unverified"},
    ],
};

검증은 명령 시작 시 한 번. 개발 중 설정 변경은 서버 재시작 필요.

Configuration

Site

KeyUseDefault
title사이드바 이름 · 탭 제목for humanity
descriptionHTML 설명 메타데이터생략

설정을 생략하면 기본 이름 for humanity. title을 지정하면 탭·사이드바에 같은 사이트 이름 적용. 홈의 제목과 소개는 README.md에서 작성. 픽셀 얼굴은 탭의 favicon과 데스크톱 커서 옆 장식에 같은 파일 사용. 사이트 이름과 문서 목록은 왼쪽 사이드바에 텍스트로 표시. 데스크톱에서는 사이트 이름을 고정하고 아래 목록만 스크롤. 사이트 이름은 Architects Daughter Regular, 미지원 글자는 본문 폰트로 표시. 현재 문서 목차는 넓은 화면에서도 문서 목록 아래에 배치. 문서 탐색과 목차는 왼쪽 사이드바에서 함께 스크롤. 데스크톱의 본문 제목과 문서 목록 첫 묶음 라벨은 글자의 위쪽 시작선을 맞춤. 사이드바와 본문 사이의 간격은 32px이며 본문 좌우 패딩은 32px 유지. 본문 main은 양쪽 보더와 패딩을 포함해 최대 900px. 넓은 화면에서는 본문을 중앙에 배치하고, 화면이 줄어들면 오른쪽 여백부터 0까지 축소. 사이드바와 본문이 함께 들어가지 않을 때 본문 폭을 줄임. 사이드바 자체의 패딩과 세로 보더는 없음.

모바일에서는 브랜드와 메뉴 버튼만 위에 고정. 버튼을 누르면 문서 목록과 목차가 왼쪽 드로어에 표시. 닫기·Escape·배경 클릭으로 닫으며, 목차를 선택하면 드로어를 닫고 해당 제목으로 이동. JavaScript가 없으면 목록을 본문 위에서 표시.

navigation은 frontmatter의 group 이름을 읽는 순서대로 나열한 배열. 사이드바의 묶음 순서에 적용. 홈은 README.md에 작성한 내용으로 표시.

export default {
    navigation: ["Getting started", "Guide", "Reference", "Examples", "Development"],
};

하위 문서 없이도 묶음 안에 여러 페이지 배치 가능. 탐색 영역에서는 모든 묶음과 문서 링크를 표시. 문서는 이름과 1px 트리 선으로 표시. 방문 여부와 무관하게 중립색을 사용하며 현재 페이지는 진한 글·굵기 500·가로 가지선으로 구분. 같은 묶음의 시작부터 현재 문서까지 이어지는 세로 줄기도 강조. 문서 링크와 사이트 이름은 hover 시 글색·굵기를 유지하고 밑줄 표시. 문서의 가로 가지는 hover한 링크색으로 표시하고, 묶음 시작부터 해당 항목까지의 세로 경로도 함께 강조. 사이트 이름·문서 탐색·TOC·하위 TOC는 Tab 포커스에도 각 링크의 hover와 같은 밑줄·색을 사용하며 박스 테두리는 표시하지 않음. 목차는 작성한 제목과 중첩 트리로 표시하며 자동 번호 없음. 현재 절·소제목은 진한 글·굵기 500, 가로 가지와 묶음 시작부터 이어지는 세로 경로는 같은 진한 색으로 구분. 선택한 항목 아래와 다른 묶음의 선은 기본색 유지. hover·키보드 포커스에서는 탐색 중인 경로를 추가로 강조하고, 벗어나면 현재 위치의 경로만 유지. 하위 목차를 탐색하면 상위 절의 경로도 표시. 모든 소제목은 항상 표시. 한 줄 항목의 높이는 데스크톱 22px, 모바일 드로어 32px. 긴 제목이 여러 줄이 되어도 가지는 첫 줄 가운데에 연결.

Status badges

KeyValueUse
phrase비어 있지 않은 상태 문구본문에서 찾을 글
kindverified / unverified초록 / amber
date선택 boolean뒤의 YYYY-MM-DD 날짜 포함 여부

Examples

SourceResult
확인됨 2026-10-01확인됨 2026-10-01
(확인되지 않았다)확인되지 않았다
Appearance

Themes and fonts

테마는 읽는 사람의 시스템 설정에 따라 밝게·어둡게 자동 적용.

Navigation