Generare file CHM

I file CHM consentono di immagazzinare e indicizzare più file HTML in un unico archivio in modo che siano facilmente consultabili e trasportabili. Essi sono per lo più usati in ambiente Windows per documentare programmi e librerie (file di help, manuali di riferimento etc.) ma vengono spesso utilizzati anche per trasportare libri, lezioni, presentazioni e altro ancora. Tra le caratteristiche principali che hanno reso questo formato così popolare troviamo il fatto di essere compresso, di consentire una veloce ricerca dei contenuti grazie alla loro indicizzazione interna e di sfruttare la ricchezza e semplicità del linguaggio HTML.

Per creare dei CHM è necessario scaricare HTML Help Workshop dal sito della Microsoft. Quello che ci serve è il file "htmlhelp.exe" e opzionalmente la documentazione HelpDocs.zip. Dopo di che dobbiamo attivare nel Doxyfile l'opzione "GENERATE_HTMLHELP" impostandola su "YES" e specificare il nome del file CHM alla voce "CHM_FILE".

Una volta eseguito Doxygen con queste opzioni troveremo nella directory che contiene il codice HTML anche un file con estenzione ".hhp". Effettuando un doppio click su di esso HTML Help Workshop si aprirà automaticamente. A questo punto non dobbiamo far altro che premere sul bottone "Compile HTML file", confermare l'operazione ed aspettare che venga generato il nostro CHM.