Эта документация объясняет, как использовать подробную локализацию для поиска ключей перевода для пользовательского текста в Discourse.
Требуемый уровень пользователя: Администратор
Поиск ключа перевода с помощью подробной локализации
Подробная локализация — это мощный инструмент в Discourse, который помогает администраторам более эффективно находить ключи перевода для пользовательского текста. Это особенно полезно, когда необходимо перевести текст, отображаемый в нескольких местах интерфейса Discourse.
Краткое содержание
В этом руководстве рассматриваются следующие темы:
- Включение подробной локализации.
- Использование подробной локализации для идентификации ключей перевода.
- Практическое применение и типичные случаи использования.
Включение подробной локализации
Существует несколько способов включения подробной локализации в зависимости от вашей конфигурации.
Использование панели инструментов разработчика (рекомендуется)
Панель инструментов разработчика Discourse включает встроенный переключатель для подробной локализации. Это самый простой метод, который работает как на самохостинговых, так и на хостинговых сайтах.
- Откройте консоль разработчика вашего браузера на сайте Discourse.
- Выполните:
enableDevTools() - Страница перезагрузится, и слева появится панель инструментов разработчика.
- Нажмите на иконку
(список) в панели инструментов, чтобы включить подробную локализацию. - Страница перезагрузится с включенной подробной локализацией.
Состояние панели инструментов разработчика сохраняется в локальном хранилище вашего браузера, а состояние подробной локализации — в сессионном хранилище. Другие пользователи не затронуты.
Прямое использование консоли браузера
- Откройте веб-инспектор вашего браузера на сайте Discourse.
- Перейдите на вкладку консоль.
- Введите следующую команду JavaScript в приглашении:
I18n.enableVerboseLocalizationSession() - Вы должны увидеть ответ, похожий на:
Использование консоли Rails (только для самохостинга)
Настройка verbose_localization существует, но является скрытой настройкой сайта. Её нельзя найти в интерфейсе администратора в разделе «Все настройки сайта». Чтобы включить её глобально для всех пользователей на самохостинговом экземпляре:
- Получите доступ к консоли Rails.
- Выполните:
SiteSetting.verbose_localization = true
Это включает подробную локализацию для всех пользователей на сайте. Предпочитайте методы, основанные на сессии, описанные выше, чтобы не загромождать интерфейс для других пользователей.
Использование подробной локализации для поиска ключа перевода
Когда подробная локализация включена, вы увидите числа, отображаемые после всего настраиваемого текста на вашем сайте.
Шаги для идентификации ключа перевода
- Перейдите в область, содержащую текст, который вы хотите обновить. Например, если вы хотите изменить слово «Имя»:
- Найдите соответствующий номер перевода в консоли вашего браузера:
- Запишите идентифицированный ключ перевода, например
user.name.title. - Перейдите в боковую панель администратора и введите
site textsв поле поиска. - Введите ключ перевода в поле поиска:
- Нажмите кнопку «Изменить» рядом с текстом и обновите его при необходимости.
Лучшие практики
- Используйте подробную локализацию, специфичную для сессии, чтобы не загромождать интерфейс для других пользователей во время задач перевода.
- Документируйте часто используемые ключи перевода для будущего использования.
- Регулярно проверяйте обновления в документации Discourse, чтобы быть в курсе новых функций локализации.
Типичные проблемы и их решения
Проблема: Маркеры перевода видны всем пользователям
Решение: Убедитесь, что вы включили подробную локализацию исключительно для своей сессии, если другие пользователи не должны её видеть. Используйте панель инструментов разработчика или метод консоли I18n.enableVerboseLocalizationSession() вместо глобальной настройки сайта.
Проблема: Трудности с поиском правильного ключа перевода
Решение: Используйте консоль и маркеры подробной локализации точно и сверяйтесь со страницей «Настройка текста сайта».
Часто задаваемые вопросы
В: Можно ли ограничить подробную локализацию только для администраторов или сотрудников?
О: Номера подробной локализации можно скрыть от нетехнических пользователей, включив их в отдельных сессиях через панель инструментов разработчика или консоль браузера.
В: Как можно проверить переводы строк?
О: После идентификации и обновления ключа перевода проверьте изменения в интерфейсе в новой сессии или вкладке браузера.