Bug 31549 - Support cross-API links when browsing offline
Support cross-API links when browsing offline
Status: RESOLVED FIXED
Product: apisupport
Classification: Unclassified
Component: API docs
3.x
All All
: P4 (vote)
: 5.x
Assigned To: Jaroslav Tulach
issues@apisupport
:
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2003-02-27 20:09 UTC by Jesse Glick
Modified: 2005-09-05 09:51 UTC (History)
1 user (show)

See Also:
Issue Type: ENHANCEMENT
:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Jesse Glick 2003-02-27 20:09:19 UTC
Currently links between APIs refer to the
http://www.netbeans.org/download/dev/javadoc/
website. This is fine when browsing them online to
begin with, but annoying when browsing them
offline (from within NB using the
apisupport/apidocs module). Possibilities:

1. Have apisupport/apidocs register a URLMapper to
convert URLs with the prefix
http://www.netbeans.org/download/dev/javadoc/ to
the proper nbfs: URLs. Problems: (a) URLMapper
provides no URL -> URL facility. (b) Not at all
clear how to make this work w/ externalbrowser +
httpserver - would need to convert to and from
internal representation? Very ugly.

2. Make the javadoc module add an optional
URL-valued "mirror" to its javadoc DTD, indicating
what online prefix this doc set mirrors. Then in
its environment provider for the DTD, filter the
returned filesystem (MFS can be a filter) as
follows: for any file object whose content type is
text/html, override the length and input stream
methods to get the real content, then go through
the HTML and rewrite links. Any links (just <a
href="..."> I guess) which pointed to a URL with a
prefix in the mirror list of a mounted javadoc FS,
would be written to point to the file object in
that other FS (using URLMapper.EXTERNAL I guess).
This is a cleaner solution but probably more work.
Comment 1 Jesse Glick 2005-04-28 05:40:13 UTC
I think Yarda is working on this, somehow.
Comment 2 Jaroslav Tulach 2005-04-28 15:45:23 UTC
All javadocs now use relative links to refer to each other. So the support is  
there. We just need to verify that it is used correctly. 


By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2012, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo