Install
npm i -g mint누구에게 맞나
Mintlify 문서를 유지하면서 고친 뒤 온라인에 바로 올리지 않고 이 기기에서 먼저 보려면 이 공식 문서 저장소가 맞다. Official Mintlify documentation이다. 저장소는
https://github.com/mintlify/docs
게시된 문서 사이트는
https://mintlify.com/docs
CLI 패키지는
https://www.npmjs.com/package/mint
더 맞는 사람은 이미 docs.json가 있는 문서 디렉터리가 있고(클론한 이 저장소 또는 자신의 Mintlify 프로젝트), 이 기기에서 npm을 실행할 수 있으며, 공식 설치 명령은 npm i -g mint 하나뿐임을 받아들인다. 이것은 전역 CLI이며 스킬 마켓 패키지가 아니다. skills add로 고쳐 쓰지 말 것.
브라우저에서만 읽으려면
https://mintlify.com/docs
문서를 고치거나 로컬 미리보기를 열 생각이 없으면 CLI는 필요 없다. 처음에는 로컬 미리보기만 한다. 이 페이지에 없는 온라인 반영 명령은 실행하지 말 것. 이 페이지는 어떤 프로그래밍 클라이언트도 지명하지 않는다. 미리보기는 브라우저에서 보면 된다.
3분 만에 첫 시도
공식 설치 경로는 이것만 사용한다:
npm i -g mint
전역 설치는 이 기기의 명령줄을 바꾼다. 전역 패키지를 받아들일지 먼저 확인한다. 플러그인이나 마켓을 따로 찾지 말 것.
전제 조건: Node/npm이 설치되어 있다. 현재 작업 디렉터리는 문서 루트, 즉 docs.json가 보이는 층이다. 그 파일이 아직 없으면 공식 문서 저장소를 먼저 클론한다. 기록되지 않은 형식의 docs.json를 지어내지 말 것.
그 루트에서 다음을 실행한다:
mint dev
이것은 로컬 미리보기를 시작하며 이 기기 프로세스다. 포트가 이 기기에서만 접근되는지 확인한 뒤 실행한다. 출력한 로컬 주소를 브라우저에서 열고 문서 한 페이지가 렌더되는지 본다.
성공 신호: mint 명령을 쓸 수 있고, mint dev 후 브라우저에서 docs.json에 대응하는 문서 트리가 보이며 docs.json를 찾을 수 없다는 오류가 아닌 것. 문서 루트가 아니라고 하면 docs.json가 있는 디렉터리로 cd한 뒤 다시 실행한다. 기록되지 않은 인자는 더하지 말 것. mint가 없으면 npm i -g mint로 돌아간다. 적히지 않은 패키지 이름으로 바꾸지 말 것.
사용 사례
사례 1: Mint CLI를 설치한다. 공식은 npm i -g mint로 설치해 문서 변경을 로컬에서 미리 본다고 쓴다. 설치 후 터미널에서 mint를 실행해 명령이 PATH에 들어갔는지 확인한다. 이는 전역 부작용이다. 신뢰하지 않는 환경에 함부로 설치하지 말 것. 이 페이지에는 버전 번호나 npx mint 대체가 없다. 없으면 이 전역 설치만 사용한다.
사례 2: 문서 루트에서 미리 본다. 공식은 문서 루트(docs.json가 있는 곳)에서 mint dev를 실행한다고 쓴다. 기존 md 페이지의 제목이나 문단을 고치고 저장한 뒤 로컬 미리보기가 갱신되는지 본다. 첫 시도에서 온라인 반영 푸시를 하지 말 것. 이 페이지에는 핫 리로드 세부나 기본 포트가 없다. 미리보기 주소는 명령줄 출력을 따르고 추측하지 말 것.
사용 경계
이것은 공식 문서 저장소와 CLI 미리보기이며 범용 정적 사이트 생성기가 아니다. docs.json가 없으면 mint dev에 공식 출발점이 없다.
공식 설치는 npm i -g mint뿐이다. mint dev는 미리보기이며 두 번째 설치 프로그램이 아니다. 스킬 마켓 설치를 지어내지 말 것. 게시된 사이트는 읽기 전용 참고이며 설치 출처가 아니다.
전역 패키지와 dev 시작은 둘 다 부작용이 있다. 먼저 디렉터리를 확인한다. 이 페이지에는 배포, 호스팅, 사용자 지정 도메인 단계가 없다. 적히지 않은 온라인 반영은 하지 말 것. mint의 다른 하위 명령도 나열되어 있지 않다. 나타나지 않은 명령을 추측하지 말 것.