콘텐츠로 건너뛰기
Lunaria

시작하기

Lunaria는 오픈소스 프로젝트용 현지화 관리 도구 체인으로, 유지보수자와 기여자가 원활하고 효율적인 현지화 워크플로우를 구축할 수 있도록 필요한 도구를 제공합니다.

왜 Lunaria인가요?

유지보수자로서 현지화 작업을 관리하는 것은 항상 쉽지 않았습니다. 일반적으로는 현지화 플랫폼으로 콘텐츠를 이전해야 하거나, 콘텐츠의 변경 사항을 신뢰할 수 있게 추적하는 것을 포기해야 했습니다. 하지만 이제는 그런 문제를 해결할 수 있습니다. Git 기반의 완전히 새로운 워크플로우를 통해, 루나리아는 이러한 두 가지 문제를 모두 해결합니다.

선택된 파일에 대한 모든 커밋은 현지화 대시보드를 생성하는 데 사용됩니다. 각 파일은 완료됨/오래됨/누락됨 상태로 분류되며, 대시보드를 통해 유지보수자는 프로젝트의 현지화 상태에 대해 상세한 개요를 확인할 수 있고, 기여자는 누락된 파일 링크와 오래된 콘텐츠에 추가해야 하는 커밋 목록을 포함해 효율적으로 도움을 줄 수 있는 모든 정보를 얻게 됩니다.

빠른 시작

프로젝트에 추가하기

@lunariajs/core를 프로젝트의 종속성에 설치함으로써 기존 프로젝트에 루나리아를 추가할 수 있습니다. 선호하는 패키지 매니저를 사용하세요:

터미널 창
npm install @lunariajs/core

그런 다음 lunaria init 명령을 실행하여 루나리아를 설정할 수 있으며, 몇 가지 질문을 받고 자동으로 답변을 새 lunaria.config.json 파일에 입력합니다:

터미널 창
npx lunaria init

프로젝트 구조에 따라 초기화 과정에서 lunaria sync를 성공적으로 실행했을 경우, 첫 번째 현지화 대시보드를 빌드할 수 있는 모든 조건이 갖춰진 상태일 수 있습니다.

lunaria.config.json 파일 내에 repository, defaultLocale, locales, 또는 files 필드 중 하나라도 누락된 경우, 구성 참조 가이드를 방문하여 설정을 완료한 후 아래 지침을 따르세요.

첫 번째 대시보드 만들기

현지화 대시보드를 만들려면, lunaria init에 의해 추가된 lunaria:build 스크립트를 실행하면 됩니다:

터미널 창
npm run lunaria:build

기본적으로 현지화 대시보드는 ./dist/lunaria/ 디렉터리 안의 index.html 파일에 빌드됩니다. 이 파일은 선택한 호스팅 플랫폼에 배포한 후 기여자들과 공유할 수 있습니다.

브라우저에서 확인하기

대시보드를 빌드한 후에는 http://localhost:3000/에서 새로운 미리보기 서버를 열기 위해 lunaria:preview를 실행할 수 있습니다.

터미널 창
npm run lunaria:preview

다음 단계

축하합니다! 이제 프로젝트의 현지화가 루나리아에 완전히 추적됩니다! 🌛

루나리아는 프로젝트에 최적화된 다양한 기능을 제공합니다. 다음 페이지들을 어떤 순서로 읽어도 좋으므로, 더 많은 정보를 알아보기 위해 아래 항목들을 살펴보세요:

대시보드 커스터마이징 자신만의 스타일과 구조 등으로 대시보드를 고유하게 만드는 방법을 배워보세요.
추적 추적의 동작 방식과 루나리아에서 콘텐츠를 어떻게 추적하는지 배워보세요.