gnome-doc-utils

gnome-doc-utils gói có chứa một bộ sưu tập các tiện ích tài liệu cho các dự án Gnome. Đáng chú ý, nó chứa các tiện ích để xây dựng tài liệu hướng dẫn và tất cả các tập tin phụ trợ trong cây mã nguồn của bạn, và nó chứa các stylesheets XSLT DocBook rằng một khi đã được phân phối với Yelp. Bắt đầu với Gnome 2.8, Yelp sẽ yêu cầu gnome-doc-utils cho XSLT.

TỔ CHỨC
test
/
thư mục kiểm tra có chứa một số bài kiểm tra cho gnome -doc-utils. Thư mục của testdocn hình thức, trong đó n là một số nguyên dương, là cây xương nguồn chứa tài liệu, với cách bố trí tương tự mà sẽ được sử dụng bởi các dự án thực tế. Các thư mục testdocs chứa các đơn vị xét nghiệm từ docbook-testdocs, được phát triển bởi Norm và Công ty cho các pan-thiên hà DocBook stylesheets. Một tập tin README thêm là trong thư mục đó, có những chỉ dẫn về việc gia hạn hoặc thay đổi bất kỳ tập tin trong gnome-doc-utils CVS.

Doc /
thư mục doc chứa tài liệu cho gnome-doc -utils. Trong hầu hết các trường hợp, gnome-doc-utils là cần thiết để xây dựng tài liệu hướng dẫn của nó. Cơ chế được đưa ra cho bootstrapping.

XSLT /
thư mục XSLT chứa tất cả các XSLT trong gnome-doc-utils. Đáng chú ý, các thư mục XSLT / docbook chứa DocBook XSLT, và XSLT / gettext chứa các tiện ích XSLT gettext để dịch văn bản tự động.

Sandbox /
thư mục sandbox không DISTed, do đó nó sẽ chỉ xuất hiện nếu bạn có một kiểm tra CVS. Đó là một sân chơi cho những ý tưởng mới.

Xml2po /
Các thư mục có chứa các công cụ xml2po xml2po phát triển bởi Danilo Segan cho bản dịch của định dạng XML tùy ý. Nó được sử dụng bởi gnome-doc-utils cho DocBook dịch.

KIỂM

Dưới thư mục kiểm tra là một số bài kiểm tra cho gnome-doc-utils. Để kiểm tra các hệ thống xây dựng (gnome-doc-utils.m4 và gnome-doc-utils.make), bạn có thể sử dụng bất kỳ testdocn (na cho số nguyên dương) thư mục. Chúng được đặt lên cây nguồn như bộ xương, hành xử chính xác như một dự án thực tế sẽ. Ngoài ra, gnome-doc-utils sử dụng riêng của mình để xây dựng tài liệu hướng dẫn riêng của nó (dưới doc), vì vậy gnome-doc-utils chính nó là một thử nghiệm của các công cụ xây dựng.

Để kiểm tra các stylesheets DocBook, sử dụng thử nghiệm / testdocs thư mục. Những bài kiểm tra đơn vị là từ gói docbook-testdocs trên docbook.sourceforge.net, được phát triển bởi Norm và Công ty Đơn giản chỉ cần gõ làm trong thư mục đó sẽ xây dựng mỗi bài kiểm tra. Nếu tên của file test là foo.001.xml, sản lượng sẽ được html / foo.001 / foo.001.html. Mỗi bài kiểm tra thường kiểm tra một số nhỏ các nguyên tố DocBook liên quan. Nhiều người trong số các tính năng của DocBook hoặc của XSLT trong gnome-doc-utils có thể không được kiểm tra bởi các. Thử nghiệm bổ sung có thể được thêm vào; thực hiện theo các hướng dẫn trong bài kiểm tra / testdocs / README cho điều đó.

