Урок №2. Создание нового документа

Начнем с примера, который часто будет использоваться на практике: с создания нового документа. Вот код, который нужно вставить в новый документ ESTK и запустить на исполнение.

Код скрипта в ESTK

Код скрипта в ESTK

Для запуска нужно нажать зеленую кнопку Run

Для запуска нужно нажать зеленую кнопку Run

#target indesign
app.documents.add();

Разберем подробно, что есть в этом коде и зачем оно там.

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

В ESTK можно вручную выбрать приложение, в котором будет запущен скрипт, но наличие директивы имеет приоритет и в целом удобнее.

По-умолчанию скрипт запускается в самом ESTK

По-умолчанию скрипт запускается в самом ESTK

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

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

Если при запуске скрипта приложение, в котором должен работать скрипт, не запущено, то ESTK автоматически запустит его.

Автозапуск приложения, указанного директивой препроцессора

Автозапуск приложения, указанного директивой препроцессора

Вторая строка скрипта дает команду InDesign создать новый документ. Разберем ее буквально по словам.

  • app (сокращение от «application»  —  приложение)  —  обращение к InDesign.
    Если скрипт должен взаимодействовать с InDesign, то для обращения к настройкам и свойствам InDesign, а также для обращения к любым объектам внутри приложения следует начинать с обращения к app.
  • documents  —  обращение к коллекции документов InDesign.
    Объектную модель (структуру и взаимосвязь объектов) можно представить в виде дерева. Объект app  —  это ствол, коллекция документов documents  —  это ветка. В коллекции тоже могут быть ветки  —  отдельные документы. А может и не быть, если коллекция пустая. У каждого документа в коллекции documents есть свои ветки  —  свойства и методы. К любому объекту в InDesign можно обратиться по цепочке, начиная с app. И в обратную сторону точно так же можно пройти от любого объекта до объекта app и не заблудиться.
    Коллекция  —  это широко используемый способ организации объектов InDesign в группы, которыми удобно управлять. Коллекция имеет определенное сходство со стандартным массивами, но обладает некоторыми особенностями, которые мы рассмотрим позже.
  • add()  —  команда, которая создает новый элемент в коллекции.
    В нашем случае это будет новый документ, поскольку мы вызываем эту команду для коллекции documents. Как уже было сказано раньше, коллекции используются очень широко: у объекта app есть коллекция документов documents, у каждого документа в коллекции есть коллекция страниц pages (рассмотрим в ближайших уроках), и так далее.
    Команды работы с коллекциями в достаточной мере унифицированы, поэтому основные методы работы с коллекциями, такие, как добавление новых элементов, схожи вплоть до полной идентичности.

Точки между словами соединяют команды в одну цепочку. В переложении на человеческий язык строка команды обозначает: «В приложении InDesign найти коллекцию documents и добавить в нее новый элемент».

Добавить комментарий

Заполните поля или щелкните по значку, чтобы оставить свой комментарий:

Логотип WordPress.com

Для комментария используется ваша учётная запись WordPress.com. Выход /  Изменить )

Google photo

Для комментария используется ваша учётная запись Google. Выход /  Изменить )

Фотография Twitter

Для комментария используется ваша учётная запись Twitter. Выход /  Изменить )

Фотография Facebook

Для комментария используется ваша учётная запись Facebook. Выход /  Изменить )

Connecting to %s