最近更新: 2010-03-09

Publish File to Trac wiki

This tool which written by Ruby language publish file to Trac wiki page. It will read the file content then publish to Trac wiki.

Many people use Trac to trace the software projects. When project execution, we will renew the project's wiki page frequently. However, many contents often are written in other documents. For example the API specification, Java will write by the Javadoc form in the .java source code, Ruby has RDoc, PHP has PHPDoc. The update log will write in the Subversion commit message. “The source code is the document”, these methods are quite universal. Because the document content had already existed, we most effective processing mode is with publish tool to read the file and to publish to the wiki page. Remembers, Copy and Paste is not the job which a professional programmer should do.

有許多人使用 Trac 追蹤軟體專案進度。當專案執行時,我們會頻繁地更新專案的 wiki 頁面。然而,許多要更新到 wiki 的內容,往往是撰寫在其他文件中。例如 API 規格, Java 會以 Javadoc 格式寫在 .java 源碼內, Ruby 有 RDoc, PHP 有 PHPDoc 。源碼更新訊息與交辦事項,會寫在 Subversion 的簽入訊息(commit message)。「源碼即文件」,這些作法是相當普遍的。由於文件的內容已經存在了,我們最有效率的處理方式,就是用發佈工具,讀取檔案後發佈到 wiki 頁面上。記住,剪貼與複製並不是一位專業程序員應該做的事。

樂多舊網址: http://blog.roodo.com/rocksaying/archives/11913027.html