ftw.book 4.1.11

功能

• 提供内容类型“书籍”，它定义了书籍的根。

• 提供内容类型“章节”，用于创建书籍结构。章节是可嵌套的。

• 使用simplelayout块将内容添加到章节中。

• 提供导出书籍或单个章节（递归）为PDF的动作。

• 提供默认simplelayout块的LaTeX表示。

• 使用schemaextender为书籍中的每个内容类型添加注入LaTeX代码的字段。

• 提供“阅读器”视图，它在一页上显示书籍，以提供愉悦的阅读体验。

• 提供simplalayout“表格”块，使用datagrid小部件输入表格数据，它生成可转换为PDF的HTML表格表示。

要求

• 需要ftw.simplelayout用于基于块的 内容创建。

• 需要ftw.file用于文件列表。

• 需要ftw.pdfgenerator用于生成PDF。

• 需要ftw.htmlblock用于自定义HTML表格。

用法

• 将ftw.book添加到您的buildout配置

[instance]
eggs +=
    ftw.book

• 安装通用导入配置文件。

• 安装LaTeX发行版，请参阅ftw.pdfgenerator安装说明。

兼容性

与Plone 4.3 和 5.1 兼容。

开发和测试

要运行完整的PDF生成测试，需要ImageMagick进行PDF的差异比较。

由于我们需要在每次更改后重新编译资源，因此已实现了一个监视器，使用yarn watch在每次更改后重新编译。

卸载

本包提供了一种卸载通用设置配置文件，但是它不会卸载包的依赖项。请确保如果您不再使用它们，则卸载依赖项。

链接

• GitHub: https://github.com/4teamwork/ftw.book

• 问题: https://github.com/4teamwork/ftw.book/issues

• Pypi: http://pypi.python.org/pypi/ftw.book

• 持续集成: https://jenkins.4teamwork.ch/search?q=ftw.book

版权

本包由 4teamwork 版权所有。

ftw.book 根据 GNU 通用公共许可证，版本 2 许可。

4.1.11 (2021-08-16)

• 为 in_toc 方法添加了查看权限检查。[mathias.leimgruber]

4.1.10 (2021-04-01)

• 修复了 collective.z3cform.datagridfield 导入。[mathias.leimgruber]

• Plone 5.x：安装时不要清除 plone.custom_attributes。[mathias.leimgruber]

4.1.9 (2020-03-24)

• Plone 5：关键词必须是可编辑的。如果所选单词没有关键词，则添加一个新关键词，否则编辑现有关键词。[tinagerber]

• Plone 5：将初始关键词设置为所选文本。[tinagerber]

• Plone 5：为关键词和脚注插件添加德语翻译。[tinagerber]

4.1.8 (2020-02-11)

• 修复“book_reader_view”视图中的章节编号。[Nachtalb]

4.1.7 (2020-01-22)

• 修复预/后 LaTeX 代码字段中 AT BaseUnit 的使用。[mathias.leimgruber]

4.1.6 (2020-01-21)

• 修复章节中的编号计数器。[tinagerber]

4.1.5 (2020-01-21)

• 修复 CSV 导入/导出（存在编码和 BOM 的问题）。[busykoala]

4.1.4 (2020-01-09)

• 将 ftw.book portal_types 翻译添加到 plone 域。[tinagerber]

4.1.3 (2020-01-07)

• 修复 CSS 计数器。[djowett-ftw]

4.1.2 (2019-12-17)

• 删除 grunt watcher 并添加编译资源。[busykoala]

4.1.1 (2019-11-20)

• 删除 referenceablebehavior。[busykoala]

4.1.0 (2019-11-14)

• 添加 Plone 5 支持。[busykoala]

• 添加开发时的 grunt 设置。[busykoala]

4.0.2 (2019-11-08)

• 始终使用 h2 标题章节内容，并使章节块更紧凑。[jone]

• PDF：使用外部链接非 PDF 内容。[jone]

