| p:abstract
| - DocBook is a semantic markup language for technical documentation. It was originally intended for writing technical documents related to computer hardware and software but it can be used for any other sort of documentation.
As a semantic language, DocBook enables its users to create document content in a presentation-neutral form that captures the logical structure of the content; that content can then be published in a variety of formats, including HTML, PDF, man pages and HTML Help, without requiring users to make any changes to the source. (en)
- DocBook es un aplicación del estándar SGML/XML e incluye una DTD propia y que se utiliza de manera más destacada en el área de la documentación técnica, especialmente para documentar todo tipo de material y programas informáticos. Existe un Comité Técnico de DocBook en OASIS (originalmente SGML Open) que mantiene y actualiza este estándar. DocBook inicialmente comenzó como una DTD de SGML, pero a partir de la versión 4 existe un equivalente para XML.
= Ejemplos = (es)
- DocBook ist ein Dokumentenformat, das in einer für SGML und XML vorliegenden Dokumenttypdefinition (DTD) festgelegt ist. Es eignet sich besonders zur Erstellung von Büchern, Artikeln und Dokumentationen im technischen Umfeld (Hardware oder Software). DocBook ist ein offener Standard, der von der Organization for the Advancement of Structured Information Standards (OASIS) gepflegt wird.
Am weitesten verbreitet ist die Verwendung von DocBook bei Open-Source-Projekten. So verwendet das Linux Documentation Project die DTD zum Erstellen der HOWTOs. KDE und GNOME/GTK+ verwenden es als grundlegendes Format für alle API-Dokumentationen sowie Benutzerhandbücher der Anwendungsprogramme.
Norman Walsh bietet DSSSL (ausgesprochen: Dissel)- und XSL-Stylesheets, um aus DocBook Druck- und Online-Formate wie PDF und HTML zu erstellen. Er ist auch Mitautor des Buches DocBook: The Definitive Guide (ISBN 1-56592-580-7), das unter der GNU Free Documentation License erschienen ist.
Ein Vergleich zwischen DocBook und der für ähnliche Zwecke vorgesehenen Darwin Information Typing Architecture (DITA) wird dort im Abschnitt Vorteile und Vergleich gegenüber DocBook angestellt. (de)
- DocBook on teknisen dokumentaation tekemiseen kehitetty merkintäkieli jonka nykyinen versio on kehitetty XML:n pohjalta. DocBookin etuna on se että se sallii käyttäjänsä luoda dokumentaation esitysneutraalissa muodossa jonka pohjalta voi automatisoidusti luoda HTML tai PDF -dokumentteja sekä man-sivuja. (fi)
- DocBook est un langage de balisage conçu à l'origine pour la documentation technique informatique (matériel et logiciel). C'est à l'origine une Définition de type de document (DTD) SGML développée par l'éditeur O'Reilly pour les besoins de l'édition technique (et plus particulièrement informatique). Elle a été portée depuis sous forme de schéma XML et de règle Relax NG pour la dernière version 5.0.
Actuellement maintenu et standardisé par le DocBook Technical Comittee du consortium OASIS, DocBook XML peut être utilisé pour tout type de documentation technique (rapports, normes, documentation, etc.).
La grande force de DocBook est d'être à la fois un format SGML et, depuis quelques années, un format XML totalement orienté sémantique, il n'inclut en effet aucune information de mise en forme ce qui permet d'utiliser ensuite la documentation ainsi structurée par tout type de support / lecteur. Un ensemble de feuille de styles XSLT est disponible pour transformer des documents DocBook vers de nombreux formats comme HTML, PDF, RTF, Javadoc, etc.
DocBook est en train de s'imposer comme le format standard pour la documentation logicielle (notamment dans la communauté Open Source) et commence à être utilisé dans l'industrie. La normalisation par l'OASIS devrait d'ailleurs le rendre de plus en plus prisé. (fr)
- DocBookは技術文書のためのマークアップ言語である。元々の用途はコンピュータのハードウェアやソフトウェアに関する技術文書の作成だったが、他の種類の文書のためにも使うことができる。
DocBookの利点のうち特に大きなものの一つは、文書内容の論理的な構造を表す、表示形式に依存しない文書の作成が可能となることである。そのようにして作った文書はユーザーが文書に手を入れることなく、HTML・PDF・manページ・HTMLヘルプなどの様々なフォーマットで出力できる。 (ja)
- DocBook er et oppmerkingsspråk skrevet i XML eller SGML som er designet for å skrive tekst i form av bøker eller artikler.
Det er spesielt egnet for dokumentasjon og bøker, og er et av de mest brukte filformatene for dokumentasjon til programvare og annen litteratur.
Formatet vedlikeholdes og utvikles av DocBook Technical Committee
DocBook fokuserer på struktur og innhold, og inneholder i liten grad elementer som lar forfatteren styre utseendet.
I likhet med for eksempel Texinfo skilles innhold og utseende, noe som gjør det enkelt å konvertere teksten til en lang rekke formater:
HTML, Postscript, PDF, troff, Rich Data Format og de fleste formater som tekst kan gjengis som.
Det ble tidligere stort sett brukt av prosjekter innen fri programvare/open source, men blir i stadig større grad også tatt i bruk i kommersiell øyemed.
Et DocBook-dokument kan variere i størrelse fra en liten artikkel eller notis til en bok, et sett med bøker eller teoretisk sett et helt bibliotek.
Den hierarkiske strukturen deler inn teksten i avsnitt, seksjoner, kapitler, bøker og sett med bøker og inneholder ingen definerte grenser for størrelsen av innholdet.
Dette er et eksempel på en minimalistisk bok:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4//EN"
"http://docbook.org/xml/4.3/docbookx.dtd">
<book lang="no">
<bookinfo>
<title>Den ultimate roman</title>
<author>
<firstname>Ola</firstname>
<surname>Dunk</surname>
<email>ola@example.org</email>
</author>
<copyright>
<year>2005</year>
<holder>Ola Dunk</holder>
</copyright>
</bookinfo>
<chapter>
<title>Navn på første kapittel</title>
<para>Det var en mørk og stormfull aften.
Noe som <emphasis>ikke</emphasis> passer sammen med
pølsefest.</para>
</chapter>
</book>
Som vist i eksempelet ovenfor indikerer elementene kun hvilken type informasjon som er i teksten, ikke hvordan den skal se ut.
Design og oppsett av utseendet foregår i neste steg i prosessen mot det endelige formatet, ved hjelp av stilsett som kan modifiseres i henhold til mediet eller filformatet som teksten skal konverteres til.
Det kan for eksempel være ønskelig med sideskift i en PDF-fil, for HTML er det ofte ønskelig med alt i en enkelt fil, eller teksten kan splittes opp i mange små filer.
Prosessen for å konvertere en fil fra DocBook til et annet format foregår grovt sett i disse stegene:
# Redigering av teksten i en vanlig tekstbehandler, som for eksempel Vim, Emacs, Notepad eller MS Word. Kildekoden lagres som ren tekst.
# Generering av målformatet (PDF, HTML, Postscript eller annet) ved hjelp av et konverteringsprogram som for eksempel xsltproc og stilsett som definerer utseendet og innhold i de nye filene. (no)
- DocBook - język znaczników do tworzenia dokumentacji technicznej, pierwotnie przeznaczony do opracowywania dokumentów związanych ze sprzętem i oprogramowaniem komputerowym, ale potem wykorzystywany w wielu innych dziedzinach. Można w nim opracowywać zarówno całe książki, jak i zwyczajne artykuły. Dodatkowe znaczniki umożliwiają tworzenie np. indeksów, słowników terminologii itd. Język powstał w roku 1991 jako wspólny projekt HaL Computer Systems oraz O'Reilly & Associates. Obecnie rozwija go DocBook Technical Committee w OASIS (pierwotnie SGML Open).
DocBook istnieje zarówno w postaci SGML-owego, jak i XML-owego DTD (Document Type Definition). Początkowo był aplikacją SGML-ową, jednak opracowano również jego XML-owy ekwiwalent, który zastąpił SGML w większości zastosowań - XML DTD pojawiło się razem z wersją 4 SGML DTD.
DocBook jest używany głównie przez wspólnotę Open Source. Przykładami są opisy API w Linux Documentation Project, GNOME i GTK+ API oraz dokumentacja kernela Linuksa.
Norman Walsh i zespół DocBook Open Repository rozwija zbiór arkuszy stylów DSSSL i XSL do generowania wydruków, plików PDF, RTF i HTML z dokumentów w formacie DocBook (jak również generowania innych formatów, w tym stron man i plików HTML Help. Walsh jest też głównym autorem książki DocBook: The Definitive Guide, oficjalnej dokumentacji DocBook. Książka jest dostępna online, na licencji GNU FDL, oraz jako publikacja drukowana.
DocBook jest bardzo łatwy do rozszerzania. Każdy, kto tego potrzebuje, może przygotować odpowiednią nakładkę personalizacyjną (ang. customization layer), która doda nowe lub usunie niepotrzebne znaczniki. Jeżeli nakładka ma być rozpowszechniana, nie może się ona dalej nazywać DocBook.
Ponieważ DocBook jest aplikacją XML, dokumenty mogą być tworzone i edytowane w dowolnym edytorze tekstu. Istnieje jednak wiele dedykowanych narzędzi upraszczających ten proces. Edytor Emacs w trybie nXML posiada wbudowane informacje o schemacie DocBook, dzięki czemu użytkownicy mogą szybko dodawać nowe elementy lub przeprowadzać kontrolę dokumenty. Istnieją także narzędzia WYSIWYG (np. [http://www.xmlmind.com/xmleditor/ XMLmind]) potrafiące automatycznie generować odpowiednią strukturę dokumentu DocBook w trakcie pisania. (pl)
- DocBook — приложение SGML или XML (проще говоря — популярный набор тегов), предназначенное для разметки документов, такое же, как HTML для разметки веб-документов.
Текущая версия DocBook V4.5 — официальный стандарт OASIS.
Преобразованием DocBook-документа в форматы, доступные для печатного или просто визуального представления (в том числе PDF, HTML, man-страницы) занимаются различные утилиты, обычно осуществляющие такое преобразование на основе настраиваемых шаблонов, или «таблиц стилей» (DSSSL или XSL), то есть происходит настоящая изоляция структуры документа от визуального представления.
В отличие от HTML-документа, DocBook-документ не рассматривается как конечный формат, поэтому, например, один документ в этом формате после преобразования может выглядеть и как один большой документ со сложной структурой, и как набор небольших простых документов-глав.
DocBook разрабатывался для создания технической документации, но может использоваться и в других целях (для создания сайтов, с преобразованием в HTML; для создания презентаций). (ru)
|
| rdfs:comment
| - DocBook is a semantic markup language for technical documentation. It was originally intended for writing technical documents related to computer hardware and software but it can be used for any other sort of documentation. (en)
- DocBook es un aplicación del estándar SGML/XML e incluye una DTD propia y que se utiliza de manera más destacada en el área de la documentación técnica, especialmente para documentar todo tipo de material y programas informáticos. Existe un Comité Técnico de DocBook en OASIS (originalmente SGML Open) que mantiene y actualiza este estándar. DocBook inicialmente comenzó como una DTD de SGML, pero a partir de la versión 4 existe un equivalente para XML. (es)
- DocBook ist ein Dokumentenformat, das in einer für SGML und XML vorliegenden Dokumenttypdefinition (DTD) festgelegt ist. Es eignet sich besonders zur Erstellung von Büchern, Artikeln und Dokumentationen im technischen Umfeld (Hardware oder Software). DocBook ist ein offener Standard, der von der Organization for the Advancement of Structured Information Standards (OASIS) gepflegt wird. (de)
- DocBook on teknisen dokumentaation tekemiseen kehitetty merkintäkieli jonka nykyinen versio on kehitetty XML:n pohjalta. DocBookin etuna on se että se sallii käyttäjänsä luoda dokumentaation esitysneutraalissa muodossa jonka pohjalta voi automatisoidusti luoda HTML tai PDF -dokumentteja sekä man-sivuja. (fi)
- DocBook est un langage de balisage conçu à l'origine pour la documentation technique informatique (matériel et logiciel). C'est à l'origine une Définition de type de document (DTD) SGML développée par l'éditeur O'Reilly pour les besoins de l'édition technique (et plus particulièrement informatique). Elle a été portée depuis sous forme de schéma XML et de règle Relax NG pour la dernière version 5.0. (fr)
- DocBookは技術文書のためのマークアップ言語である。元々の用途はコンピュータのハードウェアやソフトウェアに関する技術文書の作成だったが、他の種類の文書のためにも使うことができる。 (ja)
- DocBook er et oppmerkingsspråk skrevet i XML eller SGML som er designet for å skrive tekst i form av bøker eller artikler. Det er spesielt egnet for dokumentasjon og bøker, og er et av de mest brukte filformatene for dokumentasjon til programvare og annen litteratur. Formatet vedlikeholdes og utvikles av DocBook Technical Committee (no)
- DocBook - język znaczników do tworzenia dokumentacji technicznej, pierwotnie przeznaczony do opracowywania dokumentów związanych ze sprzętem i oprogramowaniem komputerowym, ale potem wykorzystywany w wielu innych dziedzinach. Można w nim opracowywać zarówno całe książki, jak i zwyczajne artykuły. Dodatkowe znaczniki umożliwiają tworzenie np. indeksów, słowników terminologii itd. Język powstał w roku 1991 jako wspólny projekt HaL Computer Systems oraz O'Reilly & Associates. (pl)
- DocBook — приложение SGML или XML (проще говоря — популярный набор тегов), предназначенное для разметки документов, такое же, как HTML для разметки веб-документов. (ru)
|
![[RDF Data]](http://dbpedia.org/statics/sw-cube.png)
