marr weblog

Map Should Be Art Work

2012-01-11T17:11:00.003+08:00

在黃清琦老師的演講裡，他提到「地圖應該可以包含藝術美感的元素，而不只是客觀數據的呈現，有時候必須加入製圖人的主觀美學意見」。舉的例子是，從 GIS 精準的角度，標示的點可能出現在不符規範的位置，例如某個城市被標在河湖裡，此時適度地移標是必要的。臺灣輿圖暨解說圖研究的完成，是以台灣地形圖為基礎來整合舊的史地資料，必須假設長期以來地形未變，如果有局部的資料顯示地形隨時間曾改變，則需要修正。

KeyError: 'constrainTypesMode'

2011-12-29T17:38:00.001+08:00

Here is an excerpt of error I run into:

URL: plone/app/layout/viewlets/contentactions.pt
Line 32, Column 8
Expression: <StringExpr u'plone.contentmenu'>
...
URL: plone/app/contentmenu/contentmenu.pt
Line 1, Column 0
Expression: <PathExpr standard:u'view/menu'>
...
KeyError: 'constrainTypesMode'

It turns out from my typo in content/mytype.py, by the time when I hesitate whether if using a folderish type:

-ArticleSchema = folder.ATContentTypeSchema.copy()
+ArticleSchema = folder.ATFolderSchema.copy()

Files to Edit for Adding Archetypes Type

2011-12-29T15:05:00.002+08:00

除了用 zopeskel 來建立 Content Type 的方法，手動編輯檔案的話，下列是相關檔案的順序列表：

interfaces/__init__.py
interfaces/mytype.py
content/configure.zcml
content/mytype.py
profiles/default/factorytool.xml
profiles/default/types.xml
profiles/default/types/mytype.xml
config.py
browser/configure.zcml
browser/mytype.py
browser/templates/mytype.pt
locales/

typesUseViewActionInListings in Plone PropertiesTool

2011-12-27T12:43:00.001+08:00

In my archetypes-based project, I create a folderish type Book to contain Chapter type. One of the last steps is to add Chapter type in typesUseViewActionInListings field.

For GenericSetup, it is in profiles/default/propertiestool.xml:

<property name="typesUseViewActionInListings" type="lines">
 <element value="Image"/>
 <element value="File"/>
 <element value="Chapter"/>
</property>

Note that if Book added to that field, it will be bothering when you browse Book items in Contents tab.

Collective TinyMCE Templates

2011-12-19T23:37:00.000+08:00

collective.tinymcetemplates is a TinyMCE Plugin for templates and snippets. It works with Plone 4.1.3. You can see a "Insert predefined template content" icon added:

Transmogrifier Export in Action

2011-12-19T11:29:00.001+08:00

transmogrifier 可以匯入或匯出 Plone 網站的內容，之前的經驗以匯入 CSV 或 PostgreSQL 資料為主，現在完成匯出到 PostgreSQL 的實作。

以 develop.cfg 為例，要修改的內容如下：

eggs +=
    psycopg2
    SQLAlchemy == 0.6.5
    zope.sqlalchemy
    plone.app.transmogrifier

客製 myproj.transmogrifier 的內容摘要如下：

myproj.transmogrifier/configure.zcml

  <transmogrifier:registerConfig
    name="myproj.transmogrifier.exportContent"
    title="MyProject Export Content"
    description="Transmogrifier Pipeline config to export contents."
    configuration="confs/export.cfg"
    />

  <!-- register our blueprints -->
  <utility
    component=".contentexport.ContentExporterSection"
    name="myproj.transmogrifier.contentexporter"
    />

myproj.transmogrifier/browser/configure.zcml

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:browser="http://namespaces.zope.org/browser"
    xmlns:zcml="http://namespaces.zope.org/zcml">

    <browser:page
        for="*"
        class=".contentexport.ContentExport"
        name="content-export"
        permission="cmf.ManagePortal"
        />
<configure>

myproj.transmogrifier/browser/contentexport.py

class ContentExport(BrowserView):

    def __call__(self):
        transmogrifier = ITransmogrifier(self.context)
        transmogrifier('myproj.transmogrifier.exportContent')
        self.request.response.write('exported')

myproj.transmogrifier/confs/export.cfg

[transmogrifier]
pipeline =
    contentexport

[contentexport]
blueprint = myproj.transmogrifier.contentexporter
dsn = postgresql://myuser:mysecret@localhost:5432/mydb
portal-types = News Item, Event
review-states = published

另外，還有 myproj.transmogrifier/models.py 和 myproj.transmogrifier/contentexport.py 兩個主檔，分別負責資料庫連線和匯出工作。

Search Portlet for Current Section

2011-12-18T00:13:00.000+08:00

By default, Plone provides a searchbox viewlet and a search portlet. With the viewlet, you can decide whether to search only within the current section. However, the porlet does not apply this behavior. My requirement could be illustrated by this screenshot:

Here are the files to be modified:

$ diff plone/app/portlets/portlets/search.py
55a56,61
>     def folder_path(self):
>         context_state = getMultiAdapter((self.context, self.request),
>                                          name=u'plone_context_state')
>         folder = context_state.folder()
>         return '/'.join(folder.getPhysicalPath())
>

$ diff plone/app/portlets/portlets/search.pt
29a30,44
>
>         <div class="searchSection">
>             <input id="searchbox_currentfolder_only"
>                    class="noborder"
>                    type="hidden"
>                    name="path"
>                    tal:attributes="value view/folder_path"
>                    />
>             <label for="searchbox_currentfolder_only"
>                    i18n:translate="label_searchbox_currentfolder_only"
>                    style="cursor: pointer">
>                 only in current section
>             </label>
>         </div>
>

Table View in Contents Tab

2011-12-16T16:37:00.003+08:00

Here is the default view for Plone.

I want Published column instead of Modified column. By 'grep -r listing-table' I find the target file is at plone.app.content/browser/table.pt. Related python files are batching.py, container.py and browser/tavleview.py. My naive guess of changing keyword modified to effective, does not work, showing LocationError.

Display Logos Based on Paths

2011-12-16T10:31:00.001+08:00

Here is a customization in plone.app.layout/viewlets/common.py that can display customized logos based on tab paths.

class LogoViewlet(ViewletBase):
    index = ViewPageTemplateFile('logo.pt')

    def update(self):
        super(LogoViewlet, self).update()

        portal = self.portal_state.portal()
        bprops = portal.restrictedTraverse('base_properties', None)
        if bprops is not None:
            logoName = bprops.logoName
        else:
            logoName = 'logo.jpg'
        plone_url = getToolByName(self.context, 'portal_url')()
        plone_url_len = len(plone_url)
        request = self.request
        url = request['URL']
        path = url[plone_url_len:]
        if path.startswith('/news'):
            logoName = 'logo-news.png'
        if path.startswith('/events'):
            logoName = 'logo-events.png'

To illustrate how the path variable works, add a Python Script in ZMI and use the following sample code:

from Products.CMFCore.utils import getToolByName

plone_url = getToolByName(context, 'portal_url')()
print "plone_url = %s\n" % (plone_url),
plone_url_len = len(plone_url)
request = context.REQUEST
url = request['URL']
path = url[plone_url_len:]
print "url = %s, path = %s" % (url, path)
return printed

portal_tab globalnav customization

2011-12-15T18:11:00.002+08:00

portal_tab, or globalnav, or global_section in Plone, provides clickable links. Let's say, we want a tab to open in new browser window when clicked. The trick is in plone.app.layout/viewlets/sections.pt.

<ul id="portal-globalnav"
    tal:define="selected_tab python:view.selected_portal_tab"
    ><tal:tabs tal:repeat="tab portal_tabs"
    ><li tal:define="tid tab/id;
                     turl tab/url"
         tal:attributes="id string:portaltab-${tid};
                        class python:selected_tab==tid and 'selected' or 'plain'"
        ><a href=""
           tal:content="tab/name"
           tal:attributes="href tab/url;
                           title tab/description|nothing;
                           target python: (turl.endswith('/my-url') and '_blank' or '')">
        Tab Name
        </a></li></tal:tabs></ul>

File-explorer like Document Management Tool

2011-12-02T21:48:00.001+08:00

collective.edm.listing provides a custom view for folder. It works with Plone Quick Upload to upload new files.

Workteam with oDesk

2011-11-30T21:49:00.001+08:00

感謝 pofeng 的安排，有機會到 CloudTW 聚會分享 oDesk 的使用經驗。

簡報檔: http://www.slideshare.net/marr/workteam-with-odesk

討論過程中，有人回應「這是個讓 developer 找 developer 的服務」，沒錯，所以適合在技術人員聚會裡介紹 oDesk 服務，用它來累積專案管理的經驗，oDesk 試著促成一個良性循環，讓雇主和工程師都願意重視評價結果，彼此長期建立良好名聲。

自己的使用經驗，只以 employer 身份發包 Plone web development，值得找機會以 developer 角色登入，了解專業技能認證的流程。

Joyent Cloud Computing

2011-11-29T13:39:00.001+08:00

CloudTW 有段 SmartOS 的討論，於是查了相關資訊。Joyent 成立於 2004 年，業務內容與日俱進，目前已發展為 cloud computing software stack 提供者，據說公司接收了 OpenSolaris 和 Illumos 的開發人員，併購 LayerBoom 的案例，也能跟台灣教改挫敗扯上關係，總之，這些都算是藉由 cloud computing 時代造英雄的例子。

網路上找到的既有資料，都顯示 Joyent 是家強調技術本位的公司，看了 Community Manager 也就是技術公關，心想，台灣何時會有這種角色?

POSKeyError: 'No blob file'

2011-11-26T09:25:00.001+08:00

執行 Plone migration 時，遇到 POSKeyError 錯誤，發現某個目錄裡的 File 內容出了問題，刪除這些 File 之後，就可以順利從 Plone 4.0.5 昇級到 4.1.2。

Content Not Existing?

2011-11-23T16:53:00.001+08:00

遇到 Plone instance 透過 http://mysite.com/news-events 之類的網址，出現「網頁並不存在」的訊息，透過 http://mysite.com/news-events/folder_contents 網址是可以看到內容，最後發現用 http://mysite.com/news-events/selectViewTemplate?templateId=folder_listing 之類的方式，就能解決問題。發生原因是之前選用了 lead image 擴充模組的顯示方式，當這個顯示方式不存在時，就會造成網頁無法正常顯示的問題。

Content Type Extension

2011-11-19T13:32:00.001+08:00

SchemaExtender 可以動態調整 Archetypes 型別定義值，下列是一個 extender.py 範例：

from zope.component import adapts
from zope.interface import implements

from archetypes.schemaextender.interfaces import ISchemaExtender
from archetypes.schemaextender.field import ExtensionField
from plone.app.blob.field import BlobField

from Products.Archetypes import atapi

from example.blobattype.interfaces import IExampleATType
from example.blobattype import blobattypeMessageFactory as _


class ExtensionBlobField(ExtensionField, BlobField):
    """ derivative of blobfield for extending schemas """


class ExampleATTypeExtender(object):
    adapts(IExampleATType)
    implements(ISchemaExtender)

    fields = [
        ExtensionBlobField('afile',
            widget=atapi.FileWidget(
                label=_(u"A file"),
                description=_(u"Some file"),
            ),
            required=True,
            validators=('isNonEmptyFile'),
        ),

        ExtensionBlobField('secondfile',
            widget=atapi.FileWidget(
                label=_(u"Some other file"),
                description=_(u"Some other file"),
            ),
            required=True,
            validators=('isNonEmptyFile'),
        ),
    ]

    def __init__(self, context):
        self.context = context

    def getFields(self):
        return self.fields

ATBTreeFolder vs ATFolder

2011-11-17T22:45:00.001+08:00

最近把一個 Plone 網站從 3.3.5 昇級到 4.0.7，在 ZMI 裡看得到 ATBTreeFolder 和 ATFolder 兩種目錄型別，ATBTreeFolder 就是所謂的 Large Folder，在 Plone 3 之前的時代，用它來儲存大量的內容項目，到 Plone 4 之後，目錄型別被統合了。

ATBTreeFolder 在 ZMI 裡提供 Security 設定頁籤，可以指定 Local Roles，不過 Plone 4 裡的 ATFolder 並沒有這樣的設定介面，必須搭配 plone.app.workflow 編輯 sharing.xml 來擴充權限設定介面。

CMF Action Condition

2011-11-08T00:58:00.000+08:00

使用 Products.Carousel 時，會新增一個 Carousel tab，如果想在特定的目錄裡才出現它，可以在 ZMI portal_actions/object/carousel 的 Condition (Expression) 欄位輸入下列表示式：

python: (context.id in ['carousel']) and plone_context_state.is_folderish()

Localization with i18ndude

2011-11-06T23:23:00.001+08:00

以 develop.cfg 為例，先在 parts 裡加一行 i18ndude，再加一整段的 [i18ndude] 內容：

parts =
    ...
    i18ndude

[i18ndude]
unzip = true
recipe = zc.recipe.egg
eggs = i18ndude

以 my.example 模組專案為例，處理 .po 檔案的步驟如下：

$ cd src/my.example/my/example
$ vi configure.zcml
<configure
  xmlns:i18n="http://namespaces.zope.org/i18n"

  <i18n:registerTranslations directory="locales" />

$ mkdir -p locales/zh_TW/LC_MESSAGES
$ i18ndude rebuild-pot --pot locales/my.example.pot --create my.example .
$ touch locales/zh_TW/LC_MESSAGES/my.example.po
$ i18ndude sync --pot locales/my.example.pot locales/zh_TW/LC_MESSAGES/my.example.po
$ msgfmt -o locales/zh_TW/LC_MESSAGES/my.example.mo locales/zh_TW/LC_MESSAGES/my.example.po

如果有手動增加的 po 內容，通常是寫在 manual.pot 裡，再用下列指令併進 pot 檔案裡。

$ i18ndude rebuild-pot --pot locales/my.example.pot --create my.example --merge manual.pot .

Creating Windows Buildout Project

2011-10-20T00:15:00.000+08:00

試著在 Windows 建立 Plone 4.1.2 的 Buildout 專案環境，事先要安裝 Python 2.6.7、PyWin32、PIL 1.1.6、easy_install、Subversion、Git。再下載安裝 zopeskel：

C:\> easy_install zopeskel

接著，可以用 zopeskel 來建立 Buildout 專案，範例指令如下：

C:\> mkdir Plone
C:\> cd Plone
C:\Plone> zopeskel basic_buildout

basic_buildout: A basic buildout skeleton
This creates a basic skeleton for a buildout.
Enter project name: myproj

If at any point, you need additional help for a question, you can enter
'?' and press RETURN.

Expert Mode? (What question mode would you like? (easy/expert/all)?) ['easy']:

如果遇到下列訊息，可以予以略過不理會：

UserWarning:
You don't have the C version of NameMapper installed!
I'm disabling Cheetah's useStackFrames option as it is painfully slow
with the Python version of NameMapper.
You should get a copy of Cheetah with the compiled C version of NameMapper.
You don't have the C version of NameMapper installed!

剛建立的 myproj 專案目錄裡，只有 bootstrap.py 和 buildout.cfg 兩個檔案，執行 python bootstrap.py 之後，會建立必要的目錄架構，特別是 bin 目錄裡會建立 buildout 工具程式，額外的撇步是指定 zc.buildout 版本是 1.4.4，不然預設裝的 1.5.2 版本會造成衝突，範例訊息如下：

