Re: [Doxygen-users] Zooming text in doxygen chm file

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

On Sat, Mar 22, 2014 at 8:00 AM, Albert <alb...@gm...> wrote:

> My experience (Windows 7 IE9) with the different chm files:
> - doxygen font button present but doesn't do anything, <cntrl>++ etc don't
> do anything
> - total commander font button works, <cntrl>++ etc don't do anything
> Enable "Options" -> "Internet Options .." -> "General" -> "Accessibility"
> -> "Ignore font sizes specified on webpages":
> - doxygen font button works, <cntrl>++ etc don't do anything
> - total commander font button works, <cntrl>++ etc don't do anything (no
> change)
> Had a look at the total commander chm file and content but didn't see
> something that makes the "Font button" work. I also studied the links TP
> supplied (thanks) but no new insights except the sentence "*Note:  * If
> you check *Zoom*, also specify relative units for font sizes in CSS; see §9.4.1
> *Using CSS and font tags with HTML Help*<http://www.mif2go.com/xhtml/htmlhelp_0014_941usingcssandfonttagswithhtmlhelp.htm#Rz108x49537>."
> from the first reference, but could not find anything how to apply this.
>
> Albert
>
>
> On Sat, Mar 22, 2014 at 3:07 PM, TP <wi...@gm...> wrote:
>
>>
>> On Sat, Mar 22, 2014 at 3:42 AM, Maciej W <tri...@gm...> wrote:
>>
>>> Ctrl++/- fail for me in the standard Windows CHM viewer while the
>>> doxygen help file is opened (Windows XP SP3). Also, the Font button is
>>> visible, but nothing happens upon clicking on it.
>>
>>
>> Just tried the doxygen 1.8.6 CHM, and Ctrl++/Ctrl+-/Ctrl+0 (reset font
>> size) work for me on Windows 7 (and IE11 which I believe is what actually
>> displays the pages?). You have to make sure to first click in the main area
>> of the CHM viewer to set the keyboard focus --- otherwise the focus by
>> default is the left side Contest/Search/Favorites area and those keys won't
>> work.
>>
>> You are right, the Font button is visible but does nothing.
>>
>
>
[Resending to list]

I decompiled the doxygen 1.8.6 CHM (but had to create my own .hhp project
file because I guess that doesn't get decompiled?). Anyway, what "22.8.3
Specifying CSS size values and units of measurement" [1] says is:

"
if you are generating HTML Help and you want to enable the Font
   button on the toolbar, font sizes are best expressed in em
   units. Relative units (em, ex, and %) are based on whatever absolute
   unit (pt, pc, in, cm, mm, or px) is used for the font-size property
   of the <body> tag entry;
"

So, I just modified doxygen_manual.css and changed:

   body, table, div, p, dl {
           font-family: Lucida Grande, Verdana, Geneva, Arial, sans-serif;
           font-size: 13px;
           line-height: 1.3;
   }

to:

   body, table, div, p, dl {
           font-family: Lucida Grande, Verdana, Geneva, Arial, sans-serif;
           line-height: 1.3;
   }

Regenerating the CHM then makes the Font size button work (and Ctrl+= or
Ctrl++,Ctrl+-,Ctrl+0 still work). And by doing the little trick mentioned
in "Adding tabs and toolbar buttons to HTML Help" [2] I also added the Next
/ Previous buttons. that allow the use of the Alt+Down / Alt+Up keys.

BTW, you can use F6 to switch the focus between the Navigation pane and the
main window.

It would probably be better to change all font-size specifications in the
.css from px to em but doing only the above basically works (I didn't check
very carefully).

[1]
http://www.mif2go.com/xhtml/htmlcss_0030_2283specifyingcsssizevaluesandunitsofmeasurement.htm#Rz121x63678

[2]
http://www.mif2go.com/xhtml/htmlhelp_0016_943addingtabsandtoolbarbuttonstohtmlhelp.htm#Rz108x95873