Отладка перевода

From Joomla! Documentation

This page is a translated version of the page Debugging a translation and the translation is 100% complete.

Other languages:
English • ‎español • ‎français • ‎Nederlands • ‎português • ‎русский
Split-icon.png
Split Page into Specific Joomla! Versions - J2.5 and 3.x

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.


Info non-talk.png
General Information

Отличается ли отладка языка от версии к версии? Имеются ли различия в отладке между [версиями] 1.5, 2.5 и 3.х? Если да, то давайте разделим их или отметим их получше.

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

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

Отладка языка включается в административной панели в общих настройках во вкладке "Система". Найдите параметр "Отладка языка", выберите опцию "Да" и сохраните свои изменения.

При активации этой опции все переведенные строчки будут показаны, окруженные с обеих сторон специальными символами, которые указывают их статус.

Код Статус
●Joomla CMS● (окруженный звездочками текст) указывает на то, что в файле определения языка ['этому тексту] было найдено соответствие и что эта строка была переведена.
 ??Joomla CMS?? (окруженный парами вопросительных знаков текст) указывает на то, что этот текст переводим, но в файле определения языка [ему] не было найдено соответствия.
Joomla CMS (текст без каки-либо знаков с обеих сторон) указывает на то, что данная строка непереводима.

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

Дополнительная информация по отладке языка может быть получена при включении отладки системы. Это достигается в административной панели в общих настройках во вкладке "Система". Найдите параметр "Отладка системы", выберите опцию "Да" и сохраните свое изменение.

При включении этой опции все [административные] экраны покажут внизу веб-страницы дополнительную информацию по отладке. В настоящее время она включает в себя следующее.

  • Результаты профилирования - время, ушедшее на исполнение кода до определенных меток в коде.
  • Использование памяти - сколько RAM памяти использовано.
  • Запросы к базе данных - все SQL запросы, исполненные в процессе построения данной веб-страницы.
  • Загруженные языковые файлы - список языковых файлов, загруженных в процессе построения данной веб-страницы, включая полную информацию о путях к ним. Это может пригодиться для проверки были ли загружены исполненные файлы. Число после каждого пути - число, указывающее сколько раз [система] сослалась на этот файл.
  • Untranslated strings diagnostic. A list of all the untranslated strings found and the likely file location given where the JText call was made.
  • Дизайнер непереведенных строк - список всех найденных непереведенных строк, но перечисленных в формате КЛЮЧ=значение, с тем, чтобы их можно было скопировать в какой-либо файл определения языка.

Плагин отладки

Этот системный плагин контролирует что [именно] показано при включении в общих настройках системы отладки. Он включен по умолчанию. Параметры этого плагина можно найти пройдя по "Расширения" -> "Менеджер плагинов", поискав плагин "Система - Отладка" и щелкнув на него. Переводчиков могут заинтересовать следующие три параметра.

  • Показывать загруженные языковые файлы. При установке [этой опции] на "Да", информация по отладке будет включать список языковых файлов, которые были запрошены при создании текущей страницы.
  • Показывать неопределенные языковые строчки. При установке на "Режим диагностики" в информацию по отладке будет включен список непереведенных строк и адрес файлов, содержащих вызов [метода] JText. При установке на "Режим дизайна" в информацию по отладке будет включен список непереведнных строк в формате, в котором можно напрямую копировать и вставлять в файл языкового определения. То есть, формат показа: КЛЮЧ=строка. При настройке на "Все режимы" в информацию по отладке будут включены списки как режима диагностики, так и режима дизайна.
  • Strip Key Prefix. Only used when Display undefined language strings is set to “Designer mode” or "All modes". This allows you to strip a prefix from the string to form the key. This is useful if the designer uses a common prefix for their extensions when using JText methods. See example below.

Заметьте, что непереведенные строки будут показывать только значения, переданные соответствующим методом 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". Иногда он может быть точным, иногда - неточным, и также иногда будут случаи, когда никакой файл не был определен. В таких случаях Вам необходимо проявить [свое собственное] лучшее суждение.