|
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE set PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "docbook/dtd/docbookx.dtd" [ <!ENTITY howtos.xml SYSTEM "source/howtos/howtos.xml"> <!-- Türkçe --> <!ENTITY belge-NASIL.xml SYSTEM "source/howtos/belge-NASIL.xml"> <!ENTITY apps.xml SYSTEM "source/apps/apps.xml"> <!ENTITY iptables-usage.xml SYSTEM "source/apps/iptables-usage.xml"> <!ENTITY others.xml SYSTEM "source/others/others.xml"> <!ENTITY lgpl.xml SYSTEM "source/others/lgpl.xml"> <!ENTITY gpl.xml SYSTEM "source/others/gpl.xml"> ]>
Bu satır, dosyanın bir XML dosyası
olduğunu, 1.0 sürümüne göre yazıldığını,
ve dosyadaki karakter kodlamasının UTF-8
olduğunu belirtiyor. Bir XML dosya için en azından
<?xml version="1.0"?> satırı bulunmalıdır.
XML'in güncel sürümü 1.0'dır. Bu değer
değiştirilirse dosya işlenmeyebilir.
Satırın encoding parçası dosya içeriği işlenirken
önem kazanır. Dosyada, belirtilen karakter kodlamasında bulunmayan
bir karaktere ya da karakter dizisine rastlandığında hata
üretilecektir. Burada belirtilen kodlama türü, çıktının kodlama
türü değil, başlığı barındıran dosyanın karakter kodlamasıdır.
XML bildiriminin yapıldığı <? ve
?> etiketleri XML'de işlem komutlarının
etiketleridir. İşlem komutları başlangıç etiketine bitişik
yazılırlar. Burada <?xml bir işlem
komutudur.
XML bildirim satırında kullanılabilecek diğer parametrelerden
burada bahsedilmeyecektir. Onları,
bölüm başında isimlerini ve bağlarını verdiğim belgelerde
bulabilirsiniz.
| |
Bu satır ve devamındaki satırlarda, dosyada işlenen belgenin
türü, belgeyi oluşturan etiketlerin tanımlandığı paketin
ismi ve sürümü, nerede bulunabileceği, belgeyi oluşturan
ek dosyalar varsa bunların tanımları gibi bilgiler belirtilir.
Bu tanımların başlangıç etiketi <!DOCTYPE
ve bitiş etiketi > karakteridir. İçindeki herşey başlangıç etiketi
olan etiketin parametreleri olarak belirli bir biçemde verilmek
zorundadır.
<!DOCTYPE bildirimindeki ilk parameter
olarak görünen set Docbook'un belge türü elemanlarından
biridir. set elemanı bir kitaplar kümesi
içerebilir. Bizim belgeler sitemiz de bir miktar kitap içeriyor.
Bu alanda belirtilebilecek diğer belge türü elemanları, book, part,
article article, vs. olabilir. Docbook'un elemanları ilerde
tanıtılacaktır.
Hemen ardından gelen PUBLIC bir tanımlayıcıdır.
Belirtilmesi isteğe bağlıdır. Kendinden sonra gelen dizge ile
belgede kullanılan eleman ve parametrelerin hangi DTD ile
ilişkili olduğunu belirtmekte kullanılır.
Burada <!DOCTYPE bildiriminin burada
kullanılmamış olan özelliklerinden bahsedilmeyecektir. Bu
bilgileri
Docbook Guide'da bulabilirsiniz.
| |
Bu satır, <!DOCTYPE bildiriminde bulunması
zorunlu olan sistem tanımlayıcıdır. Burada, belgenin oluşturulmasında
kullanlan DTD'nin adresi verilmelidir. Bu adres bir URL olabildiği
gibi burada olduğu gibi bir sistem dizini de olabilir. Hemen
ardından gelen [ ]'ler içindeki bölüm aşağıda anlatılmıştır.
| |
<!ENTITY bildirimiyle belgemizi
oluşturan diğer dosyaları tanıtıyoruz. Bunun için bir
değişken ismi ve SYSTEM belirteciyle de
dosyanın bulunduğu yeri belirtiyoruz. Belittiğimiz değişken
isimlerini dosya içinde diğer dosyaların bağlanacağı noktalarda
başına bir & ve sonuna da bir
; getirerek kullanıyoruz.
belgeler.xml dosyasının sonundaki gibi:
&howtos.xml; &apps.xml; &others.xml; </set> | |
Bu satır bir açıklama satırıdır. Bilgi vermek amacıyla
kullanılmıştır. Dosyanın derlenmesi sırasında bu ve benzeri
satırlar yorumlanmazlar.
|
|