Eclipse Community Forums: Platform - User Assistance (UA) » standalone html help and resource ids (contextIds)

Help

Home

Home » Eclipse Projects » Platform - User Assistance (UA) » standalone html help and resource ids (contextIds)

Show: Today's Messages :: Show Polls :: Message Navigator

standalone html help and resource ids (contextIds) [message #623570]

Wed, 14 October 2009 11:31

Yan Periard
Messages: 11
Registered: July 2009

Junior Member

Hi,

We are looking for a way to find/link to topic in the infocenter without having to use the html filename. We have found the topic parameter but this uses the topic filename. Is there a parameter that we can use to link to a specific topic by using an internal id?

We are producing documentation from a set of DITA topics/maps and would like to add a level of indirection so that even if the filenames are changed the help continues to point to the correct location. For example in DITA the resourceId http://docs.oasis-open.org/dita/v1.1/OS/langspec/langref/res ourceid.html would be our preferred way of doing this.

Is it possible?

We have tried the following, hoping that context help would work in an infocenter, but we must be doing something wrong.

http://localhost:8081/help/index.jsp?contextId=com.ixiasoft. eclipse.product.help.search_view

We are starting the infocenter from a simple java test class using the org.eclipse.help.standalone.Help class, are there options that must be used to enable context help? BTW context help is working fine locally in the full eclipse application.

any help would be appreciated.

thanks.

Report message to a moderator

Re: standalone html help and resource ids (contextIds) [message #623571 is a reply to message #623570]

Fri, 16 October 2009 19:16

Chris Goldthorpe
Messages: 815
Registered: July 2009

Senior Member

This sounds like something that could be accomplished using a help content provider but I don't fully understand the use case. Can you explain a little more of how you want to interpret the URL which is passed to the help system.?

Report message to a moderator

Re: standalone html help and resource ids (contextIds) [message #623574 is a reply to message #623571]

Tue, 20 October 2009 09:47

Yan Periard
Messages: 11
Registered: July 2009

Junior Member

Hi,

I'll try to explain myself better, sorry as english in not my first language.

We are building help files but we do not control the filenames themselves. They are part of a CMS, so the only thing under our control is the content of the file itself (in DITA). Once the document is built it is then linked to an application for contextual help purposes using fully resolved URL

http://localhost:8081/help/topic/com.foo.bar.help/html/11437 41569421.html

the problem arises if the same content is applied in a different files (eg. for branching purposes for doc, etc.) the filename can change, but we don't control the software and can't change all the help links.

So we would like to know if it would be possible to "query" the infocenter with another field like the contextId, or better use the DITA resource Id to abstract the filenames. That way as long as a Help topic refers to the correct resourceId, it can be found by the software application without having to know first hand what will be the filename.

I hope is was clearer, let me know if it is not.

thank

Report message to a moderator

Re: standalone html help and resource ids (contextIds) [message #623762 is a reply to message #623574]

Wed, 21 October 2009 13:09

Chris Goldthorpe
Messages: 815
Registered: July 2009

Senior Member

A content producer should solve your problem. If you use the org.eclipse.help.contentProducer extension point in a plug-in then any reference to an href where the first part of the path matches the name of that plug-in will use the content producer. You just need to provide a class which implements IHelpContentProducer, an interface which has one method:

public InputStream getInputStream(String pluginId, String href, Locale locale)

This way you can code whatever logic you need for resolving the actual path in the content producer.

Report message to a moderator

Re: standalone html help and resource ids (contextIds) [message #623763 is a reply to message #623762]

Wed, 21 October 2009 13:33

Yan Periard
Messages: 11
Registered: July 2009

Junior Member

Thanks, I will definitively try this.

I will let you know as soon as I have something

thanks again

Report message to a moderator

Re: standalone html help and resource ids (contextIds) [message #623768 is a reply to message #623570]

Mon, 26 October 2009 11:34

Alexej Spas
Messages: 22
Registered: July 2009

Junior Member

Please take a look on DITAworks solution: http://www.ditaworks.com/

It provides a comprehensive publishing support for Eclipse Help based on DITA and adresses the problem discussed here. It also addresses other problems of advanced Eclipse Help support that are not solved in DITA Open Toolkit like:

Support of Eclipse help contexts
Integartion of cheat sheets
Cross-plugin links resolving
Integration with development IDE
and much more...

Please take a look on following blog posts:
http://blog.ditaworks.com/features/using-dita-for-publishing -documentation-in-eclipse-help-format-functionality-preview/
http://blog.ditaworks.com/features/eclipse-help-support-with -ditaworks/

Regards,
Alexej Spas

Report message to a moderator

Re: standalone html help and resource ids (contextIds) [message #623769 is a reply to message #623570]

Mon, 26 October 2009 11:39

Alexej Spas
Messages: 22
Registered: July 2009

Junior Member

Report message to a moderator

Re: standalone html help and resource ids (contextIds) [message #623770 is a reply to message #623762]

Mon, 26 October 2009 16:25

Yan Periard
Messages: 11
Registered: July 2009

Junior Member

Hi,

just wanted to let you know that the contentProducer was the way to go. I only need to configure the eclipse built in Jetty. This to make the default returned mime type to text/html instead of text/plain.

thanks

Report message to a moderator

Re: standalone html help and resource ids (contextIds) [message #623811 is a reply to message #623770]

Wed, 23 December 2009 03:53

Alexej Spas
Messages: 22
Registered: July 2009

Junior Member

Hi all,

Please take a look on http://www.ditaworks.com/ called DITAworks (http://www.ditaworks.com/)

This is an Eclipse based tool that manages documentation with single source approach using DITA standard. It provides the way to reference dita tiopics instead of HTML files and also handles other Eclipse help generation issues like cross-plugin link generation control, pulling topic title on level of help coontexts and s.o.

It also has set of special features for producing Eclipse help and integration with RCP application and RCP application development process. Take a look on following blog-post for more details:

http://support.ditaworks.com/features/using-dita-for-publish ing-documentation-in-eclipse-help-format-functionality-previ ew/
http://support.ditaworks.com/features/eclipse-help-support-w ith-ditaworks/

Also there are some screencasts available here:
http://www.ditaworks.com/state/AG:item.34.subitem.43/AC:-1.6 60216953/

I hope this helps,
Alexej

Report message to a moderator

Previous Topic:	standalone html help and resource ids (contextIds)
Next Topic:	Re: General user documentation question

Goto Forum:

-=] Back to Top [=-

[ Syndicate this forum (XML) ] [

]

Current Time: Fri May 24 03:20:56 EDT 2013