Документация для разработчиков
Темная тема

Просмотр файлов

На странице Перевод языковых файлов (Настройки > Локализация > Просмотр файлов) отображается структура каталогов, содержащих языковые файлы, в порядке расположения на диске. Для навигации по структуре каталогов можно пользоваться:

  • ссылками на именах каталогов;
  • полем Фильтр+поиск для фильтрации и поиска файлов.

Контекстная панель

КнопкаОписание
Фильтр + поискВ поле можно указывать как путь к нужному каталогу, так и различные настройки фильтра.
Список действийВыпадающий список со следующими действиями:
  • Показать общее количество фраз;
  • Показать общее количество языковых файлов;
  • Показать количество непереведенных фраз;
  • Показать количество файлов без переводов;
  • Скрыть папки без языковых файлов;
  • Показать ссылки на файлы без переводов.
ИндексироватьПо нажатию кнопки выполняется обновление индекса фраз. Доступен выбор языков, для которых требуется выполнить операцию индексирования.
Процесс индексации занимает продолжительное время. Его можно остановить при помощи кнопки Остановить.
Кнопка экспорта/импортаПо нажатию кнопки доступны два действия:
  • Выгрузить сообщения в CSV;
  • Импортировать сообщения из CSV.


Фильтр

ПолеОписание
Имя папкиНазвание папки
Имя файлаНазвание файла
Код фразы Языковое сообщение - группа фраз на разных языках, имеющая один смысл. Список сообщений в файле хранится в следующем виде:

Подробнее в курсе Разработчик Bitrix Framework.
Код фразы.
Как выполнять поиск кода фразы.Множественный выбор. Доступны варианты:
  • с учетом регистра
  • по точному соответствию
  • находится в начале
  • находится в конце
Найти фразы по списку кодовУказываются фразы для поиска по списку кодов
Исключить фразы по списку кодовИсключить фразы для поиска по списку кодов
ФразаУказывается конкретная фраза
ЯзыкВыбирается язык из выпадающего списка
Как выполнять поиск фразыМножественный выбор. Доступны варианты:
  • с учетом регистра
  • по точному написанию слова
  • по точному соответствию фразе
  • находится в начале
  • находится в конце
Найти файлы по списку путейУказывается список путей для поиска файлов
Исключить файлы из списка путейУказывается список путей для исключения при поиске файлов


Список файлов

ПолеОписание
Колонка флажковПоле предназначено для выбора разделов, к которым предполагается применить какое-либо правило или действие.
ДействияДоступны следующие действия:
  • для папки:
    • Перейти к папке.
  • для файла:
    • Редактировать сообщения;
    • Показать PHP код;
    • Редактировать PHP.
Имя файла/папкиНазвание папки или файла.
Полный путьПолный путь до папки или файла от корневого каталога.
Код фразыПоле предназначено для разработчиков.
ЯзыкиВ списке показываются выбранные языки. При этом символом * отмечен текущий язык интерфейса.

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

Нажатие на ссылку на языковом файле приведет к открытию страницы для редактирования языкового файла.



Групповые действия

ДействиеОписание
Экспортировать выделенныеОтмеченные файлы будут экспортированы в файл CSV.
Удалить фразы, которых нет на текущем языкеВ выделенных каталогах удаляет фразы, которые нет на текущем языке.


Форма "Выгрузить
сообщения в CSV"

ПолеОписание
Обработка файловВыберите способ выгрузки языковых файлов:
  • Выгрузить только непереведенные фразы - будут выгружены только непереведенные языковые файлы и сообщения.
  • Сконвертировать кодировку в UTF-8 - языковые файлы и сообщения будут сконвертированы в кодировку UTF-8.
  • Выберите языки для выгрузки - выбираются из списка нужные языки (для выбора нескольких языков зажмите клавишу Ctrl), либо вариант Все;
  • Выгрузить сообщения только для файлов и папок - В поле указываются полные пути файлов и папок, из которых нужно выгрузить сообщения.
Кнопка ЭкспортироватьСлужит для запуска процесса экспорта языковых файлов.
Кнопка ОстановитьСлужит для остановки процесс экспорта (активна во время экспорта).


Форма "Импортировать
сообщения из CSV"

ПолеОписание
Файл CSVС помощью кнопки Выберите файл укажите файл, из которого будет осуществляться импорт данных.
Укажите кодировку файлаИз выпадающего списка выберите нужную кодировку файла.
Укажите как добавлять фразыВыберите способ обработки языковых файлов:
  • добавлять только новые переводы - будут добавлены только новые языковые файлы и сообщения;
  • обновить только фразы, найденные в csv-файле - будут только обновлены существующие языковые файлы и сообщения;
  • добавлять новые переводы и обновить фразы, найденные в csv-файле - будут как добавлены новые языковые файлы и сообщения, так и обновлены существующие.
Индексировать загруженные фразыОтметьте, если загруженные фразы необходимо сразу индексировать.
Кнопка ИмпортироватьСлужит для запуска процесса импорта языковых файлов.
Кнопка ОстановитьСлужит для остановки процесса импорта языковых файлов.


Пользовательские комментарии

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

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
evobus
Сообщение не промодерировано, возможны ошибки и неточности.
На сегодня это не актуально:

"""
Из выпадающего списка выберите нужную кодировку файла.
"""
Предлагается только checkbox UTF-8 (включить / отключить) - списка нет
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх