的gnome-DOC-utils的套餐中包含的Gnome项目文档实用程序的集合。值得注意的是,它包含的实用程序建立文档和源代码树的所有辅助文件,它包含曾经散发着Yelp的是,DocBook的XSLT样式表。与侏儒2.8开始,Yelp的需要的gnome-DOC-utils的为XSLT。
组织
测试/
测试目录中包含了一些测试GNOME -doc-utils的。形式testdocn,其中n是一个正整数,的目录是含有文档骨架源树,与相同的布局,将被用于由实际的项目。该testdocs目录包含从DocBook-testdocs,通过规范和公司的泛银河系的DocBook样式表开发的单元测试。一个额外的README文件是在该目录中,给上延长或更改任何文件的说明的gnome-DOC-utils的CVS。
DOC /
的doc目录包含GNOME-DOC文档-utils。在大多数情况下,GNOME-DOC-utils的需要建立自己的文档。机制到位的引导。
XSLT /
的XSLT目录包含所有的gnome-DOC-utils的对XSLT的。值得注意的是,XSLT / DocBook的目录中包含的DocBook XSLT和XSLT / gettext的包含XSLT的gettext实用程序自动翻译文本。
沙盒/
沙箱目录不DISTed,所以它会只有当你有一个CVS签出现。这是一个游乐场的新思路。
xml2po /
的xml2po目录包含达尼洛Segan为任意的XML格式转换开发的xml2po工具。它用于GNOME-DOC-utils的用于DocBook的翻译。
测试
在test目录一些测试的gnome-DOC-utils的。为了测试生成系统(GNOME-DOC-utils.m4和gnome-doc的-utils.make),你可以使用任何testdocn的(NA为正整数)的目录。这些被设置为骨架的源代码树,正好表现为将一个真实的项目。此外,GNOME-DOC-utils的使用自己建立自己的文档(doc下),因此GNOME-DOC-utils的本身的构建工具进行测试。
要测试的DocBook样式表,使用测试/ testdocs目录。这些单元测试是从的docbook-testdocs包上docbook.sourceforge.net,通过规范和公司简单地输入make在该目录将建立每个测试开发。如果测试文件的名称是foo.001.xml,输出将是HTML / foo.001 / foo.001.html。每个测试通常测试少数相关DocBook的元素。许多的DocBook在XSLT或功能的gnome-DOC-utils的可能不被这些测试。附加试验可以加入;按照测试/ testdocs / README的说明这一点。
用于测试XSLT也有用是将使用它的一些大的文件。在GNOME用户指南和手册的Gnumeric既作为优秀的测试文档。
黑客入侵
不像大多数C语言编程,工作在大部分的gnome-DOC-utils的确实涉及隔离逐步改善。有没有办法让一个TODO列表的广泛功能的短名单。
要在构建工具(GNOME-DOC-utils.m4和gnome-doc的-utils.make),建测试文档,看看有什么不工作。 GNOME-DOC-utils.make拥有所有应该得到充分支持的高层次目标的清单。
要对DocBook的XSLT,发现尚未实现的元素,并实现它。如果你有XML斯塔利特(xmlstar.sourceforge.net)安装,您可以键入XSLT / DocBook的/ html目录来获得
什么元素都实现了一个很好的HTML报告“做出report.html”。也有此目录需要做不能抓到report.html比赛非常简洁列表中TODO文件。
注意,XSLT是记录内嵌名为xsldoc,这本身就是GNOME-DOC-utils的一部分。随意在名为xsldoc正常工作。通过名为xsldoc产生的文档包含在文档/ XSLT手册中
什么在此版本中是新的:
- 在固定问题DIST并安装了太多的文件
- 在更新翻译:
- 公里(晨星MET)
什么版本0.20.9是新的:
- 在暂时补充RNG文件回来的兼容性。现在,RNG文件不再叫(为0.20.8)时,RNG文件将被再次过渡期后取出。
什么的0.20.6版本是新的:
- 在更新野鸭模式
- 修正了使锅'规则野鸭
- 在更新翻译:
- 在CA(尔迪Serratosa)
- 在ES(豪尔赫·冈萨雷斯,丹尼尔Mustieles)
- 在UG(Abduxukur·阿不都热西提)
什么的0.20.5版本是新的:
- 在更新野鸭RNG文件
- 在更新翻译:
- 在为(Amitakhya Phukan)
- 在bn_IN(鲁纳尔吉)
- 在EO(克里斯蒂安SCHMIDT)
- 在ES(豪尔赫·冈萨雷斯)
- 在区(Sweta科塔里)
- 或(马诺·库马尔·吉里)
什么是0.20.3版本,新的:
- 在固定嵌套命令替换的gnome-DOC-utils的。使(克里斯·科尔曼)
- 在更新翻译:
- 在CA @瓦伦西亚(普约尔FERRANDO)
- 在德(基督教Kirbach)
- 在德(马里奥Blattermann)
- 在EL(迈克尔Kotsarinis)
- 在ES(豪尔赫·冈萨雷斯)
- 在等(伊瓦尔·斯莫林)
- 在FA(Mahyar Moghimi)
- 在FR(布鲁诺Brouard)
- 在GL(弗兰Dieguez)
- 在SL(马捷Urbancic)
- 在UG(Gheyret T.Kenji)
什么的0.20.2版本是新的:
- 在更新翻译:
- 在德(马里奥Blattermann)
- 在恩@肖(托马斯·瑟曼)
- 在ES(豪尔赫·冈萨雷斯)
- 在FR(的Geode)
- 在GL(弗兰Dieguez)
- 在他(亚龙Shahrabani)
- 在胡(的Gabor Kelemen填入)
- 在ID(Dirgita)
- 在JA(草野隆行)
- 在LV(Rudols Mazurs)
- 在SL(安德烈Znidarsic)
- 在zh_CH(阿隆徐)
评论没有发现