This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.
| Summary: | help font size way too small | ||
|---|---|---|---|
| Product: | usersguide | Reporter: | Patrick Keegan <pkeegan> |
| Component: | Code | Assignee: | Irina Filippova <ifilippova> |
| Status: | RESOLVED FIXED | ||
| Severity: | blocker | CC: | kganfield, vvg |
| Priority: | P3 | ||
| Version: | 6.x | ||
| Hardware: | All | ||
| OS: | All | ||
| Issue Type: | DEFECT | Exception Reporter: | |
| Attachments: |
screenshot of small font size
Small font size in help after changes: NetBeans IDE Dev (Build 200905051401) A clip from smallhelpfont.jpg Help fontsize Patrick, on my Vista x64 a default font size on the Help pages is larger! 6.5 help compared to 6.7 help build 200905200201 on Solaris 10 resubmit, 6.5 help compared to 6.7 help build 200905200201 on Solaris 10 help size: NetBeans 6.9 M1 build on Win XP |
||
|
Description
Patrick Keegan
2009-04-17 16:36:11 UTC
Created attachment 80374 [details]
screenshot of small font size
Changing ide.css can't break the status of the issue #32667. Because, the fix only adds possibility to set up a default font size for the help content pane of the Help window. So, the help content pane will display a font with a size that is the the same as for other UI components of the NetBeans until another style will be specified and associated with elements (<body>, <p>, <h1> ...) of the displayed page. Current implementation of the http://hg.netbeans.org/main/file/e4c589c3b55b/csl.api/src/org/netbeans/modules/csl/hints/infrastructure/ide.css establishes that only the style h3 has font-size: medium, i.e. only text with the style h3 will be displayed with a default font size, For instance, please compare the text <h3>Using the Index</h3> and the text used by the labels on the Contents tab (e.g. "Legal Notices") in the attached picture. OK. That's fine. Then the CSS should probably be reverted back to what it was. The font size is way to small in the help. In the usersguide\javahelp\org\netbeans\modules\usersguide\ide.css - changed the following attributes:
Line 28: body {font-size: medium;
Line 35: p {font-size: medium;
Changing the font size attributes in the ide.css file to <medium>:
Line 28: body {font-size: medium;
Line 35: p {font-size: medium;
did not help. The default font size remains way too small (see the following attachment from dev 6.7 build 200905051401).
Guys, can you help with any suggestions?
Created attachment 81936 [details]
Small font size in help after changes: NetBeans IDE Dev (Build 200905051401)
in mac os x, font size in recent builds [eg 200905110201] seem fine to me Created attachment 81948 [details]
A clip from smallhelpfont.jpg
Please, look in the clip attached by me... Font size used in the paragraph is the same as a system font size used for the labels on the Contents tab. Now, you can choose desired default font size in the system and the same font size will be used on the help pages. From my viewpoint this issue is resolved. I still get a paragraph font size that is smaller than what appears on the tabs in the viewer, much like what is in Irina's screenshot. BTW, what's the correct place to change the css. I had tried the copy in usersguide, which all of the help topics point to. Should it be http://hg.netbeans.org/main/file/e4c589c3b55b/csl.api/src/org/netbeans/modules/csl/hints/infrastructure/ide.css instead? To have an effect with the font sizes you need change a CSS associated with your HTML help page.
See a tag in your HTML help page like this:
<html>
<head>
<link rel="stylesheet" href="../ide.css" type="text/css">
...
In the example above, you need make changes in the ../ide.css file.
Note, a linked CSS file should be always accessible at the run-time for any configuration of the NetBeans IDE/RCP when a
module containing the help page is installed. So, you can use the following URI if there are guaranties that the
usersguide module will be also installed at the run-time:
nbdocs://org.netbeans.modules.usersguide/org/netbeans/modules/usersguide/ide.css
The usersguide module is always installed in NB IDE distros, even if the IDE is running in ergonomics mode (I just checked in today's build), and all help pages link to it. And nbdocs://org.netbeans.modules.usersguide/org/netbeans/modules/usersguide/ide.css defines <p> and <body> to use medium (I also confirmed that in the build). Yet, at least on Vista, the font size for body text is definitely smaller than the font in the window tabs. Do you see smaller font on your pages only or all pages have the same wrong font size for body text too? all topics that I click on have this problem. I have tried topics in 5 help sets (usersguide, ruby, java.helpset, j2ee, apisupport) I've noticed that font family used in body of the help pages is different from other UI components of the IDE. May be it is only a visual effect when font of the text on the help pages is visible as with smaller size, because it belongs to a different family? On my system (Win XP) it seems that the help default fontsize is the same as that of NetBeans UI controls and e.g. menu items in Mozilla FF - see the attached screenshot. Victor, do you think it would be possible to do smth with ide.css file to increase the default help fontsize? Created attachment 82108 [details]
Help fontsize
I guess we already have a default font size in both bodies and paragraphs after specifying it as "medium". Because, the medium font size is defined as a default font size in the CSS specification. Note, if we use default values for the font styles then any issues on the particular platforms may be addressed to these platforms or to a User Agent (in our case UA is the SWING's JEditorPane component). For example, the Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification says [1]: "Note 1. To preserve readability, a UA applying these guidelines should nevertheless avoid creating font-size resulting in less than 9 pixels per EM unit on a computer display." In any cases, our users have an ability to change default behavior of the NetBeans to make the text of the help pages readable, i.e. a user has at least two options: * set a larger default font size in GUI of the operating system * use the --fontsize option of the netbeans command. My opinion is that it is enough for closing this issue against the userguide. [1] http://www.w3.org/TR/CSS2/fonts.html#font-size-props Thank you very much for your explanation! So, if Patrick agrees, the issue can be closed. I do not see any other way how the default fontsize can be enlarged. Patrick, what is your opinion? The explanation is helpful, but I don't think this issue can be closed. The font was a reasonable size up through 6.5 and it is way too small now (at least on Vista). That's a regression. A workaround exists (as far from obvious as it is), so it's not a P1, but it is a bug. Created attachment 82176 [details]
Patrick, on my Vista x64 a default font size on the Help pages is larger!
To create the result above I've used the latest build from the hg.netbeans.org/main repository. Product Version: NetBeans IDE Dev (Build 090515) Java: 1.6.0_13; Java HotSpot(TM) Client VM 11.3-b02 System: Windows Vista version 6.0 running on x86; Cp1251; ru_RU (nb) I tried 6.5 and 6.7 on Solaris 10, and 6.7 font in help is smaller, see attachment Created attachment 82554 [details]
6.5 help compared to 6.7 help build 200905200201 on Solaris 10
[ 200905210001 ] Just looked at the font on Vista in the latest nightly build, and it _does_ display with normal-sized font (i.e., it is bigger than the original screenshot submitted on Apr. 17. +1 for closing the issue. Created attachment 82556 [details]
resubmit, 6.5 help compared to 6.7 help build 200905200201 on Solaris 10
Troy, could you add a screenshot and give other details, e.g. which version of the build? I just downloaded the zip version of [200905210001] and get the same (small) results as in the beta build. Created attachment 95266 [details]
help size: NetBeans 6.9 M1 build on Win XP
Guys, It seems that we need another round of comparisons of help on: - Win Vista or 7 - mac - solaris to decide what to do with this issue. Please take the original screenshot submitted on April 17, 2009, and compare the help text size with the size of TOC entries and NB UI labels. On Win XP the size of NB UI labels and TOC is the same - see the screenshot of March 17, 2010 taken on NB 6.9 M1 build. I do not have any problems with reading the help pages on all systems that I usually use: * Windows Vista Ultimate x64 * Windows Vista Business * Windows XP SP3 * OpenSolaris 2008.5 * Fedora 11, 12, 13 * Ubuntu 9.04 So I vote to close this bug. BTW we should not be responsible if a user system is misconfigured or buggy fonts are installed. Closing this issue as Resolved/Fixed as no other comments for keeping it open were received. Thanks to everyone who evaluated it. |