Различия между версиями 15 и 18 (по 3 версиям)
Версия 15 от 2010-09-29 10:03:21
Размер: 7929
Редактор: RostislavDzinko
Комментарий:
Версия 18 от 2010-09-29 10:06:53
Размер: 10107
Редактор: RostislavDzinko
Комментарий:
Удаления помечены так. Добавления помечены так.
Строка 52: Строка 52:
Тип интерфейса '''Тип интерфейса'''
Строка 54: Строка 54:
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''. Например:
Строка 59: Строка 58:
from zope.interface.interfaces import IInterface
Строка 63: Строка 64:
To use this layer, you can change all page, viewletmanager, and viewlet directives to specify this layer: Чтобы использовать этот слой, поменяйте все директивы '''page''', '''viewletmanager''', и '''viewlet''', чтобы они указывали на его использование:
Строка 68: Строка 69:

== Установка скина ==

Skins are also interfaces defined using zope.interface package. You can created skin interfaces by inheritting from the layer interface. For example, here is the ITCSkin inheritted from ticket collector application layer (ITCLayer):

{{{#!highlight python
class ITCSkin(ITCLayer):
    """Skin for ticket collector app."""
}}}

To register this you can use interface and utility directives in zope namespace. Add this to src/tc/skin/configure.zcml:

{{{#!highlight xml
<configure
   xmlns="http://namespaces.zope.org/zope"
   xmlns:browser="http://namespaces.zope.org/browser"
   i18n_domain="ticketcollector">

  <interface
      interface="tc.skin.interfaces.ITCSkin"
      type="zope.publisher.interfaces.browser.IBrowserSkinType"
      />

  <utility
      component="tc.skin.interfaces.ITCSkin"
      provides="zope.publisher.interfaces.browser.IBrowserSkinType"
      name="TCSkin"
      />

</configure>
}}}

As a shortcut, you can also just use the interface directive and pass the name parameter. The following one directive has the same effect as the two above regarding the skin registration:

{{{#!highlight xml
<interface
    interface="tc.skin.interfaces.ITCSkin"
    type="zope.publisher.interfaces.browser.IBrowserSkinType"
    name="TCSkin"
    />
}}}

The skin definition is complete now, but it is not yet included from the main package. To include this package in the main package (tc.main) you need to modify the src/tc/main/configure.zcml and add this line before </configure>:

<include package="tc.skin" />
You can register all templates for this skin by adding the layer attribute:

{{{#!highlight xml
layer="tc.skin.interfaces.ITCSkin"
}}}

As you can see, you don’t have to create an extra layer just to create a custom skin. But it is not reccommended to declare any views for the skin directly, rather you can register for the layer.

Учебник - часть 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"

Установка скина

Skins are also interfaces defined using zope.interface package. You can created skin interfaces by inheritting from the layer interface. For example, here is the ITCSkin inheritted from ticket collector application layer (ITCLayer):

   1 class ITCSkin(ITCLayer):
   2     """Skin for ticket collector app."""

To register this you can use interface and utility directives in zope namespace. Add this to src/tc/skin/configure.zcml:

   1 <configure
   2    xmlns="http://namespaces.zope.org/zope"
   3    xmlns:browser="http://namespaces.zope.org/browser"
   4    i18n_domain="ticketcollector">
   5 
   6   <interface
   7       interface="tc.skin.interfaces.ITCSkin"
   8       type="zope.publisher.interfaces.browser.IBrowserSkinType"
   9       />
  10 
  11   <utility
  12       component="tc.skin.interfaces.ITCSkin"
  13       provides="zope.publisher.interfaces.browser.IBrowserSkinType"
  14       name="TCSkin"
  15       />
  16 
  17 </configure>

As a shortcut, you can also just use the interface directive and pass the name parameter. The following one directive has the same effect as the two above regarding the skin registration:

   1 <interface
   2     interface="tc.skin.interfaces.ITCSkin"
   3     type="zope.publisher.interfaces.browser.IBrowserSkinType"
   4     name="TCSkin"
   5     />

The skin definition is complete now, but it is not yet included from the main package. To include this package in the main package (tc.main) you need to modify the src/tc/main/configure.zcml and add this line before </configure>:

<include package="tc.skin" /> You can register all templates for this skin by adding the layer attribute:

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

As you can see, you don’t have to create an extra layer just to create a custom skin. But it is not reccommended to declare any views for the skin directly, rather you can register for the layer.

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