OmniGraffle 3 Reference Manual for iOS

Приложение F

Переменные

Переменная в OmniGraffle — это строка, которую можно использовать для вставки подписей объектов и линий на основе другой информации в вашем документе. Эти переменные ищут элементы с аналогичными именами в исходном коде XML-документа OmniGraffle и отображают соответствующие данные, относящиеся к строке. Например, можно использовать переменную <%Layer%> в качестве текстового объекта на полотне для отображения имени этого слоя.

С помощью переменной <%UserData%> пользователи версии OmniGraffle Pro получают доступ к сведениям уровня документа и к метаданным, введенным в инспекторе «Метаданные полотна».

Универсальные переменные

В версиях OmniGraffle Standard и Pro используется одинаковый основной набор переменных, которые перечислены в следующей таблице.

Переменная Описание
Переменные полотна и слоев
<%Canvas%> Имя полотна.
<%CanvasNumber%> Номер положения полотна на боковой панели.
<%TotalCanvases%> Общее количество полотен в документе.
<%Layer%> Имя слоя.
Переменные документов
<%Document%> Имя файла документа OmniGraffle.
<%Creator%> Имя пользователя, создавшего документ.
<%Modifier%> Имя последнего пользователя, изменившего документ.
<%#%> Номер текущей страницы на основании положения объекта на полотне по отношению к разметке печатных страниц.
<%TotalPages%> Общее количество печатных страниц в документе.
Переменные дат
<%Date%> Сегодняшняя дата.
<%CreationDate%> Дата создания документа.
<%ModificationDate%> Дата последнего изменения документа.
Строки даты, используемые в переменных дат
y Двузначное число, обозначающее год на основе декады. Например, 16 означает 2016 год.
Y Четырехзначное число, обозначающее год, например, 2016.
m Месяц, обозначаемый двузначным числом от 01 до 12. Например, 10 означает октябрь.
d Число месяца, обозначаемое двузначным числом от 01 до 31 (если в месяце 31 день), например, 05 означает пятое число.
c Текущая дата и время, например, вторник, 11 июля 10:00:00 PDT 2017.
H Часы, обозначаемые двузначным числом от 00 до 23, например, 11 означает 11 часов утра, а 23 — 11 часов вечера.
M Минуты, обозначаемые двузначным числом от 00 до 59.
S Секунды, обозначаемые двузначным числом от 00 до 59.
z Разница со средним временем по Гринвичу. Например, -0700 означает, что местное текущее время отстает от времени по Гринвичу на 7 часов.
Переменные объектов
<%X%> Расстояние объекта от начальной точки по горизонтали.
<%Y%> Расстояние объекта от начальной точки по вертикали.
<%Width%> Ширина объекта.
<%Height%> Высота объекта.
<%Length%> Длина объекта.
<%GraphicName%> Имя объекта.
Переменные инспектора «Данные документа»
<%Subject%> Текст в поле «Тема» инспектора «Данные документа».
<%Copyright%> Текст в поле «Авторские права» инспектора «Данные документа».
<%Version%> Текст в поле «Версия» инспектора «Данные документа».
<%Description%> Текст в поле «Описание» инспектора «Данные документа».
<%Comments%> Текст в поле «Комментарии» инспектора «Данные документа».
<%Authors%> Имена одного или нескольких авторов в поле «Авторы» инспектора «Данные документа».
<%Organizations%> Текст в поле «Организации» инспектора «Данные документа».
<%Languages%> Один или несколько языков, указанных в поле «Языки» инспектора «Данные документа».
<%Keywords%> Одно или несколько ключевых слов, указанных в поле «Ключевые слова» инспектора «Данные документа».
<%Projects%> Один или несколько документов, указанных в поле «Проекты» инспектора «Данные документа».

Строки даты, используемые в переменных дат

Как указано в предыдущей таблице, в OmniGraffle используются три переменные дат, дающие возможность удобно отслеживать состояние работы над документами.

  • Текущая дата (<%Date%>) — вставка текущей даты. Это особенно удобно, если нужно поставить на документ «штамп» текущей даты при его экспорте или печати.

  • Дата создания документа (<%CreationDate%>) — вставка даты первоначального создания документа согласно коду XML документа.

  • Дата изменения документа (<%ModificationDate%>) — вставка даты последнего сохранения документа согласно коду XML документа.

Переменные дат особенно удобны при использовании в сочетании с переменными <%Creator%> и <%Modifier%>, когда нужно узнать, кто последним обновил файл документа.

При использовании переменных данных можно настроить формат данных с помощью переменных. Например, чтобы получить дату в формате 2017-10-05 08:37:30 -0700Z, можно использовать следующую строку переменных:

<%date %Y-%m-%d %H:%M:%S %zZ %>

Наши переменные дат работают на основе логики, используемой в токенах Cocoa для форматирования дат.