Eclipse Community Forums - RDF feed
https://www.eclipse.org/forums/
Eclipse Community ForumsPlease confirm allowable link_to path structures using PLUGINS_ROOT
https://www.eclipse.org/forums/index.php/mv/msg/151172/475569/#msg_475569
Would someone on the Eclipse UA team please confirm which of the
following are supposed to work when specified in the link_to attribute?
And which one you would consider is a "best practice"?
Given a doc plug-in with:
pluginID = edition1_1
toc file = edition1_1.xml
anchorID in edition1_1.xml = comps
Trying to anchor into that anchorID using link_to, I see the following
behaviors:
link_to="/../edition1_1/edition1_1.xml#comps Works in Eclipse 3.4.1
link_to="/edition1_1/edition1_1.xml#comps Works
link_to="../edition1_1/edition1_1.xml#comps Works (this is also
in the help doc example in ua_help_content_nested.htm topic)
link_to="PLUGINS_ROOT/edition1_1/edition1_1.xml#comps Works
link_to="/PLUGINS_ROOT/edition1_1/edition1_1.xml#comps Does Not work
So, is it a bug that link_to="/PLUGINS_ROOT/<pluginID>/<tocfile>#anchorID"
does not work?
Or is PLUGINS_ROOT not useful for contributing into an anchor?
Is the best practice to use the path attribute format? For example:
link_to="/pluginID/path/file.xml#anchorID"
Thanks in advance!
--Lee Anne]]>Lee Anne Kowalski2009-05-26T15:37:52-00:00Re: Please confirm allowable link_to path structures using PLUGINS_ROOT
https://www.eclipse.org/forums/index.php/mv/msg/151172/623378/#msg_623378
link_to="/PLUGINS_ROOT/<pluginID>/<tocfile>#anchorID"
> does not work?
>
> Or is PLUGINS_ROOT not useful for contributing into an anchor?
It really is not necessary to specify PLUGINS_ROOT when contributing to
an anchor. The support for PLUGINS_ROOT is only there to allow the TOC
contributions to use the same format as is used for hrefs. I suppose
that if we are going to support PLUGINS_ROOT we should also support
/PLUGINS_ROOT and you could file a bug on that.]]>Chris Goldthorpe2009-05-27T22:59:21-00:00Re: Please confirm allowable link_to path structures using PLUGINS_ROOT
https://www.eclipse.org/forums/index.php/mv/msg/151172/475603/#msg_475603
link_to="/PLUGINS_ROOT/<pluginID>/<tocfile>#anchorID"
> does not work?
>
> Or is PLUGINS_ROOT not useful for contributing into an anchor?
It really is not necessary to specify PLUGINS_ROOT when contributing to
an anchor. The support for PLUGINS_ROOT is only there to allow the TOC
contributions to use the same format as is used for hrefs. I suppose
that if we are going to support PLUGINS_ROOT we should also support
/PLUGINS_ROOT and you could file a bug on that.]]>Chris Goldthorpe2009-05-27T22:59:21-00:00Thanks! (was Re: Please confirm allowable link_to path structures using PLUGINS_ROOT
https://www.eclipse.org/forums/index.php/mv/msg/151172/623380/#msg_623380
Thanks for that confirmation about anchor contributions and PLUGINS_ROOT.
I was using a tool that kept inserting a slash into the path that I
typed for my link_to, and that was messing things up when I included
PLUGINS_ROOT in the path, and I could't figure out why having that slash
made such a difference in that case. :-)
Thanks again!
--Lee Anne
Chris Goldthorpe wrote:
> > So, is it a bug that
> link_to="/PLUGINS_ROOT/<pluginID>/<tocfile>#anchorID"
> > does not work?
> >
> > Or is PLUGINS_ROOT not useful for contributing into an anchor?
>
> It really is not necessary to specify PLUGINS_ROOT when contributing to
> an anchor. The support for PLUGINS_ROOT is only there to allow the TOC
> contributions to use the same format as is used for hrefs. I suppose
> that if we are going to support PLUGINS_ROOT we should also support
> /PLUGINS_ROOT and you could file a bug on that.
>]]>Lee Anne Kowalski2009-05-29T20:38:02-00:00Thanks! (was Re: Please confirm allowable link_to path structures using PLUGINS_ROOT
https://www.eclipse.org/forums/index.php/mv/msg/151172/475606/#msg_475606
Thanks for that confirmation about anchor contributions and PLUGINS_ROOT.
I was using a tool that kept inserting a slash into the path that I
typed for my link_to, and that was messing things up when I included
PLUGINS_ROOT in the path, and I could't figure out why having that slash
made such a difference in that case. :-)
Thanks again!
--Lee Anne
Chris Goldthorpe wrote:
> > So, is it a bug that
> link_to="/PLUGINS_ROOT/<pluginID>/<tocfile>#anchorID"
> > does not work?
> >
> > Or is PLUGINS_ROOT not useful for contributing into an anchor?
>
> It really is not necessary to specify PLUGINS_ROOT when contributing to
> an anchor. The support for PLUGINS_ROOT is only there to allow the TOC
> contributions to use the same format as is used for hrefs. I suppose
> that if we are going to support PLUGINS_ROOT we should also support
> /PLUGINS_ROOT and you could file a bug on that.
>]]>Lee Anne Kowalski2009-05-29T20:38:02-00:00