Joomla User Manual

Joomla Файлы Языка

Везде, где текст должен быть выведен на экран, разработчики Joomla вставляют языковую константу, такую как JYES или JNO. В процессе рендеринга загружаются языковые файлы с переводами на подходящий язык. Все языковые файлы заканчиваются на .ini. Вы можете посмотреть в languages/en-GB/joomla.ini для некоторых базовых примеров. Строки, начинающиеся с точки с запятой, игнорируются. Их можно использовать для комментариев. Оставшиеся строки состоят из пар ключ="значение". Каждый язык имеет один и тот же набор ключей, но значения соответствуют определённым переводам.

Каждое расширение Joomla имеет свои собственные языковые файлы, так что их в общей сложности сотни. Иногда возникают такие проблемы, как отсутствующие языковые константы, неправильно написанные языковые константы или синтаксические ошибки в переводных строках, которые могут сделать целый языковой файл недействительным.

Отладка языков

Joomla предоставляет некоторые полезные механизмы отладки, которые могут облегчить поиск непереведенных строк и диагностику проблем с языковыми переводами в установленных расширениях. Чтобы попробовать их:

С главного информационного интерфейса:

• Выберите кнопку Глобальная конфигурация в панели Система.
• Выберите панель Система и установите Отладка языков в Да.
• Отображение языка обычно устанавливается в Значение. Если установить в Константа, макет нарушается из-за длинных констант, которые не переносятся.

При активной отладке языка все переводимые значения отображаются с особыми символами, указывающими их статус:

• **Joomla CMS** Текст окруженный двумя звездочками указывает, что соответствие найдено в языковом файле, и константа переведена.
• ??Joomla CMS?? Текст окруженный парами вопросительных знаков указывает, что константа переводима, но соответствие в языковом файле не найдено.
• Joomla CMS Текст без окружающих символов указывает, что значение непереводимо.

Отладка системы

Дополнительную информацию об отладке языков можно получить, активировав системную отладку.

На главной панели управления:

• Выберите Плагины, затем найдите и включите плагин System - Debug.
• Вернитесь на главную панель управления и затем...
• Выберите кнопку Глобальная конфигурация.
• Перейдите на вкладку Система и установите Отладка системы в Да.

Когда Отладка системы активирована, на всех экранах внизу каждой страницы будет дополнительная отладочная информация. Ее можно развернуть, нажав на значок Joomla, и растянуть верхнюю границу вертикально, чтобы показать больше строк.

Отладочная информация представлена по нескольким заголовкам:

• J! Информация Основная информация об установке.
• Запрос Поля запроса сервера.
• Сессия Информация о сессии.
• Профилирование Время, затраченное на выполнение кода до различных контрольных точек в коде.
• Запросы SQL-запросы, выполненные в процессе построения страницы.
• Загружено. Список всех языковых файлов, загруженных в процессе построения страницы, включая информацию о полном пути. Это может быть полезно для проверки, что ожидаемые файлы были загружены.
• Не переведено Список всех ненайденных констант перевода и вероятное расположение файла, в котором была вызвана функция перевода.
• Ошибки

Система - Отладочный Плагин

Этот системный плагин контролирует, что отображается при активации отладки в Глобальной Конфигурации. Существует три настройки, представляющие интерес для переводчиков.

На вкладке Язык:

• Ошибки при разборе языковых файлов Показать ошибку, если языковой файл не удается загрузить.

• Языковые файлы. Если установлено на Показать, то ...
• Языковая строка Если установлено на Показать, то ...
• Удалить первое слово.
• Удалить с начала _ Удалить с конца

Следующее объяснение требует пересмотра!

Обратите внимание, что непереведенные строки будут отображать только значение, переданное соответствующему методу Text. Например, с кодом:

echo Text::_('Reports Import Configuration');

Если не переведено, будет отображаться как:

# /administrator/components/com_reports/views/reports/tmpl/default.php
REPORTS IMPORT CONFIGURATION=Reports Import Configuration

Если приставка ключа удалена, и установлена как "Reports", то отображение несколько изменится:

# /administrator/components/com_reports/views/reports/tmpl/default.php
REPORTS IMPORT CONFIGURATION=Import Configuration

Обратите внимание, что путь, который показывается, является только предположением на основе вызова функции PHP debug_backtrace. Иногда он точен, иногда нет, и также существуют случаи, когда файл определить не удалось. В этих случаях вам нужно использовать собственное суждение.

Переведено с помощью openai.com