常见问题 - Boost C++ 函数库

常见问题解答

我可以使用 QuickBook 进行非 Boost 文档的编写吗？

QuickBook 略加修改后可以用于非 Boost 文档的编写。

常见问题解答由 Michael Marcin 贡献

使用 BoostBook 构建 HTML 文档时，会在文件中添加一个 Boost C++ 库的头文件。当使用 QuickBook 编写 Boost 之外的项目文档时，这并非所期望的。这种行为可以在 BoostBook 层面通过指定一些 XSLT 选项来覆盖。当使用 Boost Build 版本 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