C:\Plone\myproj> python bootstrap.py -v 1.4.4
Downloading http://pypi.python.org/packages/2.6/s/setuptools/setup
tools-0.6c11-py2.6.egg
Creating directory 'C:\\Plone\\myproj\\bin'.
Creating directory 'C:\\Plone\\myproj\\parts'.
Creating directory 'C:\\Plone\\myproj\\eggs'.
Creating directory 'C:\\Plone\\myproj\\develop-eggs'.
Getting distribution for 'setuptools'.
Got setuptools 0.6c12dev-r88846.
Generated script 'C:\\Plone\\myproj\\bin\\buildout'.

預設的 buildout.cfg 檔案內容如下：

[buildout]
parts =
    templer

[templer]
recipe = zc.recipe.egg
eggs =
    PasteScript
    templer.core

不過，我並沒使用這個 buildout.cfg 內容，而是直接複製 Linux 環境上安裝的 *.cfg 檔案，修改 base.cfg 和 lxml_static.cfg 的 eggs-directory 和 download-cache 配合 Windows 環境的目錄，再執行 buildout：

C:\Plone\myproj> bin\buildout -c develop.cfg
mr.developer: Creating missing sources dir C:\Plone\myproj\src.
Getting distribution for 'zc.recipe.egg==1.2.2'.
Got zc.recipe.egg 1.2.2.
Getting distribution for 'plone.recipe.zope2instance==4.1.9'.
Got plone.recipe.zope2instance 4.1.9.
Getting distribution for 'Zope2==2.13.10'.
Installing Zope2 2.13.10
Caused installation of a distribution:
zope2 2.13.10
with a different project name.
Got zope2 2.13.10.
Getting distribution for 'mailinglogger==3.3.3'.
Got mailinglogger 3.3.3.
Getting distribution for 'nt-svcutils==2.13.0'.
Got nt-svcutils 2.13.0.
Getting distribution for 'Products.StandardCacheManagers==2.13.0'.
Installing Products.StandardCacheManagers 2.13.0
Caused installation of a distribution:
products.standardcachemanagers 2.13.0
with a different project name.
Got products.standardcachemanagers 2.13.0.
Getting distribution for 'Products.PythonScripts==2.13.0'.
...

安裝 Pillow 時，需要安裝 Visual Studio 2008 Express，據說 2008 之外的版本並不行：

error: Setup script exited with error: Unable to find vcvarsall.bat
An error occured when trying to install Pillow 1.7.2. Look above this message fo
r any errors that were output by easy_install.
While:
  Installing instance.
  Getting distribution for 'Pillow==1.7.2'.
Error: Couldn't install: Pillow 1.7.2

編譯 lxml 如果遇到錯誤，要補足需要的檔案，以 Plone 4.1.3 為例，要下載 lxml 2.3.2 的原始碼。如果沒成功的話，還可以試試直接安裝較低的 lxml 版本。

Search Events and News via Calendar Portlet

2011-10-17T16:21:00.000+08:00

Plone 的月曆方框預設是搭配 Event 來顯示，如果某一天是在 Event 發生的期間，就可以在月曆上點選來顯示，它會先利用類似 search?review_state=published&start.query:record:list:date... 網址格式來搜尋，如果想要增加其他內容型別到月曆方框，例如新聞的話，就要到 ZMI 的 portal_calendar 新增型別，並為型別新增 start 和 end 屬性值。

RelStorage Installation

2011-10-15T23:40:00.000+08:00

RelStorage 是 ZODB 的後端儲存工具，能夠將 pickle 資料存到關聯式資料庫，也就是說，經由 RelStorage 和 ZODB 的合作，Plone 裡的內容可以直接轉存到 MySQL、PostgreSQL 之類的資料庫裡，讓資料庫的類型選擇和轉換更具彈性。

經過原作者 Shane Hathaway 不斷的改進，安裝 RelStorage 變得很簡單，以 Ubuntu 和 PostgreSQL 為搭配範例，先要建立適當的帳號和資料庫：

$ sudo su - postgres
$ createuser --pwprompt zodbuser
$ createdb -O zodbuser zodb

編輯 /etc/postgresql/8.4/main/pg_hba.conf 存取控制規則，範例如下：

local  zodb  zodbuser  md5

接著可以修改 develop.cfg 的 eggs 設定區段：

eggs +=
    psycopg2
    RelStorage

修改 base.cfg 的 instance 設定區段，其中 blob-dir 參數指定一個目錄名稱，就是用來儲存 ZODB 的 BLOB 檔案：

rel-storage =
    type postgresql
    dbname zodb
    host localhost
    user zodbuser
    password mypass
    blob-dir var/blobs

執行 buildout 生效並啟動系統後，可以查看到資料庫的表單內容：

public | blob_chunk        | table    | zodbuser
public | commit_lock       | table    | zodbuser
public | current_object    | table    | zodbuser
public | object_ref        | table    | zodbuser
public | object_refs_added | table    | zodbuser
public | object_state      | table    | zodbuser
public | pack_object       | table    | zodbuser
public | pack_state        | table    | zodbuser
public | pack_state_tid    | table    | zodbuser
public | transaction       | table    | zodbuser
public | zoid_seq          | sequence | zodbuser

object_state 表單用來記錄 Page、Folder 等的內容，它的欄位包括：

zoid, tid, prev_tid, md5, state_size, state

其中 state 欄位記錄的就是內容項目的資料值。

EEA Faceted Navigation Installation

2011-10-14T12:17:00.001+08:00

EEA Faceted Navigation 已經正式支援 Plone 4.x 版本，測試成功的安裝方式是，先到 zinstance/src 目錄下載程式碼：

$ cd ~/Plone/zinstance/src
$ svn co http://svn.plone.org/svn/collective/eea.facetednavigation/trunk eea.facetednavigation
$ svn co http://svn.plone.org/svn/collective/eea.jquery/trunk eea.jquery
$ svn co http://svn.plone.org/svn/collective/eea.faceted.vocabularies/trunk eea.faceted.vocabularies

編輯 develop.cfg 內容，下列是範例：

[sources]
    eea.facetednavigation = fs eea.facetednavigation
    eea.jquery = fs eea.jquery
    eea.faceted.vocabularies = fs eea.faceted.vocabularies

[buildout]
eggs +=
    eea.facetednavigation

zcml +=
    eea.facetednavigation-meta
    eea.facetednavigation-overrides
    eea.facetednavigation

執行 buildout 生效：

$ cd ~/Plone/zinstance
$ bin/buildout -c develop.cfg

啟用模組後，在目錄的 Action 下拉選單，可以看到 Enable faceted navigation 選項，生效後可以再到 Faceted settings 和 Faceted criteria 設定細項。

RichDocument SimpleAttachment Title

2011-10-11T16:04:00.001+08:00

RichDocument 是個 content type 模組，它跟 Page 功能很像，但編輯介面提供特定欄位來上傳圖檔和檔案，這些特定欄位又搭配 SimpleAttachment 模組，讓上傳檔案的工作變得更容易擴充維護，SimpleAttachment 也是 Ploneboard 的相依模組。

以前 Plone 3.x 時代，就試用過 RichDocument 和 SimpleAttachment，當時覺得成熟度不足，現在新版支援 Plone 4.x 的 blob 功能，再次試用，仍然遇到無法處理附檔中文標題的問題。

不過，它的設計概念和實作方式，是學習開發技巧時的參考，下列是幾個程式碼片段和錯誤訊息的記錄：

BooleanField('displayImages',
    default=False,
    languageIndependent=0,
    widget=ImagesManagerWidget(
        label="Display images download box"
    ),
),

BooleanField('displayAttachments',
    default=True,
    languageIndependent=0,
    widget=AttachmentsManagerWidget(
        label="Display attachments download box"
    ),
),


<tal:main-macro metal:define-macro="main"
 tal:define="text context/getText;
             images python:context.getFolderContents(
                        contentFilter = {'portal_type' : ['ImageAttachment']});
             firstImage python:images and images[0] or None;
             is_editable context/@@plone_context_state/is_editable;">

<div metal:use-macro="python:context.widget('displayImages')"/>
<div metal:use-macro="python:context.widget('displayAttachments')"/>

ERROR Zope.SiteErrorLog 1317974487.770.594350019308
 http://localhost:8080/mysite/Members/marr/my-page/richdocument_view_float
Traceback (innermost last):
  Module ZPublisher.Publish, line 126, in publish
  Module ZPublisher.mapply, line 77, in mapply
  Module ZPublisher.Publish, line 46, in call_object
  Module Shared.DC.Scripts.Bindings, line 322, in __call__
  Module Shared.DC.Scripts.Bindings, line 359, in _bindAndExec
  Module Products.CMFCore.FSPageTemplate, line 240, in _exec
  Module Products.CMFCore.FSPageTemplate, line 180, in pt_render
  Module Products.PageTemplates.PageTemplate, line 79, in pt_render
  Module zope.pagetemplate.pagetemplate, line 113, in pt_render
  Module zope.tal.talinterpreter, line 271, in __call__
  Module zope.tal.talinterpreter, line 343, in interpret
  Module zope.tal.talinterpreter, line 888, in do_useMacro
...
  Module zope.tal.talinterpreter, line 343, in interpret
  Module zope.tal.talinterpreter, line 531, in do_optTag_tal
  Module zope.tal.talinterpreter, line 513, in no_tag
  Module zope.tal.talinterpreter, line 343, in interpret
  Module zope.tal.talinterpreter, line 742, in do_insertStructure_tal
  Module Products.PageTemplates.Expressions, line 219, in evaluateStructure
  Module Products.PageTemplates.Expressions, line 264, in _handleText
UnicodeDecodeError: 'ascii' codec can't decode byte 0xe8 in position 94:
 ordinal not in range(128)

Link Integrity Checks

2011-10-05T10:24:00.001+08:00

Plone Site Setup 裡的 Editing 設定介面，勾選 Enable link integrity checks 後，可以啟動連結檢查功能，也就是說，某個項目被刪除或搬移時，如果發現有其他項目連結到它，系統會提醒無法刪除或搬移，並在 var/log/instance.log 裡，記錄 TypeError: ('Could not adapt', None, <InterfaceCalss plone.uuid.interfaces.IUUID>) 的錯誤訊息。只要停用連結檢查功能，完成動作後再恢復即可。

UID (Unique identifier) 是系統唯一的識別碼，即使內容項目被改名或搬移，它的 UID 仍然維持一致。像 Archetypes、ReferenceField、Kupu 都有用到 UID 服務，不過，Dexterity 使用 integer id 來管理關連，並未使用 UID。

PIL vs Pillow

2011-10-04T00:34:00.003+08:00

安裝 Plone 4.x 的時候，通常會看到 Pillow 的身影，它是 PIL (Python Image Library) 的分支，因為 Plone 社群需要一份相容 setuptools 的版本，於是開始維護這個分支，考量點在於簡化安裝流程。

Page Template Tip on Creators

2011-09-30T11:42:00.001+08:00

Plone Archetype content type 可以存取 Dublin Core Metadata 內容，例如作者、著作權、發佈日期等資訊，從 Products/Archetypes/ExtensibleMetadata.py 可以看到作者欄位識別碼是 LinesField: creators，還有 Creator 和 listCreators 兩個函式，想要存取作者資訊的話，分成 Creator 和 Creators 兩個方式：例如 <tal:content="context/Creator"> 會顯示第一筆資料，<tal:content="context/Creator"> 則會以多筆資料方式顯示。常見的範例是：

Authos:
<metal:field use-macro="python:context.widget('creators', mode='view')">
John Smith, et al.</metal:field>

Plone Theme Editor with Diazo

2011-09-29T21:04:00.000+08:00

Plone 佈景主題的開發方式，自從 Deliverance 和 Diazo 問世之後，邁入新的里程碑，加上 Plone 4.1 開始搭配 plone.app.theming 模組，建立 Diazo 工作環境的門檻大幅降低。

覺得編輯規則檔 (rules.xml) 太麻煩嗎? 現在有個視覺編輯工具正在開發，預計在 Plone 4.3 之後納入，這段影片讓你先睹一快: http://www.screenr.com/b1Rs

OFS.Uninstalled Could not import class

2011-09-27T11:36:00.001+08:00

嘗試移除 Plone 模組時，經常會遇到這個警告訊息，這代表模組並未完全移除乾淨，至少我遇過 Add-on Configuration 還留有設定項目，或是 ZMI 根目錄裡看得到 broken object 的情況。

broken object 應該可以直接刪除，Add-on Configuration 的項目要到 ZMI portal_controlpanel 裡刪除。這裡有個 DropDownMenu 的範例畫面。

如果症狀比上述情況嚴重，就要參考 Removing a persistent local utility 的除錯步驟。

Moving collective.geo.kml Viewlet

2011-09-23T17:33:00.000+08:00

collective.geo.* 是一組提供 GIS 服務的 Plone 模組，它的地圖顯示區塊，預設是在 description 欄位下方，也就是在 <div id="viewlet-above-content-body"> 的下方，想要把它移到 <div id="viewlet-below-content"> 旁邊。首先，用 firebug 得知顯示區塊被包在 <div id="kml-content-viewlet"> 裡，那麼它是由哪個檔案提供的呢?

$ grep -r kml-content-viewlet buildout-cache/eggs

collective/geo/kml/browser/kmlcontentviewlet.pt 檔案有我們要找的 div，照慣例，先到 collective/geo/kml/browser/configure.zcml 找線索：

  <browser:viewlet
      name="collective.geo.kml.kmlcontentviewlet"
      for="collective.geo.geographer.interfaces.IGeoreferenceable"
      class=".viewlets.ContentViewlet"
      manager="plone.app.layout.viewlets.interfaces.IAboveContentBody"
      template="kmlcontentviewlet.pt"
      layer="..interfaces.IGeoKmlLayer"
      permission="zope2.View"
  />

看來把 viewlet 的 manager 由 IAboveContentBody 改到 IBelowContent 就行。

Transmogrifier in Action

2011-09-22T22:23:00.001+08:00

最近用 collective.transmogrifier 將資料匯入 Plone 4.0.7，同時支援 CSV 和 PostgreSQL 兩種來源格式。

首先，用 paster 建立一個 my.importer 的專案，其中的 configure.zcml 內容範例如下：

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:five="http://namespaces.zope.org/five"
    xmlns:genericsetup="http://namespaces.zope.org/genericsetup"
    xmlns:transmogrifier="http://namespaces.plone.org/transmogrifier">

  <includeDependencies package="." />

  <genericsetup:registerProfile
      name="default"
      title="my.importer"
      directory="profiles/default"
      description="To set context for transmogrifier profiles."
      provides="Products.GenericSetup.interfaces.EXTENSION"
      />

  <include package="collective.transmogrifier" />
  <include package="collective.transmogrifier" file="meta.zcml" />
  <transmogrifier:registerConfig
    name="my.importer.importMyNews"
    title="My Importer for MyNews"
    description="Transmogrifier Pipeline config to import contents."
    configuration="confs/import_mynews.cfg"
    />

</configure>

在 confs 目錄裡，我們編輯 import_mynews.cfg 設定檔，範例內容如下：

[transmogrifier]
pipeline =
#    csvsource
    sqlsource
    type-inserter
    path-inserter
    folders
    constructor
    schemaupdater
    state-inserter
    workflowupdater
    reindexobject

