Qt Assistant是Qt自帶的一款可定制、可重新發(fā)行的幫助文件瀏覽器。Qt Assistant支持HTML文件,用戶可以利用其定制自己的功能強(qiáng)大的幫助文檔瀏覽器。關(guān)于Qt Assistant定制的資料主要是Qt Assistant自身所帶的英文文檔,雖然講解比較詳細(xì),但是對(duì)于初學(xué)者來(lái)說(shuō)難以快速的入手。因此結(jié)合具體實(shí)踐,對(duì)Qt Assistant定制的過(guò)程進(jìn)行整理,希望對(duì)他人能有所啟發(fā)。

定制過(guò)程中用到qhp,qch,qhcp,qhc四種不同格式的文件。對(duì)于這四種文件,初學(xué)者可能會(huì)經(jīng);煜V辽傥以陂_(kāi)始用的時(shí)候,一頭霧水。首先講解一下這四種文件格式。這四種文件可以分為兩組:
(1)qhp與qch。qhp是Qt Help Project的縮寫(xiě),qch是Qt Compressed Help的縮寫(xiě)。qhp文件負(fù)責(zé)組織實(shí)際用到的幫助文件(通常為HTML文件,即需要在Qt Assistant中瀏覽的文件),然后通過(guò)qhelpgenerator命令生成壓縮的qch文件。qch文件是Qt Assistant能夠識(shí)別的文檔最小單元,可以通過(guò)Qt Assistant->編輯->首選項(xiàng)->文檔標(biāo)簽頁(yè)->添加/移除操作來(lái)注冊(cè)或者注銷一個(gè)qch文件。也可以通過(guò)命令“assistant -register doc.qch”來(lái)注冊(cè)qch文件。注冊(cè)后,即可在Assistant界面中瀏覽幫助文檔。
(2)qhcp和qhc。qhcp是Qt Help Collection Project的縮寫(xiě),其主要作用是將qch二進(jìn)制文件組織成為一個(gè)collection,定制客戶化的Assistant;而qhc則是通過(guò)qcollectiongenerator命令生成的二進(jìn)制文件,啟動(dòng)Assistant時(shí)需要指定collection參數(shù),即qhc文件。qhc文件中是qch文件的集合,打開(kāi)Assistant時(shí),通過(guò)指定當(dāng)前collection即可注冊(cè)多個(gè)幫助文檔。
從上面文件的解釋看,我們需要手動(dòng)完成兩個(gè)文件即qhp和qhcp文件,通過(guò)這兩個(gè)文件再生成最終需要的qch和qhc文件。qhp和qhcp文件都是XML文件,語(yǔ)法比較簡(jiǎn)單,這里不對(duì)語(yǔ)法進(jìn)行詳細(xì)介紹,具體可查看Qt Assistant幫助文檔。下面結(jié)合我在項(xiàng)目中對(duì)Assistant定制的過(guò)程進(jìn)行總結(jié),并給出了用到的qhp和qhcp文件的內(nèi)容,這樣更有助于從整體上對(duì)該過(guò)程進(jìn)行把握。
(1)制作HTML的幫助文件。由于原來(lái)的幫助文檔是利用Word完成的,因此需要轉(zhuǎn)換。轉(zhuǎn)換的過(guò)程十分簡(jiǎn)單,即便對(duì)HTML不了解的用戶也可以輕松完成。目前網(wǎng)絡(luò)上有許多現(xiàn)成的HTML編輯器,利用這些編輯器即可輕松的進(jìn)行編輯生成相應(yīng)的html文件。
(2)編寫(xiě)qhp文件。下面是在項(xiàng)目中用到qhp文件,文件比較簡(jiǎn)單,這里僅用到了基本的功能,具體語(yǔ)法可以查看幫助文檔。這里需要注意的是通過(guò)<section>標(biāo)簽指定幫助文檔目錄,這里可以是多級(jí)目錄,但是Qt中建議不超過(guò)四級(jí)。指定目錄后,需要通過(guò)<file>來(lái)指定所有用到的HTML文件,包括HTML文件中用到的所有圖片。這里如果不指定,生成的qch文件注冊(cè)到Qt Assistant后將不能找到有效的文件進(jìn)行顯示。
<?xml version="1.0" encoding="UTF-8"?>
<QtHelpProject version="1.0">
<namespace>org.mitk</namespace>
<virtualFolder>doc</virtualFolder>
<filterSection>
<toc>
<section title="fMRIAnalyze Tutorial" ref="tutorial.htm">
</section>
</toc>
<files>
<file>tutorial.htm</file>
<file>Tutorial_files/clip_image002.jpg</file>
.....................................................................
<file>Tutorial_files/clip_image072.jpg</file>
</files>
</filterSection>
</QtHelpProject>
(3)生成qch文件。qhp文件完成后,通過(guò)qhelpgenerator命令生成壓縮的qch文件。打開(kāi)cmd,輸入" qhelpgenerator doc.qhp -o doc.qch "。這里doc.qhp為輸入的qhp文件,-o表示輸出,輸出文件名為doc.qch。
(4)編寫(xiě)qhcp文件。qhcp中主要是對(duì)用到的qch文件進(jìn)行組織,項(xiàng)目中用到的一個(gè)簡(jiǎn)單的qhcp文件如下:
<?xml version="1.0" encoding="utf-8" ?>
<QHelpCollectionProject version="1.0">
<docFiles>
<register>
<file>doc.qch</file>
<file>其他的qch文件</file>
</register>
</docFiles>
</QHelpCollectionProject>
從文件中可以看出,只需要在register標(biāo)簽中指定相應(yīng)的qch文件名稱即可。當(dāng)前這里必須確保在qhcp文件目錄下存在指定的qch文件。為了避免因?yàn)橥浬蓂ch文件而造成錯(cuò)誤,qhcp中支持通過(guò)指定qhp文件從一次生成相應(yīng)的qch和qhc文件。格式如下:
<?xml version="1.0" encoding="utf-8" ?>
<QHelpCollectionProject version="1.0">
<docFiles>
<generate>
<file>
<input>doc.qhp</input>
<output>doc.qch</output>
</file>
</generate>
<register>
<file>doc.qch</file>
</register>
</docFiles>
</QHelpCollectionProject>
從以上可以看出,在qhcp文件中多了一個(gè)<generate>標(biāo)簽,并指定了輸入qhp文件,和輸出qch文件。文件里面可以指定多個(gè)qhp和qch,只要注意好文件直接的對(duì)應(yīng)關(guān)系就可以了。
(5)生成qhc文件。通過(guò)qcollectiongenerator命令生成qhc文件,格式如下:“qcollectiongenerator doc.qhcp -o doc.qhc "。這里doc.qhcp文件輸入的qhcp文件,-o表示輸出,doc.qhc為生成的qhc文件名稱。
在編寫(xiě)qhcp文件時(shí),建議采用(4)中的第二種方式,這樣只需要一個(gè)命令即可生成qch和qhc文件,也避免了因?yàn)檫z漏qch文件而造成qhc文件錯(cuò)誤。
(6)運(yùn)行Qt Assistant?梢酝ㄟ^(guò)命令“qassistant -collectionfile doc.qhc”打開(kāi)qassistant,打開(kāi)后即可瀏覽到我們自己的幫助文檔了。當(dāng)然如果是在程序中,可以通過(guò)QProcess來(lái)調(diào)用assistant.exe,并給出相應(yīng)的collectionfile參數(shù)即可。
- PC官方版
- 安卓官方手機(jī)版
- IOS官方手機(jī)版















