看起來像幫助和手冊將工作畢竟!這是我們現在看的順序。如果您發現有任何問題或可以改進的地方,請點評。
在幫助&手冊(與版本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應用程序中的幫助。
再一次,如果有人對此有更好的解決方案或改進,請發佈!