Почтовая Информация о версии Канцелярской бумаги для OS X v10.5

Почтовая Канцелярская бумага является новой функцией в Mac OS v10.5. Каждый шаблон Почтовым приложением позволяет пользователям настраивать свои электронные письма. Каждый шаблон канцелярской бумаги является пакетом, содержащим все файлы, должен был вывести на экран канцелярскую бумагу.

Содержание:

Пакеты канцелярской бумаги

Список свойств описания

Description.plist файл является списком свойств, содержащим оглавление, описывающее все другие файлы в папке канцелярской бумаги. Это находится в папке Resources пакета канцелярской бумаги.

Список свойств описания содержит словарь со следующими ключами:

  • Имя канцелярской бумаги — имя канцелярской бумаги, поскольку это выведено на экран пользователю. Требуемый.

  • Канцелярская бумага ID — уникальный идентификатор для канцелярской бумаги. Предложено, чтобы Почта создала эту запись. Требуемый.

  • Файл HTML — имя файла HTML, включая любые расширения. Требуемый.

  • Изображение миниатюр — имя файла, содержащего изображение миниатюр канцелярской бумаги. Этот ключ является дополнительным. Если это отсутствует, Почта создает изображение миниатюр, сохраняет его в пакет канцелярской бумаги и добавляет запись в Описание.

  • Фоновые изображения — массив имен изображений, на которые ссылаются как фоновые изображения в HTML. Требуемый, если канцелярская бумага имеет какие-либо фоновые изображения.

  • Мозаичное Фоновое изображение — имя фонового изображения для HTML BODY. Требуемый, если канцелярская бумага имеет a BODY фоновое изображение.

  • Мозаичное Фоновое Смещение — словарь с информацией о расположении BODY фоновое изображение. Этот словарь имеет четыре возможных ключа, Пиксели X, Пиксели Y, Часть X и Часть Y. Первые два ключа соответствуют абсолютным значениям CSS и последним двум к значениям процента CSS. Дробные значения являются значениями плавающими от 0 до 1. Если эта запись отсутствует или неполная, значение по умолчанию значений для Фракционирования X являющийся 0.5 и Пиксели Y быть 0, соответствие записи CSS background-position: 50% 0).

  • Изображения — массив имен любых локальных изображений, в которых ссылаются IMG теги в HTML. Требуемый, если станция имеет какие-либо локальные изображения кроме фоновых изображений.

  • Составные Изображения — массив словарей. Каждый словарь представляет одно составное изображение, упомянутое в файле HTML канцелярской бумаги. Посмотрите Составные Изображения для получения дополнительной информации о IMG тег и изображения компонента. Каждое составное изображение, упомянутое в файле HTML, должно иметь запись. Каждый из ключей, описанных ниже, требуется, если присутствует изображение, которое идентифицирует ключ.

    • Составное Имя — значение SRC атрибут в IMG тег, представляющий составное изображение.

    • Базовое изображение — имя файла изображения, формирующего основу или фон, составного изображения.

    • Изображение наложения — имя файла изображения, которое будет использоваться в качестве верхнего слоя составного изображения.

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

      • Имя файла — имя файла рисунка маски.

      • Смещение Зоны отбрасывания — позиция нижнего левого угла ограничительной рамки, содержащей видимую зону отбрасывания. Это - массив целых чисел (x, y).

      • Угол Зоны отбрасывания — угол, значение плавающее измерилось в градусах, через которые повернуто изображение пользователя. Углы измеряются против часовой стрелки.

      • Размер Зоны отбрасывания — ширина и высота ограничительной рамки, содержащей видимую зону отбрасывания. Это - массив целых чисел (ширина, высота).

Файл HTML

Файл HTML определяет содержание канцелярской бумаги. Это может содержать любой допустимый HTML, выводящий на экран правильно во всех почтовых клиентах. Это не должно содержать JavaScript. Следующие разделы описывают другие типы содержания и элементов HTML, которые могут использоваться в файле HTML.

Содержимое HTML

По умолчанию содержание канцелярской бумаги не доступно для редактирования пользователем. Каждая область документа, что пользовательские редактирования должны быть окружены элементом, такой как DIV или SPAN, с contenteditable припишите набор YEStrue.

У этого пользователя доступный для редактирования элемент должен быть атрибут apple-content-name, чье значение является меткой для доступного для редактирования раздела. Эти метки используются, чтобы указать, как содержание пользователя передается, когда пользователь переключается от одной канцелярской бумаги до другого. Стандартные значения, используемые в канцелярской бумаге Apple, body и title. Когда пользователь переключается от одной канцелярской бумаги до другого, body содержание, если пользователь отредактировал его, передается body элемент новой канцелярской бумаги, и аналогично для title.

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

Динамические элементы

Динамические элементы являются заполнителями, которые могут быть вставлены в файл HTML канцелярской бумаги. Когда канцелярская бумага загружается в Новое Окно сообщения, динамический элемент заменяется статическим содержанием. Динамический элемент представлен a SPAN элемент с именем класса AppleStationeryDynamicElement. Любой HTML, содержавшийся в SPAN элемент отбрасывается, когда канцелярская бумага загружается — кроме случая, где не может быть вставлено желаемое содержание. В этом случае, содержание SPAN выведен на экран. SPAN тег должен также иметь apple-content-type атрибут, указывающий, каково заменяющее содержание. Например, значение «полного имени» для apple-content-type указывает, что динамический элемент может быть заменен полным именем пользователя. Следующие значения для apple-content-type доступны:

