자주 묻는 질문

Q: 새로운 번역 키를 어떻게 생성하나요?

R: 키 트리 구조로 이동하여 "파일 또는 폴더 생성" 버튼을 클릭하거나 컨텍스트 메뉴(마우스 오른쪽 버튼 클릭)를 사용하세요. 키의 전체 경로를 입력하고 확인합니다. 키는 선택한 네임스페이스 내에 생성됩니다.

Q: 트리 구조에서 폴더와 파일의 차이점은 무엇인가요?

R: 폴더는 키를 정리하기 위한 논리적 컨테이너입니다. 파일은 번역할 텍스트를 포함하는 개별 키입니다. 폴더는 다른 폴더나 키를 포함할 수 있습니다.

Q: 사용하지 않는 키를 어떻게 삭제하나요?

R: 트리 헤더에서 "고립된 키 표시/숨기기" 옵션을 활성화하여 LSDE에는 존재하지만 소스 코드에는 없는 키를 식별하세요. 그런 다음 컨텍스트 메뉴를 통해 해당 키를 삭제할 수 있습니다.

Q: LSDE에서 사용 가능한 LLM은 무엇인가요?

R: LSDE는 Anthropic, OpenAI, Mistral, Gemini, Deepseek, ElevenLabs 및 임시 이메일을 통한 무료 서비스 등 7개의 주요 제공업체를 지원합니다.
API 키는 전역 설정의 인증 섹션에서 구성할 수 있습니다.

Q: LLM을 무료로 어떻게 사용하나요?

R: LSDE는 임시 이메일(temp-mail 또는 10minmail)을 이용한 계정 생성을 통해 OpenAI를 무료로 사용하는 방법을 제공합니다. 시간당 약 70개의 작업과 제한된 할당량이 제공됩니다. 또한 무료 API 키를 제공하는 Gemini와 함께 Google 서비스를 사용할 수도 있습니다.

Q: LLM 번역은 신뢰할 수 있나요?

R: 결과는 적절하고 만족스럽지만, 최종 확인을 위해 언어 전문가의 검토를 거치는 것이 필수적입니다.
LLM은 적절한 문맥이 제공될 때 번역에서 뛰어난 성능을 발휘합니다.

Q: LLM 번역 품질을 어떻게 개선하나요?

R: 키의 메타데이터에 설명, 변수 및 문맥 메모를 입력하세요. 이 정보는 더 관련성 높은 결과를 보장하기 위해 LLM 요청에 통합됩니다.

Q: 메타데이터는 어떤 용도로 사용되나요?

R: 메타데이터는 번역가, 편집자 및 LLM에게 추가적인 문맥을 제공합니다. 여기에는 설명, 허용된 변수, 사용자 메모, 그리고 내용을 시각적으로 문맥화하기 위한 이미지가 포함됩니다.

Q: 키에 이미지를 어떻게 추가하나요?

R: 선택한 키의 메타데이터 창을 열고 "이미지" 섹션을 사용하세요. 이미지는 공유를 용이하게 하기 위해 압축되어 .lsde 파일에 통합됩니다.

Q: LLM이 사용자 메모에 접근할 수 있나요?

R: 아니요, 사용자 메모는 작성자와 번역가만을 위한 용도입니다.
LLM에는 전송되지 않습니다.

Q: 코드 스캐너를 어떻게 구성하나요?

R: 패턴 섹션(프로젝트 설정)으로 이동하세요. 코드베이스에서 i18n 키를 식별하기 위해 최소 1개의 캡처 그룹을 포함하는 정규 표현식(Regex)으로 패턴을 생성하세요.

Q: 어떤 프로그래밍 언어가 지원되나요?

R: 본질적인 제한은 없습니다. 언어에 관계없이 키를 캡처하기 위해 적절한 Regex를 생성하기만 하면 됩니다. 패턴 테스트를 위해 regexr.com과 같은 도구를 활용하세요.

Q: 코드에서 누락된 키를 어떻게 식별하나요?

R: 코드 스캐너에서 "누락된 키" 모드를 활성화하세요. LSDE는 소스 코드에는 존재하지만 LSDE 트리에는 없는 키만 표시합니다. 이를 일괄적으로 생성할 수 있습니다.

Q: 사후 처리 텍스트 렌더링이란 무엇인가요?

R: 텍스트 표시를 실시간으로 사용자 정의할 수 있는 시스템입니다.
Regex 패턴을 구성하여 텍스트 그룹을 캡처하고 데코레이터(색상, 아이콘, 위젯)를 할당하여 가독성을 높일 수 있습니다.

Q: 텍스트에 "위젯"을 어떻게 추가하나요?

R: 프로젝트 설정에서 Regex를 사용하여 패턴을 생성하세요. 캡처 그룹을 "Widget" 유형의 데코레이터에 할당합니다. 위젯은 성능 최적화를 위해 활성화된 창에서만 표시됩니다.

Q: 렌더링에 변수를 어떻게 연결하나요?

R: 프로젝트 설정의 변수 섹션에서 카테고리와 "태그"가 포함된 변수를 생성하세요. 이러한 태그를 캡처하도록 Regex 패턴을 구성하면 LSDE가 발견된 인스턴스에 데코레이터를 자동으로 연결합니다.

