Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Директория assets может содержать в себе четыре поддиректории:
    images — изображения;
    javascripts — JavaScript-файлы ( в формате CoffeeScript,  (расширение .js.coffee) или на чистом JavaScript (расширение .js);
    stylesheets — CSS-стили (в формате SASS, расширение файлов .sass);
    templates — hamlc-шаблоны.
    Для сборки статичных файлов используется Assets Pipeline.
  2. Директория locales содержит файлы локализации. Для интернационализации в проекте используются библиотеки i18n, R18n и i18n-js. Весь отображаемый в приложении текст берется из файлов локализации (директория config/locales в директории с версией приложения). Для добавления пользовательского текста следует создавать дополнительные файлы в директориях $latera_client и $server_client. Для замены существующего текста достаточно в этих файлах переопределить перевод по нужному ключу (таким образом можно изменить любой текст в приложении).
  3. Директория widgets хранит настройки виджетов — настраиваемых программных сущностей приложения. Все элементы, требующие настройки, настраиваются через виджеты. Настройки виджетов хранятся в YAML. Содержимое всех файлов в директориях widgets объединяется при загрузке.

...

  1. Для добавления изображений достаточно поместить их в директорию images.
  2. Добавление стилей и JavaScript-кода должно начинаться с добавления файлов custom в корне директории (файлы custom.sass и custom.js.coffee соответственно, для формы входа в ЛК - custom_login.sass). В этих файлах можно подключить остальные пользовательские файлы (с любыми именами, см. документацию по Assets Pipeline). Пользовательские файлы будут иметь больший приоритет при подключении, поэтому их названия не должны совпадать с названиями файлов приложение приложения (исключая случай, когда требуется пропустить загрузку каких-то файлов приложения). При выборе имен файлов надо учитывать, что сборщик статичных файлов отбрасывает расширение и файлы с одинаковым именем, но разным расширением могут конфликтовать, в этом случае сборщик выберет какой-то один файл. Пример такого конфликта: файлы custom.js и custom.js.coffee в одной директории.
  3. Для добавления файлов локализации достаточно поместить их в директорию locales. Крайне желательно соблюдать при этом соглашение о наименовании. В начале файла должно находиться название локали. Например, ru.yml или ru.widgets.yml.

...