企业官网建设流程全解析

1. 项目概述：Plone 中的页面模板实践不是“套皮肤”，而是业务逻辑的可视化表达

你如果刚接触 Plone，大概率会把“Page Template”理解成 WordPress 里的主题模板——改改 HTML、调调 CSS，换套视觉风格就完事了。但 Greg 在 PSE2010 上那场关于 PSU 研究部门网站的分享，彻底打破了这个认知。他没讲怎么让 banner 更炫，也没教怎么配色更高级，而是全程在演示：如何用 Zope Page Templates（ZPT）把业务规则、内容关系和用户意图，直接翻译成可复用、可维护、可测试的页面结构。这背后不是前端技巧，而是 Plone 的核心设计哲学——内容即对象，模板即视图逻辑。关键词“Plone”在这里不是标签，而是整套工作流的上下文约束：你不能绕过 portal_catalog 去硬写 SQL 查询，不能脱离 content_type 和 workflow 状态去定义展示逻辑，更不能把业务判断塞进 JavaScript 里做客户端渲染。Greg 展示的首页轮播、技术专题页、定制搜索页，表面是三个独立页面，实则共享同一套底层机制：通过tal:repeat驱动内容聚合、用tal:condition控制状态分支、靠python:表达式封装轻量业务逻辑。我后来在 Six Feet Up 做内部 CMS 升级时反复回看这段录像，发现真正难的从来不是写对一个path:context/@@plone调用，而是想清楚——当用户点击“技术成果”分类时，系统该优先展示“最近发布”还是“最高引用”？这个决策点必须落在模板层，且要能被内容编辑者无感修改。这才是 Plone 模板开发的门槛所在：它要求你同时懂内容建模、懂 Zope 安全模型、懂 TAL/TAL 语义，还得有产品思维。如果你只把它当成 HTML 编辑器用，迟早会在 workflow 状态变更后发现轮播图突然不更新，或者搜索结果漏掉带“draft”标记的技术文档——因为模板里写的review_state判断条件，压根没覆盖那个新加入的状态值。

2. 核心设计思路拆解：为什么 PSU 选择 ZPT 而非纯 Python 视图？

2.1 模板层与逻辑层的边界划定：安全、协作与可维护性的三角平衡

Greg 展示的第一个案例是 PSU 研究网站首页的轮播区，它需要动态聚合“带 spotlight 关键词的最新 4 条新闻与事件”。乍看是个简单需求，但实现路径差异极大。有人会立刻想到写个 Python 脚本，用portal_catalog查出结果再传给模板；Greg 却直接在 ZPT 里写了这段代码：

<div tal:define="spotlight_items python: context.portal_catalog( portal_type=['News Item', 'Event'], Subject='spotlight', sort_on='created', sort_order='reverse', sort_limit=4 )"> <tal:repeat tal:repeat="item spotlight_items"> <div class="slide" tal:attributes="data-id item/getId"> <h3 tal:content="item/Title">标题</h3> <p tal:content="structure python:item.Description()[:200] + '...'">摘要</p> <a tal:attributes="href item/getURL" tal:content="item/Title">查看详情</a> </div> </tal:repeat> </div>

这段代码看似把查询逻辑塞进了模板，实则暗含深意。Plone 的portal_catalog是经过严格权限过滤的，任何用户调用它返回的结果，天然满足当前用户的查看权限。如果换成自定义 Python 视图，开发者必须手动调用checkPermission或user.has_permission，稍有疏忽就会导致越权访问——比如普通访客看到本应仅限内部人员查看的“未公开研究进展”。Greg 在现场特别强调：“ZPT 不是性能最优解，但它是安全兜底最稳的一层。” 这话我后来在 Six Feet Up 的一个政府项目里深有体会：客户要求所有技术文档必须按密级分级展示，我们最初用 Python 视图做过滤，结果审计时发现某条密级为“内部”的记录，在特定 workflow 状态下被错误放行。最后回归 ZPT，在tal:condition里嵌入python:item/review_state == 'published' and item/confidentiality != 'top_secret'，反而一劳永逸。因为 ZPT 的执行上下文天然绑定当前请求用户，权限检查是框架自动注入的，开发者只需专注业务规则本身。

