Документ XSL
Таблицы стилей DocBook XSL представляют собой набор таблиц стилей XSLT для XML на основе языка DocBook .
Цель
[ редактировать ]DocBook — это язык семантической разметки. То есть он определяет значение элементов в документе, а не то, как они предназначены для представления конечному пользователю. Он обеспечивает разделение между содержанием документа и его визуальным представлением . Хотя DocBook является читаемым языком разметки, он не предназначен для чтения конечными пользователями в форме DocBook.
Целью DocBook XSL является предоставление стандартного набора преобразований DocBook в несколько форматов представления.
Выходные форматы
[ редактировать ]DocBook XSL обеспечивает преобразование в следующие форматы:
- HTML , как в виде отдельных страниц, так и в «блочном» формате, который выводит разделы на разные страницы.
- XHTML
- XSL-FO , а оттуда обычно PDF.
- Страницы руководства
- Веб-справка
Веб-справка
[ редактировать ]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 результирующего формата.
Ссылки
[ редактировать ]- ^ Веб-справочная документация
- ^ «Вики-страница веб-справки DocBook» . Архивировано из оригинала 31 января 2012 г. Проверено 11 января 2012 г.
Внешние ссылки
[ редактировать ]- Проект DocBook — проект SourceForge, поддерживающий преобразования DocBook XSL и DSSSL.
- Справочник DocBook XSL — Справочная документация по преобразованиям DocBook XSL.
- DocBook XSL: Полное руководство — HTML-версия книги, объясняющая использование DocBook XSL.
- Плагин Docbkx Maven — плагин Maven, основанный на таблицах стилей DocBook XSL, содержащий все необходимое для работы с несколькими выходными форматами.
- ant4docbook — задача Ant для DocBook.