Can I use QuickBook for non-Boost documentation?

QuickBook можно использовать для документации, не связанной с Boost, с небольшой дополнительной работой.

При создании HTML-документации с BoostBook увеличивается 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
    ;

Is there an easy way to convert BoostBook docs to QuickBook?

Существует таблица стилей, которая позволяет просматривать созданный Boostbook HTML как источник быстрой книги, см.http://svn.boost.org/trac/boost/wiki/QuickbookSourceStylesheetProject, так что это просто работа по вырезанию и вставке, чтобы преобразовать BoostBook в QuickBook (который IMO намного легче редактировать и поддерживать).

Джон Мэддок