• 从 PDF 中移除列表块表中的“类型”列。[jone]

• 修复新 DX 类型的导航和搜索设置。[jone]

• 修复章节标题的翻译。[jone]

4.0.1 (2019-11-04)

• 将 ftw.file (2.x) 添加为 ftw.file DX 集成的依赖项。[mathias.leimgruber]

4.0.0 (2019-11-04)

• 使用 Dexterity 重新实现 ftw.book。[jone]

  • 基于 ftw.simplelayout（DX）而不是 ftw.contentpage（AT）。

  • 内容类型 Remark 已不再受支持。在更新之前必须删除所有实例。

  • 章节中不再允许文件，请使用文件列表块。

  • 章节中不再允许图像，请使用文本块的图像字段。

  • 章节中不再允许链接，请使用文本块。

  • 取消了对下一个/上一个的支持，因为它没有得到适当实现/使用。

  • LaTeX 布局需要重新实现：现在它们是实例行为。

  • 提供了自动内容迁移。

• 废弃 get_raw_image_data 工具函数。[jone]

• 取消 Plone 4.2 支持。[jone]

3.5.4 (2019-02-05)

• 修复：使辅助文本出现。[busykoala]

• 取消 Plone 4.2 支持。[busykoala]

3.5.3 (2018-03-20)

• 修复：如果表格单元格包含 HTML 锚标记，则出现解析错误。[mbaechtold]

3.5.2 (2017-04-06)

• LaTeX：将 tabulary.sty 商业化。[jone]

3.5.1 (2016-09-26)

• 在 img url（css）中添加缺失的引号。[mathias.leimgruber]

3.5.0 (2016-05-04)

• 使网页的目录深度可配置。[lknoepfel]

3.4.1 (2016-03-30)

• 更改脚注表示，以避免 PDF 渲染错误。[jone]

• 修复 LaTeX 注入中的 mimetype 错误，使其无法输入值。[jone]

3.3 (2016-03-09)

• 添加了脚注 TinyMCE 插件。[lknoepfel]

3.2.0 (2015-05-26)

• 将特定于书籍的样式从 plonetheme.onegov 移动到本包。[lknoepfel]

• 添加了书籍上下文管理器。[lknoepfel]

• 将列表块中的文件包含在 zip 导出中。[mbaechtold]

• 添加 ftw.zipexport 集成。[lknoepfel]

3.1.0 (2015-03-19)

• 取消 Plone 4.1 兼容性。我们针对 ftw.publisher.core 进行测试，它不兼容。[jone]

• ftw.publisher 支持：确保布局适配器被尊重。[jone]

• ftw.book 与 ftw.contentpage 1.11.0 和 1.11.1 不兼容。当在内容页面中渲染时，HTMLBlock 会失败。[jone]

3.0.3 (2015-01-22)

• PDF 内部链接：修复包含空格的路径链接。[jone]

3.0.2 (2015-01-21)

• Listingblock PDF：移除 ftw.contentpage 1.9.0 中添加的标题。[jone]

• 按更直观的顺序规范化关键词排序。[lknoepfel]

• 为了避免与类似适配器（如 ++add++）冲突，使 LaTeX 视图适配器的布局描述符更具体。[cillianderoiste]

• 临时将 Products.DataGridField 锁定到 1.9.0，因为 1.9.1 似乎破坏了 ftw.book。[mathias.leimgruber]

3.0.1 (2014-09-30)

• 索引：通过引用重音符号支持 umlaut 排序。[jone]

• 在块上调用阅读器时修复滚动位置。[jone]

• 使用 ftw.profilehook 而不是自定义导入步骤（setuphandlers）。[jone]

3.0.0 (2014-07-11)

• 在文档选项卡中显示图像。[tschanzt]

• 移除对 simplelayout.types.common 的依赖。[jone]

• 关键词：加载 select2javascript 翻译。[jone]

• 表格：不再使用描述作为标题。描述字段对表格不再可见，因此不应用作标题。[jone]

