gnome-doc-utils

paket gnome-doc-utils berisi kumpulan utilitas dokumentasi untuk proyek Gnome. Khususnya, mengandung utilitas untuk membangun dokumentasi dan semua file tambahan di pohon sumber Anda, dan mengandung stylesheet XSLT DocBook yang pernah didistribusikan dengan Yelp. Dimulai dengan Gnome 2.8, Yelp akan membutuhkan gnome-doc-utils untuk XSLT. Uji


ORGANISASI
/
Direktori uji berisi sejumlah tes untuk gnome -doc-utils. Direktori dari testdocn bentuk, di mana n adalah bilangan bulat positif, adalah pohon sumber kerangka yang mengandung dokumentasi, dengan tata letak yang sama yang akan digunakan oleh proyek-proyek yang sebenarnya. Direktori testdocs berisi unit test dari docbook-testdocs, yang dikembangkan oleh Norm dan Co untuk pan-galaksi DocBook stylesheet. Sebuah file README tambahan dalam direktori tersebut, memberikan petunjuk tentang memperluas atau mengubah salah satu file dalam gnome-doc-utils CVS.

Doc /
Direktori doc berisi dokumentasi untuk gnome-doc -utils. Dalam kebanyakan kasus, gnome-doc-utils diperlukan untuk membangun dokumentasinya. Mekanisme berada di tempat untuk bootstrap.

XSLT /
Direktori XSLT berisi semua XSLT di gnome-doc-utils. Khususnya, direktori XSLT / docbook berisi DocBook XSLT, dan XSLT / gettext berisi utilitas XSLT gettext untuk menerjemahkan teks otomatis.

Sandbox /
Direktori sandbox tidak Disted, sehingga akan hanya muncul jika Anda memiliki checkout CVS. Ini adalah taman bermain untuk ide-ide baru.

Xml2po /
Direktori xml2po berisi alat xml2po dikembangkan oleh Danilo Segan untuk terjemahan format XML sewenang-wenang. Hal ini digunakan oleh gnome-doc-utils untuk terjemahan DocBook.

PENGUJIAN

bawah direktori test sejumlah tes untuk gnome-doc-utils. Untuk menguji sistem build (gnome-doc-utils.m4 dan gnome-doc-utils.make), Anda dapat menggunakan salah satu testdocn (untuk na bilangan bulat positif) direktori. Ini mengatur pohon sebagai sumber kerangka, berperilaku persis seperti proyek nyata akan. Juga, gnome-doc-utils menggunakan dirinya untuk membangun dokumentasi sendiri (di bawah doc), sehingga gnome-doc-utils sendiri adalah tes dari alat yang.

Untuk menguji stylesheet DocBook, gunakan uji / direktori testdocs. Unit tes ini dari paket docbook-testdocs pada docbook.sourceforge.net, yang dikembangkan oleh Norm dan Co Cukup mengetik membuat dalam direktori akan membangun setiap tes. Jika nama file uji foo.001.xml, output akan html / foo.001 / foo.001.html. Setiap tes umumnya tes sejumlah kecil elemen DocBook terkait. Banyak fitur dari DocBook atau XSLT di gnome-doc-utils tidak mungkin diuji oleh ini. Tes tambahan dapat ditambahkan; ikuti petunjuk di test / testdocs / README untuk itu.

juga berguna untuk menguji XSLT adalah untuk mengubah beberapa dokumen besar menggunakannya. Gnome Panduan Pengguna dan Gnumeric Pedoman keduanya melayani docs tes sebagai sangat baik.

HACKING

Tidak seperti kebanyakan pemrograman C, bekerja pada banyak gnome-doc-utils benar-benar melibatkan terisolasi tambahan perbaikan. Tidak ada cara untuk memberikan daftar singkat dari fitur yang luas dalam daftar TODO.

Untuk bekerja pada alat membangun (gnome-doc-utils.m4 dan gnome-doc-utils.make), membangun docs tes dan melihat apa yang tidak bekerja. gnome-doc-utils.make memiliki daftar semua target tingkat tinggi yang harus didukung.

Untuk bekerja di DocBook XSLT, menemukan elemen yang belum diimplementasikan dan menerapkannya . Jika Anda memiliki XML Starlet (xmlstar.sourceforge.net) diinstal, Anda dapat mengetik 'membuat report.html' dalam XSLT / docbook / html direktori untuk mendapatkan
laporan HTML tentang apa saja elemen diimplementasikan. Ada juga file TODO dalam direktori ini dengan daftar yang sangat singkat dari pertandingan yang perlu dilakukan yang tidak dapat ditangkap oleh report.html.

Perhatikan bahwa XSLT didokumentasikan inline dengan xsldoc, yang itu sendiri merupakan bagian dari gnome-doc-utils. Jangan ragu untuk bekerja pada xsldoc juga. Dokumentasi yang dihasilkan oleh xsldoc termasuk dalam manual di bawah doc / XSLT

Apa yang baru dalam rilis ini:.

• Tetap masalah dengan dist dan menginstal dengan terlalu banyak file
• Diperbarui terjemahan:
• km (Pagi Met)

Apa yang baru dalam versi 0.20.9:

• Sementara menambahkan RNG file kembali untuk kompatibilitas. Sekarang file RNG tidak lagi disebut (per 0.20.8), file RNG akan dihapus lagi setelah masa transisi.

Apa yang baru dalam versi 0.20.6:

• Diperbarui Mallard skema
• Tetap 'membuat pot' aturan untuk Mallard
• Diperbarui terjemahan:
• ca (Jordi Serratosa)
• es (Jorge Gonzalez, Daniel Mustieles)
• ug (Abduxukur Abdurixit)

Apa yang baru dalam versi 0.20.5:

• Diperbarui file Mallard Ping
• Diperbarui terjemahan:
• sebagai (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• eo (Kristjan SCHMIDT)
• es (Jorge Gonzalez)
• gu (Sweta Kothari)
• atau (Manoj Kumar Giri)

Apa yang baru dalam versi 0.20.3:

• Tetap substitusi perintah bersarang di gnome-doc-utils .make (Chris Coleman)
• Diperbarui terjemahan:
• ca @ valencia (Carles Ferrando)
• de (Christian Kirbach)
• de (Mario Blattermann)
• el (Michael Kotsarinis)
• es (Jorge Gonzalez)
• et (Ivar Smolin)
• fa (Mahyar Moghimi)
• fr (Bruno Brouard)
• gl (Fran Dieguez)
• sl (Matej Urbancic)
• ug (Gheyret T.Kenji)

Apa yang baru dalam versi 0.20.2:

• Diperbarui terjemahan:
• de (Mario Blattermann)
• en @ shaw (Thomas Thurman)
• es (Jorge Gonzalez)
• fr (Geode)
• gl (Fran Dieguez)
• dia (Yaron Shahrabani)
• hu (Gabor Kelemen)
• id (Dirgita)
• ja (Takayuki Kusano)
• lv (Rudols Mazurs)
• sl (Andrej Znidarsic)
• zh_CH (Aron Xu)