通过一些额外的努力,QuickBook 可以用于非 Boost 文档。
Faq 由 Michael Marcin 贡献
使用 BoostBook 构建 HTML 文档时,会有一个 Boost C++ Libraries 头文件添加到其中。当使用 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 生成的 HTML 作为 quickbook 源代码查看,请参阅 http://svn.boost.org/trac/boost/wiki/QuickbookSourceStylesheetProject,然后只需复制粘贴即可将 BoostBook 转换为 QuickBook(我认为这样更容易编辑和维护)。
--John Maddock