2011-03-25 55 views
0

我們需要編譯爲QtHelp(.qch和.qhc)。我想知道什麼工具/工具鏈對此最簡單?我們希望所見即所得的幫助創作工具作爲我們的出發點,然後通過無論我們必須獲得的QtHelp來運行輸出。wysiwyg用戶幫助創作工具與qthelp一起工作?

我們已經在過去使用過幫助&手冊,這就是我們在幫助創作工具中尋找的所見即所得界面。但是我們需要工具鏈生成簡單的html頁面(每個幫助主題一個),我們可以使用qhelpgeneratorqcollectiongenerator,以及創建.qhp(至少包含目錄和關鍵字部分)和.qhcp以生成.qch和.qhc。我沒有看到如何幫助手冊可以適應此。

我們簡單看了斯芬克斯,但它似乎有非常有限的文本格式選項。例如,它看起來沒有任何方法可以更改文本部分的字體,字體大小,字體顏色等。看起來實際上不可能有粗體和斜體的文本。看起來非常適合開發人員的文檔,但似乎缺少編寫用戶幫助文件的基本內容。如果我錯過了基本的文本格式功能,請糾正我的錯誤!

那麼,你推薦什麼所見即所得的幫助創作工具,那個工具到.qch和.qhc的路徑是什麼?

回答

0

看起來像幫助和手冊將工作畢竟!這是我們現在看的順序。如果您發現有任何問題或可以改進的地方,請點評。

在幫助&手冊(與版本5.5.1構建1296專業執照測試),在項目資源管理器,在配置部分:

轉到HTML頁面模板\默認。在HTML源代碼標籤中,註釋掉該部分。

轉到發佈選項\ Web幫助。

在佈局中,選擇無框架,無腳本。

在導航中,我們不需要任何檢查 - 雖然如果有一種方法可以控制KEYWORD_INDEX值的格式,以便我們可以直接複製並粘貼到我們的.qhp中,那太棒了!我還沒有找到辦法做到這一點,所以我們打算直接在.qhp中維護關鍵字。

同樣,目錄也是不相關的,除非我們可以控制格式,我們必須直接在.qhp中維護toc。

在Popup Topics中,我們設置爲HTML編碼主題。不知道這是否有必要。

這就是我們必須改變的所有設置。正常情況下在H & M中創建幫助內容,然後發佈Webhelp。這將爲每個主題創建一個單獨的.htm文件。

在與.htm相同的文件夾中,我們創建了.qhp和.qhcp文件,然後運行qcollectiongenerator生成我們的.qhc,然後使用Qt Assistant顯示.qhc。請參閱http://doc.qt.nokia.com/4.7/qthelp-framework.html以獲取此工具鏈Qt一側的幫助。

如果我們能夠找到一種方法來設置H & M以創建toc和關鍵字所需的格式,那將是一件好事。qhp,我們可以將它們粘貼到.qhp中(或者也可以在該模板中保存.qhp)。另一個選擇是編寫一個腳本,以便將創建的tooc和關鍵字的內容轉換爲.qhp所需的內容。如果你這樣做,不介意分享,請發佈代碼!

我們發現使用H & M至解決這個問題的一些好處:

  • 多資料員可同時工作,並且源存儲在Subversion中的文本文件,所以它是多版本,你可以比較的變化。
  • 易所見即所得創建幫助主題
  • 可以處理各種文本格式和鏈接。例如,在對功能進行端到端測試以查看H & M的哪些功能可用於我們的最終產品(在Qt助手中查看.qhc)時,我驚訝地發現Qt Assistant甚至在圖像鏈接中處理熱點到其他主題/主播。
  • .qhc已集成到Qt中,因此您可以很好地控制Qt應用程序中的幫助。

再一次,如果有人對此有更好的解決方案或改進,請發佈!

0

使用Helpinator 3 Professional它是generat chm qt javahelp word pdf文件easly ..