的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(阿隆徐)
評論沒有發現