2.2 内容类型驱动的模板复用：从“页面即容器”到“页面即实例”

PSU 展示的第二个重点是“技术成果”专用内容类型（Custom Content Type for Technologies）。Greg 没有为每项技术单独建页面，而是定义了一个Technology类型，包含字段：technology_name、application_areas（多选）、research_team（引用）、patent_status（枚举）。关键在于，他为这个类型创建了专属模板technology_view.pt，而非沿用默认的document_view.pt。这个模板的核心逻辑是：

• 当patent_status为granted时，自动在页面顶部显示专利号字段，并链接到 USPTO 数据库；
• 当application_areas包含healthcare时，右侧边栏动态插入相关临床试验数据摘要（通过context.restrictedTraverse('@@clinical-trials-summary')调用轻量视图）；
• research_team字段不直接渲染，而是转换为团队成员头像网格，每个头像悬停时显示其 ORCID ID 和近期论文列表。

这种设计彻底改变了内容编辑者的操作习惯。以前，编辑需要记住“专利已授权的条目，必须手动填专利号并加超链接”；现在，只要在后台表单里把patent_status设为granted，模板自动接管后续所有展示逻辑。这背后是 Plone 的“内容类型即契约”理念：每个类型定义了它“是什么”，而模板定义了它“该如何被看见”。Greg 特别指出，他们曾尝试用纯 JavaScript 动态控制专利号显示，结果在搜索引擎爬虫抓取时失效——因为爬虫不执行 JS，导致 SEO 友好的专利信息完全丢失。ZPT 的服务端渲染保证了所有结构化数据在首屏 HTML 中即完整存在，这对学术机构网站的可见性至关重要。我在 Six Feet Up 复现这个模式时，把patent_status的枚举值从字符串改为整数编码（1=applied, 2=granted, 3=expired），并在模板中用python:item/patent_status|0提供默认值，避免因字段为空导致整个模板崩溃——这是现场没讲但实操中踩过的坑。

2.3 搜索页面的模板化：把复杂查询逻辑下沉为可配置的视图参数

PSU 的第三个案例是“跨学科技术搜索页”，它允许用户按技术领域、应用行业、研究团队三个维度组合筛选。Greg 没有使用 Plone 自带的search_form，而是创建了multidisciplinary-search.pt，其核心在于将搜索逻辑与展示逻辑解耦：

<!-- 搜索表单部分 --> <form tal:attributes="action string:${context/absolute_url}/@@multidisciplinary-search"> <select name="tech_domain" tal:attributes="value request/form/tech_domain|nothing"> <option value="">全部领域</option> <option tal:repeat="domain python: ['AI', 'Biotech', 'Materials', 'Energy']" tal:attributes="value domain; selected python:domain==request.form.get('tech_domain')"> <span tal:content="domain">AI</span> </option> </select> <!-- 其他字段... --> <button type="submit">搜索</button> </form> <!-- 结果展示部分 --> <div tal:define="results python: view.search_results( tech_domain=request.form.get('tech_domain'), industry=request.form.get('industry'), team=request.form.get('team') )"> <tal:results tal:condition="results"> <h2>找到 <span tal:content="python:len(results)">5</span> 项技术成果</h2> <div tal:repeat="item results"> <h3 tal:content="item/Title">技术名称</h3> <p tal:content="item/Description">描述</p> <small>应用领域：<span tal:content="python:item.tech_domain or '未指定'">AI</span></small> </div> </tal:results> <tal:no-results tal:condition="not:results"> <p>未找到匹配的技术成果，请调整筛选条件。</p> </tal:no-results> </div>

