close

Belge kitabı

Navigasyona git Aramaya git

DocBook , SGML / XML standardının bir uygulamasıdır ve teknik dokümantasyon alanında özellikle her türlü materyal ve bilgisayar programlarını belgelemek için daha belirgin olarak kullanılan kendi DTD'sini içerir . Oasis'te bu standardı koruyan ve güncelleyen bir Docbook Teknik Komitesi (başlangıçta SGML Open ) vardır. Docbook başlangıçta bir SGML DTD olarak başladı, ancak sürüm 4 itibariyle XML için bir eşdeğer var.

Anlamsal bir dil olarak, Docbook sunumdan bağımsız olarak belgeler nötr bir formatta oluşturmamıza izin verir. Bu nötr formatta, hem içerik hem de mantıksal yapısı toplanır, böylece çok sayıda formatta otomatik olarak yayınlanmasına (sunulmasına) izin verilir: HTML , XHTML , EPUB , PDF , man sayfaları , HTML Help , vb. Orijinal belgede herhangi bir değişiklik gerektirmeden sunum "şablonları" uygulanması.

Giriş

Docbook bir XML dilidir . Mevcut sürümünde (5.0), resmi olarak yerleşik şematron kurallarına sahip bir rahatlama ng şeması ile tanımlanır . (Bir XML şeması +schematron ve bir DTD de mevcuttur , ancak bunlar şu anda standart olmayan olarak kabul edilir.)

Docbook belgeleri, içeriklerinin görünümünü veya sunumunu değil, sadece söz konusu içeriğin anlamını tanımlar . Örneğin, bir bölüm başlığı olan belirli bir ifadenin nasıl görüntüleneceğini tam olarak belirtmek yerine, Docbook sadece söz konusu ifadenin bir bölüm başlığı olduğunu gösterir. Daha sonra, sayfa içinde söz konusu başlığın nerede ve nasıl görüntüleneceğine karar vermek, harici bir işleme aracının veya işlediğimiz izleyici uygulamasının görevi olacaktır.

Docbook, bunlar üç ana kategoride de dahil olmak üzere semantik öğeleri tanımlamak için çok sayıda etikete sahiptir: yapısal, blok ve çizgi.

Yapısal etiketler , içeriğinizin genel özelliklerini belirtir. Örneğin, kitap öğesi , çocuk öğelerinin bir kitabın parçası olacağını belirtir: başlıklar , bölümler , sözlükler , ekler vb . Bazı yapısal etiketler:

  • Set :
  • Kitap :
  • Bölüm :
  • Makale :
  • Bölüm :
  • Ek :
  • özveri :

Yapısal öğeler başka yapısal öğeler içerebilir, ancak her zaman bir Docbook belgesinde birinci seviye öğeler olmalıdır.

Blok etiketleri paragraflar , listeler vb. Gibi öğeleri temsil eder ve hepsinin içinde metin içermesi gerekmez. Bu blok elemanları genellikle sırayla düzenlenir ve birbirleri "altında" görüntülenir. ("Aşağıda" kültürel ortama bağlı olarak değişebilir: çoğu batı dilinde "aşağıdaki" sayfada aşağıya doğru anlamına gelecektir; ancak bazı doğu dillerinde "Aşağıdaki" sağdan sola doğru anlamına gelecektir. her kültür için yer alan bu tür kavramlara tamamen tarafsızdır.)

Çizgi etiketleri , vurgulanan harfler , köprüler vb. Gibi öğeleri temsil eder ve genellikle bir blok öğesi içindeki metnin kısımlarına uygulanır, bu da genellikle oluşturucu aracının ona bir tür özel tipografik tedavi uygulamasına neden olur. Bu kısımlar. (DocBook belirtimi, özel tipografik işlemin beklendiğini belirtir, ancak tam olarak hangi özel işlemin uygulanması gerektiğini belirtmez. Örneğin, "vurgulanmış harfler" mutlaka "italik harfler" anlamına gelmez; mizanpaj aracı yazı tipini artırmayı seçebilir boyut veya arka plan rengini değiştirerek.)

Örnekler

Docbook SGML/XML Makalesi 

<? XML versiyonu = "1.0" bağımsız = "hayır"?> 
     <! Doctype makale genel "-// vahası // dtd docbook xml v4.2 // tr" 
       "http://www.oasis-open.org/ docbook/xml/4.2/docbookx.dtd ">

     <Makale  lang = "tr" > 
      <itit> ile teknik belgeler oluşturma
      Docbook </itit>

      <articleinfo> 
       <yazar> 
        <ad> Leonardo </ad> 
        <soyadı> Şövalye </soyadı> 
       </yazar> 
      </articleinfo>

      <bölüm  id = "Art-intro" >

       <tites> Giriş </tite>

       <Para> Docbook, standardın bir uygulamasıdır
       SGML/XML ve bir yazılımda kullanılan kendi DTD'sini içerir.
       belge alanı öne çıkıyor
       Teknik, özellikle her türlü her türlü
       daha büyük için malzeme ve bilgisayar programları
       bilgi için buraya bakın <ulink 
       url= "http://www.oasis-open.org/docbook/" /> . </ para>

      </bölüm>

     </takam>

Anlamsal bir bakış açısından, bu belge ilgili "başlığı" (başlığı) ile bir "makale"dir (makale). "Yazar" (yazar) açıkça tanımlanmıştır ve başka bir tür ek "bilgi" (Makalinfo) da dahil edilmiş olabilir. Bu örnek makale tek bir "bölümden" oluşur, ayrıca ilgili "başlık"; ve metnin "paragrafları" ile.

