RML Reference: Free XML dialect for ReportLab PDF generation

需积分: 15 7 下载量 121 浏览量 更新于2024-07-31 1 收藏 318KB PDF 举报
RML(Render Markup Language)参考文档,版本为0.7,是一种专用于生成PDF文件的XML方言,类似于HTML在浏览器中创建网页,RML则通过ReportLab库将RML文本转换成完整的PDF模板。起初,RML是由ReportLab公司作为其免费ReportLab库的一个商业扩展开发的,尽管原始版本仍然由ReportLab提供支持,但本文档介绍的是一个名为z3c.RML的免费开源实现,它基于原始RML文档的公开资料构建。 z3c.RML的目标是尽可能保持与原版RML的兼容性,同时提供更清洁、功能丰富的API。该版本的RML元素中使用了多种属性类型,包括: 1. Boolean类型:用于表示布尔值,允许的值有"true"、"yes"和"1"表示真,而"false"、"no"和"0"表示假。此外,还有一种特殊的值"default"。 2. BooleanWithDefault类型:这种布尔属性同样可以接受"value",但额外增加了"default"选项,即当未指定值时,默认采用"false"或"true"。 3. Choice类型:用于定义一组可选值,用户在使用时可以从这些预设值中选择。 4. Float类型:用于存储浮点数,如3.14或-2.5。 5. Integer类型:用于整数值,例如10或者-5。 6. Date类型:表示日期,通常按照特定格式如YYYY-MM-DD或MM/DD/YYYY。 7. DateTime类型:结合了日期和时间,格式如YYYY-MM-DD HH:MM:SS。 8. String类型:用于文本数据,可以包含任意字符,如"Hello, World!"。 9. URI类型:用于URL或URI地址,如"http://www.example.com"。 10. List类型:用于存储一列值,可以包含多个同类属性的列表,如[1, 2, 3]。 z3c.RMLReference文档详细介绍了如何在模板中使用这些属性,并提供了大量示例代码来帮助开发者理解和应用RML技术。这份文档的价值在于,它不仅是一个技术指南,也是开发者学习和实践RML以及PDF生成的实用资源,对于那些较少接触RML的人来说,这是一份难得的参考资料。由于内容是自动生成于代码,因此其准确性和完整性非常高,是从事OpenERP(尤其是那些依赖ReportLab库的应用)的开发者不可或缺的学习资料。