#[csvsource]
#blueprint = collective.transmogrifier.sections.csvsource
#filename = my.importer:data/mynews.csv

[sqlsource]
blueprint = transmogrify.sqlalchemy
dsn = postgresql://username:secret@localhost:5432/dbname
query = SELECT id, title, description FROM my_table

[type-inserter]
blueprint = collective.transmogrifier.sections.inserter
key = string:_type
value = string:News Item

[path-inserter]
blueprint = collective.transmogrifier.sections.inserter
key = string:_path
value = string:/myfolder/${item/id}

[folders]
blueprint = collective.transmogrifier.sections.folders

[constructor]
blueprint = collective.transmogrifier.sections.constructor

[schemaupdater]
blueprint = plone.app.transmogrifier.atschemaupdater

[state-inserter]
blueprint = collective.transmogrifier.sections.inserter
key = string:_transitions
value = string:publish

[workflowupdater]
blueprint = plone.app.transmogrifier.workflowupdater

[reindexobject]
blueprint = plone.app.transmogrifier.reindexobject

來源是 SQL 資料時，使用的是 [sqlsource]，來源是 CSV 資料時，就改用 csvsource，並在 data 目錄裡放好 mynews.csv 檔案，內容範例如下：

id,title,description
data1,My Data #1,Description of My Data #1

接著，編輯 my/importer/profiles/default/transmogrifier.txt 檔案，內容如下：

# this file contains transmogrifier profile names to run
# on GenericSetup transmogirifier's step
my.importer.importMyNews

以上就是 my.importer 專案的主要設定內容。最後，編輯 buildout.cfg 的內容如下：

eggs =
     SQLAlchemy == 0.6.5
    psycopg2
    collective.transmogrifier
    plone.app.transmogrifier
    transmogrify.sqlalchemy
   my.importer

zcml =
    collective.transmogrifier-meta
    collective.transmogrifier
    plone.app.transmogrifier
    transmogrify.sqlalchemy

上述 SQLAlchemy == 0.6.5 語法，代表要指定 (pin) 安裝 0.6.5 版本的 SQLAlchemy，不指定的話，可能會安裝太新的版本，未必合用，我的經驗是 SQLAlchemy 0.7.2 會遇到 ImportError: No module named exceptions 錯誤訊息。

一切搞定後，要讓上述設定值生效的話，可以直接到 ZMI 的 portal_setup，在 Import 頁籤裡，從 Select Profile or Snapshot 找尋 my.importer 選項，再找到 Run transmogrifier pipeline (第41項) 並勾選它，最後點選 Import selected steps 按鈕。

額外一提，PostgreSQL 裡的欄位資料如果更新為空值，執行 transmogrifier 後，也會將 Plone 表單欄位清空。

argument 2 to map() must support iteration

2011-09-21T23:53:00.000+08:00

使用 collective.transmogrifier 和 transmogrify.sqlalchemy 讀取 PostgreSQL 內容匯入 Plone 表單時，遇到 TypeError: argument 2 to map() must support iteration 錯誤訊息，原因是表單所需要的 id 是 string 型別，來自 SQL 的 gid 內容則是 number 型別，想法子傳支援 iteration 的型別就行了。

AttributeError: getLocallyAllowedTypes

2011-09-21T01:49:00.000+08:00

import 一個 folder zexp 到 Plone 4.1 根目錄後，遇到 AttributeError: getLocallyAllowedTypes 錯誤訊息，查到 #11950 討論這個問題，並附有 patch 檔案，預計在 Plone 4.1.1 會修掉這問題。

Document Byline

2011-09-19T22:06:00.002+08:00

有人並不喜歡看到網頁的「作者」「最近修改」資訊，這些資訊被 Plone 稱為 Byline，想要不顯示 Byline 資訊，除了在 portal_skins 和 CSS 可以修改外，在 ZMI 的 portal_view_customizations 裡，也可以修改 plone.belowcontenttitle.documentbyline 來達到效果：原則上就是從 <tal:creator /> 開始，拿掉這些 page template 內容。

pkg_resources.DistributionNotFound

2011-09-15T00:03:00.000+08:00

執行 paster addcontent 時，遇到 pkg_resources.DistributionNotFound 訊息，處理方式是在搜尋哪個 .cfg 檔案包含 [zopeske] 設定區段，在裡面加上 ${instance:eggs} 設定值，例如：

[zopeskel]
recipe = zc.recipe.egg
eggs =
   ...
   ${instance:eggs}

重新執行 buildout 後，就能正常使用。

Macro Expansion Failed

2011-09-08T17:20:00.000+08:00

在 ZMI portal_skins 裡，想要客製 newsitem_view 時，看到一個訊息：

Macro expansion failed
<type 'exceptions.AttributeError'>: widget

這只是個煩人的訊息，直接修改內容並存檔，還是能夠運作。如果去處理它的話，會造成 page template 變得太複雜，在 Ticket #7173 被歸為暫不處理的項目。

cmf.ManagePortal ComponentLookupError

2011-09-08T11:57:00.000+08:00

在 Plone 4.1 遇到下列訊息：

File "/home/marr/Plone/buildout-cache/eggs/
AccessControl-2.13.4-py2.6-linux-i686.egg/AccessControl/security.py",
 line 165, in protectClass
  permission = getUtility(IPermission, name=permission_id)
File "/home/marr/Plone/buildout-cache/eggs/
zope.component-3.9.5-py2.6.egg/zope/component/_api.py",
 line 169, in getUtility
  raise ComponentLookupError(interface, name)
zope.configuration.config.ConfigurationExecutionError:
 <class 'zope.component.interfaces.componentlookuperror'="">:
 (<interfaceclass zope.security.interfaces.ipermission="">, 'cmf.ManagePortal')
in:
File "/home/marr/Plone/buildout-cache/eggs/
p4a.subtyper-1.2.0-py2.6.egg/p4a/subtyper/configure.zcml",
 line 49.2-55.8
  <browser:page
      name="subtyper"
      for="*"
      permission="cmf.ManagePortal"
      class=".browser.SubtyperView"
      allowed_interface=".browser.ISubtyperView"
      />

臨時的解法是修改 p4a/subtyper/configure.zcml 內容，加上：

<include package="Products.CMFCore" 
file="permissions.zcml" />

以上，應該是 add-on 昇級的議題。另外，類似的訊息還有 ComponentLookupError: (<InterfaceClass plone.keyring.interfaces.IKeyManager>, '') 的錯誤，在 ZMI portal_setup 重新載入所有的 plone.keyring KeyManager Registration 步驟就行。

PloneFormGen + Dexterity

2011-09-02T14:31:00.000+08:00

在 TTW is Back on Plone 影片裡，示範三分鐘線上建立報價單的方法，包括工作流程設定，利用的工具有 Products.PloneFormGen、plone.app.dexterity、experimental.dexteritytypeviews、collective.pfg.dexterity、uwosh.northstar。
看起來 Dexterity 相當成熟了，不過預設的 ATContentTypes 還沒被取代。

AddRemoveWidget and ComboBoxWidget

2011-08-18T10:06:00.003+08:00

AddRemoveWidget permits to add self-entered data, which makes it a good replacement for KeywordWidget. Example code looks like:

from Products.AddRemoveWidget.AddRemoveWidget import AddRemoveWidget

...

  atapi.LinesField(

      'watershed',

      storage=atapi.AnnotationStorage(),

      widget=AddRemoveWidget(

          label=_(u"Watershed"),

          description=_(u"Enter one tag per line, multiple words allowed."),

      ),

      vocabulary_factory='watershed',

  ),

AddRemoveWidget works with multiple-value fileds, if you need just single-value fields, try ComboBoxWidget instead. Example code looks like:

from Products.AddRemoveWidget.ComboBoxWidget import ComboBoxWidget

...



  atapi.StringField(

      'vote',

      storage=atapi.AnnotationStorage(),

      widget=ComboBoxWidget(

          label=_(u"Best Band Ever"),

          description=_(u"Single Choice."),

      ),

      vocabulary=['The Beatles', 'The Smiths', 'Led Zeppelin', 'Joy Division'],

  ),

Look into the source code for more config options.

Editing Plone Short Name

2011-08-17T14:59:00.001+08:00

Short Name 可以譯成「識別碼」，它是構成 URL 的一部份，這個欄位在編輯時，預設是不顯示。如果網站包含整批具備流水編號的內容，例如想用 ISBN 當作識別碼，這類場合就適合在編輯時顯示識別碼欄位。
在 Plone Setup 的 Editing 設定項目，可以指定是否顯示 Short Name 欄位。

系統設定值勾選啟用後，還要確定使用者偏好設定，必須同步設定啟用才真的生效。

生效後的範例如下圖：

以 Archetype 的表單為例，Short Name 在程式碼內部使用 id 這個欄位名稱，剛新增時的網址會使用 book.2011-08-17.8631510722 之類的字串，如果 Short Name 欄位留空未填，那麼預設會使用 title-to-id 行為方式來更改 id 欄位值。

Diazo Installation

2011-08-09T22:27:00.002+08:00

在 Plone 裡安裝 Diazo 最簡單的方法，是搭配安裝 plone.app.theming，它需要 Plone 4.1 之後的環境，使用 4.1 版本的 Unified Installer 是最簡單的方法。

$ diff -Nu develop.cfg.orig develop.cfg

--- develop.cfg.orig    2011-08-09 22:21:25.495261571 +0800

+++ develop.cfg 2011-08-09 22:23:31.063243116 +0800

@@ -110,6 +110,7 @@

 # we're extending buildout.cfg

 extends =

     buildout.cfg

+    http://good-py.appspot.com/release/plone.app.theming/1.0b8



 extensions +=

     mr.developer

@@ -117,6 +118,7 @@

 eggs +=

     Products.DocFinderTab

     plone.reload

+    plone.app.theming



 parts +=

     test

$ bin/buildout -c develop.cfg

Uninstalling zopepy.

Uninstalling instance.

Installing _mr.developer.

Generated script '/home/marr/plone410/zinstance/bin/develop'.

Installing instance.

Getting distribution for 'plone.app.theming==1.0b8'.

Got plone.app.theming 1.0b8.

Getting distribution for 'repoze.xmliter==0.4'.

Got repoze.xmliter 0.4.

Getting distribution for 'plone.resource==1.0b5'.

Got plone.resource 1.0b5.

Getting distribution for 'plone.subrequest==1.6.1'.

Got plone.subrequest 1.6.1.

Getting distribution for 'diazo==1.0rc3'.

Got diazo 1.0rc3.

Getting distribution for 'experimental.cssselect==0.1'.

Got experimental.cssselect 0.1.

Generated script '/home/marr/plone410/zinstance/bin/instance'.

Installing zopepy.

Generated interpreter '/home/marr/plone410/zinstance/bin/zopepy'.

Updating zopeskel.

Installing omelette.

Updating backup.

Updating chown.

chown: Running echo Dummy references to force this to execute after referenced parts

echo /home/marr/plone410/zinstance/var/backups

chmod 600 .installed.cfg

find /home/marr/plone410/zinstance/var -type d -exec chmod 700 {} \;

