콘텐츠로 건너뛰기
Lunaria

Lunaria CLI

Lunaria는 터미널에서 Lunaria를 사용하는 데 도움을 주기 위해 내장된 lunaria 명령줄 인터페이스 (CLI) 프로그램을 제공합니다.

아래 목록에 있는 명령어 중 하나를 실행하고, 필요 시 명령어의 기본 동작을 수정할 수 있는 옵션을 포함하여 사용하세요.

터미널에서 lunaria --help를 입력하면 사용 가능한 모든 명령어와 전역 옵션을 확인할 수 있습니다:

터미널 창
npx lunaria --help

이 명령어는 다음 메시지를 터미널 창에 표시합니다:

터미널 창
lunaria [command] [...options]


명령어


    build  대시보드 및 상태를 디스크에 빌드합니다.
     init  프로젝트에서 Lunaria를 초기화합니다.
  preview  빌드된 대시보드를 로컬에서 미리 보여줍니다.
   stdout  콘솔에 구성 정보와 상태를 기록합니다.
     sync  프로젝트 기반으로 구성 필드를 동기화합니다.


전역 옵션


         --help  이 도움말 메시지를 표시합니다.
--config <path>  구성 파일의 위치를 지정합니다.

명령어

lunaria build

대시보드 및 상태를 디스크에 빌드합니다. 기본적으로 파일은 dist/lunaria 폴더에 출력되며, 각각 index.html과 status.json이라는 이름으로 저장됩니다.

옵션

--skip-status

상태 생성을 건너뛰고, 디스크에 이미 존재하는 최신 상태를 사용합니다.

이 옵션은 상태 빌드를 기다리지 않고 대시보드를 지속적으로 재빌드하고자 할 때(예: 스타일 변경 사항을 테스트하기 위해) 권장됩니다.

lunaria init

프로젝트에서 Lunaria를 초기화합니다. 몇 가지 질문을 통해 프로세스를 진행하고 새로운 lunaria.config.json 파일을 설정합니다.

lunaria preview

lunaria build로 빌드한 최신 지역화 대시보드를 제공하는 로컬 서버를 시작합니다.

이 명령어는 프로덕션 환경에서 사용하기 위한 것이 아닙니다. 프로덕션 호스팅을 원하시면 특정 배포 안내 문서를 참고하세요.

옵션

--port <number>

미리 보기 서버가 열릴 포트를 지정합니다. 기본적으로 3000이 사용됩니다. 만약 3000 또는 지정한 포트가 사용 중이라면, 임의의 사용 가능한 포트가 대신 사용됩니다.

lunaria stdout

콘솔에 구성 정보와 상태를 기록합니다.

이 명령어는 패키지에 의존하지 않고도 Lunaria와 상호 작용하고자 할 때 사용됩니다. 예를 들어, 리포지토리에 이미 설정된 Lunaria를 사용하는 GitHub Action을 구축할 때 유용합니다.

lunaria sync

프로젝트의 구조에 따라 구성 파일의 files, defaultLocale, 그리고/또는 locales 필드를 동기화합니다.

이 명령어는 프로젝트의 package.json을 분석하여, 일반적으로 자체 구성 파일이나 기본 콘텐츠 구조로부터 구성 정보를 추론할 수 있는 패키지를 확인합니다.

현재 lunaria sync에서 지원되는 패키지는 vitepress와 @astrojs/starlight입니다.

옵션

--package <package>

동기화하고자 하는 패키지를 지정합니다. 같은 프로젝트에 여러 개의 지원 패키지가 있을 경우 선택 프롬프트를 건너뜁니다.

--skip-questions

구성 파일의 files, defaultLocale, 및/또는 locales 필드를 변경할 때 발생하는 모든 개별 확인 프롬프트를 건너뜁니다.

전역 옵션

--help

도움말 메시지를 출력합니다.

--config <path>

프로젝트 루트 기준으로의 Lunaria 구성 파일 경로를 지정합니다. 기본적으로, Lunaria는 프로젝트 루트에 lunaria.config.json 파일이 있다고 기대합니다.

구성 파일을 다른 디렉터리에 두거나 다른 이름으로 사용하고 싶은 경우 이 옵션을 사용하세요.