![]() |
![]() ![]() ![]() ![]() |
![]() |
Step 3: Add indexes to your documentationBoost , Boost.AutoIndex , Getting Started and Tutorial
|
||||||||||||
![]() |
Note |
|---|---|
Несколько индексов, подобных этому, работают правильно, только если вы говорите таблицам стилей XSL соблюдать атрибут «тип» на каждом индексе по умолчанию. Вы можете включить функцию, добавив< |
В Quickbook вы добавляете ту же разметку, но заключаете ее между двумя побегами с тремя галочками.
'''<index/>'''
Или проще через файл-помощник auto_index_helpers.qbk, так что дано:
[include auto_index_helpers.qbk]
Можно просто написать:
[named_index class_name Class Index] [named_index function_name Function Index] [named_index typedef_name Typedef Index] [named_index macro_name Macro Index] [index]
![]() |
Note |
|---|---|
AutoIndex ничего не знает об элементе XML< |
Если вы используете генерацию внутреннего индекса AutoIndex
<auto-index-internal>on
(обычно рекомендуется для вывода HTML, нонепо умолчанию), тогда вы также можете решить, в какую обертку XML помещается сгенерированный индекс. По умолчанию это<<section>...</section>>XML-блок (это заменяет оригинальный<<index>...</index>>блок). Однако, в зависимости от структуры документа и того, хотите ли вы, чтобы индекс находился на отдельной странице или на первой странице после TOC, вы можете разместить индекс в блоке XML другого типа. Например, если в вашем документе используется контент верхнего уровня<<chapter>>, а не<<section>>, то может быть предпочтительнее разместить индекс в блоке<<chapter>>или<<appendix>>. Вы также можете разместить индекс в блоке<<index>>, если хотите, и в этом случае индекс появляется не на собственной странице, а после TOC на выходе HTML.
Вы управляете типом блока XML, используемого путем установки атрибута<<auto-index-type>element-name>в Jamfile или через опцию командной строки<index-type=element-name>в сам AutoIndex. Например, чтобы разместить индекс в приложении, ваш Jamfile может выглядеть так:
using quickbook ;
using auto-index ;
xml mylibrary : mylibary.qbk ;
boostbook standalone
:
mylibrary
:
# auto-indexing is on:
<auto-index>on
# PDFs rely on the XSL stylesheets to generate the index:
<format>pdf:<auto-index-internal>off
# HTML output uses auto-index to generate the index:
<format>html:<auto-index-internal>on
# Name of script file to use:
<auto-index-script>index.idx
# Set the XML wrapper for HML Indexes to "appendix":
<format>html:<auto-index-type>appendix
# Turn on multiple index support:
<xsl:param>index.on.type=1
Статья Step 3: Add indexes to your documentation раздела Boost.AutoIndex Getting Started and Tutorial может быть полезна для разработчиков на c++ и boost.
:: Главная :: Getting Started and Tutorial ::
реклама |