# 상세 로컬라이제이션으로 번역 키 찾기
**URL:** https://meta.discourse.org/t/find-a-translation-key-with-verbose-localization/134651
**Category:** Site Management
**Tags:** how-to, customization
**Created:** [11월 28, 2019, 8:30오후 UTC](https://meta.discourse.org/t/find-a-translation-key-with-verbose-localization/134651 "2019-11-28T20:30:32Z")
**Posts on this page:** 4
**Page:** 1
### Author:  [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [11월 28, 2019, 8:30오후 UTC](https://meta.discourse.org/t/find-a-translation-key-with-verbose-localization/134651/1 "2019-11-28T20:30:32Z")
> 🔖 이 문서에서는 Discourse에서 사용자 정의 텍스트의 번역 키를 찾기 위해 상세 로컬라이제이션(verbose localization)을 사용하는 방법에 대해 설명합니다.
>
> 🙋 필요한 사용자 권한: 관리자
# 상세 로컬라이제이션을 사용하여 번역 키 찾기
상세 로컬라이제이션은 Discourse에서 사용자 정의 텍스트의 번역 키를 보다 효과적으로 찾는 데 도움이 되는 강력한 도구입니다. 이는 Discourse UI의 여러 위치에 나타나는 텍스트를 번역해야 할 때 특히 유용합니다.
## 요약
이 가이드에서는 다음 내용을 다룹니다:
- 상세 로컬라이제이션 활성화.
- 상세 로컬라이제이션을 사용하여 번역 키 식별.
- 실제 적용 사례 및 일반적인 사용 사례.
## 상세 로컬라이제이션 활성화
설치 환경에 따라 상세 로컬라이제이션을 활성화하는 방법은 여러 가지가 있습니다.
### 개발자 도구 모음 사용 (권장)
[Discourse 개발자 도구 모음](https://meta.discourse.org/t/introducing-discourse-developer-toolbar/346215)에는 상세 로컬라이제이션을 위한 내장 토글이 포함되어 있습니다. 이 방법은 가장 쉽고, 셀프 호스팅 및 호스팅된 사이트 모두에서 작동합니다.
1. Discourse 사이트에서 브라우저의 개발자 콘솔을 엽니다.
2. 다음을 실행합니다:
```js
enableDevTools()
```
3. 페이지가 새로고장되고 화면 왼쪽에 개발자 도구 모음이 나타납니다.
4. 도구 모음의 📜 (스크롤) 아이콘을 클릭하여 상세 로컬라이제이션을 켭니다.
5. 상세 로컬라이제이션이 활성화된 상태로 페이지가 새로고장됩니다.
> ℹ 개발자 도구 모음의 상태는 브라우저의 로컬 스토리지에 저장되고, 상세 로컬라이제이션의 상태는 세션 스토리지에 저장됩니다. 다른 사용자에게는 영향이 없습니다.
### 브라우저 콘솔을 직접 사용하여
1. Discourse 사이트에서 브라우저의 웹 인스펙터를 엽니다.
2. 콘솔 탭으로 이동합니다.
3. 프롬프트에서 다음 JavaScript 명령을 입력합니다:
```js
I18n.enableVerboseLocalizationSession()
```
4. 다음과 유사한 응답을 볼 수 있습니다:
> ℹ 이 세션 기반 접근 방식은 사이트 방문 시 다른 사용자가 번역 마커를 보지 않도록 보장합니다.
### rails 콘솔 사용 (셀프 호스팅 전용)
`verbose_localization` 사이트 설정이 존재하지만 이는 [숨겨진 사이트 설정](https://meta.discourse.org/t/using-hidden-site-settings/308773)입니다. 관리 UI의 "All Site Settings"에서 찾을 수 없습니다. 셀프 호스팅 인스턴스에서 모든 사용자를 위해 전역적으로 활성화하려면:
1. [rails 콘솔](https://meta.discourse.org/t/using-hidden-site-settings/308773)에 접근합니다.
2. 다음을 실행합니다:
```ruby
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](https://meta.discourse.org/t/customize-all-text-in-discourse/36092)
- [How to translate customized text content?](https://meta.discourse.org/t/how-to-translate-customized-text-content/64670)
- [Introducing Discourse developer toolbar](https://meta.discourse.org/t/introducing-discourse-developer-toolbar/346215)
---
### Author:  [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [1월 3, 2026, 7:24오후 UTC](https://meta.discourse.org/t/find-a-translation-key-with-verbose-localization/134651/3 "2026-01-03T19:24:30Z")
> [@Discourse](#):
>
> ### 모든 사용자에게 설정 활성화하기
>
> 1. 사이트 설정 페이지로 이동하세요.
> a. 관리자 사이드바를 찾으세요.
> b. `All Site Settings`(모든 사이트 설정)를 선택하세요.
> b. 설정 페이지의 필터 필드에 `verbose`를 입력하세요.
> 2. `verbose localization` 사이트 설정을 활성화하세요.
이 설정은 이제 숨겨진 사이트 설정이 되었으므로 "모든 사이트 설정"에서 더 이상 찾을 수 없습니다.
>
따라서 이제 [rails console](https://meta.discourse.org/t/using-hidden-site-settings/308773)에 접근해야 합니다.
---
### Author:  [@benjamincfarmer](https://meta.discourse.org/u/benjamincfarmer)
#### Post date: [1월 22, 2026, 2:50오후 UTC](https://meta.discourse.org/t/find-a-translation-key-with-verbose-localization/134651/4 "2026-01-22T14:50:13Z")
호스팅된 시스템은 이제 이 속성에 어떻게 접근해야 하나요?
---
### Author:  [@Lilly](https://meta.discourse.org/u/Lilly)
#### Post date: [1월 22, 2026, 2:57오후 UTC](https://meta.discourse.org/t/find-a-translation-key-with-verbose-localization/134651/5 "2026-01-22T14:57:03Z")
> [@benjamincfarmer](#):
>
> 호스팅 시스템이 이제 이 속성에 액세스하려면 어떻게 해야 하나요?
이렇게 하면 됩니다.
> [@Discourse](#):
>
> 개별 세션에 대한 설정 활성화
또는 개발자 도구를 사용할 수도 있습니다.
> [@david](#):
>
> ### 📜 상세 로컬라이제이션
>
> [상세 로컬라이제이션 기능](https://meta.discourse.org/t/find-a-translation-key-with-verbose-localization/134651)을 전환합니다.