關於利用Qt編寫應用程序的幫助文檔

轉載請註明出處!


關於利用Qt編寫應用程序的幫助文檔

首先推薦Qt官網的example 官網的例子講的很細緻很全面,不過官網的例子全是英文的。百度文庫裏有對這個例子的翻譯,我也看了一下,感覺還不如去看英文的。好的言歸正傳。

講一下大概的步驟

1、準備.html文件(裏面就是我們大家經常看到的關於應用程序的文字說明)

2、編寫.qhp文件(來管理你的html文件)

3、調用qhelpgenerator 將.qhp文件編譯成.qch文件

(如果你只希望自己編寫的幫助文檔在Qt Assistant裏查看的話,到這就可以了)

4、編寫.qhcp文件(來管理你的.qch文件,其實在這就可以製作自己的assistant了)

5、調用qcollectiongenerator 將.qhcp文件編譯成.qhc文件

6、調用assistant 運行你自己製作的assistant

 

<1>準備.html文件

對於這個步驟,對於有些孩子沒難度,不過還是要說一下。因爲我一開始就不懂怎麼弄。製作html文件有很多方法,我只說我是怎麼弄的,別的方法我沒試過哦,用wps新建一個文字文檔,在裏面書寫你想對應用的說明(可以設置超鏈接)。然後在編寫好說明文檔之後,點擊文件另存爲.html文件就可以了。是不是很簡單啊!

2、編寫.qhp文件

講一下這個文件的作用吧。這個文件幹嘛的呢?最簡潔個回答就是管理。Html文件,其實在叫我解釋我不知道怎麼解釋了。我們可以通過Qt Assistant來直觀的接觸一下吧,打開Qt Assistant (位置一般在Qt安裝目錄的bin下面),點擊菜單欄上的Edit 選擇看到最後一行Preferences 彈出如圖的對話框

 

你可以看到Doucumentation,選擇他,點擊Add彈出讓你選擇文件,你可能我是說可能啊!不知道要選擇什麼文件,我是在ubuntu系統下弄的,所以window不知道,沒有試過,

/usr/share/qt4/doc/qch/  點到這看到了吧東西了吧對的就是.qch文件。你可以選擇qt.qch看看,看看點擊ok 你可以發現在Qt Assistant Qt的幫助手冊!對的,這一步你編寫的文件就是這個。有點太羅嗦了。

新建.qhp文件在linux是直接vim 來新建的後綴 **.qhp就可以了。

好吧我直接把我自己寫的.qhp文件貼出來吧!本人語言有點錯亂,注射講的不好,多多包含。

 

 

 

到這,你就就可以在命令行輸入:qhelpgenerator ** .qhp -o **.qch

這樣就可以生產.qch文件了,按上面個步驟可以將你自己製作的.qch文件添加到Qt Assistant

裏面。

3、編寫qhcp文件

這個文件主要是對.qch文件進行管理,其實就相當於一個Assistant,直接上代碼吧,多的我也講的不專業。文章最先面有相關文章的連接,裏面對每個文檔都有比較詳細的講解!我也是查看他們的文章做的,不過激勵推薦官網的例子!

 

編寫好qhcp文件就可以生成qhc文件了在命令行輸入:qcollectiongenerator **.qhcp-o qhc

這樣就生成qhc文件了。

最後運行QtAssistant 命令:assistant-collectionFile **.qhc 這樣就可以打開你自己編寫的幫助文檔了!是不是感覺很好玩啊!

最後還有一步其實,那家是將這個幫助文檔可以在我們自己編的應用程序的help查看,還是貼個代碼吧

 

特別注意在調用.qhc文件的路徑問題!

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章