TracWikiPrintPlugin

此插件允许您导出为PDF（书籍或文章格式）或可打印的HTML格式（页面内容不带Trac页眉/页脚），方便打印。PDF导出基于wkhtmltopdf。

旧版本（V3.0.0及以下）使用xhtml2pdf生成PDF文件。虽然它是一个纯Python解决方案，但由于wkhtmltopdf的输出质量更好，因此已被放弃。有关这些不受支持的旧版本，请参阅WikiPrintXhtml2pdf。

主要特性

• 默认设置的行政页面。
• 可自定义PDF页脚。
• 可自定义PDF书籍格式的封面。
• 自动为PDF书籍创建目录。
• 使用CSS完全自定义生成的PDF或HTML的样式。
• 不同的页面大小。
• PDF“打印对话框”，在创建PDF文件之前更改设置。
• 使用 Makro 指定具有导出功能的 PDF 图书的内容和格式。

通过在每个维基页面的“其他格式下载”部分添加项目，此插件无缝集成到 Trac 用户界面中。

完整文档可以在主页上找到：[TracWikiPrintPlugin](https://trac-hacks.org/wiki/TracWikiPrintPlugin) (https://trac-hacks.org/wiki/TracWikiPrintPlugin)

支持的 Trac 版本

Trac 1.4 和 1.6 完全支持。

对于旧版本，请使用 TracWikiPrintPlugin V3.x.x 或更早版本。

许可

版本 up 到 V3.x.x 都是按照 GPL 许可的。

从 V4.0.0 开始，插件完全重写，现在是 BSD 许可。

下载

从这里下载压缩的源代码：[下载链接](https://trac-hacks.org/browser/tracwikiprintplugin?format=zip)

源代码

您可以从TracWikiPrintPlugin (https://trac-hacks.org/wiki/TracWikiPrintPlugin) 使用 Subversion 检出，或者使用 Trac 浏览源代码。

安装

要从主分支安装插件

$ pip install https://trac-hacks.org/svn/tracwikiprintplugin/trunk

安装较旧的 V3.0.0 版本

$ pip install https://trac-hacks.org/svn/tracwikiprintplugin/tags/V3.0.0

安装 wkhtmltopdf。

注意： wkhtmltopdf 必须在您的路径中，或者更确切地说，在 Trac 使用的路径中。

使用 Trac 插件管理页面启用插件，或者在您的 trac.ini 文件的组件部分添加 wikiprint.* = enabled。

[components]
...
wikiprint.* = enabled

使用方法

启用插件后，在 Wikiprint 部分下方将出现一个新的管理面板，在每篇维基页面的末尾的“其他格式下载”部分将提供 4 种新的下载格式

• 可打印 HTML
• PDF 页面
• PDF 页面（自定义设置）
• PDF 图书

可以使用新的 makro PdfBook 从任意数量的维基页面创建 PDF 图书。

管理页面

可以使用 Wikiprint 管理页面提供页面导出的默认配置。这些设置在用户导出 PDF 时未覆盖。虽然大多数设置与 PDF 文件相关，但这里指定的样式页面也适用于生成 可打印 HTML 页面。

可打印 HTML

维基页面将从 Trac 的页脚、页眉和导航中去除。结果页面仅包含维基内容。

页面的样式根据管理面板中选择的样式页面进行设置。

PDF 页面

PDF 页面 将维基页面创建为 PDF 文件，无封面页。样式将使用在全局配置中定义的样式页面中的样式。

维基页面中的表格内容 makro，如 [[PageOutline()]] 或其他，不会被从页面上去除。

PDF 页面（自定义设置）

维基页面被导出为 PDF 文件。这与正常的 PDF 页面 导出类似，但在生成 PDF 文件时可以覆盖全局配置。在实际导出之前，用户将看到一个类似“打印对话框”的设置页面。

PDF 图书

这将创建一个类似图书的 PDF 文档。在导出时，用户将看到一个设置页面来指定封面页以及是否添加目录。可以通过选择可用的样式页面来更改样式。用于图书的封面页可以是任何维基页面。

维基页面中常见的目录 makro，如 [[PageOutline()]] 或 [[TracGuideToc()]]，将从中删除。

PdfBook makro

使用该 makro 可以定义具有任意数量的维基页面、封面页和目录的 PDF 图书。在创建图书时，用户可以覆盖 makro 中指定的配置。例如，可以更改预定义的封面页或省略目录。请注意，在创建图书时不能添加或删除页面。

makro配置被渲染给用户，并添加了一个按钮来创建PDF书籍。请注意，一个wiki页面只支持一个PdfBook makro。

makro必须使用WikiProcessors语法指定

{{{#!PdfBook
...
}}}

内容必须像INI文件一样格式化。以下定义了以下部分

• [parameters]：指定封面页和目录
• [pages]：要添加到书籍中的wiki页面列表。

{{{#!PdfBook
[parameters]
# Name of a wiki page to be used as the cover page
cover = CoverPage
# Set to 1 for a table of contents, else set to 0
toc = 1

[pages]
# Names of wiki pages to be added to the PDF book.
WikiStart
WikiFormatting
}}}