Q: 대화에 사용할 음성을 어떻게 생성하나요?

R: 먼저 ElevenLabs API 키를 확보해야 합니다(무료 플랜 사용 가능). 프로젝트 설정에서 음성 프로필을 구성한 다음, 음성 관리자를 사용하여 내레이션을 생성하세요.

Q: SAD와 MAD의 차이점은 무엇인가요?

R: SAD (Single Actor Dialog) = 키당 한 명의 화자. MAD (Multi Actor Dialog) = Regex 태그로 식별되는 한 키 내의 여러 화자.
MAD는 관리해야 할 키의 수를 획기적으로 줄여줍니다.

Q: 대화에서 여러 캐릭터를 어떻게 관리하나요?

R: MAD 모드에서는 키 내에서 {캐릭터} 텍스트와 같은 태그를 사용하세요. 캐릭터 ID와 텍스트를 캡처하도록 Regex를 구성한 다음, 변수에서 각 캐릭터에 음성 프로필을 할당하세요.

Q: 음성 생성 후 텍스트를 수정했다면 어떻게 해야 하나요?

R: LSDE는 수정을 감지하고 음성을 재검증할 것을 제안합니다.
MAD 모드에서는 캐릭터를 이동하거나 추가한 경우 드래그 앤 드롭을 통해 기존 음성 인스턴스를 재할당할 수 있습니다.

Q: 에디터에서 텍스트 글꼴이나 크기를 어떻게 변경하나요?

R: 전역 설정 > 사용자 인터페이스 > 타이포그래피로 이동하세요. 크기, 간격, 글꼴 및 줄 높이를 조정할 수 있습니다.

Q: LSDE 인터페이스 언어를 어떻게 변경하나요?

R: 전역 설정 > 접근성 > 언어 선택으로 이동하세요.
2개의 인터페이스 언어를 구성하고 [F1] 키로 서로 전환할 수 있습니다.

Q: 기존 프로젝트를 어떻게 가져오나요?

R: 로컬라이제이션 관리자(Gestionnaire de Localisations)로 이동하여 "스마트 가져오기" 옵션을 사용하세요. 폴더 구조를 ../folder/lang/namespace.json 형식으로 구성하면 LSDE가 자동으로 가져옵니다.

Q: 수정으로부터 키를 어떻게 보호하나요?

R: 메인 에디터에서 "보호" 체크박스를 선택하여 해당 텍스트를 최종본으로 표시하세요.
LLM 작업은 이를 자동으로 무시합니다.

R: .lsde 파일에 프로젝트 전체가 포함되어 있습니다.
Git, 이메일 또는 클라우드 서비스를 통해 공유하세요. LSDE는 파일을 열 때 변경 사항을 자동으로 동기화합니다.

Q: 협업자의 진행 중인 작업을 어떻게 추적하나요?

R: 트리에서 "진행 중인 작업이 있는 키 표시/숨기기" 옵션을 활성화하세요. 활성 작업 또는 승인 대기 중인 작업에 할당된 키를 빠르게 확인할 수 있습니다.

Q: 여러 언어가 표시될 때 에디터가 느려지는 이유는 무엇인가요?

R: 기본적으로 LSDE는 성능 최적화를 위해 비활성 창에서 복잡한 렌더링(위젯)을 비활성화합니다. 성능에 문제가 없다면 전역 구성에서 이 최적화 옵션을 끌 수 있습니다.

Q: 코드 스캐너 속도를 어떻게 개선하나요?

R: 모든 결과를 표시하는 대신 트리에서 특정 키를 선택하세요. 이렇게 하면 결과가 필터링되어 스캐너 속도가 빨라집니다. 또한 조건부가 포함된 너무 복잡한 Regex는 피하는 것이 좋습니다.

Q: .lsde 파일이란 무엇인가요?

R: 프로젝트의 핵심 파일입니다.
JSON 형식을 기반으로 하며, 모든 키, 번역, 메타데이터 및 오디오 보이스를 중앙에서 관리합니다.

코드베이스에 직접 통합하여 필요에 따라 항목을 추출하고 매핑할 수도 있습니다:

tstype MetasEntries = [key: StructureKeyWithNamespace, value: IStructureMetaData][];
type ValuesEntries = [StructureKeyWithNamespace, [Locales, string][]][];
type VoicesEntriesMap = [StructureKeyWithNamespace, [Locales, ISpeakerVoiceConfig[]][]][];

Git을 통한 버전 관리를 활용할 수 있도록 프로젝트 루트에 저장하는 것을 권장합니다. 민감한 데이터가 포함되어 있지 않으므로 번역가나 에디터와 쉽게 공유할 수 있습니다.

루트 디렉토리에 파일이 있으면 game:.scenes.the-ice-land.events.the-lost-house.1과 같은 전체 키 경로를 더 쉽게 검색할 수 있습니다.
IDE는 이 파일을 표준 JSON 파일로 인식하므로, 입력된 노트와 메타데이터를 편리하게 읽을 수 있습니다.

마지막으로, .lsde 파일은 하위 호환성을 지원합니다. 이전 프로젝트들도 최신 버전의 소프트웨어에서 문제없이 열립니다.