Интерфейс TextEditor

Материал из wiki.appsalutecreator.com
Перейти к: навигация, поиск

Ico text.pngРедактор текстов

Ico text.png Text Editor - хранилище всех текстовых ресурсов (надписей) на различных языках.
Аналогично графике и звукам при помощи мышки они перетаскиваются в соответствующие свойства объектов, находящихся в Scene Editor.

См. также
Урок 6

Окно редактора имеет следующий вид:

Text baze main.jpg

Общие свойства и действия с текстом

После сохранения действий в текстовом редакторе база автоматически обновляется в редакторе сцен.

  • элемент текстовой базы - строка текста, которая может хранить в себе несколько различных фраз,записанных в разные поля
  • один текст на разных языках записывается в один элемент текстовой базы
  • в текстовой базе может храниться voice
  • элемент текстовой базы может хранить в себе несколько иконок, для которых можно выбрать одну из 4-х категорий (mainPicture, icon1, icon2,icon3)
  • каждому элементу текстовой базы присваивается уникальный номер.
  • при добавлении элемента - присваивается следующий по порядку уникальный номер
  • при экспорте экранов в текущий проект элементы текстовой базы добавляются автоматически в базу текущего проекта и присваиваются им следующие по порядку уникальные номера
  • может существовать несколько элементов с одинаковыми именами (но следует избегать этого!)
  • текст может быть автоматически добавлен в текущий проект или добавлен из другой текстовой базы
  • элемент текстовой базы может быть удален, модифицирован, категоризирован

Кнопки быстрого запуска

Вверху окна приложения расположены кнопки общего меню:

  • 00 6.png — команда создать Новый файл;
  • 00 7.png — команда открыть уже созданный проект;
  • 00 8.png — сохранить изменения в файле;
  • TxtEditor open Res base.JPG — открыть базу ресурсов;
  • 00 18.png — создать новую папку в корневой базе;
  • New record.jpg — добавить новую текстовую запись;
  • Add new rec fr.jpg — добавить новую текстовую запись из базы ресурсов;
  • Add url.jpg — добавить новую url запись;
  • 00 19.png — удалить текстовую запись;
  • Text base find.png — найти необходимую текстовую запись в текстовой базе.

Меню редактора

1. Если нажать в меню кнопку File, выпадет список команд, с помощью которых можно создать новый или загрузить уже созданный файл, сохранить файл с указанием места сохранения и т.д.
2.Для импорта фраз на другом языке необходимо воспользоваться Функцией Импортировать меню File и выбрать .xml-файл с текстом и выбрать язык
3. Если нажать в меню кнопку Resource, выпадет список команд:

  • Open Resource - позволяет создать базу по ранее подготовленной графической базе ресурсов с точным совпадением структуры и названием папок и файлов. Используется для Hidden Objects;
  • Choose Resource File - позволяет подгрузить базу графических ресурсов для перетаскивания изображений из ResourcesEditor на иконку;
  • Choose Categories Config - помогает классифицировать текстовые файлы по категориям.

00 51.PNG 00 52.PNG


Создание и заполнение текстовой базы проекта

Текстовая база не создается автоматически при создании проекта.
Для создания и заполнения текстовой базы:
1. Заходите в пункт меню file -> New. Появляется пустая база ресурсов, по умолчанию названная Untitled.
2. Слева в дереве текстовых объектов кликаем правой кнопкой мыши и выбираем Add record. Каждый раз при добавлении новой текстовой записи редактор просит нас написать ее имя. Это имя можно будет изменить в любой момент. Запишем имя arrow_If_down.
3. Выделить запись и в окне приложения TextEditor справа в столбце Word запишем слово, в столбце Sentence1,Sentence2 - указать подсказку для текстовой записи, в столбце voice - подключить звуковой файл для текстовой записи из ResourcesEditor.
00 54.PNG

Необходимо обязательно сохранять любые изменения с текстом в редакторе TextEditor.
Для вызова текстового редактора можно воспользоваться меню Инструменты -> Редактор текстов, либо кнопкой быстрого запуска Text base.png.

Замечание. Букву Ё заменяем на Е

Импорт текстовой базы

Открыть окно импорта можно через меню Project > Import > Import From XML / CSV

TextsEditor import menu.jpg


Настройка импорта

