Movatterモバイル変換


[0]ホーム

URL:


Siirry sisältöön
Wikipedia
Haku

DocBook

Wikipediasta

DocBook on teknisen dokumentaation tekemiseen kehitettymerkintäkieli, jonka nykyinen versio on kehitettyXML:n pohjalta. DocBookin etuna on, että se sallii käyttäjänsä luoda dokumentaation esitysneutraalissa muodossa, jonka pohjalta voi automatisoidusti luodaHTML- taiPDF-dokumentteja sekäman-sivuja.DocBookia on sen XML-pohjaisuuden vuoksi lähes mahdotonta kirjoittaa käsin. Yleensä sitä käytetään jonkinlaisena välitiedostomuotona muunnettaessa rakenteisia dokumentteja.

DocBookin kehitys alkoi 1991Usenet-keskusteluissa. Mukaan tulivat HAL Computer Systems jaO'Reilly & Associates, jotka myöhemmin perustivat oman komiteansa sitä kehittämään (Davenport Group). Vuonna 1998 kehitys siirtyi SGML Open -konsortiolle, josta tuli myöhemminOASIS (Organization for the Advancement of Structured Information Standards).

Esimerkki

[muokkaa |muokkaa wikitekstiä]
<?xml version="1.0" encoding="UTF-8"?><bookxml:id="simple_book"xmlns="http://docbook.org/ns/docbook"version="5.0"><title>Verysimplebook</title><chapterxml:id="chapter_1"><title>Chapter1</title><para>Helloworld!</para><para>Ihopethatyourdayisproceeding<emphasis>splendidly</emphasis>!</para></chapter><chapterxml:id="chapter_2"><title>Chapter2</title><para>Helloagain,world!</para></chapter></book>

Kritiikki

[muokkaa |muokkaa wikitekstiä]

OpenBSDn mandocin kehittäjä Ingo Schwarze yritti kirjoittaa Unixinmanuaalisivuille muunninta DocBook-muodosta. Schwarzen mukaan DocBook on turvonnut, redundantti ja epätäydellinen samaan aikaan, eikä sitä pitäisi käyttää mihinkään. BSD:n manuaalisivuilla käytettävään mdoc-muotoon verrattuna DocBookin spesifikaatio on viisi kertaa pitempi, suuri osa sen elementeistä on tarpeettomia ja vain haittaavat luettavuutta ja lisäävät moniselitteisyyttä. Spesifikaatio on monissa kohdissa epämääräisesti määritelty. Lähes kaikki voidaan ilmaista usealla eri tavalla, mikä tekee kielestä vaikeamman oppia ja lukea ja tuloksesta epäyhtenäisemmän. Silti DocBook ei pystyi ilmaisemaan kaikkia manuaalisivujen piirteitä.[1]

Aiheesta muualla

[muokkaa |muokkaa wikitekstiä]

Lähteet

[muokkaa |muokkaa wikitekstiä]
  1. https://undeadly.org/cgi?action=article&sid=20190419101505
Tämätietotekniikkaan liittyvä artikkeli ontynkä. Voit auttaa Wikipediaalaajentamalla artikkelia.
Noudettu kohteesta ”https://fi.wikipedia.org/w/index.php?title=DocBook&oldid=22076034
Luokka:
Piilotettu luokka:

[8]ページ先頭

©2009-2025 Movatter.jp