藍(lán)云工具箱綠色免安裝版v4.3 最新版
酷魚(yú)網(wǎng)掃描端2.0.12178.370 官方版
摸魚(yú)屏保2.0.exe最新版
瘋狂星期四文案最新版1.0 pc電腦版
鳥(niǎo)人云手機(jī)電腦版1.0 官方版
VMOS云手機(jī)電腦版1.1.5.0 官方版
飛智游戲廳電腦版(飛智游戲手柄連接軟件)v2.5.0.7 PC空間站版
fanbook客戶端v1.6.97.1552 官方版
iriun webcam for pc2.8.1 pc版
ElevenClock(win11時(shí)鐘小工具)3.7.0 免費(fèi)版
定時(shí)強(qiáng)制鎖屏軟件1.0 彩蛋版
Windows微信多開(kāi)助手v1.0 C++版
eSearch識(shí)屏搜索1.7.4 免費(fèi)版
電腦助手20220718單文件版免費(fèi)下載
自然人電子稅務(wù)局(扣繳端)V3.1.173 全國(guó)通用版
批量二維碼生成器1.2.0 免費(fèi)版
柜柜PC客戶端(家具設(shè)計(jì))3.4.1.2 官方正式版
剪切板資源捕獲器(抓取下載鏈接工具)1.0.0 免費(fèi)版
我的ABC軟件工具箱6.25.0 官方64位版本
奧維互動(dòng)地圖2025高清衛(wèi)星地圖v9.9.6 X64 電腦版
精銳萬(wàn)能票據(jù)打印軟件4.5.1.0 破解版
滴答清單電腦客戶端4.2.0.1最新版
MveBox(哩嗶哩Blibli解析下載工具)1.0 免費(fèi)版
Simple Allow Copy(萬(wàn)能網(wǎng)頁(yè)復(fù)制插件)0.8.3 最新版
云上越秀電腦版4.5.1.2 官方版
2021吾愛(ài)京東助手520特別版
云屋白板4.9.3.0最新版
今目標(biāo)免費(fèi)版2021版10.3.0.253 官方版
藍(lán)奏云直鏈解析工具1.0綠色版
劃詞搜題工具1.0免費(fèi)版





vidc1.2圖形化端口映射工具
隨機(jī)數(shù)產(chǎn)生工具1.4 最新免費(fèi)版
智騎聯(lián)盟電腦版1.0.1.20170214 官方正式版
篤行局域網(wǎng)評(píng)分軟件3.0 官方版
JD青龍面板管理助手2.9吾愛(ài)專版
貼吧Cookies獲取器1.01 綠色版
動(dòng)漫共和國(guó)PC端1.1.0 最新版
三菱PLC模擬仿真中文軟件(FX-TRN-BEG-CL)1.
定時(shí)重新啟動(dòng)任務(wù)看門(mén)狗1.0 綠色免費(fèi)版