![]() |
![]() ![]() ![]() ![]() ![]() |
![]() |
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 ::
реклама |