常见问题

我可以使用 QuickBook 来编写非 Boost 文档吗？

QuickBook 可以用于非 Boost 文档，但需要额外的一些工作。

此常见问题由 Michael Marcin 贡献

当使用 BoostBook 构建 HTML 文档时，Boost C++ 库的头部会被添加到文件中。当使用 QuickBook 来记录 Boost 以外的项目时，这可能并不理想。此行为可以通过在 BoostBook 层面指定一些 XSLT 选项来覆盖。当使用 Boost Build version 2 (BBv2) 时，可以通过向 BoostBook 目标声明添加参数来实现。

例如

using quickbook ;

xml my_doc : my_doc.qbk ;

boostbook standalone
    :
        my_doc
    :
        <xsl:param>boost.image.src=images/my_project_logo.png
        <xsl:param>boost.image.alt="\"My Project\""
        <xsl:param>boost.image.w=100
        <xsl:param>boost.image.h=50
        <xsl:param>nav.layout=none
    ;

有没有一种简单的方法可以将 BoostBook 文档转换为 QuickBook？

有一个样式表允许将 Boostbook 生成的 HTML 视为 quickbook 源代码，请参见 http://svn.boost.org/trac/boost/wiki/QuickbookSourceStylesheetProject，因此只需剪切和粘贴即可将 BoostBook 转换为 QuickBook（在我看来，这更容易编辑和维护）。

--John Maddock