gnome-doc-utils

гном-Doc-Utils пакети містить набір утиліт документації для проекту Gnome. Примітно, що він містить утиліти для побудови документації і всіх допоміжних файлів в дереві вихідних, і містить XSLT стилів DocBook, що були колись поширюються разом з Yelp. Починаючи з GNOME 2.8, Yelp вимагає GNOME-Doc-утиліти для XSLT.

Організації

тест /
тестовий каталог містить ряд тестів для GNOME -doc утилітами. Довідники виду testdocn, де п ціле позитивне число, є каркасні дерева джерело, що містить документацію, з тим же макет, який буде використовуватися реальних проектів. Каталог testdocs містить юніт-тестів з Docbook-testdocs, розроблених нормі і Ко для пан-галактичних DocBook стилів. Додатковий файл README в цьому каталозі, дає вказівки про продовження або зміну будь-якого з файлів у GNOME-Док-утиліти CVS.

DOC /
каталог Doc містить документацію по GNOME-Док -utils. У більшості випадків, гном-док-утиліти потрібно, щоб побудувати свою документацію. Є механізми для початкового завантаження.

XSLT /
каталог XSLT містить всі XSLT в Gnome-Doc-Utils. Примітно, що каталог XSLT / DocBook містить DocBook XSLT, і XSLT / Gettext містить утиліту XSLT GetText для перекладу автоматичного текст.

Пісочниця /
каталог пісочниці НЕ DISTed, тому він буде з'являються тільки якщо у вас є з CVS. Це майданчик для нових ідей.

Xml2po /
каталог xml2po містить xml2po інструмент, розроблений Данило Шегай для перекладу форматів довільних XML. Він використовується Gnome-Doc-утиліти для перекладу DocBook.

ТЕСТУВАННЯ

Під тестовому каталозі цілий ряд тестів для Gnome-Doc-Utils. Для перевірки системи збірки (гном-док-utils.m4 і гном-док-utils.make), ви можете використовувати будь-який з testdocn (для на позитивне ціле число) каталоги. Вони створюються як скелет дерево вихідних текстів, ведучи точно як реальний проект буде. Крім того, гном-док-утиліти використовує себе будувати свою власну документацію (під ДОС), так гном-док-утиліти саме по собі є випробуванням спеціальних засобів.

Для перевірки таблиць стилів DocBook, використовувати Тест / testdocs каталог. Ці модульні тести з пакету DocBook-testdocs на docbook.sourceforge.net, розробленої Норма і Ко Просто наберіть зробити в цьому каталозі будуть будувати кожен тест. Якщо ім'я тестового файлу foo.001.xml, вихід буде HTML / foo.001 / foo.001.html. Кожен тест зазвичай відчуває невелику кількість елементів, пов'язаних з DocBook. Багато з особливостей DocBook або в XSLT в Gnome-Doc-утиліти не можуть бути перевірені них. Можуть бути додані додаткові випробування; дотримуйтесь інструкцій в тестовому / testdocs / README для цього.

Також корисно для тестування XSLT є перетворення деяких великих документів, що використовують його. Керівництво користувача Gnome і Gnumeric Керівництво та служити прекрасним тестом документи.

ЗЛОМ

На відміну від більшості програм C, що працюють на багато гномів-Doc-Utils дійсно пов'язані ізольовані додаткові поліпшення. Там немає ніякого способу, щоб дати короткий перелік загальних рисах в списку TODO.

Для роботи на будівельних інструментів (Gnome-док-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-Utils. Не соромтеся працювати на xsldoc, а також. Документація генерується xsldoc входить в керівництві по DOC / XSLT

Що нового У цьому випуску :.

• Виправлена Проблема з дист і встановити занадто багато файлів
• Оновлено переклади:
• км (Morn Met)

Що нового у версії 0.20.9:

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

Що нового у версії 0.20.6:

• Оновлене крижні схеми
• Виправлена ​​"зробити горщик" правилом для крижні
• Оновлено переклади:
• Ca (Jordi Серратос)
• ES (Хорхе Гонсалес, Даніель Mustieles)
• мкг (Abduxukur Abdurixit)

Що нового у версії 0.20.5:

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

Що нового у версії 0.20.3:

• Виправлена ​​вкладений підстановки команд в GNOME-Doc-утиліти .make (Chris Coleman)
• Оновлено переклади:
• Ca @ Валенсія (Карлес Ferrando)
• де (Christian Кірбі)
• де (Mario Blattermann)
• El (Michael Kotsarinis)
• ES (Jorge Gonzalez)
• ET (Івар Смолін)
• FA (Махьяр Moghimi)
• FR (Bruno Brouard)
• GL (Fran Dieguez)
• SL (Матей Urbancic)
• мкг (Gheyret T.Kenji)

Що нового у версії 0.20.2:

• Оновлено переклади:
• де (Mario Blattermann)
• RU @ Шоу (Thomas Турман)
• ES (Jorge Gonzalez)
• FR (Geode)
• GL (Fran Dieguez)
• він (Ярон Shahrabani)
• Ху (Gabor Kelemen)
• ID (Dirgita)
• JA (Такаюкі Kusano)
• LV (Rudols Mazurs)
• SL (Андрій Znidarsic)
• zh_CH (Aron Xu)