DocBook XSL - DocBook XSL

В DocBook XSL таблицы стилей - это набор XSLT таблицы стилей для XML -основан DocBook язык.

Цель

DocBook - это язык семантической разметки. То есть он определяет значение элементов в документе, а не то, как они должны быть представлены конечному пользователю. Это обеспечивает разделение между содержанием документа и визуальным представлением. Хотя DocBook является удобочитаемым языком разметки, он не предназначен для чтения конечными пользователями в его форме DocBook.

Цель DocBook XSL - предоставить стандартный набор преобразований из DocBook в несколько форматов представления.

Форматы вывода

DocBook XSL обеспечивает преобразование в следующие форматы:

• HTML, как в виде отдельных страниц, так и в «фрагментированном» формате, который выводит разделы на разные страницы.
• XHTML
• XSL-FO, а оттуда обычно PDF
• Страницы руководства
• WebHelp

Интернет-справка

Webhelp - это формат вывода HTML с фрагментами в таблицах стилей DocBook xslt, который был представлен в версии 1.76.1. Документация для веб-справки^[1] также предоставляет пример веб-справки и является частью распространения DocBook xsl. Его основные функции включают в себя макет страницы на основе CSS без набора фреймов, многоязычный поиск полного содержимого, панель оглавления (TOC) со сворачиваемым деревом оглавления, автоматическую синхронизацию панели содержимого и оглавления. Этот формат веб-справки был первоначально реализован Касуном Гаджасингхе и Дэвидом Крамером в рамках программы Google Summer of Code 2010.^[2]

DocBook XSL также имеет преобразования в слайд-форматы для HTML и XSL-FO. EPUB поддержка в настоящее время экспериментальная.

Конфигурация

Таблицы стилей DocBook XSL легко настраиваются. Каждый из различных форматов имеет ряд параметров XSLT, доступных для простой настройки. Например, преобразования XSL-FO позволяют пользователю определять размер страниц. Кроме того, сами документы XSLT имеют модульную структуру; Пользователь может добавлять, изменять или заменять определенные уровни функциональности. Это может позволить DocBook XSL обрабатывать новые теги документации, добавленные в стандартный DocBook, или просто изменять способ создания результирующего формата XSLT.

Рекомендации

1. Веб-справочная документация
2. "Вики-страница DocBook в Интернете". Архивировано из оригинал на 31.01.2012. Получено 2012-01-11.

внешняя ссылка

• Проект DocBook - Проект Sourceforge, поддерживающий преобразования DocBook XSL и DSSSL.
• Справочник по DocBook XSL - Справочная документация по преобразованиям DocBook XSL.
• DocBook XSL: полное руководство - HTML-издание книги, объясняющее использование DocBook XSL.
• Плагин Docbkx Maven - Плагин Maven на основе таблиц стилей DocBook XSL, содержащий все необходимое для работы с несколькими выходными форматами.
• ant4docbook - задача Ant для DocBook.