Docbook SGML/XML'de kitap 

     <?xml version="1.0" standalone="no"?> 
     <!DOCTYPE book KAMU "-//OASIS//DTD DocBook XML V4.2//EN" 
       "http://www.oasis-open.org/ docbook/xml/4.2/docbookx.dtd"> 
     <book  lang= "tr"  id= "simple_book" > 
      <title> Çok basit bir kitap </title>

       <bölüm  id = "bölüm_1" > 
        <itites> Bölüm 1 </itle> 
        <Para> Merhaba Dünya! </ para> 
        <Para> Umarım günün iyi olur! </para> 
       </bölüm>

       <bölüm  id = "bölüm_2" > 
        <itites> Bölüm 2 </itle> 
        <Para> Tekrar merhaba, dünya! | _ 
       _

Anlamsal bir bakış açısından, bu belge "başlık" (başlık) olan bir "kitap" (kitap); Her biri kendi "başlığı" olan iki "bölümden" oluşur ve bu "bölümler" metnin "paragrafları" vardır. Bütün bunlar insanlar tarafından kolayca anlaşılabilir bir formatta ifade edildi.

Şemalar ve Doğrulama

Hem bir docbook oluşturan farklı öğeler hem de bunları birleştirecek kurallar (örneğin, her "kitap" öğesinin "bölüm" gibi başka bir yapısal unsurdan önce bir "başlık" öğesi içermesi gerektiği) Bir şemada (şemada) resmi olarak tanımlanmış, bilgisayar programları belgeyi söz konusu şemaya karşı doğrulayabilir ve böylece belge iyi oluşturulduğunu her zaman belirleyebilir .

Yazma

XML belgeleri olarak, Docbook belgeleri herhangi bir metin düzenleyicisiyle yazılabilir, ancak bunları bir XML düzenleyicisi ile yazmak her zaman daha kolay olacaktır veya daha da iyisi, belirli Docbook şemaları entegre olan bir XML düzenleyicisi ile daha da iyi olacaktır. Örneğin , nXML modunda çalışan Emacs veya XML Kopya Düzenleyicisi .

Ayrıca, Docbook belgelerini CSS ile biçimlendirerek oluşturabilen XMLMIND editörü ("XXE"), oksijen XML düzenleyicisi gibi daha "görsel" editörler ( WYSIWYG ) vardır ; o Gerçek zamanlı olarak XSL dönüşümleri gerçekleştiren Syntext Serna .

İşleme Sonrası

Ayrıca, XML belgeleri olarak DocBook belgeleri, XML'i destekleyen herhangi bir araç veya programlama dili tarafından otomatik olarak doğrulanabilir ve işlenebilir.

Bu araçlar genellikle, genellikle Docbook XLS "stil sayfaları" olan Docbook , Docbook belgelerini HTML , PDF , vb. İçerik, sözlük ve/veya dizinlerin otomatik üretimini düşünmek, hatta önceki içerik filtrelemesine izin vererek, orijinal docbook'un yalnızca belirli bölümlerini çıkaracak şekilde sofistike dönüşümlere izin vermek.

kullanır

Docbook, özellikle Linux Dokümantasyon Projesi, GNOME ve GTK+ API referansları ve Linux çekirdek belgeleri olmak üzere birkaç bağlamda yaygın olarak kullanılmaktadır . Solaris İşletim Ortamı kılavuz sayfaları , DTD'leri veya DocBook şemalarını kullanan belgelerden de oluşturulur .

Tarih

Docbook, 1991 yılında, HAL Computer Systems ve O'Reilly & Associates'in ortak bir projesinden doğdu ve daha sonra kendi organizasyonu (Davenport Grubu) olana kadar gelişti, 1998'de SGML Açık Konsorsiyumu tarafından yönetilecek şekilde , daha sonra Docbook Teknik Komitesinin şu anda var olduğu OASIS organizasyonu olacak ve Docbook standardını korumaktan sorumlu.

Docbook spesifikasyonu, hem bir DTD belgesi hem de Relax NG - W3C XML şeması ile tanımlanan hem SGML hem de XML formatlarında mevcuttur . Sürüm 5 itibariyle, Relax ng şeması "normatif" dir, formatların geri kalanı sadece adaptasyonlardır.

Docbook bir SGML uygulaması olarak doğdu, ancak şu anda XML adaptasyonu en çok kullanımda değiştirildi. (SGML DTD'nin 4. sürümünden itibaren, XML DTD sürümü kendi yoluna ve kendi numaralandırma şemasına gitti.)

Başlangıçta, Docbook formatının kullanımı pratik olarak tasarımına katılan şirketler grubuyla sınırlıydı, ancak şimdi tüm ücretsiz yazılım topluluğu ve geniş bir şirket yelpazesi tarafından, kullanımı sağlayan çok sayıda araçla yaygın olarak benimsenmiştir. onun.

Norman Walsh ve DocBook Open Repository geliştirme ekibi , DocBook belgelerinin PDF ve HTML sürümlerini oluşturmak için (ayrıca HTML yardım ve man referans sayfaları dahil diğer biçimleri geliştirmek için) bir dizi DSSSL ve XSL stil sayfası sağlar . Walsh ayrıca Docbook: The Definitive Rehberi'nin ana yazarıdır . Bu kitap GFDL altında veya O'Reilly & Associates tarafından yayınlanan basılı ( ISBN 1565925807) mevcuttur . "

Referanslar

Dış bağlantılar

  • Bu çalışma, yayıncıları tarafından GNU Özgür Belgeleme Lisansı ve Creative Commons Attribution-ShareAlike 3.0 Unported Lisansı altında yayınlanan İngilizce Wikipedia " DocBook "un türetilmiş bir çevirisini içermektedir .
« https://es.wikipedia.org/w/index.php?title=DocBook&oldid=125248651 » adresinden alındı