gnome-doc-utils

gnome-doc-utils pakete ay naglalaman ng isang koleksyon ng mga papeles utility para sa proyekto Gnome. Kapansin-pansin, naglalaman ito ng mga utility para sa pagbuo ng dokumentasyon at lahat pandiwang pantulong na file sa iyong mapagkukunan ng puno, at naglalaman ito ng DocBook XSLT stylesheet na ibinahagi sa isang beses sa Yelp. Simula sa Gnome 2.8, Yelp ay mangangailangan ng gnome-doc-utils para sa XSLT.
Pagsubok

samahan
/
Ang pagsubok na direktoryo ay naglalaman ng isang bilang ng mga pagsubok para lamang-lupa -doc-utils. Direktoryo ng form testdocn, kung saan n ay isang positibong integer, ang balangkas pinagmulan puno na naglalaman ng mga papeles, na may parehong layout na ito ay gagamitin sa pamamagitan ng aktwal na proyekto. Ang direktoryo testdocs naglalaman ng mga pagsusuri ng yunit mula sa docbook-testdocs, na binuo ng Norm at Co. para sa pan-galactic DocBook stylesheet. Isang karagdagang Readme file sa directory na iyon, na nagbibigay sa mga tagubilin sa pagpapalawig o baguhin ang anuman sa mga file sa gnome-doc-utils CVS.

Doc /
Ang direktoryo ng doc ay naglalaman ng dokumentasyon para sa gnome-doc -utils. Sa karamihan ng mga kaso, gnome-doc-utils ay kinakailangan upang bumuo ng mga papeles nito. Mekanismo ay nasa lugar na para bootstrapping.

XSLT /
Ang direktoryo XSLT ay naglalaman ng lahat ng mga XSLT sa gnome-doc-utils. Kapansin-pansin, ang direktoryo XSLT / docbook naglalaman ng DocBook XSLT, at XSLT / gettext naglalaman ng XSLT gettext utility para sa pagsalin ng awtomatikong pag-text.

Sandbox /
Ang direktoryo ng sandbox ay hindi DISTed, kaya habilin ito lilitaw lamang kung mayroon kang CVS checkout. Ito ay isang lugar para sa mga bagong ideya.

Xml2po /
Ang direktoryo xml2po naglalaman ng xml2po tool na binuo ni Danilo Segan para sa pagsasalin ng mga arbitrary na mga format ng XML. Ito ay ginagamit sa pamamagitan ng gnome-doc-utils para sa pagsasalin DocBook.

PAGSUBOK

Sa ilalim ng pagsubok na direktoryo ay isang bilang ng mga pagsusulit para sa gnome-doc-utils. Upang subukan ang build system (gnome-doc-utils.m4 at gnome-doc-utils.make), maaari mong gamitin ang alinman sa mga testdocn (para sa Na positibong integer) direktoryo. Ang mga naka-set up bilang balangkas pinagmulan puno, gumagana nang eksakto tulad ng real proyekto ginagawa. Gayundin, gnome-doc-utils ay gumagamit ng sarili nito upang bumuo ng sarili nitong papeles (sa ilalim doc), kaya gnome-doc-utils mismo ay isang pagsubok sa mga tool build.

Upang subukan ang DocBook stylesheet, gamitin ang pagsubok / testdocs direktoryo. Ang mga pagsusuri ng yunit ay mula sa docbook-testdocs package sa docbook.sourceforge.net, na binuo ng Norm at Co. lamang ng pag-type sa gumawa na direktoryo ay bumuo ng bawat test. Kung ang pangalan ng pangsubok na file ay foo.001.xml, ang output ay magiging html / foo.001 / foo.001.html. Ang bawat pagsubok sa pangkalahatan ay sumusubok sa isang maliit na bilang ng mga kaugnay na mga elemento DocBook. Marami sa mga tampok ng DocBook o ng XSLT sa gnome-doc-utils ay maaaring hindi nasubok sa pamamagitan ng mga ito. Karagdagang mga pagsubok maaaring idagdag; sundin ang mga tagubilin sa pagsubok / testdocs / Readme para doon.