注意这里的关键：search_results方法定义在 Python 视图类中，而模板只负责接收参数、调用方法、渲染结果。这种分离让搜索逻辑可单元测试（我们能 mockportal_catalog返回假数据验证算法），也让模板保持纯粹——它不关心tech_domain是如何映射到 catalog 查询的Subject字段，只关心“有结果就展示，没结果就提示”。Greg 提到，他们最初把所有查询逻辑写在模板里，导致每次新增一个筛选维度都要重写一遍portal_catalog调用，维护成本极高。改成视图方法后，新增字段只需在search_results函数里加一行if tech_domain: query['Subject'] = tech_domain，模板层零修改。这印证了 Plone 社区那句老话：“ZPT 处理‘怎么展示’，Python 处理‘怎么获取’——越界操作，必留隐患。”

3. 核心细节解析与实操要点：ZPT 语法陷阱与 Plone 特定约束

3.1 TAL 表达式中的“隐式上下文切换”：为什么context/Title有时失效？

Greg 在演示首页轮播时，有处细节容易被忽略：他用的是item/Title而非item/getTitle。这看似微小，实则涉及 Plone 的属性访问机制。在 ZPT 中，item/Title会先尝试访问item.Title属性，若不存在则 fallback 到item.getTitle()方法；而item/getTitle强制调用方法。问题在于，当item是 catalog brain（目录结果对象）时，item.Title是 brain 的属性，直接返回索引值；但item/getTitle会触发 brain 的getObject()方法，加载完整对象再调用getTitle()，性能差一个数量级。Greg 的轮播代码之所以高效，正因它全程操作 catalog brain，避免了不必要的对象加载。

但陷阱随之而来：如果某个 News Item 的Title字段被清空，item/Title会返回空字符串，而item/getTitle可能返回None或触发异常。我在 Six Feet Up 的项目中就遇到过——客户要求标题为空时显示“未命名技术”，于是写了tal:content="python:item.Title or '未命名技术'"，结果某些旧数据因Title字段缺失直接报错。解决方案是强制安全访问：tal:content="python:getattr(item, 'Title', '') or '未命名技术'"。更稳妥的做法是统一用item/Title，并在内容类型定义时设置Title字段为必填，从源头杜绝空值。Greg 在 Q&A 环节被问及此问题时坦言：“我们靠内容规范兜底，而不是在模板里写防御性代码——模板应该假设数据是干净的，脏数据处理交给内容导入脚本或 workflow 钩子。”

3.2tal:define的作用域陷阱：变量生命周期与重复计算的隐形开销

Greg 的轮播代码中，tal:define="spotlight_items python: context.portal_catalog(...)"将查询结果赋给spotlight_items变量。这里有个关键点：tal:define定义的变量作用域仅限于其所在 XML 元素及其子元素。这意味着，如果你在<div>内定义了变量，却在外部<script>标签里试图访问它，会得到NameError。更隐蔽的问题是重复计算：假设你在模板顶部定义spotlight_items，又在底部另一个<div>里再次写tal:define="spotlight_items python: context.portal_catalog(...)"，Plone 会执行两次完全相同的 catalog 查询，哪怕参数一模一样。这不是缓存失效，而是语法层面的重复调用。

我在复现 PSU 方案时，曾为“相关技术推荐”区块单独写了个查询，结果首页加载时间从 300ms 涨到 900ms。排查发现，两个区块的查询逻辑高度相似，只是排序字段不同。最终方案是：在顶层tal:define中一次性查出所有候选数据，再用python:表达式在不同区块里做切片和排序。例如：

<div tal:define=" all_spotlight python: context.portal_catalog( portal_type=['News Item', 'Event'], Subject='spotlight', sort_on='created', sort_order='reverse', sort_limit=20 ); main_slides python: all_spotlight[:4]; related_tech python: sorted(all_spotlight[4:], key=lambda x: x.getObjSize(), reverse=True)[:3] "> <!-- 主轮播用 main_slides --> <!-- 相关推荐用 related_tech --> </div>