• 放弃对 Plone 4.1 的支持。[jone]

• 新增独立的“ftw.book: 添加章节”添加权限。这以前是“simplelayout.types.common: 添加页面”。[jone]

• 重构表格：隐藏无关字段。[jone]

• 重构备注以使用 ftw.contentpage 的 TextBlock 作为基础。[jone]

• 重构 HTMLBlock 以使用 ftw.contentpage 的 TextBlock 作为基础。[jone]

• 使 ftw.contentpage 的 ListingBlock 在章节中可用。[jone]

• 改进书籍内部链接支持。TinyMCE 现已正确配置，以便可以在富文本字段中链接书籍内容。现在，阅读器视图支持书籍内部链接，如锚点，允许在阅读器视图中跳转到内容。[jone]

• 添加具有关键词索引和用于在书籍文本块富文本字段中添加关键词的 TinyMCE 插件的关键词。关键词索引可以在书籍上启用，并将包含在 PDF 中。当启用索引且 ftw.tabbedview 已安装并用于书籍视图时，将出现一个新的关键词选项卡，允许快速查找书籍中的关键词。[jone]

• 将段落替换为 BookTextBlock。[jone]

• 实现卸载配置文件。[jone]

• 添加退出阅读器视图的隐藏链接。[Julian Infanger]

2.2.20 (2014-02-28)

• 修复 TOC 树中的无效标记：将 <ul> 移入 <li>。[jone]

2.2.19 (2014-02-05)

• 更新法语和英语翻译。[jone]

• 修复使用强制单栏布局时使用横版时的页面宽度错误。布局需要在切换到横版之前应用。[jone]

• 为表格添加新的导出/导入图标。[jone]

• 表格 CSV 导入：修复换行问题。某些 Excel 版本（至少是 OSX）使用 r 而不是 rn 来表示换行，这导致导入错误。[jone]

2.2.18 (2013-09-20)

• 实现 Products.DataGridField 1.9 兼容性。（使用标签而不是标题 -> https://github.com/collective/Products.DataGridField/blob/1.9.0/Products/DataGridField/SelectColumn.py#L26) [mathias.leimgruber]

• 表格对象：为手动创建的警告门户消息添加“警告”。[jone]

• 表格对象：修复默认边框布局以包含在允许的边框布局中。[jone]

2.2.17 (2013-09-11)

• 修复默认 Sphinx 布局中的默认书籍标题。标题是直接使用的，不需要转换为 LaTeX。[jone]

2.2.16 (2013-08-26)

• 修复默认布局架构扩展器在工厂中不扩展的问题。当在工厂中时，值设置不正确。[jone]

• 根据 ftw.lawgiver 的更改，将“修改 LaTeX 注入”权限移动到 lawgiver 动作组“管理内容设置”。[jone]

2.2.15 (2013-05-27)

• 表格对象：通过捕获解析错误来使表格生成更稳健。[jone]

• 表格对象：修复单元格中的不良 HTML 独立标签。[jone]

2.2.14 (2013-05-24)

• 在表格对象中允许HTML。这使得我们可以执行诸如仅将单元格中的一个单词标记为粗体或使用 <sup> 等操作。[jone]

2.2.13 (2013-05-24)

• 仅对 IWithinBookLayer 注册 HTMLBlock 视图。这允许我们在默认简单布局块视图之外重用块。优点是标题不是按书籍风格编号（dynamic_title）。[jone]

2.2.12 (2013-04-16)

• 支持立法者：添加权限。[jone]

• 在阅读器视图中支持 JQuery 1.7：以不同的方式访问高度/定位。[jone]

• 修复浮动图像重叠脚注/页面边框的问题。[jone]

• 修复两列环境中的图像浮动/图像宽度问题。[jone]

• 表格脚注：使用 text/x-html-safe 输出格式，并只允许 text/html 输入。[jone]

• HTMLBlock：在 simplelayout_schemas 中使其更严格后重置 HTML 输出类型。[jone]