chmod 744 /home/marr/plone410/zinstance/bin/*

Dummy references to force this to execute after referenced parts

/home/marr/plone410/zinstance/var/backups

Installing test.

Generated script '/home/marr/plone410/zinstance/bin/test'.

Updating repozo.

Updating unifiedinstaller.

*************** PICKED VERSIONS ****************

[versions]



*************** /PICKED VERSIONS ***************

Development Eggs

2011-08-03T11:40:00.003+08:00

When using paster to create "development eggs", there will install Paste, PasteScript, PasteDeploy eggs in Plone src directory. These eggs are for development purpose, will enable paster options like local commands. However, along with my.package.egg-info, they are not into version control repository.

Vocabulary Import Tips

2011-08-02T23:39:00.002+08:00

Run into this error:

ImportError: No module named schema.vocabulary

Fix it by changing the imports in vocabulary.py, from:

from zope.interface import implements
from zope.app.schema.vocabulary import IVocabularyFactory
from zope.schema.vocabulary import SimpleVocabulary

to:

from zope.interface import implements
from zope.schema.interfaces import IVocabularyFactory
from zope.schema.vocabulary import SimpleVocabulary

zope.app.schema 3.5.0 removes deprecated vocabulary directive.

Transmogrifier Tips

2011-08-01T17:09:00.003+08:00

SQLAlchemy: No module named exceptions

After running buildout, my Plone fails to start and show this message -- ImportError: No module named exceptions.
Adding a pin for SQLAlchemy to version 0.6.8 fixes the issue. For details see SQLAlchemy changelog

Named Transmogrifier Pipelines

In collective/transmogrifier/genericsetup.py, 'transmogrifier.txt' is assigned to be read. So place the file in profiles/default directory, pipeline identifiers are read one per line, for example 'mysite.migration.importFromCSV'. In ZMI portal_setup 'Import' tab, you can run the selected steps.

CSV Import with Transmogrifier

2011-08-01T10:09:00.002+08:00

假設你的欄位資料，都放在 mydata.csv 檔案裡，想要批次匯入來建立 MyContentType 內容，下列是主要的步驟範例。

以自製模組 mysite.migration 為例，它的 configure.zcml 內容範例如下：

<configure
    xmlns="http://namespaces.zope.org/zope"
    xmlns:five="http://namespaces.zope.org/five"
    xmlns:i18n="http://namespaces.zope.org/i18n"
    xmlns:genericsetup="http://namespaces.zope.org/genericsetup"
    xmlns:transmogrifier="http://namespaces.plone.org/transmogrifier"
    i18n_domain="mysite.migration">

  <!-- Include zcml files of all required packages -->
  <includeDependencies package="." />

  <genericsetup:registerProfile
      name="default"
      title="mysite.migration"
      directory="profiles/default"
      description="MySite transmogrifier profile."
      provides="Products.GenericSetup.interfaces.EXTENSION"
      />

  <!-- Register Transmogrifier Profile -->
  <include package="collective.transmogrifier" />
  <include package="collective.transmogrifier" file="meta.zcml" />
  <transmogrifier:registerConfig

    name="mysite.migration.importFromCSV"
    title="Import Content Data From CSV"
    description="Transmogrifier config to import contents from CSV"
    configuration="confs/import_from_csv.cfg"
    />

  <!-- -*- extra stuff goes here -*- -->

</configure>

在 confs/import_from_csv.cfg 內容範例如下：

[transmogrifier]
pipeline =
    csvsource
    type-inserter
    path-inserter
    folders
    constructor
    schemaupdater
    state-inserter
    workflowupdater
    reindexobject


[csvsource]
blueprint = collective.transmogrifier.sections.csvsource
filename = crgis.migration:data/mydata.csv

[type-inserter]
blueprint = collective.transmogrifier.sections.inserter
key = string:_type
value = string:MyContentType

[path-inserter]
blueprint = collective.transmogrifier.sections.inserter
key = string:_path
value = string:/myfolder/${item/id}

[folders]
blueprint = collective.transmogrifier.sections.folders

[constructor]
blueprint = collective.transmogrifier.sections.constructor

[schemaupdater]
blueprint = plone.app.transmogrifier.atschemaupdater

[state-inserter]
blueprint = collective.transmogrifier.sections.inserter
key = string:_transitions
value = string:publish

[workflowupdater]
blueprint = plone.app.transmogrifier.workflowupdater

[reindexobject]
blueprint = plone.app.transmogrifier.reindexobject

profiles/default/transmogrifier.txt 的內容範例如下：

# this file contains transmogrifier profile names to run
# on GenericSetup transmogrifier's step
crgis.migration.importFromCSV

以上模組檔案內容就緒後，在 buildout.cfg 加上：

[buildout]
...
develop =
    src/mysite.migration

[instance]
...
eggs =
    mysite.migration

執行 bin/buildout 之後，進入 ZMI 的 portal_setup 設定畫面，從 "Select Profile Or Snapshot" 下拉選單，點選 mysite.migration 項目，再點選 "Run transmogrifier pipeline" 項目，最後點選 "Import selected steps" 按鈕。

Bio by Pictures

2011-07-19T15:48:00.003+08:00

第一台電腦是 PC XT 8088 的時代，當時是買 Acer 但找不到照片，只好用這張類似的畫面。全機黑色的 Acer XT 比這漂亮太多了。

中學時代的電腦，主要是遊戲機的功能，學 BASIC 的目的，也是想寫出自己的遊戲。

自己是搖滾迷，id nickname 是取自英國樂團吉他手的名字。

第一個網站，內容是介紹搖滾樂。

架站總是要學 Unix 知識，後來發現歷史故事也充滿趣味。

現在是 Python 愛好者一枚。

New User Interface Preview

2011-07-03T08:33:00.004+08:00

Plone 操作介面的發展規劃，經過 Plone UI Sprint 的努力工作後，終於有了 plone.app.cmsui 測試版實作，搭配 Plone 4.1 環境，讓我們可以體驗新介面的預覽版。

另一個改版重點，是導入新的 page layout 管理機制，底層是一個稱為 Block 的引擎，它將網頁分成結構式和動態的顯示元件，經過組合再呈現。短期內，Plone 則推出 plone.app.page 讓 Folderish Page 取代 Folder，許多測試正在演進中。

Change Archetypes CreationDate

2011-06-30T00:17:00.003+08:00

建立 Plone 內容時，系統會自動指定建立時間，想要竄改這個時間，可以用 bin/plonectl debug 存取 Data.fs，以 app.mysite.news['my-news'] 為例，使用 created() 這個 accessor 可以查詢建立時間，使用 setCreationDate() 這個 mutator 可以指定建立時間，完成之後要記得 transaction.commit()。再進 ZMI 的 portal_catalog 重新執行 created 的索引動作。
在 Products/Archetypes/ExtensibleMetadata.py 可以看到程式碼細節。

Plone BlobStorage and Image

2011-06-28T15:17:00.005+08:00

下列是使用 Plone 4.0.7 實測 Blob 功能的記錄。

新增一個 Image，附的圖檔約 1.4MB，看到 var/blobstorage 裡出現一個 0x00/0x00/0x00/0x00/0x00/0x00/0x20/0x5b/0x038f4c3af3551d22.blob 檔案，大小 1486990，驗證圖檔放進 blobstorage 裡，值得注意的是，同時伴隨產生一個 0x00/0x00/0x00/0x00/0x00/0x00/0x20/0x66/0x038f4c3af6acde66.blob 檔案，大小 40615。

在 Plone 裡把上述圖檔刪除，原本 blobstorage 對應的檔案仍然存在，並未馬上被刪除，直到執行 pack 之後，blobstorage 裡面剩下 0x00/0x00/0x00/0x00/0x00/0x00/0x20 目錄，底下的檔案都被刪除。

接著，即使重複上述的圖檔新增動作，上傳同樣圖檔，blobstorage 會產生新的對應檔名，例如 0x00/0x00/0x00/0x00/0x00/0x00/0x20/0x6e/0x038f4c4d455447cc.blob (size 1486990) 和 0x00/0x00/0x00/0x00/0x00/0x00/0x20/0x75/0x038f4c4d482af9ee.blob (size 40615)。

新增一個 File，附的檔案指定上述的圖檔，blobstorage 則會產生 0x00/0x00/0x00/0x00/0x00/0x00/0x20/0x7d/0x038f4c7f2e73e400.blob (size 1486990)，但是沒有產生大小為 40615 的伴隨檔案。

如果編輯舊的 File，上傳新的檔案，則會對應產生 0x00/0x00/0x00/0x00/0x00/0x00/0x20/0x88/0x038f4cd0ba71df00.blob (size 11080872) 新檔案，原本的 0x00/0x00/0x00/0x00/0x00/0x00/0x20/0x7d/0x038f4c7f2e73e400.blob (size 1486990) 仍然存在，直到執行 pack 之後，才會只剩 0x00/0x00/0x00/0x00/0x00/0x00/0x20/0x88/0x038f4cd0ba71df00.blob (size 11080872)。

另外，新增 News Item 時，預設有兩種方式來上傳圖檔。一種是從 Image 欄位上傳圖檔，這種方式並不會在 blobstorage 裡產生對應的檔案，相同目錄裡也看不到對應的 ATImage 檔案，暫不清楚跟 show_content_type 是否相關。另一種方式是從 RichWidget 欄位上傳圖檔，這種方式會在 News Item 相同的目錄裡，建立對應的 ATImage 檔案，同時也在 blobstorage 裡產生 0x00/0x00/0x00/0x00/0x00/0x00/0x20/0xd1/0x038f4cde1e238bee.blob (size 1486990) 和 0x00/0x00/0x00/0x00/0x00/0x00/0x20/0xd6/0x038f4cde20a1d711.blob (size 6285) 的對應檔案，效果等同先建立 ATImage 再於 RichWidget 裡指定連結。

額外一提的是，如果 RichWidget 欄位上傳的圖檔，目錄已存在相同檔名的檔案，則會自動更名為 copy_of_SomeImage.jpg 之類的識別碼。

使用 blobstorage 後，即使所有的 Image File 都清掉，在檔案系統裡還是會留下之前建立過的目錄：

var/blobstorage/
├── 0x00
│   └── 0x00
│       └── 0x00
│           └── 0x00
│               └── 0x00
│                   └── 0x00
│                       ├── 0x20
│                       └── 0x21
└── tmp

Add Custom Field to Criteria in ATTopic

2011-06-21T13:26:00.002+08:00

以 Plone site 的 events/aggregator 為例，點選 Criteria 頁籤，可以編輯選集的條件，這個編輯頁面使用 Products/ATContentTypes/skins/ATContentTypes/criterion_edit_form.cpt 程式碼，摘要如下：


<div class="field" style="float:left">

  <label for="field">Field name</label>

  <div class="formHelp"
       id="fieldHelpSort">
      List Available Fields
  </div>

  <select name="field"
          id="sortfield"
          tal:define="fields context/listSortFields">

  <option value="no_sort"
          tal:attributes="selected python:not context.hasSortCriterion();"
          >No sort order</option>

  <tal:block tal:repeat="field fields">
      <option value=""
              tal:define="explanation python:field[2]"
              tal:attributes="value python:field[0];
                              selected python:context.hasSortCriterion()
                         and context.getSortCriterion().field==field[0];
                              title explanation"
              tal:content="python:field[1]"
                i18n:attributes="title"
                i18n:translate="">Field</option>
  </tal:block>
  </select>

</div>

其中的 listSortFields 定義在 content/topic.py 裡。
想在條件裡新增自製欄位的話，最簡單的方式，是到 Site Setup 的 Collections 裡設定，例如點擊 All fields 後，再勾選 Contributors 選項，讓它成為啟用的項目。

Migration In Action

2011-06-01T15:23:00.003+08:00

看過昇級的背景資訊後，可以真的動手了。

Plone 3.3.5 昇級到 4.0.x，算是相對容易的情境，原則上，把 Plone 3.3.5 選用或自製的模組版本，盡量先更新到合適的號碼，這樣就可以準備一份夠好的 Data.fs。再次提醒，實際昇級前，一定要把 Data.fs 備份好，完成昇級步驟後，還要進行許多測試工作，途中遇到錯誤的話，還是可能要用到 Data.fs 備份檔。

Plone 3.3.5 和 4.0.x 都有 buildout 工具，利用 buildout 就可以把許多昇級工作搞定，昇級 buildout.cfg 最簡單的方式，是先用 Unified Installer 安裝系統，再把 egg 和其他設定值搬到 buildout.cfg 裡。

依據上述的原則，下列是實戰過程的記錄。

舉例來說，原本 Plone 3.3.5 搭配 Ploneboard 2.0，先昇到 Ploneboard 2.2 之後，就可以同時在 Plone3 和 Plone4 使用。不過，Ploneboard 搭配的 python-dateutil，要使用 1.5 版本，處理方式是在 [versions] 設定區段，指定為 python-dateutil = 1.5，如果安裝 python-dateutil 2.0 的話，會造成 Ploneboard 無法執行，處理方法是刪掉 python-dateutil 2.0 再裝 1.5 版本。

webcouturier.dropdownmenu 模組也有類似的情況，它的 2.0 版本是搭配 Plone 3.x，到 2.1 版本就同時支援 Plone 3 和 4。另外，我是昇級 Plone4 後才發現 webcouturier 有 2.1 版，事後再昇級 webcouturier 並沒問題。

設定 Plone 4.0.5 的 buildout.cfg 時，記得把 Products.PloneHotfix 加上去，執行 bin/buildout 之後，把舊系統的 Data.fs 放到 var/filestorage 目錄，執行 bin/plonectl debug 來啟動新系統，總之，要等完成昇級測試後，再改用 bin/plonectl start。

進 ZMI 的昇級畫面後，先勾選 dry run 執行模擬，接著有一系列的昇級動作，其中的 plone.app.upgrade 在 v40/betas.py 檔案裡，定義了 convertToBlobs() 函式，會把 File 和 Image 轉存為 Blob 檔案，這個過程會把舊檔刪除，再建立新檔，如果舊站已存在許多 File 和 Image 的話，這個步驟會花很長的時間。

手邊一個 9.6G Data.fs 建立 6.5G blobstorage，最後 Data.fs 剩下 278.9M，因此，執行昇級前最好留有 Data.fs 一倍以上的硬碟空間。

The Python Paradox

2011-05-22T19:14:00.007+08:00

This is a zh-tw translation of The Python Paradox by Paul Graham.

在某次演講中，我的話語惹毛不少人，那段話是這樣說的 -「使用 Python 的專案，會比 Java 的專案，容易吸引到更聰明的程式人員。」

我可沒說 Java 程式員是笨的，那句話的焦點在於 Python 程式員是聰明的。學習一個新的程式語言，需要花費不少工夫，因此，人們不會為了混口飯吃，而去學 Python，那些學 Python 的程式員，是基於對編程的熱愛，而且他們對已知的語言都感到不滿意。

這類的程式員，應該是公司想要雇用的。由於找不到好的形容詞，我姑且稱這種現象是 Python 的弔詭 - 如果公司的軟體專案使用密教式的語言來開發，他們會雇用到較好的程式員，因為這樣的條件會吸引那些願意學這類語言的好手。對程式人員而言，下列的說法，更是無庸置疑：如果你想要找到好工作，該學的語言，必然不是那些只能混口飯吃的語言。

迄今，只有很少的公司夠聰明，能明白這樣的道理，不過，還有另一種演化趨勢，來自於那些最受程式員喜愛的公司，例如 Google，當他們要找 Java 工程師時，也會要求同時具備 Python 經驗。

我有個朋友，熟知所有廣被使用的語言，他手邊的專案，多數就用 Python 開發，而選用 Python 的最大原因，是程式碼看起來舒服。比較程式語言的選用條件時，這樣的理由聽起來可能好笑，但搭配下列的情境，這句話就不像鬧著玩了：動手編程時，你會花很多時間在讀程式碼，而不是寫程式碼。編修程式碼的過程，就像雕塑師在作品上捏塑泥巴的過程，如果語言讓程式碼變醜，嚴謹的程式員看了可會抓狂，就像糊成一團的泥巴，會讓雕塑師無法忍受一樣。

提到醜的程式碼，人們很容易想到 Perl，不過，Perl 表面上的醜，或是生硬語法所帶來的醜，並不是我想講的，錯誤概念所造成的醜，才是真的讓人無法接受的事。有時候 Perl 程式碼看起來像卡通人物幹譙時的一串符號，但有些情況下，Perl 在概念上比 Python 來得優異。

話說回來，這兩個語言仍然各自演化中，和 Ruby (Icon, Joy, J, Lisp, Smalltalk) 一樣，投身它們的程式員，都是熱愛編程的族群，而且是更有機會搞好編程的一群。

Related Items and ReferenceField

2011-05-14T12:57:00.008+08:00

預設的 ATContentType 提供 relatedItems 欄位，可以用來建立或指定關連項目，想在程式裡指定的話，可以參考下列的資訊：

>>> app.mysite['front-page'].setRelatedItems(app.mysite.news)
>>> app.mysite['front-page'].getRelatedItems()
[<ATFolder at /mysite/news>]

setRelatedItems() 每次只接一個參數，因此後來接的參數，原則上就是蓋掉之前的設定值。想要清空內容的話，就是使用 setRelatedItems('')，想要指定多值，或是加入新值的話，可用串列的技巧：

>>> app.mysite['front-page'].setRelatedItems
([app.mysite.news,app.mysite.events])

還有個 getRawRelatedItems() 可以傳回 UID：

>>> app.mysite['front-page'].getRawRelatedItems()
['f8a2a96821f6e3df8dafd19d16b68fb2',
 '04b2e1267906691beccdff58dd861176']

另外，在plone.app.layout/viewlets/content.py 裡的 ContentRelatedItems 程式碼片段，示範如何存取及顯示：

class ContentRelatedItems(ViewletBase):
    index = ViewPageTemplateFile("document_relateditems.pt")
    def related_items(self):
        context = aq_inner(self.context)
        res = ()
        if base_hasattr(context, 'getRawRelatedItems'):
            catalog = getToolByName(context, 'portal_catalog')
            related = context.getRawRelatedItems()
            if not related:
                return ()
            brains = catalog(UID=related)
            res = list(brains)
        return res

Values for Archetypes Field and Widget

2011-05-12T15:40:00.002+08:00

StringField 搭配 StringWidget 或 SelectionWidget 是最簡化的情況，儲存的資料是 string，如果 StringField 搭配 MultiSelectionWidget 或 InAndOutWidget，儲存的資料就是 list。前者的空值是 ''，後者的空值是 ['']，使用 page template 顯示時，就要額外處理它們的差異。例如：

<div tal:condition="context/myfield">
My Field:
<span metal:use-macro="python:context.widget('myfield', mode='view')" />
</div>

當資料是空的 string 時，整個 <div /> 並不會顯示，當資料是空的 list 時，還是會出現 My Field: [''] 之類的畫面。
一個簡單的處理方式是：

<div tal:condition="python:context.myfield != ['']">
My Field:
<span metal:use-macro="python:context.widget('myfield', mode='view')" />
</div>

Couldn't find index page for 'PasteScript'

2011-05-10T17:30:00.004+08:00

在 Plone 4.0.2 正常運作一段時間後，因為修改 src 目錄裡的自製模組，需要重新執行 bin/buildout，遇到錯誤訊息：

Download error: (-2, 'Name or service not known') -- Some packages may not be found!
Couldn't find index page for 'PasteScript' (maybe misspelled?)

distutils.errors.DistutilsError:
 Could not find suitable distribution for Requirement.parse('PasteScript')
While:
  Installing.
  Processing develop directory '/home/marr/mysite/zinstance/src/my.package'.

檢查 my.package/setup.py 裡面有一行 setup_requires=["PasteScript"], 設定值，註解掉暫時有排除問題，但仍不清楚原理。
另外在 Problems running Buildout to install a them created with Paster 有類似的討論，或許會有正確解答的線索。

eea.jquery datepicker localization

2011-04-28T14:29:00.003+08:00

eea.jquery 的 UI 模組，已經把 localization 需要檔案準備好，在 ui/development-bundle/ui/i18n 目錄裡找得到。想要將 datepicker 日曆裡的月份星期以中文顯示，在 Plone 裡至少要修改兩個檔案，首先是利用 jsregistry.xml 註冊需要的 javascript resource，接著在 ui/configure.zcml 裡註冊實際的檔案位置。

eea/jquery/profiles/ui/jsregistry.xml

  <javascript id="++resource++jquery.ui-1.7.js"
   cacheable="True" compression="safe" cookable="True" enabled="True" inline="False"
   expression="" position-after="jquery.js" />
+ <javascript id="++resource++ui.datepicker-zh-TW.js"
+  cacheable="True" compression="safe" cookable="True" enabled="True" inline="False"
+  expression="" position-after="jquery.js" />
 </object>

eea/jquery/ui/configure.zcml


+    <browser:resource
+        name="ui.datepicker-zh-TW.js"
+        file="development-bundle/ui/i18n/ui.datepicker-zh-TW.js"
+        permission="zope.Public"
+        />
+
     <browser:resource
         name="jquery-ui-1.7.custom.css"
         file="css/smoothness/jquery-ui-1.7.custom.css"
         permission="zope.Public"

Diazo Theming Tool

2011-04-24T00:32:00.002+08:00

Diazo 能夠讀取設計師的網頁藍圖，搭配內容管理系統，即時產生網站的佈景主題，同時可以佈署數個網站，快速提供一致的操作介面。它是改善使用經驗的強大工具，整個過程不需要存取系統原有的程式碼。這項技術概念，早期由 Deliverance 和 XDV 提供實作，Diazo 著眼在簡化流程，讓佈署的門檻降得更低。

為了使用 Diazo，通常要進行下列的準備工作：
1. 找出佈景主題的檔案裡，哪些是動態顯示的部份，最好使用 HTML 的 id 識別碼，將它們標識出來。
2. 編寫規則設定檔的內容，使用 replace 或 copy 的語法，用來產生上述網頁裡的動態內容。
3. 找出佈景主題的檔案裡，哪些是共用的部份，指的通常是 <head /> 裡的 CSS 或 JavaScript 的程式碼，使用 append 或 prepend 的語法，將它們寫到規則設定檔裡。
4. 找出佈景主題的檔案裡，哪些部份是多餘的，在規則設定檔裡使用 drop 語法來刪除它們。

規則設定檔使用 XML 格式，可以利用 CSS3 或 XPath 的 selector，來指定負責顯示和內容的元件。

有了佈景主題的 HTML 檔案，還有規則設定的 XML 檔案，就可以利用 Diazo 的編譯器，把它們轉成一個 XSLT 檔案，接著佈署在網站應用程式裡，透過 Apache mod_transform 之類的 XSLT 處理器，就能動態產生搭配佈景主題的網站內容。

XSLT 的轉換動作很快，靜態的網頁資源，例如圖檔、CSS、JavaScript 等，也可以直接由靜態網站提供服務。

實用的情境之一，是使用一份佈景主題的 HTML 檔案，配合不同的網站應用程式，產生不同的 XSLT 檔案，再用網址比對的技巧，依照網頁請求來回應不同的 XSLT 檔案。

GenericSetup Circular Dependency

2011-04-22T15:41:00.003+08:00

使用 Plone 4.0.5 import 一個 theme 檔案時，遇到 GenericSetup There are unresolved or circular dependencies. 訊息，因為相依關係造成 import 無法正常完成，似乎只是 warning 而不是 error。之前已有討論，而且應該已經解決。

Blob Storage Restore

2011-04-21T17:59:00.004+08:00

前幾天執行了 Plone 4.0 到 Plone 4.0.5 的昇級，記錄幾個心得。
主機在 vm 裡，新的 Plone instance 只能先從 localhost 存取，又由於想要整頓帳號，因此使用 w3m http://localhost:8080/ 先建立 Plone Site，再從前台逐步把帳號和資料恢復。
線上直接執行 cp -a ~/plone400/zinstance/var/blobstorage/0x00 ~/plone405/zinstance/var/blobstorage 可能不會正確回復資料，根據討論資訊，配合備份 Data.fs 的時間，也要同時備份 var/blobstorage 的資料。
以 File 為例，舊的檔案如果上傳新的來覆蓋，在 blobstorage 裡會存在兩筆資料，使用 pack 讓 ZODB 更新後，則會只留一筆。這代表 blobstorage 裡的關連，是動態維護的。
目前找到的文件資訊，建議使用 collective.recipe.backup，再找時間繼續測試。

DateIndex Patch for DateError

2011-04-19T13:59:00.003+08:00

在 Plone 4.0.2 ZMI portal_catalog/Indexes 裡，點選 DateIndex 後，想要 Browse 時，偶而會遇到 DateError: Invalid date: (1915, 0, 7, 4, 59, 0, 'UTC') 的錯誤，雖然前台還沒遇到問題，但這樣的狀況總叫人不安。

在 plone IRC 有人提到，這是 manage_browse 的臭虫，使用 browseIndex.dtml DateIndex 當關鍵字，找到 Browse DateIndex Broken for edge cases，將 Zope2 的 Products/PluginIndexes/dtml/browseIndex.dtml 加上 patch 之後，有暫時處理這個臭虫。不過，後來發現搭配 eea.jquery 的 datepicker 功能時，還是會有月份數字少1的問題，例如輸入 1999-01-01 會變成 1999-00-01，看來沒有一勞永逸。

Custom Folder Listing Tips

2011-04-13T16:54:00.009+08:00

常見的 Plone 目錄頁面，可以顯示標題、作者、日期、摘要描述，不過，從 /mysite/@@security-controlpanel 進入 Security settings 設定畫面，有個「Allow anyone to view 'about' information」選項，可以決定一般訪客是否看得到作者和日期資訊。

完整資訊都呈現的效果如下：

希望登入後，還是不顯示作者、日期嗎? 這裡有幾個暴力修改法。
我先用 firebug 查看 HTML 的部份內容，找到「<span class="documentByLine">」的關鍵字，再到 Plone/buildout-cache/eggs 目錄，用 grep -r documentByLine | grep '.pt' 指令，找到 Products/CMFPlone/skins/plone_content/folder_listing.pt 檔案。


<tal:byline condition="show_about">

show_about 是控制的變數，我們只要調整 condition 條件值，就可以改變它顯示的行為。


<tal:byline condition="python: show_about and (context.getId() == 'events')">

在手邊的例子裡，打算讓它在 events 裡才顯示。
使用 context.id 很可能也行，另外 context.getId() in ('events', 'news') 則可以指定數個目錄值。

如果自製的 content type 裡，有個 my_field 欄位，在的迴圈段落，加上 item_myfield item/getMy_field;，就可以用 <span tal:content="item_myfield"> 來顯示。

不過，我遇到的例子 my_field 是個 list，顯示結果是 ['\xe6\xb1\x89\xe6\x97\x8f']，如果只是想要顯示 list 裡的第一個值，最簡化的處理方式是使用 context.my_field[0]。

Archetypes SelectionWidget

2011-02-02T01:38:00.004+08:00

建立 Archetypes 表單時，可用的 widget 很多種，這裡特別整理跟選項有關的設定方式。對於「單選」的欄位，使用 SelectionWidget 就行，頂多只需要指定 format 設定值。下列範例提示了值得留意之處：

from Products.Archetypes.Field import StringField
from Products.Archetypes.Widget import SelectionWidget
...
    StringField(
        name='myfield',
        vocabulary='_get_selection_vocab',
        widget=SelectionWidget(
            label_msgid='label_myfield',
            format='select',
        ),
    ),
...
    def _get_selection_vocab(self):
        """sample selection voc
        """
        return DisplayList((('item01','Item One'),('item02','Item Two'),))

對於「複選」的欄位，使用 MultiSelectionWidget 就可搞定，如果選項過多，就要考慮是否改用 InAndOutWidget。
更多細節，從 Archetypes Developer Manual 找得到說明。

EEA Vocabulary Setup

2011-01-29T17:39:00.005+08:00

了解 vocabulary 的運作原理後，可以參考 Products.EEAContentTypes 的設定範例，在 Products/EEAContentTypes/setup/vocabularies.py 檔案裡看得到變數設定值：

vocabs = {}
vocabs['themes'] = (
    ('default', 'Default'),
    ...
    ('various', 'Various other issues'),
    ('waste', 'Waste'),
    ('water', 'Water'),
)

在 Products/EEAContentTypes/setup/ConfigurationMethods.py 裡看得到設定方法：

def setupATVocabularies(self, portal):
    """ Installs all AT-based Vocabularies """

    from Products.ATVocabularyManager.config import TOOL_NAME \
         as ATVOCABULARYTOOL
    from vocabularies import vocabs

    vkeys = vocabs.keys()
    atvm = getToolByName(portal, ATVOCABULARYTOOL, None)
    if atvm is None:
        return

    for vkey in vkeys:

        if hasattr(atvm, vkey):
            continue

        print "adding vocabulary %s" % vkey

        atvm.invokeFactory('SimpleVocabulary', vkey)
        vocab = atvm[vkey]
        for (ikey, value) in vocabs[vkey]:
            vocab.invokeFactory('SimpleVocabularyTerm', ikey)
            vocab[ikey].setTitle(value)

不過，ConfigurationMethods.py 裡用的 SetupWidget 是舊式方法，新版已改用 GenericSetup 方式安裝。另外，collective.realestatebroker 使用 unicode_vocabulary 來取代 SimpleVocabulary，collective-docs 裡說明 vocabulary 的新式建立方式也和 Archetypes 不同，目前使用 dexterity 來搭配測試。

Drop Down Menu

2011-01-21T09:41:00.004+08:00

目前試過三種 Plone 的 dropdown menu 模組，最早用的是 webcouturier.dropdownmenu，最近再裝了 quintagroup.dropdownmenu 和 Products.qPloneDropDownMenu，初步看來 quintagroup.dropdownmenu 可以配合 Plone 4 環境，Products.qPloneDropDownMenu 則有兩個版本分支，分別配合 Plone 3 和 Plone 4 環境。
安裝 quintagroup.dropdownmenu 的方式之一，是到 src 目錄下載原始碼：

$ cd src
$ svn co \
http://svn.quintagroup.com/products/quintagroup.dropdownmenu/trunk \
quintagroup.dropdownmenu

再編輯 buildout.cfg 內容，在 eggs, zcml, devel 變數加上 quintagroup.dropdownmenu 設定值，最後執行 buildout 讓設定值生效，我用的是指定 develop.cfg 來當執行參數：

$ bin/buildout -c develop.cfg

過程遇到版本衝突的訊息：

While:
  Installing instance.
Error: There is a version conflict.
We already have: zope.schema 3.5.4
but z3c.form 2.4.1 requires 'zope.schema>=3.6.0'.

再次編輯 buildout.cfg 裡的 versions 設定區段，加上 z3c.form = 2.2.0 後，重新執行上述指令就行。

安裝後的設定方式，是到 ZMI portal_actions 裡的 portal_tabs 新增 CMF Action 和 CMF Action Category，由於它用了 RAM Cache，想要馬上看到更改後的效果，從 http://localhost:8080/mysite/@@ramcache-controlpanel 之類的網址，清除 cache 記錄即可。

Study on Vocabulary

2011-01-16T16:37:00.008+08:00

在 Dynamic Vocabularies in Plone Archetypes 文件裡，介紹幾種常見的 vocabulary 範例。最簡單的設定方式，是在 config.py 檔案列出清單：

HOUR = DisplayList((
  ('1', '1'),
  ('2', '2'),
  etc...
))

再於 content type 的定義檔案裡，指定 vocabulary 變數值：

StringField(
    'hour',
    vocabulary=HOUR,
    widget=SelectionWidget(
        label='Hour',
    ),
    required=1,
),

這個例子的清單，還可以用程式碼來產生：

class Event(ATContent):
    def getHours(self):
        dl = DisplayList()
        for x in range(1, 13):
          dl.add(str(x))
          dl.add(str(x))
        return dl

這樣就可以改用 method 存取：

StringField(
    'hour',
    vocabulary="getHours",
    widget=SelectionWidget(
        label='Hour',
    ),
    required=1,
),

進一步來看，想要動態存取目錄裡的物件，可以借助 Acquisition 的服務：

from Acquisition import aq_parent

程式碼範例如下：

def getLinks(self):
    dl = DisplayList()
    linklist = aq_parent(self).contentValues(
                   filter={'portal_type': 'Link'}
               )
    for link in linklist:
        dl.add(link['id'], link['title'])
       
    return dl

接著，還可以參考 eea.faceted.vocabularies 的範例：

eea/faceted/vocabularies
|-- README.txt
|-- __init__.py
|-- catalog.py
|-- configure.zcml
|-- faceted.py
|-- portal.py
|-- position.py
|-- section.py
|-- simple.py
|-- tests.py
|-- types.py
|-- utils.py
`-- version.txt

以 faceted.py 為例，裡面的 FacetedPortalTypesVocabulary 會回傳 portal_types 和 portal_facedted 裡定義的項目，而 portal_facedted 是由 eea.faceted.tool 提供，如果要調整項目的排序方式，可以查詢 items.sort(key=operator.itemgetter(1), cmp=compare) 程式碼片段。

測試過程遇到 ValueError: Supplied vocabulary values resulted in duplicate term tokens 錯誤訊息，狀況是混用 Products.ATVocabularyManager 和 vocabularies.zcml 兩種方式，把 vocabulary name 都設成一樣，結果在進入 facetednavigation 的 configlet 畫面，它要把所有 vocabulary 清單列出時，發生這樣的錯誤。

更底層的細節，則可參考 zope.schema.vocabulary 和 zope.app.schema.vocabulary 的內容：
SimpleVocabulary : implements(IVocabularyTokenized)
SimpleTerm : implements(ITokenizedTerm)
FacetedPortalTypesVocabulary : implements(IVocabularyFactory)

Exploring Objects with iw.debug

2010-12-23T21:07:00.003+08:00

iw.debug 是用於 Zope 或 Plone 的偵錯工具，看來是仿照 Debug Anywhere 原理做成，和 plonectl debug 的方式有所不同。以 Plone 4.0.2 為例來安裝，在 buildout.cfg 裡指定 eggs 和 zcml 加入 iw.debug 即可，iw.debug 0.3 的相依套件是 ipython 0.10.1。
執行方式是先 bin/plonecfg fg 在前景模式啟動，透過 http://localhost:8080/myportal/@@ipdb 之類的網址，就可以在 console 看到 ipdb> 提示符號，輸入 ll 可以查看 local 變數。

Widget to show Localized Title

2010-12-22T17:37:00.003+08:00

eea.facetednavigation 的 checkbox widget 預設不會顯示翻譯過的標題，下列是個解法：

$ diff widgets/checkbox/widget.pt widgets/checkbox/widget.pt-new
14,15c14,15
<   <legend tal:define="title python:view.data.get('title', '')"
<     tal:content="
<     python:view.translate(title)" i18n:translate="">HTML Widget</legend>
---
>   <legend tal:define="title python:view.data.get('title', '')"
>     i18n:translate="" i18n:domain="plone">
>     <span tal:replace="title"/></legend>
25c25
<         wbr_term_label python:view.word_break(term_label);
---
>         term_label_translated python:term[1];
35c35
<           tal:content="structure wbr_term_label">term label</label>
---
>           tal:content="structure term_label_translated">term label</label>

Plone Folder

2010-12-01T10:27:00.002+08:00

Plone 3 和 Plone 4 目錄的實作方式不同，前者分成「一般目錄」和「大型目錄」兩種目錄型別，後者則是只實作一種型別，將兩種型別的特色整併。

一般目錄 (Folder) 最適合存放 50 個項目之內的場合，在內容操作介面裡，使用者可以手動拖拉，調整項目的順序。缺點在於，存取目錄物件時，是使用 Python 的 pickle 指令，會將整個目錄資料載入記憶體，目錄裡的項目過多時，容易造成效能變差。同時，目錄裡的項目值是以 tuple 型別來指定，存取過程都是整批處理，容易造成 ZODB 的衝突錯誤。

大型目錄 (Large Folder) 則是適合存放大量項目的場合，內部以 B-tree 實作，對於記憶體和硬碟的衝擊較小，同時也能針對局部資料進行鎖定，不易造成 ZODB 的衝突錯誤。它的缺點則是沒有提供調整項目順序的介面，而且要額外到 portal_types 設定，才能把項目內容顯示在資訊方框。

Plone 4 重新實作一個 plone.folder 型別，混合上述的優點，不再分成兩種目錄型別。

透過 Plone 3 網站 ZMI 的 portal_types 工具，可以詳細觀察 Large Folder 的屬性值，特別留意 Implicitly addable 的設定值，勾選後就可以在 Plone 3 的前台介面新增，例如 Members、news、events 目錄，都是使用 Large Folder 型別。

Plone 3.x Migration to Plone 4.0

2010-11-30T14:18:00.003+08:00

migration 至少分成資料與模組的昇級，兩者相關，但處理的重點不同。前者可參考 quintagroup.transmogrifier 的範例，後者則要先閱讀 Upgrade Guide。

找到一個 ethnomed project 當作模組昇級範例，它已具備 buildout policy theme contenttypes extrafields reviewlist 等模組，透過 svn co https://svn.hsl.washington.edu/repos/ethnomed/ethnomed.buildout/trunk 可以取得原始碼。

開發過程有使用 Products.CacheSetup 之類的相依關係，在 Plone 4 的場合會遇到問題，可參考這個 chageset 的處理方式。另外 ethnomed/contenttypes/browser/viewlets.py 裡的 membership = self.tools.membership() 要改成 membership = getToolByName(self.context, 'portal_membership') 才能正常顯示多位作者。

額外的範例還有 PloneBooking 的 changeset。

Title-to-Id Behavior

2010-11-29T22:11:00.005+08:00

title-to-id 是 Plone 的行為特色，在建立文件的過程，會把 title 欄位的值，轉換成 URL 的值。事實上，也可以事後轉換，例如寫成 External Method 來批次執行。

Archetypes 預設就使用 title-to-id 機制，相關的程式碼片段整理如下：

Products/Archetypes/BaseObject.py

# Import conditionally, so we don't introduce a hard dependency
try:
    from plone.i18n.normalizer.interfaces import IUserPreferredURLNormalizer
    from plone.i18n.normalizer.interfaces import IURLNormalizer
    URL_NORMALIZER = True
except ImportError:
    URL_NORMALIZER = False

class BaseObject(Referenceable):
    ...
    def generateNewId(self):
        """Suggest an id for this object.
        This id is used when automatically renaming an object after creation.
        """
        title = self.Title()
        # Can't work w/o a title
        if not title:
            return None

        # Don't do anything without the plone.i18n package
        if not URL_NORMALIZER:
            return None

        if not isinstance(title, unicode):
            charset = self.getCharset()
            title = unicode(title, charset)

        request = getattr(self, 'REQUEST', None)
        if request is not None:
            return IUserPreferredURLNormalizer(request).normalize(title)

        return queryUtility(IURLNormalizer).normalize(title)

    def _renameAfterCreation(self, check_auto_id=False):
        """Renames an object like its normalized title.
        """
        old_id = self.getId()
        if check_auto_id and not self._isIDAutoGenerated(old_id):
            # No auto generated id
            return False

        new_id = self.generateNewId()

plone/i18n/normalizer/__init__.py

class URLNormalizer(object):
    ...
    def normalize(self, text, locale=None, max_length=MAX_URL_LENGTH):
        ...
        text = baseNormalize(text)
        base = text # use text.lower() to make it lower-case

把原本 base = text.lower() 改成 base = text。

另外，Dexterity 則利用 Name From Title 的行為設定來啟用，參考 plone.app.content 裡 interfaces.py 的 INameFromTitle。

Archetype Content Customization

2010-11-24T22:02:00.007+08:00

在 Plone 4 初期，Archetype 還活著，它仍是自製表單的常見方式，即使日後要改用 Dexterity，也有機會透過 transmogrifier 來轉移內容。想要客製化 Archetype 表單，常見的工作是修改 view 和 edit 的程式碼，以 MyType 的 view 為例，它是由 base_view.pt 來管理 js、css、header、body、folderlisting、footer 六個 macro 設定值，預設會去拉 mytype_view.pt 來顯示，找不到的話就使用 base.pt 來顯示，base.pt 提供四個 macro 設定值，能夠滿足小規模的調整需求。原則上不需要修改 base_view.pt 內容，想要大規模地修改 view 動作，可以在 browser/configure.zcml 裡註冊新的顯示方式。
使用 ReferenceField 的話，要搭配 ReferenceBrowserWidget，它要從 archetypes.referencebrowserwidget 載入，利用 allowed_types=('Document',) 之類的設定值，可以限定項目種類，利用 allow_search=True 可以決定是否提供搜尋欄位。
想要修改 schemata 的話，是使用類似 schema.changeSchemataForField('related_category', 'reference') 這樣的語法。預設的 Dublin Core metadata 相關欄位，設定在 Products/Archetypes/ExtensibleMetadata.py 檔案裡，例如 rights 欄位的資訊：

TextField(
    'rights',
    accessor="Rights",
    default_method='defaultRights',
    widget=TextAreaWidget(
        label=_(u'label_copyrights', default=u'Rights'),
        description=_(u'help_copyrights',
                      default=u'Copyright statement.'),
        )),

透過 default_method 可以指定預設的內容，例子裡的 defaultRights 就是呼叫 portal_metadata 的 listSchemas() 來比對是否存在預設值，而且在 Products/ATContentTypes/content/schemata.py 檔案裡，利用 finalizeATCTSchema() 來指派各欄位的 schemata 位置。
另外，使用 Plone 4 的朋友，記得參考新的網頁管理方式。

Transmogrifier - Import/Export Made Easy

2010-11-05T16:22:00.006+08:00

collective.transmogrifier 是處理資料轉換或匯出匯入的工具，常被用來支援 Plone 網站資料的匯出匯入，但其他網站同樣可以引用。

成功測試的是使用 Plone 3.3.5 UnfiedInstaller 來安裝，修改 buildout.cfg 內容如下：

eggs =
    Pillow
    Plone
    collective.transmogrifier
    plone.app.transmogrifier
    transmogrify.sqlalchemy
    pysqlite
    argparse
    iw.debug

zcml =
    collective.transmogrifier-meta
    collective.transmogrifier
    plone.app.transmogrifier
    transmogrify.sqlalchemy
    iw.debug

[versions]
Pillow = 1.2
SQLAlchemy = 0.6.5
argparse = 1.1
distribute = 0.6.14
iw.debug = 0.3
plone.app.transmogrifier = 1.1
pysqlite = 2.6.0
transmogrify.sqlalchemy = 1.0.1
collective.transmogrifier = 1.2
ipdb = 0.2
ipython = 0.10.1

使用時要搭配設定檔，例如建立一個 import_test.cfg 檔案，來處理資料庫內容的匯入。設定檔的格式跟 buildout.cfg 類似，第一個設定區段 [transmogrifier] 先指定要用到的 pipeline 項目，也就是轉換資料的過程，需要哪些分解動作。以匯入的例子來說，資料來源是資料庫的內容，存取的資料會依序在 pipeline 傳遞，最後寫進 ZODB 並且更新 Archetype 之類的表單內容。

[transmogrifier]
pipeline =
    source
    add_type
    add_path
    constructor
    schemaupdater

每個 pipeline 項目又有對應的 section 設定值，其中的 blueprint 是 named adapter，而且慣例是以 package name 來命名，完全避免撞名的問題。以 [source] 的設定值為例，它是搭配 SQLite 來讀取資料，傳遞中的資料以 dict 格式來處理，以 [add_type] 為例，它會新增一組 '_type': 'MyContentType' 資料併入 dict 裡，再往下一個 pipeline 傳遞。

[source]
blueprint = transmogrify.sqlalchemy
dsn = sqlite:///database.sqlite
query = SELECT gid, name as title, organizer, address, tel FROM test

[add_type]
blueprint = collective.transmogrifier.sections.inserter
key = string:_type
value = string:MyContentType

[add_path]
blueprint = collective.transmogrifier.sections.inserter
key = string:_path
value = python:'/MyFolder/'+str(item['gid'])

[constructor]
blueprint = collective.transmogrifier.sections.constructor
required = True

[schemaupdater]
blueprint = plone.app.transmogrifier.atschemaupdater

資料來源並不限於資料庫，也可以是 CSV 檔案，除了匯出匯入資料外，也可以轉換文字編碼之類的動作。如果想套用 PostgreSQL 來源，安裝的模組檔案改為 psycopg2，並參考 transmogrify.sqlalchemy 的範例，改成 dsn = postgres://scott:tiger@localhost:5432/mydatabase 的設定值。

Building Policy Package

2010-10-24T12:49:00.004+08:00

客製化 Plone 網站的方式，有兩種途徑，一種是在網頁設定介面進行，稱為 TTW (Through The Web)，另一種是在檔案系統裡撰寫程式碼，稱為 TTF (Through The Filesystem)。
撰寫程式碼的好處之一，是日後可以重覆沿用設定值，Plone 利用 GenericSetup 和 ZopeSkel 等機制，協助管理員建立客製化的 Policy Package 模組。以 UnifiedInstaller 安裝方式為例，開發中的模組程式碼要放在 src 目錄裡，建立工具是 paster 程式，步驟如下：

$ cd src
$ ../bin/paster create -t plone zopenfoundry.policy
Selected and implied templates:
  ZopeSkel#basic_namespace  A basic Python project with a namespace package
  ZopeSkel#plone            A project for Plone products

Variables:
  egg:      zopenfoundry.policy
  package:  zopenfoundrypolicy
  project:  zopenfoundry.policy
Expert Mode? (What question mode would you like?
 (easy/expert/all)?) ['easy']:
Version (Version number for project) ['1.0']:
Description (One-line description of the project) ['']:
 ZOpenFoundry Policy Package
Register Profile (Should this package register a GS Profile)
 [False]: True

特別注意，Register Profile 要指定為 True。
再編輯 buildout.cfg 內容，在 develop = 指定 src/zopenfoundry.policy，並在 eggs = 和 zcml = 指定 zopenfoundry.policy，執行 bin/buildout 指令，通知系統已建立了新模組。要留意的是，試過把 package name 寫在 base.cfg 的結果，並不會讓系統找到新模組。
想要測試模組是否能被系統存取，可用 zopepy 工具來檢查：

$ bin/zopepy

>>> from zopenfoundry import policy
>>>

沒有發現 ImportError 的話，就是成功了。
接著，要在 profiles 目錄裡建立設定檔，如果 profiles 目錄還未被建立，可以手動完成：

$ cd src/zopenfoundry.policy/zopenfoundry/policy
$ mkdir profiles
$ mkdir profiles/default

在 profiles/default 目錄裡建立 properties.xml 檔案，內容如下：

<?xml version="1.0"?>
<site>
 <property name="title">ZOpenFoundry Site Policy</property>
 <property name="description">Welcome to ZOpenFoundry Site</property>
</site>

至此，就可以重啟系統，到 Plone Site Setup 把模組啟用。

Permission to Search Member

2010-10-20T17:28:00.003+08:00

預設在 Plone 的 Users 資料夾裡，未登入的使用者無法看到會員資訊，而被通知 You are not allowed to list portal members. 訊息，這是因為 Anonymous User 沒有 List portal members 的權限，處理方式之一，是到 ZMI 的 Security tab 調整。

如果 Plone Site Setup 裡有選項，讓管理員能夠設定的話，會更理想。關於權限的基本說明，可參考 Basic Roles and Permissions in Plone。

EEA Faceted Navigation

2010-10-07T18:29:00.003+08:00

Faceted Navigation (FacetedNav) 是 Plone 顯示搜尋結果的新方式，以搜尋結果為中心，使用者可以在週圍選擇查詢條件，結合 jQuery 後，它能夠更快速地回應搜尋結果。

完成測試的環境是 Plone 3.3.5，有人貢獻 Plone 4 patch，現在也有 collective repository for Plone 4。

可以結合 Syndication (XML) 和 Cache (memcache) 提供進階應用。開發人員來自 EEA (European Environment Agency) 是歐盟提供環保政策資訊的單位，已有生產許多 Plone 模組。

BLOB Support for Plone

2010-09-25T15:23:00.001+08:00

經過一番努力，Plone 4 已預設支援 blob 大型檔案，像是 Image 和 File 這兩個內容型別，上傳後的檔案，會存放在 filesystem 裡，而不再是 ZODB 了。例如上傳一個 4MB 的圖檔，到 zinstance/var/blobstorage 目錄裡，可以發現這個檔案實際存放於此，至於這個圖檔的 metadata 或 history 資訊，仍然是存在 ZODB 裡。

$ ls -l var/blobstorage/0x00/0x00/0x00/0x00/0x00/0x00
  /0x0f/0xa9/0x03891a0bd54aebbb.blob
-r-------- 1 marr marr 4815658 2010-09-25 12:27
  0x03891a0bd54aebbb.blob
$ ls -l var/blobstorage/0x00/0x00/0x00/0x00/0x00/0x00
  /0x0f/0xb2/0x03891a0be6c98b00.blob
-r-------- 1 marr marr   20868 2010-09-25 12:27
  0x03891a0be6c98b00.blob

內建的內容型別可以立即享受上述的功能，舊版的 Archetype 內容型別，必須要先完成昇級才行。昇級的主要步驟，是使用 schema extender 把 FileField 換成 BlobField，再利用 plone.app.blob 的 migrate 工具程式來執行昇級。細節可參考範例。

使用 Dexterity 的場合，可參考 developer manuanl 的範例。

Features and Tips for Plone 4

2010-09-14T22:16:00.003+08:00

前陣子 Plone 4 正式推出，由於使用 Python 2.6，執行效率大幅提昇，支援 blob 大型檔案，有效改善 ZODB 過度成長的問題，預設搭配 SunBurst 佈景主題，以及 TinyMCE 編輯器，操作更加容易。想要知道更多改進之處，不妨直接下載安裝，或是到 demo site 親身體驗。

與開發人員有關的調整，包括 develop.cfg 的使用，可參考 Creating a theme package with ZopeSkel 的範例，另外要留意的是，訊息檔的翻譯方式也有新方式。這些調整，其實也是為了繼續朝 Plone 5 前進。

Ploneboard 2.1 with Plone 3.3.5

2010-08-22T11:55:00.005+08:00

雖然 Plone 4.0 近期就要正式問世，最近還是先搭配 Plone 3.3.5 安裝了 Ploneboard 2.1b2。執行 buildout 安裝過程沒問題，但在 quick install 過程遇到 AttributeError: portal_placeful_workflow 的錯誤訊息，原因在於 CMFPlacefulWorkflow 是它的相依模組，但沒有自動隨之啟用，解決方法很簡單，就是手動先把 CMFPlacefulWorkflow 啟用，再啟用 Ploneboard 就行，這個動作也會順便把 SimpleAttachment 啟用。正式的解法已寫成 trunk，訊息翻譯的成果也要放在這裡。

選擇想要新增討論區的目錄，以首頁為例，從新增項目的下拉選單找到 Message Board。

設定討論區的基本資料，包括標題、摘要描述、分類關鍵詞等。

討論區的基本樣貌已經具備，接著，點選 Add Forum 就可新增討論板。

設定討論板的資料，包括標題、摘要描述、分類關鍵詞、附件檔案最大數量等。

討論板的預設狀態是 Requite membership to post，表示註冊會員在登入系統後才能張貼討論文章，新的討論主題稱為 conversation。

設定討論主題的資料，包括標題、內文、附件檔案等。

bzr Tip: These branches have diverged

2010-08-16T16:15:00.003+08:00

Bazaar 是搭配 Launchpad 所用的管理工具，屬於分散式版本管理方式，由 Canonical 公司支援發展。
最近使用 bzr 2.0.1 的經驗，遇到 "bzr: ERROR: These branches have diverged. Use the missing command to see how. Use the merge command to reconcile them." 訊息，有撇步表示可以使用 bzr pull --overwrite 指令，再把 patch 重新擺回去。

Plone Theme Resource Customizer

2010-08-08T20:43:00.003+08:00

想要更換 Plone 網站的 logo 或 CSS 設定值，傳統方式是到後台介面 (也就是 Zope Management Interface, ZMI) 進行設定，現在由前台介面 (也就是 Plone Site Setup) 也可以搞定了。

安裝 plone.app.themeeditor 後，原本要到 portal_skins 或 portal_view_customizations 才能編輯的佈景主題資源檔案，現在都可以在 Plone Site Setup 裡統一進行修改，操作方式請見教學影片，甚至可以搭配 windmill 進行測試工作。

How Sahana Eden Uses Launchpad

2010-08-05T17:03:00.004+08:00

幾天前看了 launchpad 的介紹，網頁講得像是天下無敵，因此就問 Fran 有打算完全使用 launchpad 來開發嗎? Fran 表示 launchpad 的 branch 支援很棒，但 ticket 並不能搭配 branch 來排序，如果 branch 數量不多是夠用，但 branch 數量多時，就亂到難以管理。
因此 Sahana Eden 目前只使用 bzr 及 launchpad 來管理 branch，但使用 trac 來管理 ticket，另外 trac 本來就有 wiki 能整理文件。
還有一點，Eden 借用 lauchpad 的 BluePrint 概念，但直接在 trac wiki 上撰寫 BluePrint。
或許日後 launchpad 會改善上述的排序問題，

Setting Random Times with zope.sendmail

2010-06-16T08:58:00.003+08:00

This is an abstract from How to add a random time between two emails sent from zope.sendmail.

需要搭配 Plone 架設 newsletter 的場合，可以使用 collective.dancing，它能夠管理訂戶資料，並利用 zope.sendmail 協助自動發信。如果訂戶數量過大，批次發信可能會被列入黑名單，此時，試試設定亂數時點，來處理這樣的問題。方式是撰寫 plone.smtp 程式碼：

import random
import time

from zope.sendmail import mailer

class SMTP(mailer.SMTPMailer):
    """Override SMTPMailer to let a random time"""

    def send(self, fromaddr, toaddrs, message):
        time.sleep(random.uniform(0,2))
        super(SMTP, self).send(fromaddr, toaddrs, message)

Tips on LeadImage and Folder View

2010-06-07T14:26:00.003+08:00

Folder 預設的標準顯示方式，如果覺得單調，想要增加圖示，可以藉助於 Content Lead Image。

使用 buildout 新增擴充模組的方法，就可以安裝 collective.contentleadimage，在 Site Setup 裡可以指定使用 lead image 的 content type，包括 Folder。指定後，在 Folder 的 display 選項裡，就看得到 Folder lead-image view。

如果逐行顯示目錄的方式，還是覺得單調，想要改成兩欄式，可以在 ploneCustom.css 裡調整 vevent 的 class 設定值。

.vevent {
  float: left;
  height: 137px;
  width: 42%;
  margin-left: 4em;
}

如果發現 History 的位置亂掉，可以到 ZMI portal_view_customizations 修改 plone.belowcontentbody.contenthistory (zope.interface.interface-plone.belowcontentbody.contenthistory)，在上方新增一行：

<div class="visualClear"></div>

以上是 Through The Web (TTW) 的修改方式，如果要在程式碼裡調整，可以參考 Plone Manual dynamic views 的說明。

Developer Options for Plone 4

2010-05-24T12:27:00.002+08:00

從 Plone 4 beta 版本開始，buildout.cfg 裡關於
開發者的設定值，被獨立放在 develop.cfg 檔案裡，如此一來，paster 和 ZopeSkel 之類的工具，預設就不會馬上安裝，要額外執行指令，才會安裝開發工具：

bin/buildout -c develop.cfg

安裝開發工具後，還可以測試寄送通知信的工作，這類開發測試的工作獨立出來後，可以進一步簡化一般使用者的安裝步驟。

web2py I18N Translation Tool

2010-05-22T12:12:00.005+08:00

web2py 是個類似 Django 或 Ruby on Rails 的 web application framework，使用案例之一是 Sahana Eden，Sahana 是一套災難管理系統，最早以 PHP 語言開發，後來有 Python 語言的分支版本，稱為 Eden，便是採用 web2py 開發架構。
web2py 以 Python dictionary 為基礎，有個處理介面訊息翻譯的內部引擎，在管理頁面就可以編輯訊息檔內容，檔案放在 applications 目錄裡專案的 languages 目錄。不過，要是想利用 PO 檔來管理訊息翻譯，就得搭配 web2py2po 工具，原始碼在 nursix 或 sourceforge 上。

Get Id of Items

2010-05-04T11:25:00.004+08:00

My customized content types need a link passing its ID to another PHP script. This PHP script looks into database and performs based on the ID. Here is the sample page template:

<div tal:define="itemId context/getId;
                 itemIdUpper python: itemId.upper()">
<a href=""
 tal:attributes="href python: 'http://another.site.com/some.php?k='+itemIdUpper;
                 title itemIdUpper;">Show in Another App</a>
</div>

Plone 4 Way to Get Icon

2010-04-30T10:12:00.007+08:00

昇級 Plone 4 的過程，發現有些 content type icon 沒有顯示，在 log 裡找到線索：

WARNING Plone Deprecation Warning
The icon for the 'controlpanel/DropdownConfiguration' action 
was obtained from the action icons tool. 
The action icons tool has been deprecated 
and will be removed in Plone 5. 
You should register action icons directly on the action now, 
using the 'icon_expr' setting.

繼續追查後，原來 icon 存取方式已經改變，在 CMF 2.2.0-alpha 正式引入新的方式，而 Plone 4 使用 CMF 2.2.0 版本，自然也受到影響。如果到 ZMI 裡的 portal_actionicons 查看比較，會發現大有不同。

Plone 4 Upgrading

2010-04-29T11:26:00.003+08:00

目前 Plone 4 處於 beta 2 階段，測試 Plone 3 昇級的結果，還算順利，值得一提的訊息有：

INFO PythonScripts Some of your Scripts have stale code cached.
Since Zope cannot use this code, starup will be slightly slower
until these Scripts are edited.
You can automatically recompile all Scripts that have this problem
by visiting /manage_addProduct/PythonScripts/recompile
of your server in a browser.
ERROR PortalTransforms Cannot register transform rtf_to_html,
using BrokenTransform: Error Unable to find binary "rtf-converter"

工作原理和以前一樣，把 Data.fs 放到新版環境裡的 var/filestorage 再啟動，同樣有 dry run mode 提示，但整體的介面訊息變得更清楚。
目前遇到的狀況是 webcouturier.dropdownmenu 在昇級後，造成 LocationError: (None, 'html_tag') 的錯誤訊息，來源之一是 webcouturier/dropdownmenu/browser/dropdown_recurse.pt Line 29, Column 12。事先把 dropdownmenu 模組停用，就可以避掉這問題。
另外，可能會遇到 Default Theme 跳到 Unstyled 的狀態，只要進 plone_control_panel 或 @@skins-controlpanel 指定為佈景主題為 Plone Classic Theme 或 Sunburst Theme 就搞定。

Changing Tabs with Viewlet

2010-04-13T13:33:00.003+08:00

在 Plone 的 Navigation Settings 裡，利用 automatically generate tabs 的設定，可以在 portal-globalnav 區域自動產生根目錄的 tab 項目，如果只想限定目錄自動產生為 tab 項目，那就把 Generate tabs for items other than folders 取消勾選，如果某個自動產生的目錄 tab 項目，不希望它出現在 portal-globalnav 區域，除了取消自動產生 tab 項目的方式外，還可以動手修改 viewlet 來達成。

上述的 portal-globalnav 名稱，是從 CSS 角度來稱呼它，用 firebug 查得到它在 CSS 檔案的位置，如果是從 viewlet 角度來稱呼它，它的名稱是 global_sections。

例如根目錄有個名稱為 tmp 的目錄，不希望它出現在 portal-globalnav 區域，到 portal_view_customizations 裡的 plone.global_sections 加個 tal:condition 就行：

<ul id="portal-globalnav">
  <tal:tabs tal:repeat="tab view/portal_tabs">
    <li tal:attributes="
      id string:portaltab-${tab/id};
   class python:view.selected_portal_tab==tab['id']
         and 'selected' or 'plain'">
     <a href="" 
        tal:condition="python: tab['id'] != 'tmp'"
        tal:content="tab/name"
        tal:attributes="href tab/url;
                        title tab/description|nothing;">
     Tab Name
     </a></li></tal:tabs>
</ul>

想要知道有哪些 viewlet 以及它們的位置，可使用 http://localhost:8080/Plone/@@manage-viewlets 之類的網址來查詢。

Quotes of the Day

2010-04-08T18:27:00.003+08:00

"The best way to keep learning after you leave school is surround yourself with the smartest people you can find."

"If you want to build a ship, don't drum up men to collect wood and don't assign them tasks and work, but rather teach them to long for the endless immensity of the sea."

"Understanding how to write well and effectively communicate the nuances of your thoughts is the most important thing you will learn in school."

"I would have written a shorter letter if I'd had the time." -- Mark Twain

"Great leaders are great teachers. And great teachers are great storytellers."

"If you want to be a leader, you will teach. The two are inseparable."

"As leaders, you learn more by listening than by talking. Listening makes you mor humble, more intuitive, and smarter. Talking does none of these things."

"When you listen, you learn how things work as opposed to when you talk and state how you thing things work."

"If you must talk, ask questions."

"If we have data, let's look at the data. If all we have are opinions, let's go with mine." -- Jim Barksdale

"You shouldn't be able to figure out the pecking order or org chart by looking at a product."

"There is no such thing as a minor lapse of integrity." -- Tom Peters

"I have no special talent. I am only passionately curious." -- Albert Einstein

"Nothing great was ever achieved without enthusiasm."

"Team are not juries locked in a room until they reach a unanimous verdict. Don't spend hours in endless meetings striving for unanimity. Consensus is not unanimity. Guide the team to declare when 'good enough' is better."

"The perfect is the enemy of the good, from which there is no progress."

"If everyone is thinking alike, then somebody isn't thinking." -- George Patton

"Where there is harmony, there is no innovation."

"Innovation comes from creativity. Creativity cannot be managed. It can be allocated, it can be budgeted, it can be measured, it can be tracked and encouraged, but it can't be dictated."

"If you're the innovator, you're like a virus. The antibodies want to kill you.
Leaders protect people from antibodies."

"A leader's job is not to prevent risk, but to build the capability to recover when failures occur. There is no such thing as a good failure and a bad failure. Or there is such a thing as a good failure and a bad failure. A good one happens quickly, and it provides plenty of lessons. Sometimes you have to look at these lessons in the data. A bad failure takes a long time and you don't learn anything. Leaders don't prevent failures. They prevent bad failures."

"Learn something new so that you can remember how hard it is to learn."

"Teach something so you can learn."

"Humility is correlated with age. Arrogance is inversely correlated with age."

"As smart leader, you surround yourself with great people. You people understand what they're doing better than you do."

"Good judgment comes from experience, and a lot of that come from bad judgment." -- Will Rogers

"Show me a team that never makes a mistake, and I'll show you a team that has never done anything innovative."

"Smart people can smell hypocrisy, so think before you act or speak. You have to commit to your team's goal and vision? They can tell when you don't really mean it."

"Setting an example is not the main means of influencing another, it is the only means." -- Albert Einstein

"If you would not work for yourself, why do your people?"

All are from Rules to Success by Jonathan Rosenberg.

Plone3 Theme

2010-04-03T23:51:00.006+08:00

概念上 Plone3 Theme 包括 template (page template)、stylesheet (CSS)、image 三種類型，以及 browser、skin 兩種機制。剛接觸 Plone 的朋友，先從修改 image 和 CSS 下手，比較容易入門。

以 CSS 為例，開發的準備工作之一，要將 Plone 執行模式設定成 debug mode 而非 production mode，也就是 parts/instance/etc/zope.conf 檔案的內容，要有下列的設定結果：

debug-mode on

這樣 CSS 修改結果才能馬上生效，而不會受到 cache 和 compression 的影響。

在 ZMI 的 plone_skins/plone_styles 裡，找得到 ploneCustom.css 檔案，預設是個空白範例，可以用來測試設定效果。想要修改它，先確定下拉選單的選項是 custom，再按 Customize 鈕，這樣會把這份灰底設定檔複製到 portal_skins/custom 目錄，並打開在網頁上等待編輯。值得留意的是，僅管下列內容看似是註釋文字，但它們是會被執行的程式碼，通常不該被刪除：

/* <dtml-with base_properties> (do not remove this :) */
/* <dtml-call "REQUEST.set('portal_url', portal_url())"> (not this either :) */

