Различия между версиями 13 и 17 (по 4 версиям)
Версия 13 от 2010-09-29 09:22:34
Размер: 7615
Редактор: RostislavDzinko
Комментарий:
Версия 17 от 2010-09-29 10:05:37
Размер: 8153
Редактор: RostislavDzinko
Комментарий:
Удаления помечены так. Добавления помечены так.
Строка 35: Строка 35:
You can create a new package named skin inside tc namespace. All the skin related things will be added here. First create the skin directory and __init__.py file to make it a Python package: Вы можете создать новый пакет с именем '''skin''' внутри пространства имен '''tc'''. Все вещи, связанные со скином, будут добавляться здесь. Сначала создайте папку '''skin''' и файл _ _init_ _.py, чтобы создать пакет Python:
Строка 41: Строка 41:
The skin definition will be placed in src/tc/skin/interfaces.py and the registration in src/tc/skin/configure.zcml. To create a new layer, you need to write an interface of the type IBrowserSkinType. You can create ITCLayer as given below in src/tc/skin/interfaces.py:
Определение скина будет находится в ''src/tc/skin/interfaces.py'', а регистрация в ''src/tc/skin/configure.zcml''. Чтобы создать новый слой, вам следует описать интерфейс типа '''IBrowserSkinType'''. Создайте '''ITCLayer''', как показано ниже, в ''src/tc/skin/interfaces.py'':
Строка 51: Строка 52:
Note Interface type
The IBrowserSkinType is an interface type similar to Interface. To create an interface type, you can create an interface inheritting from zope.interface.interfaces.IInterface. For example:
from zope.interface.interfaces import IInterface
'''Тип интерфейса'''

'''IBrowserSkinType''' - интерфейс, который очень похож на '''Interface'''. Чтобы создать тип интерфейса, создайте интерфейс, наследуясь от ''zope.interface.interfaces.IInterface''. Например:
Строка 57: Строка 58:
from zope.interface.interfaces import IInterface
Строка 61: Строка 64:
To use this layer, you can change all page, viewletmanager, and viewlet directives to specify this layer: Чтобы использовать этот слой, поменяйте все директивы '''page''', '''viewletmanager''', и '''viewlet''', чтобы они указывали на его использование:

Учебник - часть 3

Введение

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

Есть два термина, которые ассоциируются с внешним видом - слой (layer) и скин (skin). Перед тем, как продолжить, следует лучше разобраться в этих понятиях BlueBream.

Слои

Слой определяет ощущение (feel) пользовательского интерфейса приложения. Слой содержит логику отображения приложения. Логика отображения включает в себя вывод страниц и расстановку виджетов. Общими вещами для слоев являются страницы, контент-провайдеры, менеджеры вьюдетов и вьюлеты. Слои разрабатываются BlueBream (Python) разработчиками.

Скины

Скин определяет внешний вид пользовательского интерфейса приложения. Общими понятиями для скинов являются шаблоны (ZPT) и ресурсы (CSS, Javascript, и т.д.). Скин использует слои для получения данных шаблонами. Скины разрабатываются HTML верстальщиками и графическими дизайнерами.

Слои против скинов

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

И слои и скины поддерживают наследование/заимствование. Этот механизм реализуется путем комбинирования наследования интерфейсов и техник просмотра компонентов.

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

В этом разделе обсуждается создание нового скина для приложения "сборщик заявок".

Новый скин

Все виды (представления) по умолчанию регистрируются на слой, который установлен по умолчанию. Следовательно, вам не нужно явно указывать слой, чтобы зарегистрировать вид на слой по умолчанию. Интерфейс, который определяет слой по умолчанию, находится тут: zope.publisher.interfaces.browser.IDefaultBrowserLayer. Слой по умолчанию содержит множество вещей, которые вам не всегда нужны (настройки безопасности). Поскольку очень много всего в zope.app зарегистрировано на слой по умолчанию, он содержит неконтролируемое количество мусора. Очень трудно подтвердить, что все регистрации соответствуют потребностям безопасности вашего приложения. Другая проблема в том, что эти виды могут быть доступны, даже когда вы этого не хотите. И хотя рекомендуется разрабатывать слои с нуля, некоторые регистрации в слое по умолчанию могут быть очень даже полезными. Примерами являются регистрации видов страниц с ошибками, регистрации траверсинга, и виджеты.

Установка слоя

Вы можете создать новый пакет с именем skin внутри пространства имен tc. Все вещи, связанные со скином, будут добавляться здесь. Сначала создайте папку skin и файл _ _init_ _.py, чтобы создать пакет Python:

   1 $ mkdir src/tc/skin
   2 $ echo "#Python Package" > src/tc/skin/__init__.py

Определение скина будет находится в src/tc/skin/interfaces.py, а регистрация в src/tc/skin/configure.zcml. Чтобы создать новый слой, вам следует описать интерфейс типа IBrowserSkinType. Создайте ITCLayer, как показано ниже, в src/tc/skin/interfaces.py:

   1 from zope.publisher.interfaces.browser import IBrowserSkinType
   2 
   3 class ITCLayer(IBrowserSkinType):
   4     """Ticket collector application layer"""

Тип интерфейса

IBrowserSkinType - интерфейс, который очень похож на Interface. Чтобы создать тип интерфейса, создайте интерфейс, наследуясь от zope.interface.interfaces.IInterface. Например:

   1 from zope.interface.interfaces import IInterface
   2 
   3 class IMyInterfaceType(IInterface):
   4     """My interface type"""

Чтобы использовать этот слой, поменяйте все директивы page, viewletmanager, и viewlet, чтобы они указывали на его использование:

   1 layer="tc.skin.interfaces.ITCLayer"

Документации/Bluebream/BluebreamУчебник3 (последним исправлял пользователь RostislavDzinko 2010-09-29 10:41:57)