• 让贡献者默认添加表格对象。[jone]

2.2.11 (2013-01-24)

• 修复嵌套和空视觉突出显示导致 LaTeX 错误的问题。[jone]

• 修复在突出显示的文本中使用连字符时的错误。[jone]

• 使用本地文本格式化命令，例如 textbf 而不是 {bf}。[jone]

2.2.10 (2013-01-21)

• 修复书籍的移动和复制。[tschanzt]

• onegov.ch 审批通过：在 readme 中添加徽章。[jone]

• 加载缺失的 CMFCore 权限。[jone]

• 表格：添加带有缩进和灰色的新格式组合。[jone]

• 修复表格数据导入器。[jone]

• 添加景观支持（仅管理员）。[jone]

• 在 LaTeX 方案中添加复选框以插入列分隔符。[jone]

• 在 LaTeX 方案（管理员）中添加字段以插入页面分隔符。[jone]

• 在块中添加字段以隐藏显示的标题，使其不在目录中显示。[jone]

• 修复阅读器视图，使其在存在讨论项目时不崩溃。[jone]

• 通过添加“首选布局”字段（仅管理员）添加 LaTeX 两列支持。[jone]

• 索引页面：使用排除类型配置的导航类型，以便它也适用于评论。[jone]

• 修复导航工具箱事件处理器，以便删除 plone 网站时不会崩溃。[jone]

2.2.9 (2012-10-16)

• 阅读器视图：支持 #content 元素上的 min-height。[jone]

• 修复移动时的导航工具箱。[tschanzt]

• 使 documentstab 与 document_date 一起工作。[tschanzt]

2.2.8 (2012-08-20)

• 在“索引”选项卡上禁用过滤器框。[jone]

• 不要搜索块类型，而是它们的父类型（章节），因为简单布局中已更改了此概念。[jone]

• 通过插入零-hspace 修复浮动图像的位置。[jone]

• 更新德语文本视图。[jone]

• 禁用为书籍和章节设置默认页面。这些类型不是普通文件夹，因此设置默认页面不常见。[jone]

2.2.7 (2012-07-17)

• 修复段落块中全宽度图像的浮动问题。[jone]

• 章节：显式定义方案。[jone]

• 修复与 LinguaPlone 相关的问题：从 Products.LinguaPlone 而不是 Products.Archetypes 导入。[treinhard]

2.2.6 (2012-06-26)

• 支持 LinguaPlone。[treinhard]

2.2.5 (2012-06-13)

• 突出显示：包含 soulutf8 LaTeX 包，并将转换移至单独的子转换器，以便懒加载包含的包。[jone]

• 表格：修复表格生成器中的实体处理。[jone]

2.2.4 (2012-06-11)

• 段落：验证表格宽度，并向编辑器显示视图小部件，提示表格宽度应定义。[jone]

• LaTeX：使用 soulutf8 而不是 soul 包以允许突出显示文本中的 utf8 字符。[jone]

• 在书籍内，HTML <h?> 标签不应转换为 LaTeX 标题。我们使用章节和块标题来构建书籍结构。这解决了 plone 视图标题编号与 LaTeX 的编号不一致的问题。[jone]

2.2.3 (2012-05-16)

• 修复 latexinjection 扩展器 - 使用 IWithinBookLayer。[mathias.leimgruber]

• 修复备注的 LaTeX 标记。[jone]

• 重构图像处理。[jone]

2.2.1 (2012-05-09)

• 表格 LaTeX 视图：修复脚注 LaTeX 转换。[jone]

• 优化表格布局，使其更接近 plone 默认布局。[eschmutz]

• 修复段落 LaTeX 视图（blob 存储）中的条件。[mathias.leimgruber]

2.2 (2012-04-30)

• 将书籍元数据字段切换到 AttributeStorage。[jone]

• 添加新内容类型：表格。[eschmutz]

• 添加新内容类型：备注。用于在书籍章节中添加评论。[eschmutz]