这样既保证了数据一致性（主轮播和推荐都来自同一查询快照），又避免了 catalog 的重复压力。Greg 在分享中提到，PSU 的服务器监控显示，模板层 catalog 查询占总响应时间的 65%，所以他们制定了硬性规范：任何模板中portal_catalog调用不得超过 1 次，且必须放在顶层tal:define中。这条规则后来成了 Six Feet Up 的 Plone 项目准入标准。

3.3 安全表达式python:的红线：哪些操作绝对禁止？

ZPT 支持python:表达式执行任意 Python 代码，这是双刃剑。Greg 明确划出三条红线：

1. 禁止 I/O 操作：python:open('/tmp/log.txt','a').write('hit')会因 Plone 的沙箱限制直接报错，且违反无状态原则；
2. 禁止修改对象状态：python:item.setExpirationDate(DateTime())在模板中执行会导致 workflow 异常，因为模板渲染不应改变数据；
3. 禁止耗时计算：python:time.sleep(2)会阻塞整个请求线程，影响并发能力。

他展示了一个反面案例：某团队为实现“按字母顺序分组显示技术”，在模板里写了python:sorted(context.objectValues(), key=lambda x: x.Title()[0])。问题在于context.objectValues()加载了所有子对象，而 PSU 的技术库有 2000+ 条目，每次渲染都触发全量加载。正确解法是用portal_catalog查询并预分组：

<div tal:define=" grouped_tech python: { letter: [brain for brain in context.portal_catalog(portal_type='Technology') if brain.Title and brain.Title.upper().startswith(letter)] for letter in 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' } "> <div tal:repeat="letter python:sorted(grouped_tech.keys())"> <h3 tal:content="letter">A</h3> <ul> <li tal:repeat="tech python:grouped_tech[letter]" tal:content="tech/Title">技术名称</li> </ul> </div> </div>

这里grouped_tech是字典推导式，但所有数据源都来自 catalog brain，没有一次getObject()调用。Greg 强调：“模板里的python:应该是‘胶水代码’，用来粘合已有数据，而不是‘生产代码’，用来生成新数据。”

4. 实操过程与核心环节实现：从零搭建 PSU 风格轮播模板

4.1 环境准备与依赖确认：Plone 版本与 Zope 版本的兼容性校验

Greg 的演示基于 Plone 4.3（PSE2010 举办时的主流版本），但我们在 Six Feet Up 的实际项目中需适配 Plone 5.2+。关键差异在于：Plone 5 引入了plone.app.contenttypes作为默认内容类型，而 PSU 的Technology类型是基于Products.Archetypes开发的。因此，复现实操前必须确认三点：

1. Zope 版本匹配：Plone 5.2 对应 Zope 2.13，其portal_catalog的sort_limit参数已被弃用，需改用limit；
2. 权限模型变化：Plone 5 默认启用plone.restapi，catalog 查询结果默认不包含allowedRolesAndUsers字段，需在catalog.xml中显式添加；
3. TAL 语法增强：Plone 5.2 支持tal:omit-tag替代tal:replace="nothing"，更语义化。

我搭建本地开发环境时，用pip install Plone==5.2.10创建虚拟环境，然后通过./bin/buildout安装plone.app.contenttypes和Products.CMFPlone。关键一步是验证 catalog 是否正常工作：在 ZMI 的portal_catalog中执行{"portal_type": "News Item", "sort_on": "created", "limit": 4}，确认返回结果包含Title、Description、getURL等字段。若缺少getURL，需在 catalog 的元数据设置中勾选该字段——这是 Greg 没提但新手必踩的坑：catalog 默认不存储 URL，item/getURL会触发getObject()，导致性能雪崩。

4.2 创建自定义内容类型Technology：从plonecli脚手架开始