Cũng hữu ích để thử nghiệm các XSLT là chuyển đổi một số tài liệu lớn bằng cách sử dụng nó. Hướng dẫn sử dụng Gnome và Sổ tay Gnumeric cả phục vụ tài liệu thử nghiệm là tuyệt vời.

HACKING

Không giống như hầu hết các lập trình C, làm việc trên nhiều gnome-doc-utils thực sự không liên quan đến cô lập cải tiến gia tăng. Không có cách nào để đưa ra một danh sách ngắn các tính năng mở rộng trong một danh sách TODO.

Để làm việc trên các công cụ xây dựng (gnome-doc-utils.m4 và gnome-doc-utils.make), xây dựng tài liệu kiểm tra và xem những gì không làm việc. gnome-doc-utils.make có một danh sách của tất cả các mục tiêu cấp cao cần được hỗ trợ đầy đủ.

Để làm việc trên DocBook XSLT, tìm một phần tử Chưa thực hiện và thực hiện nó . Nếu bạn có XML Starlet (xmlstar.sourceforge.net) được cài đặt, bạn có thể gõ "làm report.html 'trong XSLT / docbook / html thư mục để có được một báo cáo HTML
tốt đẹp trên các yếu tố được thực hiện. Ngoài ra còn có một tập tin trong thư mục này TODO với một danh sách rất ngắn gọn của trận đấu mà cần phải được thực hiện mà không thể được đánh bắt bởi report.html.

Lưu ý rằng XSLT là tài liệu nội tuyến với xsldoc, đó chính là một phần của gnome-doc-utils. Cảm thấy tự do để làm việc trên xsldoc là tốt. Các tài liệu được tạo bởi xsldoc được bao gồm trong hướng dẫn dưới doc / XSLT

là gì mới trong phiên bản này:.

• Cố định vấn đề với quận và cài đặt với quá nhiều tập tin
• dịch Cập nhật:
• km (Morn Met)

là gì mới trong phiên bản 0.20.9:

• Tạm thời thêm RNG file lại để tương thích. Bây giờ các tập tin RNG không còn được gọi là (như của 0.20.8), các tập tin RNG sẽ bị gỡ bỏ lại sau một thời gian chuyển tiếp.

là gì mới trong phiên bản 0.20.6:

• schema Mallard cập nhật
• Fixed 'làm nồi' quy tắc cho Mallard
• dịch Cập nhật:
• ca (Jordi Serratosa)
• es (Jorge Gonzalez, Daniel Mustieles)
• ug (Abduxukur Abdurixit)

là gì mới trong phiên bản 0.20.5:

• Cập nhật tập tin Mallard RNG
• dịch Cập nhật:
• như (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• eo (Kristjan Schmidt)
• es (Jorge Gonzalez)
• gu (Sweta Kothari)
• hoặc (Manoj Kumar Giri)

mới trong phiên bản 0.20.3 là gì:

• Cố định lệnh lồng nhau thay thế trong gnome-doc-utils .make (Chris Coleman)
• dịch Cập nhật:
• ca @ valencia (Carles Ferrando)
• de (Christian Kirbach)
• de (Mario Blattermann)
• el (Michael Kotsarinis)
• es (Jorge Gonzalez)
• et (Ivar Smolin)
• fa (Mahyar Moghimi)
• fr (Bruno Brouard)
• gl (Fran Dieguez)
• sl (Matej Urbancic)
• ug (Gheyret T.Kenji)

là gì mới trong phiên bản 0.20.2:

• dịch Cập nhật:
• de (Mario Blattermann)
• en @ shaw (Thomas Thurman)
• es (Jorge Gonzalez)
• fr (Geode)
• gl (Fran Dieguez)
• ông (Yaron Shahrabani)
• hu (Gabor Kelemen)
• id (Dirgita)
• ja (Takayuki Kusano)
• lv (Rudols Mazurs)
• sl (Andrej Znidarsic)
• zh_CH (Aron Xu)