Окно импорта:

TextEditor import dialog wnd.jpg

  • Путь к импортируемому файлу:
    • Для выбора импортируемого файла нажмите на кнопку справа поля (...)
    • Импорт возможен только из файлов .xml и .csv
  • Тип импортируемой базы:
    • База текущего проекта - импорт базы вашего текущего открытого проекта; импорт записей будет осуществлен по их id.
    • База другого проекта (наша структура xml/csv файла) - импорт текстов из другого проекта; импорт записей может быть осуществлен по структуре базы либо по именам записей.
    • Внешняя база (со своей структурой) - импорт внешнего файла с отличающейся от нашей структурой; для данного типа импорта нужна детальная настройка (об этом ниже).
  • Тип импорта:
    • Добавить как новые с сохранением структуры - для каждой импортируемой записи создает новую запись в текущей базе; сохраняется изначальная структура записей импортируемого файла.
    • Добавить как новые в отдельный каталог - создает в корне базы новый каталог, для каждой импортируемой записи создает новую запись в каталоге; сохраняется изначальная структура записей импортируемого файла относительно нового каталога.
    • Обновить записи (дополняет отсутствующие поля) - "мягкое" обновление записей - добавляет в существующие записи отсутствующие там поля, если таковые заполнены в импортируемой базе.
    • Обновить записи (заменяет поля импортированными не-пустыми) - "жесткое" обновление записей - добавляет либо заменяет в существующих записях те поля, которые заполнены в импортируемой базе.
    • Заменить записи - перезаписывает все поля записи на импортируемые, даже если в импортируемой записи они пустые.
  • Добавлять отсутствующие (новые) записи - если установлено - добавляет импортируемые записи, отсутствующие в текущей базе, как новые записи (с сохранением структуры).
  • Импорт по полю:
    • ID записи - сравнение записей при импорте по их iid.
    • Путь к записи - сравнение записей при импорте по их пути в структуре и имени записи.
    • Имя записи - сравнение записей при импорте по их имени. Берётся первое найденное имя! Для данного пункта КРАЙНЕ ЖЕЛАТЕЛЬНО иметь уникальные имена записей во избежание потери данных и лишних проблем.
  • Выбор импортируемых локализаций
    • В данном поле показаны все локализации, находящиеся в импортируемом файле.
    • Для импорта той или иной локали - отметьте её галочкой.
    • Для импорта всех локалей - отметьте их все.
    • Кнопка "Reload locales" перегружает локали импортируемого файла (например если он был изменен в процессе работы с этим окном).
    • Зелеными шариками TextsEditor green sphere.png обозначены языки, используемые в проекте (выбранные в Project > Properties > Selected languages...).
    • Серыми шариками TextsEditor gray sphere.png обозначены языки, которые на данный момент не используются в проекте. Вы можете их импортировать, но для работы с ними их нужно будет включить.

Настройка импорта из внешней базы (XML)

Окно импорта внешней XML базы:

TextEditor import custom base.jpg

Элементы интерфейса:

  • (1) - структура импортируемого файла
  • (2) - выбранный элемент структуры, отвечающий за текстовую запись
  • (3) - структура выбранного элемента текстовой записи
  • (4) - основные параметра записи - id, имя и каталог
  • (5) - параметры импорта локалей

Пошаговая инструкция на примере xml нашей текстовой базы

  1. В структуре импортируемого файла (1) найдите элемент, отвечающий за текстовую запись, и дважды кликните по нему левой кнопкой мыши (ЛКМ)
  2. Задайте соответствие между полями в структуре выбранного элемента (3) и необходимыми полями для нашей текстовой базы (4):
    Первый способ сделать это: перетащите строку из структуры (3) в соответствующее поле (4)
    TextEditor import custom dragndrop.jpg
    Второй способ: выбрать нужную строку (3) и нажать кнопку напротив соответствующего поля (4)
    TextEditor import custom buttonclick.jpg
    Способ третий (хардкор): вписать путь к полю вручную (делать на свой страх и риск, либо если нужного поля по какой-то причине нет в структурке)
  3. Выберите тип хранение локали и записей:
    1. Locale is attribute value - код локали находится в значении атрибута, например как в нашей базе:
      TextEditor import custom localeisvalue 1.jpg
      1. Select by sentence_id или Select sentence field - покажу на примере
        TextEditor import custom localeisvalue 2.jpg
      2. Locale - путь к атрибуту с локалью
      3. sentence_id и sentence_text - путь к атрибуту, содержащему sentnce, и путь к атрибуту, содержащему его текст
      4. _word, _sent1..3 - пути к атрибутам, содержащим соответствующие данные
    2. Locale is attribute name - код локали является самим атрибутом, а его значение - текстом
      TextEditor import custom localeisattribute 1.jpg
      TextEditor import custom localeisattribute 2.jpg
      Заполните соответствующие поля для нужных \ присутствующих в файле локалей.