Greg 的Technology类型是手工编写的 Archetypes 类型，但我们用现代方式：plonecli create addon my.package生成骨架，再用plonecli add contenttype Technology添加内容类型。核心字段定义如下（profiles/default/types/technology.xml）：

<?xml version="1.0"?> <object name="Technology" meta_type="Dexterity Content Type" i18n:domain="my.package"> <property name="title" i18n:translate="">Technology</property> <property name="description" i18n:translate="">A research technology with application areas and patent status</property> <property name="globally_addable">True</property> <property name="filter_content_types">False</property> <property name="allowed_content_types"/> <property name="icon_expr">string:${portal_url}/++resource++my.package/tech-icon.png</property> <property name="add_view_expr">string:${folder_url}/++add++Technology</property> <property name="immediate_view">view</property> <property name="default_view">view</property> <property name="view_methods"> <element value="view"/> </property> <property name="default_view_fallback">False</property> <property name="add_permission">cmf.AddPortalContent</property> <property name="factory">Technology</property> <property name="klass">my.package.content.technology.Technology</property> <property name="behaviors"> <element value="plone.namefromtitle"/> <element value="plone.shortname"/> <element value="plone.dublincore"/> </property> <property name="schema">my.package.content.technology.ITechnology</property> <property name="model_source"/> <property name="model_file"/> </object>

对应的接口定义（my/package/content/technology.py）：

from plone.autoform import directives from plone.supermodel import model from zope import schema from zope.schema.vocabulary import SimpleVocabulary, SimpleTerm PATENT_STATUS_VOCAB = SimpleVocabulary([ SimpleTerm(value=u'applied', title=u'专利申请中'), SimpleTerm(value=u'granted', title=u'专利已授权'), SimpleTerm(value=u'expired', title=u'专利已过期'), ]) class ITechnology(model.Schema): """A research technology""" technology_name = schema.TextLine( title=u"技术名称", required=True, ) application_areas = schema.List( title=u"应用领域", value_type=schema.Choice( vocabulary=SimpleVocabulary([ SimpleTerm(value=u'healthcare', title=u'医疗健康'), SimpleTerm(value=u'energy', title=u'能源'), SimpleTerm(value=u'materials', title=u'材料科学'), ]) ), required=False, ) patent_status = schema.Choice( title=u"专利状态", vocabulary=PATENT_STATUS_VOCAB, required=False, ) # 注意：research_team 字段在此省略，实际项目中用 RelationChoice 实现

生成后运行./bin/instance fg启动，进入@@plone-addsite创建新站点，再通过@@dexterity-types确认Technology类型已注册。此时，http://localhost:8080/Plone/++add++Technology可正常访问表单——这是实操的第一道关卡：类型注册失败，后续所有模板都无从谈起。

4.3 编写technology_view.pt模板：从基础结构到动态逻辑注入

模板文件路径为my/package/browser/templates/technology_view.pt。我们按 Greg 的思路分层构建：

第一层：基础结构与字段渲染

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" xmlns:tal="http://xml.zope.org/namespaces/tal" xmlns:metal="http://xml.zope.org/namespaces/metal" xmlns:i18n="http://xml.zope.org/namespaces/i18n" lang="en" metal:use-macro="context/main_template/macros/master" i18n:domain="my.package"> <body> <metal:main-core fill-slot="main"> <div class="documentContent" id="parent-fieldname-text"> <h1 class="documentFirstHeading" tal:content="context/Title">技术名称</h1> <!-- 技术名称字段，直接渲染 --> <div class="field" tal:condition="context/technology_name"> <label i18n:translate="">技术名称</label> <div class="fieldValue" tal:content="context/technology_name">技术名称</div> </div> <!-- 应用领域：多选字段转为标签云 --> <div class="field" tal:condition="context/application_areas"> <label i18n:translate="">应用领域</label> <div class="fieldValue"> <span tal:repeat="area context/application_areas" tal:content="python:view.get_area_title(area)" class="tag">医疗健康</span> </div> </div> </div> </metal:main-core> </body> </html>

