gnome-doc-utils

gnome-doc-utils pachete conține o colecție de utilitare de documentare pentru proiectul Gnome. În special, aceasta conține utilitati pentru construirea de documentare, iar toate fișierele auxiliare din arborele sursă, și conține de stil XSLT DocBook care au fost odată distribuite cu Yelp. Începând cu Gnome 2.8, Yelp va necesita gnome-doc-utils pentru XSLT.
ORGANIZATIA
încercare
/
Directorul de test conține o serie de teste pentru GNOME -doc-utils. Directoare de testdocn formular, în cazul în care n este un număr întreg pozitiv, sunt copaci sursa schelet care conțin documentație, cu același aspect care ar fi folosit de proiecte concrete. Directorul testdocs conține teste unitare din docbook-testdocs, dezvoltat de Norma și Co pentru pan-galactice foi de stil DocBook. Un fișier suplimentar README este în acel director, oferind instrucțiuni cu privire la extinderea sau modificarea oricare dintre fișierele în gnome-doc-utils CVS.
Doc /
directorul doc contine documentatie pentru gnome-doc -utils. În cele mai multe cazuri, este necesară gnome-doc-utils pentru a construi documentația acestuia. Mecanisme sunt la locul lor pentru procesul de bootstrap.
XSLT /
Directorul XSLT conține toate XSLT în gnome-doc-utils. În special, directorul XSLT / docbook conține DocBook XSLT, și XSLT / gettext conține utilitarul XSLT nls pentru traducere automată a textului.
Nisip /
Directorul nisip nu este DISTed, asa ca va apar numai dacă aveți o casă CVS. Este un loc de joaca pentru idei noi.
Xml2po /
Directorul xml2po conține instrumentul xml2po dezvoltat de Danilo Segan pentru traducerea formate XML arbitrare. Acesta este utilizat de gnome-doc-utils pentru traducere DocBook.
TESTARE
Sub directorul de testare o serie de teste pentru gnome-doc-utils. Pentru a testa sistemul de build (gnome-doc-utils.m4 și gnome-doc-utils.make), puteți utiliza oricare din testdocn (pentru na întregi pozitive) directoare. Acestea sunt înființate arborilor ca schelet, se comporta exact ca un adevărat proiect ar fi. De asemenea, gnome-doc-utils se folosește pentru a construi propria documentație (sub doc), așa gnome-doc-utils sine este un test de uneltele de compilare.
Pentru a testa foilor de stil DocBook, utilizați încercare director / testdocs. Aceste teste unitare sunt de pachetul docbook-testdocs pe docbook.sourceforge.net, dezvoltat de Norm și Co Pur și simplu tastând face în acel director va construi fiecare test. În cazul în care numele fișierului de test este foo.001.xml, ieșirea va fi html / foo.001 / foo.001.html. Fiecare test teste, în general, un număr mic de elemente DocBook conexe. Multe dintre caracteristicile DocBook sau ale XSLT în gnome-doc-utils ar putea să nu fie testate de către acestea. Se pot adăuga Teste suplimentare; urmați instrucțiunile din testul / testdocs / README pentru asta.
De asemenea, util pentru testarea XSLT este de a transforma unele documente mari, folosind o. Ghidul utilizatorului Gnome și Manualul Gnumeric servesc documente de test ca excelente.
Hacking
Spre deosebire de cele mai multe de programare C, lucru pe o mare parte din gnome-Doc-utils într-adevăr nu implică izolat îmbunătățiri incrementale. Nu există nici o modalitate de a da o listă scurtă de caracteristici generale într-o listă TODO.
Pentru a lucra pe uneltele de compilare (gnome-doc-utils.m4 și gnome-doc-utils.make), să construiască docs de testare și a vedea ce nu funcționează. gnome-doc-utils.make are o listă cu toate obiectivele la nivel înalt, care ar trebui să fie sprijinite în totalitate.
Pentru a lucra pe DocBook XSLT, găsiți un element care nu este pusă în aplicare încă și să pună în aplicare o . Dacă aveți XML Starlet (xmlstar.sourceforge.net) instalat, aveți posibilitatea să tastați "face report.html" în XSLT / DocBook / html director pentru a obține
un raport frumos HTML pe care sunt puse în aplicare elemente. Există, de asemenea, un fișier TODO în acest director cu o listă foarte succintă a meciurilor care trebuie să fie făcut că nu poate fi prins de report.html.
Rețineți că XSLT este documentată în linie cu xsldoc, care este ea însăși o parte din gnome-DOC-utils. Simțiți-vă liber pentru a lucra la xsldoc de asemenea. Documentația generată de xsldoc este inclus în manualul de sub doc / XSLT

Ce este nou în această versiune:.

• fixă problemă cu dist și instala cu prea multe fișiere
• Traduceri Actualizat:
• km (Morn Met)

Ce este nou în versiunea 0.20.9:

• adăugând Temporar in RNG fișierele înapoi pentru compatibilitate. Acum, că fișierele RNG nu mai sunt numite (ca de 0.20.8), fișierele RNG vor fi eliminate din nou după o perioadă de tranziție.

Ce este nou în versiunea 0.20.6:

• Updated schemă Mallard
• fix "face oală" regulă de Mallard
• Traduceri Actualizat:
• ca (Jordi Serratosa)
• es (Jorge Gonzalez, Daniel Mustieles)
• UG (Abduxukur Abdurixit)

Ce este nou în versiunea 0.20.5:

• Fișierele Mallard RNG Updated
• Traduceri Actualizat:
• ca (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• EO (Kristjan SCHMIDT)
• es (Jorge Gonzalez)
• gu (Sweta Kothari)
• sau (Manoj Kumar Giri)

Ce este nou în versiunea 0.20.3:

• substituție fix comandă imbricate în gnome-doc-utils .make (Chris Coleman)
• Traduceri Actualizat:
• ca @ Valencia (Carles Ferrando)
• de (Creștin Kirbach)
• de (Mario Blattermann)
• el (Michael Kotsarinis)
• es (Jorge Gonzalez)
• și (Ivar Smolin)
• fa (Mahyar Moghimi)
• fr (Bruno Brouard)
• gl (Fran Dieguez)
• sl (Matej Urbancic)
• UG (Gheyret T.Kenji)

Ce este nou în versiunea 0.20.2:

• Traduceri Actualizat:
• de (Mario Blattermann)
• en @ Shaw (Thomas Thurman)
• es (Jorge Gonzalez)
• fr (Geode)
• gl (Fran Dieguez)
• el (Yaron Shahrabani)
• hu (Gabor Kelemen)
• id (Dirgita)
• ja (Takayuki Kusano)
• LV (Rudols Mazurs)
• sl (Andrej Znidarsic)
• zh_CH (Aron Xu)