상세 로컬라이제이션으로 번역 키 찾기

[Discourse]

이 문서에서는 Discourse에서 사용자 정의 텍스트의 번역 키를 찾기 위해 상세 로컬라이제이션(verbose localization)을 사용하는 방법에 대해 설명합니다.

필요한 사용자 권한: 관리자

상세 로컬라이제이션을 사용하여 번역 키 찾기

상세 로컬라이제이션은 Discourse에서 사용자 정의 텍스트의 번역 키를 보다 효과적으로 찾는 데 도움이 되는 강력한 도구입니다. 이는 Discourse UI의 여러 위치에 나타나는 텍스트를 번역해야 할 때 특히 유용합니다.

요약

이 가이드에서는 다음 내용을 다룹니다:

• 상세 로컬라이제이션 활성화.
• 상세 로컬라이제이션을 사용하여 번역 키 식별.
• 실제 적용 사례 및 일반적인 사용 사례.

상세 로컬라이제이션 활성화

설치 환경에 따라 상세 로컬라이제이션을 활성화하는 방법은 여러 가지가 있습니다.

개발자 도구 모음 사용 (권장)

Discourse 개발자 도구 모음에는 상세 로컬라이제이션을 위한 내장 토글이 포함되어 있습니다. 이 방법은 가장 쉽고, 셀프 호스팅 및 호스팅된 사이트 모두에서 작동합니다.

1. Discourse 사이트에서 브라우저의 개발자 콘솔을 엽니다.
2. 다음을 실행합니다:

   enableDevTools()
   

3. 페이지가 새로고장되고 화면 왼쪽에 개발자 도구 모음이 나타납니다.
4. 도구 모음의 (스크롤) 아이콘을 클릭하여 상세 로컬라이제이션을 켭니다.
5. 상세 로컬라이제이션이 활성화된 상태로 페이지가 새로고장됩니다.

개발자 도구 모음의 상태는 브라우저의 로컬 스토리지에 저장되고, 상세 로컬라이제이션의 상태는 세션 스토리지에 저장됩니다. 다른 사용자에게는 영향이 없습니다.

브라우저 콘솔을 직접 사용하여

1. Discourse 사이트에서 브라우저의 웹 인스펙터를 엽니다.
2. 콘솔 탭으로 이동합니다.
3. 프롬프트에서 다음 JavaScript 명령을 입력합니다:

   I18n.enableVerboseLocalizationSession()
   

4. 다음과 유사한 응답을 볼 수 있습니다:
   
   

이 세션 기반 접근 방식은 사이트 방문 시 다른 사용자가 번역 마커를 보지 않도록 보장합니다.

rails 콘솔 사용 (셀프 호스팅 전용)

verbose_localization 사이트 설정이 존재하지만 이는 숨겨진 사이트 설정입니다. 관리 UI의 "All Site Settings"에서 찾을 수 없습니다. 셀프 호스팅 인스턴스에서 모든 사용자를 위해 전역적으로 활성화하려면:

1. rails 콘솔에 접근합니다.
2. 다음을 실행합니다:

   SiteSetting.verbose_localization = true
   

이 방법은 해당 사이트의 모든 사용자를 위해 상세 로컬라이제이션을 활성화합니다. 다른 사용자의 UI를 혼란스럽게 하지 않도록 위의 세션 기반 방법을 사용하는 것이 좋습니다.

상세 로컬라이제이션을 사용하여 번역 키 찾기

상세 로컬라이제이션이 활성화되면 사이트의 모든 사용자 정의 가능한 텍스트 뒤에 숫자가 표시됩니다.

번역 키 식별 단계

1. 업데이트하려는 텍스트가 포함된 영역으로 이동합니다. 예를 들어, "Name"이라는 단어를 변경하려고 한다면:
   
   
2. 브라우저의 콘솔에서 관련 번역 번호를 찾습니다:
   
   
3. user.name.title과 같이 식별된 번역 키를 기록합니다.
4. Admin 사이드바로 이동하여 검색 바에 site texts를 입력합니다
5. 검색 상자에 번역 키를 입력합니다:
   
   
6. 텍스트의 편집(Edit) 버튼을 클릭하고 필요에 따라 텍스트를 업데이트합니다.

모범 사례

• 세션별 상세 로컬라이제이션을 사용하여 번역 작업 중 다른 사용자의 UI를 혼란스럽게 하지 마세요.
• 향후 참조를 위해 자주 사용되는 번역 키를 문서화하세요.
• 새로운 로컬라이제이션 기능에 대한 정보를 얻기 위해 Discourse 문서의 업데이트를 정기적으로 확인하세요.

일반적인 문제 및 해결 방법

문제: 모든 사용자에게 번역 마커가 표시됨

해결 방법: 다른 사용자가 이를 보지 않아야 하는 경우 세션에서만 상세 로컬라이제이션을 활성화했는지 확인하세요. 전역 사이트 설정 대신 개발자 도구 모음 또는 I18n.enableVerboseLocalizationSession() 콘솔 방법을 사용하세요.

문제: 올바른 번역 키 찾기가 어려움

해결 방법: 콘솔과 상세 로컬라이제이션 마커를 정확하게 사용하고, 사이트 텍스트 사용자 정의(Customize Site Texts) 페이지와 대조하세요.

자주 묻는 질문

Q: 상세 로컬라이제이션을 관리자 또는 스태프에게만 제한할 수 있나요?
A: 개발자 도구 모음 또는 브라우저 콘솔을 통해 개별 세션에서 활성화함으로써 비기술적 사용자에게 상세 로컬라이제이션 번호를 숨길 수 있습니다.

Q: 문자열 번역을 어떻게 검증할 수 있나요?
A: 번역 키를 식별하고 업데이트한 후, 새로운 브라우저 세션이나 탭에서 UI 변경 사항을 검토하세요.

추가 자료

• Customize text in Discourse
• How to translate customized text content?
• Introducing Discourse developer toolbar

[Moin]

@Discourse

모든 사용자에게 설정 활성화하기

1. 사이트 설정 페이지로 이동하세요.
   a. 관리자 사이드바를 찾으세요.
   b. All Site Settings(모든 사이트 설정)를 선택하세요.
   b. 설정 페이지의 필터 필드에 verbose를 입력하세요.
2. verbose localization 사이트 설정을 활성화하세요.

이 설정은 이제 숨겨진 사이트 설정이 되었으므로 "모든 사이트 설정"에서 더 이상 찾을 수 없습니다.

config/site_settings.yml

따라서 이제 rails console에 접근해야 합니다.

[benjamincfarmer (Ben Farmer)]

호스팅된 시스템은 이제 이 속성에 어떻게 접근해야 하나요?

[Lilly (Lillian)]

@benjamincfarmer

호스팅 시스템이 이제 이 속성에 액세스하려면 어떻게 해야 하나요?

이렇게 하면 됩니다.

@Discourse

개별 세션에 대한 설정 활성화

또는 개발자 도구를 사용할 수도 있습니다.

@david

상세 로컬라이제이션

상세 로컬라이제이션 기능을 전환합니다.