2.1 (2012-04-02)

• 添加了基于ftw.tabbedview的替代默认书籍视图。[mathias.leimgruber]

• 添加了ftw.tabbedview概述。[mathias.leimgruber]

2.0.2 (2012-03-22)

• 修复了Book FTI的view_methods（应包括默认视图）。[jone]

2.0.1 (2012-03-22)

• 修复标题计数器：计算用户无视图权限的对象。[jone]

• 重置标题计数器，以在部分导出中获得一致的标题编号。#6 [jone]

• 在默认书籍布局中使用“版本”一词代替“发布”。#5 [jone]

• 将simplelayout-block-wrapper添加到章节视图中（Simplelayout问题）。[mathias.leimgruber]

2.0 (2012-03-05)

• 添加HTML块内容类型。[jone]

• 添加设置默认书籍布局的升级步骤。[jone]

• 默认布局：添加logo和logo-width字段。[jone]

• 在尝试确定读者高度的计算中的最后一个元素时查找CSS类‘bookReaderLastElement’。[buchi]

• 将JSON响应的内容类型头设置为‘application/json’，以防止主题化。[buchi]

• 与plone4分支上新的simplelayout版本兼容。[jone]

• 为章节实现一个独立的类。现有章节有迁移步骤。[jone]

• 修复章节的编辑图标。[jone]

• 移除pagestyle字段：新布局不支持pagestyle。[jone]

• 使用schema extender启用特定于default-layout的字段。将默认布局移动到单独的模块。[jone]

• 实现支持多个布局，可在书籍中选择。[jone]

• 重新添加将visualHighlight转换为新的ftw.pdfgenerator实现的步骤。[jone]

• 在书籍和章节类型上添加“PDF”操作。这允许仅导出所选章节。[jone]

• 使用export_pdf视图代替as_pdf，因为它在ftw.pdfgenerator中已更改。[jone]

• 图像块PDF表示：使用描述作为标题，如果描述为空则不使用标题。[jone]

• 将发布、作者和作者地址字段添加到书籍中，用于latex布局。[jone]

• 将缺少的fncychap.sty添加到默认布局中（由sphinx布局所需）。[jone]

• 修复了一个bug，该bug导致当图像没有定义有效布局时，pdflatex进程挂起。将宽度默认为100%修复了问题。[jone]

• 将plonegov.pdflatex替换为ftw.pdfgenerator。[jone]

• 修复schema extender与schema extender的问题。[jone]

• 添加了Bookview，它显示书籍的目录。[ttschanz]

• 修复了一个bug，该bug导致PDF渲染失败：删除不必要的/错误的acqusition包装器检查。[jone]

• 使用TOC前缀在书籍中显示标题。以正确的尺寸在书籍中显示标题。[eschmutz]

• 添加了一个IWithinBookLayer请求层。[jone]

• 在书籍级别实现了导航小部件，它不会显示父项以缩小上下文。一个额外的返回父项小部件提供了一个链接到父项。[ttschanz]

1.1.1 (2011-10-19)

• Readerview：通过以不同的方式构建toc编号来修复奇怪的脑比较问题。[jone]

1.1 (2011-10-18)

• 实现了一个新的读者视图，使用AJAX懒加载显示整个书籍。[jone]

• 代码清理和测试改进。[jone]

• 为管理员用户添加了LaTeX代码注入支持。允许在书籍中的每个对象前后注入LaTeX代码。[jbaumann]

• 添加了自定义html2latex规则以渲染</span>。[jbaumann]

1.0 (2010-11-02)

• 添加了图标/修复setup.py/egg结构。[mathias.leimgruber]

• LaTeX选项（toc、loi、lot等），LaTeX中的链接和图像。[jinfanger]

0.1 (2009-09-04)

• 实现了对标题页、目录和其他列表的支持。[jinfanger]

• 添加了将书籍或章节渲染为PDF的操作。[jinfanger]

• 实现基本功能。