/* </dtml-with> */

除此之外的 /* */ 內容都是註釋文字，要刪要留，悉聽尊便。

例如，下列是一段可以讓版面置中對齊的設定範例：

#visual-portal-wrapper {
  background: #aaaaaa url(&dtml-portal_url;/banner.jpg) no-repeat top left;
  margin-left: auto !important;
  margin-right: auto !important;
  width: 900px !important;
}

還有 sectional CSS 的範例，可以單獨修改首頁的顯示方式。更多的資訊，可參考 Plone 3 Theming 書籍。

Utilizing JavaScript in Plone Without Knowing

2010-03-31T18:04:00.004+08:00

This is an abstract from Utilize Available JavaScript in Plone without Knowing JavaScript by Chrissy Wainwright.

使用 Plone 預設操作介面時，有些 script 已經在默默運作，更棒的是，只要粗略了解程式碼運作的原理，不必精通 Javascript 的細節，就可以搭配 portal_skins/plone_ecmascript 裡的 .js 內容，將頁面調整成我們想要的效果。

編輯內容時，想要把內容拆開在不同的 tab 頁面顯示，不必重傳網頁內容，這樣的效果稱為 FormTabbing 技巧。

form_tabbing.js 檔案就是達成上述效果的工具，下列的程式碼示範它的運作方式：

