gnome-doc-utils

GNOME-док-Utils пакети съдържа колекция на документация помощни програми за проекта Gnome. За отбелязване е, че съдържа помощни програми за изграждане на документация и всички помощни файлове в изходния си дърво, и той съдържа XSLT стилови на DocBook, че след като бяха разпространени с Yelp. Като се започне с Gnome 2.8, Yelp ще изисква GNOME-док-UTILS за XSLT.

ОРГАНИЗАЦИЯ

тест /
директория тест съдържа редица тестове за GNOME -doc-UTILS. Directories на форма testdocn, където N е цяло положително число, са скелет дърветата, съдържащи документация, с еднакво оформление, че ще бъдат използвани от реални проекти. Директория testdocs съдържа единица тестове от DocBook-testdocs, разработени от Norm и Ко за пан-галактически на DokBook стиловите на. Допълнително README файл е в тази директория, даване на инструкции за удължаване или промяна на някой от файловете в GNOME-док-UTILS CVS.

Док /
директория док съдържа документация за GNOME-док -utils. В повечето случаи, се изисква GNOME-док-UTILS да изгради своята документация. Въвеждат се механизми, за инициализиране.

XSLT /
директория XSLT съдържа всички от XSLT в GNOME-док-UTILS. За отбелязване е, директорията на XSLT / DocBook съдържа DocBook XSLT и XSLT / gettext съдържа полезността на XSLT gettext за превод автоматичен текст.

Пясък /
директория пясъчника не е DISTed, така че ще се появи само ако имате CVS касата. Това е идеалното място за всички нови идеи.

Xml2po /
директория xml2po съдържа инструмента xml2po разработен от Данило Сиган за превод на произволни XML формати. Той се използва от GNOME-док-UTILS за DocBook превод.

ИЗПИТВАНЕ

под тази в теста са редица тестове за GNOME-док-UTILS. За да се тества системата строителство (GNOME-док-utils.m4 и GNOME-док-utils.make), можете да използвате всеки от testdocn (за Na положително число) директории. Те са изградени като скелет дърветата, се държи точно като истински проект би. Също така, GNOME-док-UTILS самата използва, за да изгради своя собствена документация (по док), така GNOME-док-UTILS самата е тест на специализираните инструменти за.

Да тествате стиловите на DokBook, използвайте тест / testdocs директория. Тези единица тестове са от DocBook-testdocs пакет за docbook.sourceforge.net, разработен от Norm и Co. Просто напишете направи в тази директория ще изгради всеки тест. Ако името на файла тест е foo.001.xml, продукцията ще бъде HTML / foo.001 / foo.001.html. Всеки тест обикновено се тества от малък брой свързани DocBook елементи. Много от функциите на DocBook или на XSLT в GNOME-док-UTILS не може да бъде тествана от тях. Могат да се добавят допълнителни тестове; следвайте инструкциите в тест / testdocs / README за това.

Също полезно за тестване на XSLT е да превърне някои големи документи, които го използват. Ръководството на Gnome потребителя и ръководството за Gnumeric служат като отлични Документи за изпитване.

Хакерство

За разлика от повечето програмиране C, работи по-голямата част от GNOME-док-UTILS наистина е свързано с изолиран постепенни подобрения. Няма начин да се даде кратък списък с широки функции в списъка с TODO.

Да работят на специализираните инструменти за (GNOME-док-utils.m4 и GNOME-док-utils.make), изграждане на тестови документи и да видим какво не работи. GNOME-док-utils.make има списък на всички цели на високо равнище, която трябва да се поддържа напълно.

да работи по DocBook XSLT, намери един елемент, който не се изпълнява още и да го приложат , Ако имате XML Starlet (xmlstar.sourceforge.net) инсталиран, можете да напишете "направи report.html" в XSLT / DocBook / HTML директория да получите
приятно HTML доклад за това, което са приложени елементи. Има и файл TODO в тази директория с много кратка списък с мачове, които трябва да се направи, че не може да бъде уловена от report.html.

Имайте предвид, че XSLT е документирано инлайн с xsldoc, който от своя страна е част от GNOME-док-UTILS. Чувствайте се свободни да работят по xsldoc, както добре. Документацията, генерирани от xsldoc е включена в наръчника по док / XSLT

Какво ново в тази версия:.

• Фиксирано Проблемът с дист и инсталират с прекалено много файлове
• Актуализирани преводи:
• км (Морн Met)

Какво ново във версия 0.20.9:

• Временно добавяне RNG файлове обратно за съвместимост. Сега, RNG файлове вече не се нарича (както на 0.20.8), RNG файлове ще бъдат премахнати отново след период на преход.

Какво ново във версия 0.20.6:

• Updated Mallard схема
• Фикс "направи пот" правило за Mallard
• Актуализирани преводи:
• Калифорния (Jordi Serratosa)
• ES (Jorge Gonzalez, Daniel Mustieles)
• мкг (Abduxukur Abdurixit)

Какво ново във версия 0.20.5:

• Актуализирани Mallard RNG файлове
• Актуализирани преводи:
• като (Amitakhya Phukan)
• bn_IN (Руна Bhattacharjee)
• EO (Кристиян SCHMIDT)
• ES (Jorge Gonzalez)
• гу (Sweta Kothari)
• или (Manoj Kumar Гири)

Какво ново във версия 0.20.3:

<> <ул Li> Фиксирана вложените заместване команда в GNOME-док-UTILS .make (Chris Coleman)

Какво ново във версия 0.20.2:

• Актуализирани преводи:
• де (Mario Blattermann)
• BG @ Шоу (Thomas Търман)
• ES (Jorge Gonzalez)
• FR (Geode)
• GL (Fran Dieguez)
• той (Ярон Shahrabani)
• HU (Gabor Келемен)
• ID (Dirgita)
• йа (Такаюки KUSANO)
• лв (Rudols Mazurs)
• SL (Andrej Znidarsic)
• zh_CH (Aron Xu)