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.

Bug 74006 - RFE: usage for ide.css links in JavaHelp
Summary: RFE: usage for ide.css links in JavaHelp
Status: RESOLVED FIXED
Alias: None
Product: usersguide
Classification: Unclassified
Component: Code (show other bugs)
Version: 5.x
Hardware: All All
: P2 blocker (vote)
Assignee: issues@usersguide
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-03-27 02:16 UTC by Masaki Katakai
Modified: 2006-04-28 15:05 UTC (History)
1 user (show)

See Also:
Issue Type: ENHANCEMENT
Exception Reporter:


Attachments
list of nbdocs://modulename/ style in NB5.0 JavaHelp (13.88 KB, text/plain)
2006-03-27 02:20 UTC, Masaki Katakai
Details
list of ../../ide.css style in NB5.0 JavaHelp (126.24 KB, text/plain)
2006-03-27 02:21 UTC, Masaki Katakai
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Masaki Katakai 2006-03-27 02:16:09 UTC
I'd like to ask doc team to work on these for next NetBeans release, 5.5.

1. Use nbdocs:/<absolute path> style in JavaHelp
2. Do not use ../../../ style for ide.css, use nbdocs:/.../ide.css instead
3. Update style guide of http://usersguide.netbeans.org/links.html

1. In current 5.0 javahelp, there are two types for the link to inside JavaHelp,

(1).'nbdocs://<module_name>'
href="nbdocs://org.netbeans.modules.j2ee.platform/org/netbeans/modules/j2ee/platform/docs/web/create/jsp/jsp_compile.html"

(2). 'nbdocs:/<absolute path>'
href="nbdocs:/org/netbeans/modules/j2ee/platform/docs/web/create/jsp/jsp_usetaglib.html"

We should use the way of (2) for the convenience. When we localize JavaHelp, we
g11n team need to modify these patch to add ../ja/.. . If the link includes
module name, it's not easy to add them and check them by simple script. Please
use nbdocs:/<absolute> style in entire JavaHelp.

2. Also href="../../../../usersguide/ide.css" style is not easy to handle because
g11n team need to add additional /../ and /ja/ into it. If these could use
nbdocs:/org/netbeans/modules/usersguide/ide.css, we can change them by simple script
Comment 1 Masaki Katakai 2006-03-27 02:20:04 UTC
Created attachment 29407 [details]
list of nbdocs://modulename/ style in NB5.0 JavaHelp
Comment 2 Masaki Katakai 2006-03-27 02:21:36 UTC
Created attachment 29408 [details]
list of ../../ide.css style in NB5.0 JavaHelp
Comment 3 Patrick Keegan 2006-04-12 16:43:42 UTC
Masaki. I started implementing the changes you suggested, but I realized it is
not desirable to implement the first part of your request. The
nbdocs://org.netbeans.modules.j2ee.platform/org/netbeans/modules/... style is
what we need to enable the feature where the IDE provides reasonable feedback if
the module that is referred to is not installed. So I am not inclined to change
that. Is there any way that your scripts can be written to detect the pattern in
the nbdocs links?

However, I don't see a problem making all of the .css links use the absolute
link, so I will fix those.
Comment 4 Masaki Katakai 2006-04-13 09:19:21 UTC
Thank you for evaluation. I understand the problem now.
Comment 5 Patrick Keegan 2006-04-28 15:05:09 UTC
Masaki, I have fixed part 2 of the issue (created absolute links for the
ide.css) in the help topics that are outside of usersguide. I have not changed
the topics in usersguide.