gnome-doc-utils

гном-Doc-Utils пакеты содержит набор утилит документации для проекта Gnome. Примечательно, он содержит утилиты для построения документации и всех вспомогательных файлов в дереве исходных текстов, и он содержит XSLT стилей DocBook, что были когда-то, распределенных с Yelp. Начиная с GNOME 2.8, Yelp требует GNOME-Док-утилиты для XSLT.
ОРГАНИЗАЦИЯ
контрольная работа/
Каталог тест содержит ряд тестов для гномов-Doc-утилит. Справочники виде testdocn, где п целое положительное число, являются каркасные деревья источник, содержащий документацию, с тем же макет, который будет использоваться по фактическим проектов. Каталог testdocs содержит модульные тесты из DocBook-testdocs, разработанных норме и Ко для пан-галактических DocBook стилей. Дополнительный файл README в этом каталоге, дает указания о продлении или изменении любого из файлов в GNOME-Док-утилиты CVS.
DOC /
Каталог док содержит документацию для GNOME-Doc-утилит. В большинстве случаев, гном-док-утилиты требуется, чтобы построить свою документацию. Механизмы на месте для начальной загрузки.
XSLT /
Каталог XSLT содержит все XSLT в Gnome-Doc-утилит. Примечательно, каталог XSLT / DocBook содержит DocBook XSLT, и XSLT / Gettext содержит XSLT GetText утилиту для автоматического перевода текста.
   
песочница /
Каталог песочницы не DISTed, так что они будут, только если у вас есть CVS проверку. Это площадка для новых идей.
xml2po /
Каталог xml2po содержит xml2po инструмент, разработанный Данило Segan для перевода форматов произвольных XML. Он используется Gnome-док-утилит для перевода DocBook.
ТЕСТИРОВАНИЕ
В директории тестового ряд тестов для гномов-Doc-утилит. Чтобы проверить систему сборки (гном-док-utils.m4 и гном-док-utils.make), вы можете использовать любой из testdocn (для на положительное целое число) каталоги. Они создаются как скелет деревья источника, ведет себя точно так, как в реальном проекте будет. Кроме того, гном-док-утилиты использует себя, чтобы построить свою собственную документацию (в соответствии с Doc), так гном-док-утилиты само по себе является испытанием на строительных инструментов.
Чтобы проверить стилей DocBook, использовать тестовый каталог / testdocs. Эти модульные тесты из пакета DocBook-testdocs на docbook.sourceforge.net, разработанной Норма и Ко просто набрав сделать в этом каталоге будет строить каждый тест. Если имя тестового файла foo.001.xml, выход будет HTML / foo.001 / foo.001.html. Каждый тест обычно испытывает небольшое количество элементов, связанных с DocBook. Многие из особенностей DocBook или в XSLT в гнома-Doc-утилиты не могут быть проверены с помощью них. Могут быть добавлены дополнительные испытания; следуйте инструкциям в тестовом / testdocs / README для этого.
Также полезно для тестирования XSLT является преобразование некоторых крупных документов, используя его. Руководство пользователя Гном и Gnumeric Руководство и служат превосходными тестовые документы.
ВЗЛОМ
В отличие от большинства программ C, работающих на много гном-Doc-Utils действительно привлечь изолированных постепенных улучшений. Там нет никакого способа, чтобы дать краткий перечень широких возможностей в списке TODO.
Для работы на строительных инструментов (гном-док-utils.m4 и гном-док-utils.make), строить тестовые документы и посмотреть, что не работает. гном-док-utils.make есть список всех целей высокого уровня, которые должны быть полностью поддерживается.
Для работы на DocBook XSLT, найти элемент, который еще не реализован, и реализовать его. Если у вас установлен XML-Starlet (xmlstar.sourceforge.net), вы можете ввести "сделать report.html" в XSLT / DocBook / HTML каталог, чтобы получить
хороший отчет о том, что HTML-реализованы элементы. Существует также файл TODO в этом каталоге с очень сжатой списке совпадений, которые должны быть сделано, что не может быть захвачен report.html.
Обратите внимание, что XSLT документально баннер с xsldoc, которая сама является частью GNOME-Doc-утилит. Не стесняйтесь работать на xsldoc также. Документация генерируется xsldoc входит в руководстве по DOC / XSLT

Что нового В этом выпуске:.

• Исправлена Проблема с дист и установить слишком много файлов
• Обновлены переводы:
• км (Морн Met)

Что нового в версии 0.20.9:

• Временно добавления ГСЧ файлы обратно на совместимость. Теперь, когда ГСЧ файлы больше не называется (по 0.20.8), ГСЧ файлы будут удалены снова после переходного периода.

Что нового в версии 0.20.6:

• Обновлено кряквы схемы
• Исправлена ​​"сделать горшок" правило для кряквы
• Обновлены переводы:
• Ca (Хорди Серратоса)
• ES (Хорхе Гонсалес, Даниэль Mustieles)
• мкг (Abduxukur Abdurixit)

Что нового в версии 0.20.5:

• Обновлены кряквы ГСЧ файлы
• Обновлены переводы:
• , как (Amitakhya Пхукан)
• bn_IN (Руна Бхаттачарджи)
• ео (Кристьян Шмидт)
• ES (Хорхе Гонсалес)
• гу (Sweta Котари)
• или (Манодж Кумар Гири)

Что нового в версии 0.20.3:

• Исправлена ​​вложенный замещения команда в GNOME-Doc-утилиты .make (Крис Коулмэн)
• Обновлены переводы:
• ча @ Валенсия (Карлес Ferrando)
• де (Кристиан Kirbach)
• де (Марио Blattermann)
• эль (Майкл Kotsarinis)
• ES (Хорхе Гонсалес)
• ET (Ивар Смолин)
• FA (Махьяр Moghimi)
• FR (Бруно Brouard)
• GL (Фран Дьегес)
• SL (Матей Urbancic)
• мкг (Gheyret T.Kenji)

Что нового в версии 0.20.2:

• Обновлены переводы:
• де (Марио Blattermann)
• EN @ Шоу (Томас Турман)
• ES (Хорхе Гонсалес)
• FR (Geode)
• GL (Фран Дьегес)
• он (Ярон Shahrabani)
• ху (Габор Kelemen)
• ID (Dirgita)
• JA (Такаюки Kusano)
• LV (Rudols Mazurs)
• SL (Андрей Znidarsic)
• zh_CH (Арон Сюй)