После всех установок нажмите ОК. Если всё установлено правильно - вы увидите список доступных в файле языков и сможете импортировать файл.

Настройка импорта из внешней базы (CSV)

Окно импорта из CSV:

TextEditor import custom csv.jpg

Элементы интерфейса:

  • (1) - тип разделителя
  • (2) - структура csv файла
  • (3) - поля для импорта

Пошаговая инструкция:

  1. Выберите тип разделителя (1) - обычно используется табуляция (Tab \t ), но в некоторых случаях разделителем может быть другой символ.
  2. Если разделитель был изменен - для применения нажмите Reload
  3. Задайте соответствие между структурой импортируемого CSV файла (2) и полями для импорта (3)
    • Первый способ: перетащите строку из структуры (2) в соответствующее поле (3)
    • Второй способ:выбрать нужную строку (2) и нажать кнопку напротив соответствующего поля (3)
    • Третий способ: заполните поля вручную
  4. Когда все необходимые поля будут заполнены - жмите OK



Экспорт текстовой базы

Существует два варианта экспорта текстовой базы:

  • Export into txt . . . - в файл с расширением .csv (текстовый файл)
  • Export into xml . . . - в файл с расширением .xml (текстовая база)

Само окно экспорта аналогично окну импорта:

TextsEditor export menu.jpg

  • Экспорт в xml генерирует файл, идентичный файлу текстовой базы, но лишь с выбранными в окне языками;
  • При экспорте в csv создается файл такой структуры:

Text baza export 5.jpg

Экспортироваться будут лишь те языки, которые были выбраны в данном окне, вне зависимости от их наличия в базе. Пустые поля и языки экспортированы не будут.

При выборе флага "Export empty lines" будут экспортированы все пустые поля и языки, что очень полезно для перевода базы.

Добавление иконок в текстовый элемент

Необходимость добавления изображения в текстовый элемент, может возникнуть, например, при формировании элементов hiddenObject, или при работе с элементами economics. Изображение перетаскивается в текстовый элемент из редактора ресурсов мышкой. Но, в случае необходимости создать множество элементов за один раз, есть более эффективный способ:

  • На панели с кнопками быстрого запуска нажимаем Add new text records from resource....

Add new rec from.jpg

  • Открылось окошко choose resource file в нем следует выбрать необходимый sirx файл.

Choose resource file.jpg

  • В открывшемся дереве ресурсов выбираем нужную папку

Tree resources.jpg

  • Из отмеченной папки файлы преобразуются в текстовые элементы, содержащие строку word и соответствующее изображение. Причем добавятся они в текстовый редактор в папку, которая создастся в соответствии с папкой, содержащей эти иконки в редакторе ресурсов.

Если вдруг так получилось, что к текстовой записи подвязан ресурс которого больше нет в базе ресурсов -- он будет обозначен как "INVALID RESOURCE":

TextsEditor invalid image.JPG

Поиск записи в текстовой базе

Окно поиска текстовой записи активируется при нажатии кнопки быстрого запуска Text base find.png.
Text base find wind.jpg
Поиск проходит по непосредственно содержимому текстового поля.
Поиск по дереву базы может проходить сверху вниз и снизу вверх, если выбрать один из пунктов группы Find direction:

  • down - искать сверху вниз;
  • up - искать снизу вверх.

Для оптимизации процесса поиска можно выбрать в группе Find mode один из следующих пунктов:

  • in the whole tree - искать во всем дереве;
  • from the current item - искать от текущего элемента.

Строка, которая вводится в строку поиска может быть подстрокой интересующей нас записи либо же полностью с ней совпадать. Это можно регулировать с помощью пункта Only the whole text.