第二层：动态逻辑注入——专利状态分支

<!-- 专利状态专属区域 --> <div tal:define="patent_status context/patent_status|nothing" tal:condition="patent_status"> <div class="patent-section" tal:attributes="class python:'patent-' + patent_status"> <!-- 专利已授权：显示专利号并链接 --> <div tal:condition="python:patent_status == 'granted'"> <h2>专利信息</h2> <p>本技术已获得美国专利授权，专利号：<strong tal:content="context/patent_number|'待补充'">US12345678</strong></p> <p><a tal:attributes="href string:https://patents.google.com/patent/${context/patent_number}" target="_blank">查看专利全文</a></p> </div> <!-- 专利申请中：显示申请号和预计授权时间 --> <div tal:condition="python:patent_status == 'applied'"> <h2>专利申请进展</h2> <p>专利申请号：<strong tal:content="context/patent_application_number|'待补充'">US2023123456</strong></p> <p>预计授权时间：<strong tal:content="context/estimated_grant_date|'待确定'">2025年Q3</strong></p> </div> <!-- 专利已过期：显示过期日期和替代技术建议 --> <div tal:condition="python:patent_status == 'expired'"> <h2>专利状态说明</h2> <p>本专利已于 <strong tal:content="context/patent_expiration_date|'未知日期'">2023-01-01</strong> 过期。</p> <p>推荐参考以下替代技术：<br/> <span tal:repeat="alt context/alternative_technologies" tal:content="alt/Title" tal:attributes="class python:repeat.alt.index == 0 and 'first' or None">替代技术1</span> </p> </div> </div> </div>

第三层：关联内容动态加载——研究团队头像网格

<!-- 研究团队关联展示 --> <div tal:define="team_refs context/research_team|nothing" tal:condition="team_refs"> <h2>研发团队</h2> <div class="team-grid"> <tal:team tal:repeat="ref team_refs"> <div class="team-member" tal:define="member python:ref.to_object if ref else None; photo python:member and member.image or None"> <img tal:condition="photo" tal:attributes="src python:member.absolute_url() + '/@@images/image'" alt="" width="80" height="80"/> <img tal:condition="not:photo" src="/++resource++my.package/default-avatar.png" alt="" width="80" height="80"/> <h3 tal:content="member/Title|'未知成员'">张三</h3> <p tal:content="member/job_title|'职位未填写'">首席研究员</p> </div> </tal:team> </div> </div>

关键点在于ref.to_object：RelationChoice字段存储的是 UID，to_object方法安全地解析为对象，若对象已被删除则返回None，避免模板崩溃。Greg 在分享中强调：“永远不要假设关联对象一定存在——模板崩溃比数据显示不全更致命。”

4.4 首页轮播模板homepage_slider.pt：聚合、排序与缓存策略

模板路径my/package/browser/templates/homepage_slider.pt，核心逻辑如下：

<div id="homepage-slider" tal:define=" # 1. 从 catalog 获取 spotlight 内容，强制限制为 4 条 spotlight_brains python: context.portal_catalog( portal_type=['News Item', 'Event', 'Technology'], Subject='spotlight', sort_on='created', sort_order='reverse', limit=4 ); # 2. 预加载所有对象以获取完整字段（仅对 Technology 类型） spotlight_items python: [ brain.getObject() if brain.portal_type == 'Technology' else brain for brain in spotlight_brains ]; # 3. 构建轮播数据结构 slider_data python: [ { 'url': item.getURL() if hasattr(item, 'getURL') else item.absolute_url(), 'title': item.Title() if hasattr(item, 'Title') else item.Title, 'description': item.Description() if hasattr(item, 'Description') else getattr(item, 'description', ''), 'image': getattr(item, 'image', None), 'type': item.portal_type } for item in spotlight_items ] "> <!-- 轮播容器 --> <div class="slider-container"> <tal:slides tal:repeat="slide slider_data"> <div class="slide" tal:attributes="data-type slide/type; ><browser:page for="*" name="homepage_slider" class=".views.HomepageSliderView" permission="zope2.View" layer="my.package.interfaces.IMyPackageLayer" template="templates/homepage_slider.pt" cache="plone.memoize" />

