ophelia 0.4.1

静态内容

将Ophelia视为被药物增强的SSI。它本质上没有区别，只是更友好且功能更强大。

当您基本上自己编写HTML，但只需要一次编写重复内容时，请使用Ophelia。将重复减少到零的代价是：您的网站必须遵循Ophelia组合模板的正确模式。

请将您网站的布局视为分层：所有页面都有共同的样式，部分有特定的特征，每个页面都有独特的内容。对Ophelia来说，这种层次结构反映在您的文档的文件系统组织结构中是至关重要的；模板如何组合是从它们在目录层次结构中的位置推导出来的。

动态内容

Ophelia使Python语言可用于包含动态内容。每个模板文件都可以包含一个Python脚本。贡献同一页面的Python脚本和模板共享一组公共变量来修改和使用。

Ophelia的内容模型非常简单，如果每个发布的内容对象都是其自己的视图，效果最佳：它在页面上表示的内容。即使您从外部资源获取内容（例如，数据库或版本控制存储库），只要对象的不同视图不依赖于对象类型，甚至对象本身，您仍然可以使用Ophelia，即使每个内容对象有多个视图也是如此。

尝试在更复杂的网站上使用Ophelia会导致逻辑和展示之间的混乱。不要将Ophelia用于实际上是应用程序、内容管理系统等网站界面的网站。

模板文件

对于每个请求，Ophelia都会查找一些模板文件。它会从从网站根目录到页面的路径上的每个目录中获取一个名为“__init__”的文件，并为页面本身获取一个最终的文件。如果找到最终的模板，Ophelia将提供该请求。

在构建页面时，页面的模板被评估，其内容存储在所谓的内部槽中。然后，从页面到根目录的每个模板依次被评估，并可能包含内部槽的当前内容。结果在每一步之后都存储在内部槽中。

处理根模板的结果被作为页面提供。

Python脚本

每个模板文件都可以从Python脚本开始。在这种情况下，脚本通过其自己的行上的第一个“<?xml?>”标签（除了左右留下的空白）与模板分开。如果模板文件只包含Python脚本而没有实际的模板，请在它的最后一行放置“<?xml?>”。

Python脚本在从网站根目录到页面的遍历过程中按顺序执行。它们在随后用作模板评估上下文的同一变量命名空间中运行。由Python脚本设置的变量可以被随后运行的任何脚本以及模板中使用的TALES表达式使用和修改。

命名空间由Ophelia使用一个变量初始化，该变量为__request__，它引用请求对象。因此，脚本可以访问请求细节和遍历内部。除了设置变量外，脚本还可以导入模块、定义函数、访问文件系统，以及通常可以做的任何Python程序的事情。

磁盘上的文档

通常，一个网站将包含无法从上述模板组装的文档。这些是像图像、javascript文件和样式表这样的资产，以及例如可能由某些其他系统（如源代码文档生成器）导出的页面。

为了将此类内容混合到Ophelia生成的网站的URL空间中，模板层次结构必须省略相关路径，并且第二个目录层次结构需要直接对应URL空间的需求，以包含从磁盘提供的文档。如果Ophelia发现它无法使用模板提供服务，则将回退到磁盘上的文档。只有在后者不包含与请求的URL对应的文件时，才会发送“404 Not found”错误响应。