full-name

Полное имя пользователя от Меня карта в Адресной книге.

first-name

Имя пользователя от Меня карта в Адресной книге.

email

Адрес электронной почты учетной записи, используемой для отправки сообщения.

date

Текущая дата.

Динамический элемент типа date должен также иметь a date-format атрибут. Его значение является строкой формата, как используется NSCalendarDate.

Изображения

Локальные изображения, в которых Вы предоставляете как ресурсы в пакете канцелярской бумаги и ссылка IMG теги встраиваются в сообщение, когда оно отправляется. URL в каждом IMG тег или фоновый атрибут являются путем относительно папки Resources пакета. Все IMG элементам нужны атрибуты ширины и высоты с абсолютом, не относительным, значения.

Фоновые изображения, на которые ссылаются в списке свойств описания, также быть встроенными в сообщение, когда это отправляется. Эти изображения очень подобны локальным изображениям, но не указаны в IMG тег, и имеет различный ключ в файле Описания.

Составные изображения

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

Составное изображение указано в HTML с IMG тег, чей src атрибут является именем составного изображения. Путь не может содержащий запаздывающую наклонную черту. Это имя не является именем файла, но совпадает с Составным Именем, данным в списке свойств описания. Поскольку конечный пользователь может видеть это имя, это должно быть что-то подходящее для пользователя для наблюдения. IMG тег также имеет имя класса AppleCompositeImage.

Каждый рисунок маски определяет область, в которой пользователь может отбросить изображение. Единственные данные в использующейся маске являются альфа-каналом. Когда пользователь отбрасывает изображение в зоне отбрасывания, изображение повернуто на угол зоны отбрасывания, указанный в списке свойств описания. Это тогда измерено (поддержание его пропорций) использование размера зоны отбрасывания и расположило использование смещения зоны отбрасывания от файла Описания. Затем, альфа от маски установлена как альфа для изображения пользователя.

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

Изображения

Изображения, на которые ссылаются IMG теги или как фоновые изображения включены в папку Resources пакета канцелярской бумаги. Они должны также быть перечислены в записи Изображений в списке свойств описания. Когда сообщение отправляется, данные для этих изображений встраиваются в сообщение.

Составные изображения

. Если канцелярская бумага в папку Resources составного раздела изображений пакета канцелярской бумаги, файл HTML содержит любые ссылки для составления композита изображений, файлы, используемые для создания составного изображения включена, они идентифицируются с Базовым изображением, Изображением Наложения, и Маски вводят Description.plist файл, как описано выше.

Изображение миниатюр

Каждый пакет канцелярской бумаги должен содержать изображение миниатюр канцелярской бумаги. Если изображение миниатюр не присутствует, Почта создает один и вставляет запись для него в списке свойств описания. Изображение миниатюр должно иметь размерности 69 x 90 пикселей.

Папка канцелярской бумаги

Пакеты канцелярской бумаги сохранены в /Library/Application Support/Apple/Mail/Stationery. В этом Stationery папка является папками, группирующими канцелярские принадлежности в категории. Каждая папка категории содержит пакеты канцелярской бумаги.

Папка Stationery и каждая папка категории содержат названный файл TableOfContents.plist. Файл является первоначально дополнительным, потому что Почта создает его или обновляет его при необходимости. Если новые пакеты канцелярской бумаги или новые папки категории добавляются, не добавляя записи для них в файлах оглавления, Почта автоматически добавляет их к надлежащему файлу оглавления. Однако может быть желательно добавить записи вручную для новых пакетов канцелярской бумаги и категорий для управления порядком представления и имен, представленных пользователю.

Оглавление канцелярской бумаги

Файл оглавления в папке Stationery содержит массив словарей, каждый из которых представляет одну папку категории. Порядок записей в словаре определяет порядок, в котором категории выведены на экран пользователю.

Словарь, представляющий категорию, имеет три ключа, несмотря на то, что Почта генерирует двух из них автоматически, если они отсутствуют. Требуемой записью является Имя папки, дающее имя файла папки категории. Пользовательское имя (включая изменения случая) резервируется и не должно использоваться в качестве имени папки категории. Другие записи являются Именем Дисплея и Категорией ID. Если Имя Дисплея отсутствует, Имя папки используется в качестве имени дисплея, и если предоставлена Категория, которую ID пропускает, строка уникального идентификатора.

Оглавление категории

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

Словарь, представляющий канцелярскую бумагу, имеет четыре ключа. Требуемая запись, Имя папки, дает имя файла, включая почтовое расширение канцелярской бумаги, пакета канцелярской бумаги. Другие три записи являются Именем Дисплея, Изображением миниатюр и Канцелярской бумагой ID. Если какая-либо из этих последних трех записей отсутствует, Почта ищет их в списке свойств описания канцелярской бумаги, и добавьте их к оглавлению. если Канцелярская бумага тот, которой ID не найден, Почта генерирует