Отладка перевода
From Joomla! Documentation
It has been suggested that this article or section be split into specific version Namespaces. (Discuss). If version split is not obvious, please allow split request to remain for 1 week pending discussions. Proposed since 4 years ago.
Joomla! поддерживает некоторые пригодные механизмы отладки, которые могут помочь в поиске непереведенных строк и диагностике проблем с переводом установленных расширений.
Отладка языка
Отладка языка включается в административной панели в общих настройках во вкладке "Система". Найдите параметр "Отладка языка", выберите опцию "Да" и сохраните свои изменения.
При активации этой опции все переведенные строчки будут показаны, окруженные с обеих сторон специальными символами, которые указывают их статус.
| Код | Статус |
|---|---|
| **Joomla CMS** | (окруженный звездочками текст) указывает на то, что в файле определения языка ['этому тексту] было найдено соответствие и что эта строка была переведена. |
| ??Joomla CMS?? | (окруженный парами вопросительных знаков текст) указывает на то, что этот текст переводим, но в файле определения языка [ему] не было найдено соответствия. |
| Joomla CMS | (текст без каки-либо знаков с обеих сторон) указывает на то, что данная строка непереводима. |
Отладка системы
Дополнительная информация по отладке языка может быть получена при включении отладки системы. Это достигается в административной панели в общих настройках во вкладке "Система". Найдите параметр "Отладка системы", выберите опцию "Да" и сохраните свое изменение.
При включении этой опции все [административные] экраны покажут внизу веб-страницы дополнительную информацию по отладке. В настоящее время она включает в себя следующее.
- Результаты профилирования - время, ушедшее на исполнение кода до определенных меток в коде.
- Использование памяти - сколько RAM памяти использовано.
- Запросы к базе данных - все SQL запросы, исполненные в процессе построения данной веб-страницы.
- Загруженные языковые файлы - список языковых файлов, загруженных в процессе построения данной веб-страницы, включая полную информацию о путях к ним. Это может пригодиться для проверки были ли загружены исполненные файлы. Число после каждого пути - число, указывающее сколько раз [система] сослалась на этот файл.
Непереведенные строки - список всех найденных непереведенных строк и вероятный путь к файлу, где эти строки были вызваны функцией JText.
- Дизайнер непереведенных строк - список всех найденных непереведенных строк, но перечисленных в формате КЛЮЧ=значение, с тем, чтобы их можно было скопировать в какой-либо файл определения языка.
Плагин отладки
Этот системный плагин контролирует что [именно] показано при включении в общих настройках системы отладки. Он включен по умолчанию. Параметры этого плагина можно найти пройдя по "Расширения" -> "Менеджер плагинов", поискав плагин "Система - Отладка" и щелкнув на него. Переводчиков могут заинтересовать следующие три параметра.
- Показывать загруженные языковые файлы. При установке [этой опции] на "Да", информация по отладке будет включать список языковых файлов, которые были запрошены при создании текущей страницы.
- Показывать неопределенные языковые строчки. При установке на "Режим диагностики" в информацию по отладке будет включен список непереведенных строк и адрес файлов, содержащих вызов [метода] JText. При установке на "Режим дизайна" в информацию по отладке будет включен список непереведнных строк в формате, в котором можно напрямую копировать и вставлять в файл языкового определения. То есть, формат показа: КЛЮЧ=строка. При настройке на "Все режимы" в информацию по отладке будут включены списки как режима диагностики, так и режима дизайна.
Удалить приставку ключа. Используется только когда [параметр] Показывать неопределенные языковые строки настроен на Режим дизайнер или Все режимы. Это позволяет Вам удалять из строчек какую-либо приставку для формирования ключа. Это пригодно если дизайнер при использовании метода JText использует для своих расширений общую приставку. Смотрите примеры ниже.
Заметьте, что непереведенные строки будут показывать только значения, переданные соответствующим методом JText. Например, следующим кодом:
echo JText::_( 'Reports Import Configuration' );Если не переведено, режим дизайнера покажет это так:
# /administrator/components/com_reports/views/reports/tmpl/default.php REPORTS IMPORT CONFIGURATION=Reports Import Configuration
Если [параметр] "Удалить приставку ключа" настроен на "Доклады", то формат слегка изменится на [следующий]:
# /administrator/components/com_reports/views/reports/tmpl/default.php REPORTS IMPORT CONFIGURATION=Import Configuration
Заметьте, что показанный путь является только лучшей догадкой, основанной на вызове функции РНР "debug_backtrace". Иногда он может быть точным, иногда - неточным, и также иногда будут случаи, когда никакой файл не был определен. В таких случаях Вам необходимо проявить [свое собственное] лучшее суждение.