<dl class="enableFormTabbing">
<dt id="fieldsetlegend-unique-id1">button one</dt>
<dt id="fieldsetlegend-unique-id2">button two</dt>
<dd id="fieldset-unique-id1">content one</dd>
<dd id="fieldset-unique-id2">content two</dd>
</dl>

範例中的兩個按鈕，分別由 <dt> 標籤語法所指定，按鈕的 id 要以 fieldsetlegend- 字樣開頭，按鈕所對應的內容，分別由 <dd> 標籤語法所指定，其 id 則要以 fieldset- 字樣開頭。同樣的道理，上述程式碼的原理，也可以用於 <form> 標籤裡：

<form class="enableFormTabbing">
<fieldset id="fieldset-[unique-id]">
<legend id="fieldsetlegend-[same-id-as-above]">Title</legend>
</fieldset>
</form>

除此之外，還有 table_sorter.js 和 collapsiblesections.js 的範例，有興趣就去試吧。

ZopeSkel local commands

2010-03-26T15:01:00.003+08:00

UnifiedInstaller 是目前開發 Plone 的建議起步方式，特別是 Plone 3 UnifiedInstaller 把 buildout 整合後，系統的安裝和擴充都變得更方便了。
不過，最近想用 paster 來建立 archetype 專案，還是讓我遇到 local commands 找不到的問題。雖然應該不是 paster_plugin 的問題，但在 buildout.cfg 調整下列的設定值，同樣能解決我的困擾：