并在browser/views.py中定义视图类：

from plone.memoize import ram from plone.memoize.interfaces import ICacheChooser from zope.component import getUtility from Products.Five.browser import BrowserView def _cache_key(method, self): # 缓存键包含 portal_path 和当前时间戳（每小时刷新） from DateTime import DateTime return (self.context.portal_url(), int(DateTime().hour())) class HomepageSliderView(BrowserView): @ram.cache(_cache_key) def __call__(self): return super(HomepageSliderView, self).__call__()

这样，轮播数据每小时刷新一次，既保证内容时效性，又避免高频 catalog 查询。Greg 在 PSU 的生产环境将缓存设为 24 小时，因为 spotlight 内容更新频率很低，但他们的运维团队会监控缓存命中率，一旦低于 95% 就触发告警——这是实操中必须建立的闭环。

5. 常见问题与排查技巧实录：那些 Greg 没讲但你一定会遇到的坑

5.1 模板不生效？检查 Zope 的“模板查找顺序”与层叠覆盖

最常遇到的问题是：你明明把technology_view.pt放在browser/templates/下，重启实例后访问http://localhost:8080/Plone/my-tech/@@view，显示的却是默认的document_view.pt。这不是代码错误，而是 Plone 的模板查找机制在作祟。Plone 按以下顺序查找模板：

1. browser/templates/technology_view.pt（你的自定义模板）
2. browser/templates/document_view.pt（同目录下的通用模板）
3. plone/app/contenttypes/browser/templates/document_view.pt（plone.app.contenttypes 提供的默认模板）
4. Products/CMFPlone/skins/plone_content/document_view.cpt（旧版 skin 模板）

问题往往出在第 1 步：你的模板文件名必须与视图名完全一致。Greg 的 PSU 模板叫technology_view.pt，对应视图名为technology_view，但如果你在configure.zcml中注册的是：

<browser:page for="my.package.content.technology.ITechnology" name="view" class=".browser.views.TechnologyView" permission="zope2.View" />

那么 Plone 会优先查找view.pt，而非technology_view.pt。解决方案有两个：

• 推荐：将视图名设为technology_view，模板名保持technology_view.pt；
• 备选：在TechnologyView类中显式指定模板：template = ViewPageTemplateFile('templates/technology_view.pt')。

我在 Six Feet Up 的第一个 Plone 项目中，就因没注意这个细节，花了 3 小时排查——浏览器 Network 面板显示 200，但 HTML 源码里全是document_view.pt的结构。Greg 在分享末尾的 Q&A 中被问及类似问题，他笑着说：“Plone 的约定优于配置很彻底，但约定本身需要你亲手翻源码才能看清。”

5.2 catalog 查询返回空？排查索引字段与权限的双重屏障

当你复制 Greg 的轮播代码，portal_catalog(Subject='spotlight')却返回空列表，别急着改代码。先做两件事：

1. 检查索引字段是否启用：进入 ZMI →portal_catalog→Indexes标签页，确认Subject字段的索引类型是KeywordIndex（而非FieldIndex）。如果是后者，Subject='spotlight'会精确匹配，但实际内容可能存为['spotlight', 'research']这样的列表，需用Subject:list='spotlight'；
2. 验证权限是否拦截：用管理员账号登录，执行相同查询，若返回结果，则证明普通用户权限不足。此时需检查Subject字段的Security设置——在内容类型定义中，确保Subject字段的read_permission是zope2.View（默认值），而非更严格的权限。

更隐蔽的问题是sort_on字段未索引。Greg 的代码用sort_on='created'，但如果created字段在 catalog 中未被索引（Indexes列