kapaki-pakinabang din para sa pagsubok ng XSLT ay upang ibahin ang anyo ng ilang mga malaking mga dokumento gamit ito. Ang Gnome Gabay sa Gumagamit at ang Gnumeric Manu-manong parehong maglingkod bilang mahusay na pagsubok doc.

Pag-hack

Hindi tulad ng karamihan C programming, na nagtatrabaho sa karami ng gnome-doc-utils talaga ay may kasangkot ilang incremental pagpapabuti. Walang paraan upang magbigay ng isang maikling listahan ng mga malawak na mga tampok sa isang listahan ng TODO.

Upang magtrabaho sa mga tool build (gnome-doc-utils.m4 at gnome-doc-utils.make), magtayo ng pangsubok na doc at makita kung ano ay hindi gumagana. gnome-doc-utils.make ay may listahan ng lahat ng mga target na mataas na antas na dapat na ganap na sinusuportahan.

Upang magtrabaho sa mga DocBook XSLT, hanapin isang elemento na hindi pa ipinapatupad at ipatupad ito . Kung mayroon kang XML munting bituin (xmlstar.sourceforge.net) na naka-install, maaari mong i-type 'gumawa report.html' sa XSLT / docbook / html direktoryo upang makakuha ng
gandang ulat HTML sa kung anong mga elemento ay ipinatupad. May TODO file sa direktoryong ito na may isang napaka-maikli at malinaw na listahan ng mga pagtutugma na kailangang ma-tapos na hindi maaaring nakuha ng report.html din.

Tandaan na ang XSLT ay dokumentado naaayon sa xsldoc, na kung saan ay mismong isang bahagi ng gnome-doc-utils. Huwag mag-atubiling upang gumana sa xsldoc pati na rin. Ang papeles na binuo ng xsldoc ay kabilang sa mga manu-manong sa ilalim ng doc / XSLT

Ano ang bagong sa paglabas:.

• Fixed problema sa dist at i-install sa masyadong maraming mga file
• Na-update pagsasalin:
• km (umaga Met)

Ano ang bagong sa bersyon 0.20.9:

• Pansamantalang pagdaragdag ng RNG mga file pabalik para sa compatibility. Ngayon na ang RNG mga file ay hindi na tinatawag na (bilang ng mga 0.20.8), ang RNG file ay tatanggalin muli pagkatapos ng isang panahon ng paglipat.

Ano ang bagong sa bersyon 0.20.6:

• Na-update pato schema
• Mga Fixed 'gumawa ng mga palayok' panuntunan para sa pato
• Na-update pagsasalin:
• ca (Jordi Serratosa)
• es (Jorge Gonzalez, Daniel Mustieles)
• .ug (Abduxukur Abdurixit)

Ano ang bagong sa bersyon 0.20.5:

• Na-update pato RNG file
• Na-update pagsasalin:
• bilang (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• eo (Kristjan Schmidt)
• es (Jorge Gonzalez)
• Gu (Sweta Kothari)
• o (Manoj Kumar Giri)

Ano ang bagong sa bersyon 0.20.3:

• Ang Nakatakdang Nested utos pagpapalit sa gnome-doc-utils .make (Chris Coleman)
• Na-update pagsasalin:
• ca @ Valencia (Carles, Iloilo Ferrando)
• de (Christian Kirbach)
• de (Mario Blattermann)
• el (Michael Kotsarinis)
• es (Jorge Gonzalez)
• et (Ivar Smolin)
• pa (Mahyar Moghimi)
• fr (Bruno Brouard)
• gl (Fran Dieguez)
• sl (Matej Urbancic)
• .ug (Gheyret T.Kenji)

Ano ang bagong sa bersyon 0.20.2:

• Na-update pagsasalin:
• de (Mario Blattermann)
• en @ Shaw (Thomas Thurman)
• es (Jorge Gonzalez)
• fr (Geode)
• gl (Fran Dieguez)
• siya (Yaron Shahrabani)
• hu (Gabor Kelemen)
• id (Dirgita)
• ja (Takayuki KUSANO)
• lv (Rudols Mazurs)
• sl (Andrej Znidarsic)
• zh_CH (Aron Xu)