[zopeskel]
recipe = zc.recipe.egg
dependent-scripts = true
eggs =
    PasteScript
    ZopeSkel
initialization =
    import paste.script.command
    paste.script.command.system_plugins.append('zopeskel')

假設在 src 目錄裡，先用 paster 建立一個名稱為 myproject.mytype 的 archetype 專案，就可以在專案目錄裡執行 paster --help 看到 addcontent 等的 local command 資訊。

ZPublisher.Conflict ConflictError

2010-03-26T11:37:00.003+08:00

My log contains the following message:

INFO ZPublisher.Conflict ConflictError at /VirtualHostBase/http/my.host.org:80/MySite/VirtualHostRoot/_vh_MySite/some-folder/mportal_factory/MyTypes/mytype.2010-03-26.5609762949/@@plone_lock_operations/refresh_lock: database conflict error (oid 0x02 d2e1, class BTrees._IOBTree.IOBucket, serial this txn started with 0x0385090b54cf6f88 2010-03-26 02:51:19.877413, serial currently committed 0x0385090b54cf6f88 2010-03-26 02:51:35.450306) (1 conflicts (0 unresolved) since startup at Fri Mar 26 03:55:41 2010)

It seems similar to the message in http://n2.nabble.com/ZPublisher-Conflict-ConflictError-td339922.html. In my case, a package webcouturier.dropdownmenu is used and 'Depth of dropdown menus' is set as 3, without enabling caching. Since there are more and more items added to the folder, 3 levels of dropdown menus bring us problem. After the level is set to 2, the page response time much improves. Problably the BTrees object is from cataloguing for dropdown menus.

