OT: V cem psat helpy

Radek Benedikt benedikt na lphard.cz
Neděle Duben 20 00:01:25 CEST 2014


Ahoj,

	Divam se, ze se tady debata zjednodusila na html/pdf. Jenze ten Windows
help ma sice dost spolecneho s html, ale ciste html to neni. Nese si to
filozofii windows helpu z doby windows 3.0. A tam moc internetu nebylo.
Ten help je kompilovany, indexovany,...
	Par dni zpatky tady probehla diskuze o cteckach knih. A z ni docela
jednoznacne vypadlo, ze na pdf je potreba zarizeni s vystupnimi
moznostmi formatu do jakeho to bylo "vytisteno". Tj. na A4 knihu
nejradeji neco velikosti "A4". Zmensit to na format uhlopricky 6" je
mnohdy neresitelny problem. To jen na okraj samospasitelnosti pdf
formatu.
	Kdyz zustanu u tech ctecek, tam se pouziva jako nativni format
napr. .epub. A ten je prave neco podobneho jako ten Microsofti help. Je
to a neni to html. Je to sada stranek v html, zabalenych do jednoho
souboru s pridanymi dalsimi daty.
	Jinak k tomu DocBooku, je to cistokrevne xml, takze konverze do html
helpu vcetne podpory "pridane" inteligence v nem je. Jen je potreba z
neho kromne cistych dat pri konverzi, tj. tech html stranek dostat i tu
"inteligenci". A tam se ve finalu zavola MS help compiler na ktery se tu
tazatel puvodne ptal. Oni ty soubory mohou byt navic i komprimovane.
	MS kompiler byl (zda je i nyni nevim) soucasti SDK pro Windows. A byl i
soucasti kompilatoru C od MS (tam tusim bylo pribaleno SDK) a od
Borlandu (jeste kdyz psal prekladace). Divil bych se, ze by dnes v
aktualni verzi nebyl soucasti Visual Studia.
	Jenze dnes je tam preklad z xml/html formy tech zdrojovych kodu helpu
ne z rtf. Zda to rtf zdrojaky umi i dnes netusim.

Pokud ocituji samotny MS 
http://msdn.microsoft.com/en-us/library/ms524279(v=vs.85).aspx:

> An HTML help project (.hhp) file is a text file that brings together
> all the elements of a help project. It contains the data HTML Help
> Workshop needs to combine topic (.html, .htm), image
> (.jpeg, .gif, .png), index (.hhk), and contents (.hhc) files into a
> single compiled help (.chm) file.



	Radek (benedikt2hw.cz)

> Resite nepodstatne. Pokud se manual napise v DocBooku, neni problem ho
> prevest do PDF/HTML/cokoliv.
> Kouknete na wikipedii: "Mezi výhody DocBooku patří možnost konverze
> dokumentů do dalších formátů jako HTML, PDF, RTF, HTML Help a
> dalších."




Další informace o konferenci Hw-list