ZServer uncaptured python exception

2010-03-26T10:06:00.003+08:00

在 http://aspn.activestate.com/ASPN/Mail/Message/zope-list/3492748 提到，使用者臨時取消網頁存取動作，例如按了瀏覽器的停止鍵，會產生這類的訊息，一般是無須追究的情況，真想探究 exception 內容的話，要主動去接取它。如果伴隨系統資源吃緊的狀況，可用 'debug spinning zope' 關鍵字來查詢除錯技巧，或是查詢 spider 或 bot 的造訪狀況，必要時採用 iptables -A INPUT -s -j DROP 的激烈手段。

User SubGroup and Associated Roles

2010-03-13T10:42:00.004+08:00

Plone 3.2 版本之前的會員管理介面 prefs_users_overview 執行搜尋時，只能針對 full name 欄位進行比對，不能比對 id 欄位，另外也有 subgroup 與 role 的顯示問題，症狀主要記錄於 #9317 和 #8940。目前已在 changeset 33533 完成修訂，並整理出新的管理介面。

Fake Eggs ?

2010-03-08T11:42:00.002+08:00

This is an abstract from Scrambled eggs by Martin Aspeli.

藉由 egg 機制，我們可以更順暢地進行模組軟體的包裝與散佈，但是，遇到 buildout 想要自動昇級某些模組時，為了滿足相依衝突時，egg 也可能帶來許多痛苦，我們會被一堆版本昇級要求資訊淹沒。

由於 Plone 3.0 到 3.1 搭配的 Zope 並沒有包裝成 egg 檔案，導致 setuptools 無從得知 Zope 3 模組的 egg metadata 資訊。舉例來說，如果你安裝一個相依於 zope.component 的模組，但是 setuptools 並不知道你已經有 zope.component 了，因此會試著下載最新版的 zope.component。由於新版 zope.component 的下載動作會引發其他相依關係，很容易造成永無止境的昇級要求。

為了解決上述問題，plone.recipe.zope2install 這個 recipe 預設會安裝一些 fake egg，它的效果，就像是建立一堆指到 parts/zope2/lib/python/* 的 egg。如此一來，setuptools 就能知道系統裡存在 zope.component、zope.interface 等標準模組，不需要再去下載新版檔案。

常見的情況是，我們只知道需要安裝某個檔案，但不清楚所需的明確版本，因此 fake egg 會指定為 0.0 版本，除非你為特定的 recipe 額外指定它的版本號碼。也就是說，如果有個模組的相依關係是 zope.component >= 3.1，setuptools 仍然會以為系統既有的 zope.component 版本過舊，將嘗試下載新的版本。

那麼，模組的相依資訊被記錄於何處? 它的來源大致有兩類，一是在模組檔案的 setup.py 內容裡，二是從 buildout.cfg 檔案的 eggs 設定值尋找。相依資訊的常見形式，又可分成兩類，第一類的例子是「我需要和 zope.component 一起工作」，只指定模組名稱，而不指定模組版本，第二類的例子是「我需要和 zope.component >= 3.4 版本一起工作」，同時指定模組名稱與版本條件。

有時，在 setup.py 裡指定最小版本號碼是必要的，因為某些版本以上的模組，才提供我們需要的功能。當然，在 setup.py 裡明確指定「我需要和 zope.component == 3.4 版本工作」是合法的設定方式，但通常會造成日後的災難，而指定最大版本號碼的方式，例如「我需要和 zope.component >=3.4, <=3.4.999 版本工作」，通常也是很糟的形式。一般而言，除非有必要，永遠不要在 setup.py 裡指定「==」的版本要求，頂多使用「<=」的版本形式。因為，這類不適當的設定值一旦出錯，除錯工作極度困難。

另一方面，目前 setuptools 的運作方式，是找尋最新版本來下載，如果它先下載了某個模組的新版本，就會順著它的相依關係來下載其他模組，即使某個舊版本提供更合適的相依條件，setuptools 並無從得知，這會導致下列問題：

* setuptools 下載過新版本的模組，和稍後模組的最大版本條件相衝突。幸好，這個問題並不難解決。

* 原本 buildout 運作正常，但是有人在 PyPI 上傳新版模組，造成相依關係更新，接著你又執行 buildout 更新動作，下載了新版模組，引發更多新版模組的下載。運氣好的話，系統會通知版本衝突的訊息，運氣不好的話，表面上 build 動作完成，但執行系統時卻失敗。

Quote Portlet

2010-03-03T14:07:00.002+08:00

想在 Plone 網站加上 quote portlet 嗎? 利用 collective.portlet.quote 輕鬆就能完成，它還有 Quote Folder 專門來放 Quote Type。不過，並不喜歡預設的方框樣版，想要改個樣子，於是動手修改兩個檔案。

修改 randomquote.pt 內容如下：

    <dd class="portletItem odd">
      <q tal:content="structure view/get_quote">
        Body text
      </q>
    </dd>
    <dd class="QuoteSource">
        <span class="portletBottomLeft"></span>
        <p tal:condition="not:view/has_link">
            –
            <tal:block replace="view/get_source"/>
        </p>
        <tal:block condition="view/has_link">
            <a tal:attributes="href view/get_link">
               –
               <tal:block replace="view/get_source"/>
            </a>
        </tal:block>
        <span class="portletBottomRight"></span>
    </dd>

新增 ploneCustom.css 內容如下：

.QuoteSource
{
    border-color: #8CACBB;
    border-width: 1px;
    border-style: none solid none;
    margin: 0;
    text-align: right;
    padding: 0.25em 1em;
}

有圖有真相。

Bus Rapid Transit

2010-01-22T15:43:00.006+08:00

本文取自友人 AB 轉寄來的內容，略作極小的排版修改。我支持大眾交通系統應慎重考量低耗能高效率的方案選項，盲目地 MRT 並非民眾之福。另外，據說嘉義也有 BRT (Bus Rapid Transit)，但跟巴西 Curitiba 的實例相比，仍有不小差距。

之前，我一直覺得捷運是很棒的東西，但是我這幾年再也不這麼認為。

先講公視獨立特派員上週的報導：1800億的夢（高雄捷運）
線上觀看：http://www.peopo.org/innews/post/49974

非常值得花時間看完的報導。

不過我已經看到有人評論：「搞捷運眼光要看遠」

這些論點看似有理，但是其所謂的捷運，都只侷限在台灣目前獨立於路面外的軌道捷運（高架或隧道）。

請看看上述影片中另一種不一樣的捷運：BRT

其實對於捷運的反省，我也是從這幾年才開始。

首先是四年前我從《你，還在開車嗎？》這本書中，看到夏鑄九教授為這本書所寫的序提到：

今天，一般市民或許不瞭解，台北市的財力已經無法承擔繼續興建目前這個光鮮亮麗卻不符永續城市原則、已經過了時的七Ο年代的昂貴捷運系統了。而高雄，卻因為政治原因，比照台北，亦步亦趨。這就是交通部為何不得不在城市運輸政策上終結高、中運量的捷運系統，改推輕軌的原因。我們若不另外選擇電車（或者說，有軌電車）、公車與腳踏車等運輸工具，台灣的城市交通就還是一條不歸路。

—《你，還在開車嗎？》序，夏鑄九

而《你，還在開車嗎？》這本書也提到一種捷運的替代方案：BRT (Bus Rapid Transit) 系統：

借用巴西的 Curitiba 的經驗，告訴我們一個公共交通系統，若是擁有專用的巴士道、底盤低矮的巴士、路邊收費站，及高於路面的登車月台，功能將不輸於任何有軌的公共運輸設施，而成本卻祇有軌道捷運的一小部份。
—《你，還在開車嗎？》，Alan Thein Durning，p.113

那時候光憑文字很難想像什麼是BRT，直到後來看到公視的報導。

之後，某次和蠻野心足生態協會理事長文魯彬經過台北某個捷運工地，他就指著工地說捷運不好，我就問他為什麼？捷運不是很環保嗎？他說：

捷運也是高耗能的交通系統，只是不像汽車，污染立即可見，捷運的污染產生在林口發電場。

之後，我從潘翰聲的文章也讀到類似的評論：

而捷運耗電量極大，將汽車污染物從都市轉移到鄉村區的燃煤電廠，是環境不正義的課題，二氧化碳的減量效果應有詳實的量化分析。

不過該文章另一個論點更點出另一個問題：

更嚴重的是，捷運的經濟效益被誇大，本案（台北捷運南北線）所評估的效益高達六成是土地增值效益，簡直是花公家的錢幫財團炒地皮。

這是經濟問題，民代和民選地方首長、官員似乎都不願意告訴民眾：

台北捷運系統每公里平均造價60多億元，以目前搭乘率的票務收入，也僅能維持台北捷運公司的操作營運，無法回收建設成本，更遑論未來還需更大一筆維修老舊車體的費用。大概估算，搭台北捷運的乘客約得到政府交叉補貼2/3的票價，即一段20元的票價，政府已補貼使用者40元，原應向乘客收60元。其他縣市想有樣學樣，要求中央政府補助興建捷運，但大眾運輸網絡都不如台北，其便利性及效益就大打折扣，真怕最終淪為載蚊子的捷運。 BRT 每公里造價約莫數千萬元，真的低廉又環保。
http://zh.wildatheart.org.tw/archives/mrtaeaeiebrtcaeece.html

果然不幸言中：「高雄捷運通車不到兩年，已經虧掉60億」

台灣最大的問題是不敢跟私人運具（汽車）搶道，所以目前還沒有任何一條捷運是利用現有路面。而公車專用道的興建，都還要接受民代質疑：是否會因為車道數量縮減而影響到汽車的行車速度？

真是奇怪，要顧全到汽車不會塞車，早就是都市交通中被實證為不可行的交通策略，看看美國城市的道路面積擴張的程度，還是無法解決都市交通問題的事實即可得知。

而且，讓私人運具不方便（塞車、停車問題），才會讓大家轉用大眾運輸系統，這不是很簡單的道理嗎！

看著台北捷運局的捷運願景圖密密麻麻的捷運線路，只希望它不會成真。

Dexterity vs Archetypes

2010-01-18T17:30:00.003+08:00

This blog is an abstract from How is Dexterity related to Archetypes by Martin Aspeli.

Dexterity 是 Archetypes 的替代方案，這兩種方案都是 Plone 建構 content type 的框架技術。由於 Archetypes 存在已久，是成熟的方案，而 Dexterity 是後起之秀，結合新版 Zope 技術，有些新技術能夠有效處理以往難以解決的問題。

下列是幾項主要的差異：

* Dexterity 結合新版 CMF、Zope 3 的技術與功能，程式碼更精簡，測試工作更能自動且完整。
* Dexterity 具備更高的模組化程度，更容易整合 SQL 資料庫。
* Archetypes 自有的 Schema 機制，並無法完全相容於 zope.interface 或 zope.schema 的介面。
* Archetypes 使用 accessor 與 mutator 來處理設定值，Dexterity 則使用 attribute notation 方式來處理，因此 Archetypes 的寫法類似 context.getFirstName() 而 Dexterity 是 context.first_name 這樣的寫法。
* Archetypes 自有的 field 和 widget 配合 content object 的脈絡來運作，並不容易被應用在獨立表單，Dexterity 則使用 z3c.form 函式庫，這是表單運作的標準工具。
* Archetypes 並不支援新增表單，Dexterity 則透過 z3c.form 來支援，這代表它不需要用到 portal_factory，執行效率能夠改善。
* Dexterity 支援 behavior，但 Archetypes 沒有直接支援。