Hi all,

the next step is to get something that will run nicely from CD. I'm using batch
files for displayHelp and shutdown at the moment but I notice that a lot of Java
apps (Eclipse included) use a Windows executable to control the lifecycle. This
would be far more convenient because I can't expect customers to run a batch
script to stop the help system but clicking the X in the top-right corner leaves
the process running.

Any pointers?

Thanks,
Richard

Eclipse needs the config.ini file _and_ the bundles.info file in
org.eclipse.equinox.simpleconfigurator in order to run. Bundles.info seems to
contain a list of the plugins.

Hi,

Thanks to Everybody for the help!
Sorry for the late answer, I was out of office for a few days.

Yes, Richard's explanation about paths seems to explain my problem.

Aman, thank you very much for suggesting help with the scripts. If you don't
mind, I will probably get back to you with this a bit later... At the moment, we
are looking at the possible help format options, and the folder structure is not
clear too.

Thanks again and best regards,

Irina

--- In eclipse_tw@yahoogroups.com, "Aman Talwar" <adstalwar@...> wrote:
>
> Hi,
> Opening an external file is very much possible in Eclipse Help using VB script
or Java Script.
> I have developed Help systems that open PDF files saved outside the
Eclipse/plugins folder using VB script.
>
> Irina, can you please help me with the exact folder hierarchy so that I can
develop a script for you?
>
> Regards,
> Aman Talwar
>
> --- In eclipse_tw@yahoogroups.com, "rlauriston" <robert@> wrote:
> >
> > That sounds right to me, I think I've come across such problems before. If
that's the cause, it won't matter what browser you're using.
> >
> > --- In eclipse_tw@yahoogroups.com, "rpineger" <marrocdanderfluff@> wrote:
> > >
> >
> > > As for the relative paths. I tried this out for you. The Eclipse help
system creates an http server (called Jetty) and serves the pages to Internet
Explorer. That would mean that you can't go outside the root folder of the http
server unless you specifically add it to the configuration somewhere - and I
don't know where. At least that is the way it works in Apache and possibly IIS
(which are also web servers). So my guess would be, that if your relative path
tries to leave the plugins folder it the help system can't find the page.
> > >
> > > Richard
> > >
> > > --- In eclipse_tw@yahoogroups.com, "irmalkova" <irmalkova@> wrote:
> > > >
> > > > Hi,
> > > >
> > > > Thanks for your help, but somehow this doesn't work exactly as I hoped.
> > > >
> > > > First of all, it doesn't work with target="_blank". If i use "_self",
then - yes, I can see the file in the Eclipse Help viewer. With "_blank" -
nothing happens when I click, no topic, no error message...
> > > >
> > > > Another issue. I want to use a relative path in href (because the
location depends on installation), and this would not work either...
> > > > If instead of C:/Program Files/CCC/GeneralHelp I want to put something
like ../GeneralHelp, is it possible?
> > > >
> > > > Sorry again for basic questions, but links in Eclipse help seem to work
differently than in other types of HTML or Java helps...
> > > >
> > > > Thanks again and best regards,
> > > >
> > > > Irina
> > > >
> > > >
> > > > --- In eclipse_tw@yahoogroups.com, "rlauriston" <robert@> wrote:
> > > > >
> > > > > Have you tried <A HREF "file://C:/Program
Files/CCC/GeneralHelp/something.htm" target="_blank"> ?
> > > > >
> > > > > That should open the specified URL in a new window.
> > > > >
> > > > >
> > > > > --- In eclipse_tw@yahoogroups.com, "irmalkova" <irmalkova@> wrote:
> > > > > >
> > > > > > Hi All,
> > > > > >
> > > > > > And sorry if the question (or rather answer)is obvious, I am new to
Eclipse help. We write helps for a number of products here, and so far it was
never Eclipse Help - usually HTML pages generated by AuthorIT or chms. Now we
have 2 application written with Eclipse RCP, and they should use Eclipse
(context sensitive) help.
> > > > > >
> > > > > > Is it possible to have an external link in an Eclipse help topic, so
that it opens another HTML help system in another browser? And this will not be
a link to web (this seems to work), but to the local computer. Say, the Eclipse
help plugin is
> > > > > > C:\Program
Files\CCC\EclipseApplication\plugins\com.cccgroup.application.help_1.2.0,
> > > > > > and we want to open an html file
> > > > > > C:\Program Files\CCC\GeneralHelp\something.htm
> > > > > >
> > > > > > I don't seem to be able to do this. How would you define such a
link?
> > > > > >
> > > > > > Thanks a lot and sorry again for a "beginner" question,
> > > > > >
> > > > > > Irina
> > > > > >
> > > > >
> > > >
> > >
> >
>

Hi,
Opening an external file is very much possible in Eclipse Help using VB script
or Java Script.
I have developed Help systems that open PDF files saved outside the
Eclipse/plugins folder using VB script.

Irina, can you please help me with the exact folder hierarchy so that I can
develop a script for you?

Regards,
Aman Talwar

--- In eclipse_tw@yahoogroups.com, "rlauriston" <robert@...> wrote:
>
> That sounds right to me, I think I've come across such problems before. If
that's the cause, it won't matter what browser you're using.
>
> --- In eclipse_tw@yahoogroups.com, "rpineger" <marrocdanderfluff@> wrote:
> >
>
> > As for the relative paths. I tried this out for you. The Eclipse help system
creates an http server (called Jetty) and serves the pages to Internet Explorer.
That would mean that you can't go outside the root folder of the http server
unless you specifically add it to the configuration somewhere - and I don't know
where. At least that is the way it works in Apache and possibly IIS (which are
also web servers). So my guess would be, that if your relative path tries to
leave the plugins folder it the help system can't find the page.
> >
> > Richard
> >
> > --- In eclipse_tw@yahoogroups.com, "irmalkova" <irmalkova@> wrote:
> > >
> > > Hi,
> > >
> > > Thanks for your help, but somehow this doesn't work exactly as I hoped.
> > >
> > > First of all, it doesn't work with target="_blank". If i use "_self", then
- yes, I can see the file in the Eclipse Help viewer. With "_blank" - nothing
happens when I click, no topic, no error message...
> > >
> > > Another issue. I want to use a relative path in href (because the location
depends on installation), and this would not work either...
> > > If instead of C:/Program Files/CCC/GeneralHelp I want to put something
like ../GeneralHelp, is it possible?
> > >
> > > Sorry again for basic questions, but links in Eclipse help seem to work
differently than in other types of HTML or Java helps...
> > >
> > > Thanks again and best regards,
> > >
> > > Irina
> > >
> > >
> > > --- In eclipse_tw@yahoogroups.com, "rlauriston" <robert@> wrote:
> > > >
> > > > Have you tried <A HREF "file://C:/Program
Files/CCC/GeneralHelp/something.htm" target="_blank"> ?
> > > >
> > > > That should open the specified URL in a new window.
> > > >
> > > >
> > > > --- In eclipse_tw@yahoogroups.com, "irmalkova" <irmalkova@> wrote:
> > > > >
> > > > > Hi All,
> > > > >
> > > > > And sorry if the question (or rather answer)is obvious, I am new to
Eclipse help. We write helps for a number of products here, and so far it was
never Eclipse Help - usually HTML pages generated by AuthorIT or chms. Now we
have 2 application written with Eclipse RCP, and they should use Eclipse
(context sensitive) help.
> > > > >
> > > > > Is it possible to have an external link in an Eclipse help topic, so
that it opens another HTML help system in another browser? And this will not be
a link to web (this seems to work), but to the local computer. Say, the Eclipse
help plugin is
> > > > > C:\Program
Files\CCC\EclipseApplication\plugins\com.cccgroup.application.help_1.2.0,
> > > > > and we want to open an html file
> > > > > C:\Program Files\CCC\GeneralHelp\something.htm
> > > > >
> > > > > I don't seem to be able to do this. How would you define such a link?
> > > > >
> > > > > Thanks a lot and sorry again for a "beginner" question,
> > > > >
> > > > > Irina
> > > > >
> > > >
> > >
> >
>

That sounds right to me, I think I've come across such problems before. If
that's the cause, it won't matter what browser you're using.

--- In eclipse_tw@yahoogroups.com, "rpineger" <marrocdanderfluff@...> wrote:
>

> As for the relative paths. I tried this out for you. The Eclipse help system
creates an http server (called Jetty) and serves the pages to Internet Explorer.
That would mean that you can't go outside the root folder of the http server
unless you specifically add it to the configuration somewhere - and I don't know
where. At least that is the way it works in Apache and possibly IIS (which are
also web servers). So my guess would be, that if your relative path tries to
leave the plugins folder it the help system can't find the page.
>
> Richard
>
> --- In eclipse_tw@yahoogroups.com, "irmalkova" <irmalkova@> wrote:
> >
> > Hi,
> >
> > Thanks for your help, but somehow this doesn't work exactly as I hoped.
> >
> > First of all, it doesn't work with target="_blank". If i use "_self", then -
yes, I can see the file in the Eclipse Help viewer. With "_blank" - nothing
happens when I click, no topic, no error message...
> >
> > Another issue. I want to use a relative path in href (because the location
depends on installation), and this would not work either...
> > If instead of C:/Program Files/CCC/GeneralHelp I want to put something like
../GeneralHelp, is it possible?
> >
> > Sorry again for basic questions, but links in Eclipse help seem to work
differently than in other types of HTML or Java helps...
> >
> > Thanks again and best regards,
> >
> > Irina
> >
> >
> > --- In eclipse_tw@yahoogroups.com, "rlauriston" <robert@> wrote:
> > >
> > > Have you tried <A HREF "file://C:/Program
Files/CCC/GeneralHelp/something.htm" target="_blank"> ?
> > >
> > > That should open the specified URL in a new window.
> > >
> > >
> > > --- In eclipse_tw@yahoogroups.com, "irmalkova" <irmalkova@> wrote:
> > > >
> > > > Hi All,
> > > >
> > > > And sorry if the question (or rather answer)is obvious, I am new to
Eclipse help. We write helps for a number of products here, and so far it was
never Eclipse Help - usually HTML pages generated by AuthorIT or chms. Now we
have 2 application written with Eclipse RCP, and they should use Eclipse
(context sensitive) help.
> > > >
> > > > Is it possible to have an external link in an Eclipse help topic, so
that it opens another HTML help system in another browser? And this will not be
a link to web (this seems to work), but to the local computer. Say, the Eclipse
help plugin is
> > > > C:\Program
Files\CCC\EclipseApplication\plugins\com.cccgroup.application.help_1.2.0,
> > > > and we want to open an html file
> > > > C:\Program Files\CCC\GeneralHelp\something.htm
> > > >
> > > > I don't seem to be able to do this. How would you define such a link?
> > > >
> > > > Thanks a lot and sorry again for a "beginner" question,
> > > >
> > > > Irina
> > > >
> > >
> >
>

Hi Irina,

what I think is happening here is that the security in Internet Explorer (or the
default browser) is preventing a pop-up window. Eclipse help uses a local
browser to display the HTML pages. Try adjusting the security settings in
Internet Explorer, close it and start the help system again.

As for the relative paths. I tried this out for you. The Eclipse help system
creates an http server (called Jetty) and serves the pages to Internet Explorer.
That would mean that you can't go outside the root folder of the http server
unless you specifically add it to the configuration somewhere - and I don't know
where. At least that is the way it works in Apache and possibly IIS (which are
also web servers). So my guess would be, that if your relative path tries to
leave the plugins folder it the help system can't find the page.

Richard

--- In eclipse_tw@yahoogroups.com, "irmalkova" <irmalkova@...> wrote:
>
> Hi,
>
> Thanks for your help, but somehow this doesn't work exactly as I hoped.
>
> First of all, it doesn't work with target="_blank". If i use "_self", then -
yes, I can see the file in the Eclipse Help viewer. With "_blank" - nothing
happens when I click, no topic, no error message...
>
> Another issue. I want to use a relative path in href (because the location
depends on installation), and this would not work either...
> If instead of C:/Program Files/CCC/GeneralHelp I want to put something like
../GeneralHelp, is it possible?
>
> Sorry again for basic questions, but links in Eclipse help seem to work
differently than in other types of HTML or Java helps...
>
> Thanks again and best regards,
>
> Irina
>
>
> --- In eclipse_tw@yahoogroups.com, "rlauriston" <robert@> wrote:
> >
> > Have you tried <A HREF "file://C:/Program
Files/CCC/GeneralHelp/something.htm" target="_blank"> ?
> >
> > That should open the specified URL in a new window.
> >
> >
> > --- In eclipse_tw@yahoogroups.com, "irmalkova" <irmalkova@> wrote:
> > >
> > > Hi All,
> > >
> > > And sorry if the question (or rather answer)is obvious, I am new to
Eclipse help. We write helps for a number of products here, and so far it was
never Eclipse Help - usually HTML pages generated by AuthorIT or chms. Now we
have 2 application written with Eclipse RCP, and they should use Eclipse
(context sensitive) help.
> > >
> > > Is it possible to have an external link in an Eclipse help topic, so that
it opens another HTML help system in another browser? And this will not be a
link to web (this seems to work), but to the local computer. Say, the Eclipse
help plugin is
> > > C:\Program
Files\CCC\EclipseApplication\plugins\com.cccgroup.application.help_1.2.0,
> > > and we want to open an html file
> > > C:\Program Files\CCC\GeneralHelp\something.htm
> > >
> > > I don't seem to be able to do this. How would you define such a link?
> > >
> > > Thanks a lot and sorry again for a "beginner" question,
> > >
> > > Irina
> > >
> >
>

You might want to ask that question on the eclipse.platform.ua newsgroup on
news.eclipse.org.

--- In eclipse_tw@yahoogroups.com, "irmalkova" <irmalkova@...> wrote:
>
> Hi,
>
> Thanks for your help, but somehow this doesn't work exactly as I hoped.
>
> First of all, it doesn't work with target="_blank". If i use "_self", then -
yes, I can see the file in the Eclipse Help viewer. With "_blank" - nothing
happens when I click, no topic, no error message...
>
> Another issue. I want to use a relative path in href (because the location
depends on installation), and this would not work either...
> If instead of C:/Program Files/CCC/GeneralHelp I want to put something like
../GeneralHelp, is it possible?
>
> Sorry again for basic questions, but links in Eclipse help seem to work
differently than in other types of HTML or Java helps...
>
> Thanks again and best regards,
>
> Irina
>
>
> --- In eclipse_tw@yahoogroups.com, "rlauriston" <robert@> wrote:
> >
> > Have you tried <A HREF "file://C:/Program
Files/CCC/GeneralHelp/something.htm" target="_blank"> ?
> >
> > That should open the specified URL in a new window.
> >
> >
> > --- In eclipse_tw@yahoogroups.com, "irmalkova" <irmalkova@> wrote:
> > >
> > > Hi All,
> > >
> > > And sorry if the question (or rather answer)is obvious, I am new to
Eclipse help. We write helps for a number of products here, and so far it was
never Eclipse Help - usually HTML pages generated by AuthorIT or chms. Now we
have 2 application written with Eclipse RCP, and they should use Eclipse
(context sensitive) help.
> > >
> > > Is it possible to have an external link in an Eclipse help topic, so that
it opens another HTML help system in another browser? And this will not be a
link to web (this seems to work), but to the local computer. Say, the Eclipse
help plugin is
> > > C:\Program
Files\CCC\EclipseApplication\plugins\com.cccgroup.application.help_1.2.0,
> > > and we want to open an html file
> > > C:\Program Files\CCC\GeneralHelp\something.htm
> > >
> > > I don't seem to be able to do this. How would you define such a link?
> > >
> > > Thanks a lot and sorry again for a "beginner" question,
> > >
> > > Irina
> > >
> >
>

Hi,

Thanks for your help, but somehow this doesn't work exactly as I hoped.

First of all, it doesn't work with target="_blank". If i use "_self", then -
yes, I can see the file in the Eclipse Help viewer. With "_blank" - nothing
happens when I click, no topic, no error message...

Another issue. I want to use a relative path in href (because the location
depends on installation), and this would not work either...
If instead of C:/Program Files/CCC/GeneralHelp I want to put something like
../GeneralHelp, is it possible?

Sorry again for basic questions, but links in Eclipse help seem to work
differently than in other types of HTML or Java helps...

Thanks again and best regards,

Irina


--- In eclipse_tw@yahoogroups.com, "rlauriston" <robert@...> wrote:
>
> Have you tried <A HREF "file://C:/Program Files/CCC/GeneralHelp/something.htm"
target="_blank"> ?
>
> That should open the specified URL in a new window.
>
>
> --- In eclipse_tw@yahoogroups.com, "irmalkova" <irmalkova@> wrote:
> >
> > Hi All,
> >
> > And sorry if the question (or rather answer)is obvious, I am new to Eclipse
help. We write helps for a number of products here, and so far it was never
Eclipse Help - usually HTML pages generated by AuthorIT or chms. Now we have 2
application written with Eclipse RCP, and they should use Eclipse (context
sensitive) help.
> >
> > Is it possible to have an external link in an Eclipse help topic, so that it
opens another HTML help system in another browser? And this will not be a link
to web (this seems to work), but to the local computer. Say, the Eclipse help
plugin is
> > C:\Program
Files\CCC\EclipseApplication\plugins\com.cccgroup.application.help_1.2.0,
> > and we want to open an html file
> > C:\Program Files\CCC\GeneralHelp\something.htm
> >
> > I don't seem to be able to do this. How would you define such a link?
> >
> > Thanks a lot and sorry again for a "beginner" question,
> >
> > Irina
> >
>

Have you tried <A HREF "file://C:/Program Files/CCC/GeneralHelp/something.htm"
target="_blank"> ?

That should open the specified URL in a new window.


--- In eclipse_tw@yahoogroups.com, "irmalkova" <irmalkova@...> wrote:
>
> Hi All,
>
> And sorry if the question (or rather answer)is obvious, I am new to Eclipse
help. We write helps for a number of products here, and so far it was never
Eclipse Help - usually HTML pages generated by AuthorIT or chms. Now we have 2
application written with Eclipse RCP, and they should use Eclipse (context
sensitive) help.
>
> Is it possible to have an external link in an Eclipse help topic, so that it
opens another HTML help system in another browser? And this will not be a link
to web (this seems to work), but to the local computer. Say, the Eclipse help
plugin is
> C:\Program
Files\CCC\EclipseApplication\plugins\com.cccgroup.application.help_1.2.0,
> and we want to open an html file
> C:\Program Files\CCC\GeneralHelp\something.htm
>
> I don't seem to be able to do this. How would you define such a link?
>
> Thanks a lot and sorry again for a "beginner" question,
>
> Irina
>

Hi All,

And sorry if the question (or rather answer)is obvious, I am new to Eclipse
help. We write helps for a number of products here, and so far it was never
Eclipse Help - usually HTML pages generated by AuthorIT or chms. Now we have 2
application written with Eclipse RCP, and they should use Eclipse (context
sensitive) help.

Is it possible to have an external link in an Eclipse help topic, so that it
opens another HTML help system in another browser? And this will not be a link
to web (this seems to work), but to the local computer. Say, the Eclipse help
plugin is
C:\Program
Files\CCC\EclipseApplication\plugins\com.cccgroup.application.help_1.2.0,
and we want to open an html file
C:\Program Files\CCC\GeneralHelp\something.htm

I don't seem to be able to do this. How would you define such a link?

Thanks a lot and sorry again for a "beginner" question,

Irina

Like you say, I think it's possibly permissions. I've had trouble recently with
other software. MS Windows now seems to have a system of flags that track the
origin of each file and prevent them working. I think they might call it
'trusted computing'. In my original post I was asking if anyone knew of anywhere
I could find out more.

Other answers below:
--- In eclipse_tw@yahoogroups.com, "rlauriston" <robert@...> wrote:
>
> Are the other users trying to launch this from a network directory?
> If so, their classpaths are probably wrong, and there are a lot of
> things that can go wrong with permissions etc.

The batch script sets the classpath and I echo it in my version so I think that
is right. It certainly finds Java and Eclipse doesn't have any particular
requirements does it? It's usually just unzip and go.

>
> I'm not sure what to make of "set EH_DIR=%~dp0".

Sets %EH_DIR% to the folder that the batch script was run in.

>
> Eclipse has way too much overhead for a standalone help system. I
> use OmniHelp for that.

We're using Eclipse Help, that decision is out of my hands.

>

The error given is as follows:

!SESSION Thu Nov 12 17:10:27 GMT 2009 ------------------------------------------
!ENTRY org.eclipse.equinox.launcher 4 0 2009-11-12 17:10:27.504
!MESSAGE Exception launching the Eclipse Platform:
!STACK
java.lang.ClassNotFoundException:
org.eclipse.core.runtime.adaptor.EclipseStarter
	 at java.net.URLClassLoader$1.run(Unknown Source)
	 at java.security.AccessController.doPrivileged(Native Method)
	 at java.net.URLClassLoader.findClass(Unknown Source)
	 at java.lang.ClassLoader.loadClass(Unknown Source)
	 at java.lang.ClassLoader.loadClass(Unknown Source)
	 at org.eclipse.equinox.launcher.Main.invokeFramework(Main.java:556)
	 at org.eclipse.equinox.launcher.Main.basicRun(Main.java:514)
	 at org.eclipse.equinox.launcher.Main.run(Main.java:1311)
	 at org.eclipse.equinox.launcher.Main.main(Main.java:1287)


And when I look inside the org.eclipse.core.runtime jar, there is no 'adaptor'
folder or (obviously) EclipseStarter class. This is a full install of all the
Eclipse plugins. Why is it looking for a class that doesn't exist? Why does it
only do that on other computers?

Richard

--- In eclipse_tw@yahoogroups.com, "rpineger" <marrocdanderfluff@...> wrote:
>
> Thanks for getting back to me so quickly. I hope you don't mind the time lag.
I'm in the UK and finished work shortly after posting. This time, I'll check
again for messages when I get home.
>
> For the time being, I don't want an InfoCentre although we may resort to that
and use Robert's instructions so that the reviewers can see something.
>
> I'm eventually going to put the knowledge base on a CD and so I want it to run
in standalone mode. This 'fileserver' experiment is only for 3 reviewers and is
not a publish, just a review of where we are up to. Unfortunately, it doesn't
work.
>
> I'm using a batch script to run the platform as standalone help the contents
are below. This runs on the original server but not on any other computers.
>
> Thanks in advance for any help you can give me.
>
> Richard
>
> --start-cmd.bat---
>
> set EH_DIR=%~dp0
> set
CLASSPATH=%EH_DIR%plugins\org.eclipse.help.base_3.4.0.v200909170800.jar;%CLASSPA\
TH%
> java org.eclipse.help.standalone.Help -clean -configuration "%temp%\config"
-data "%temp%\data" -command displayHelp
>
> --end--
>

Are the other users trying to launch this from a network directory? If so, their
classpaths are probably wrong, and there are a lot of things that can go wrong
with permissions etc.

I'm not sure what to make of "set EH_DIR=%~dp0".

Eclipse has way too much overhead for a standalone help system. I use OmniHelp
for that.

--- In eclipse_tw@yahoogroups.com, "rpineger" <marrocdanderfluff@...> wrote:
>
> Thanks for getting back to me so quickly. I hope you don't mind the time lag.
I'm in the UK and finished work shortly after posting. This time, I'll check
again for messages when I get home.
>
> For the time being, I don't want an InfoCentre although we may resort to that
and use Robert's instructions so that the reviewers can see something.
>
> I'm eventually going to put the knowledge base on a CD and so I want it to run
in standalone mode. This 'fileserver' experiment is only for 3 reviewers and is
not a publish, just a review of where we are up to. Unfortunately, it doesn't
work.
>
> I'm using a batch script to run the platform as standalone help the contents
are below. This runs on the original server but not on any other computers.
>
> Thanks in advance for any help you can give me.
>
> Richard
>
> --start-cmd.bat---
>
> set EH_DIR=%~dp0
> set
CLASSPATH=%EH_DIR%plugins\org.eclipse.help.base_3.4.0.v200909170800.jar;%CLASSPA\
TH%
> java org.eclipse.help.standalone.Help -clean -configuration "%temp%\config"
-data "%temp%\data" -command displayHelp
>
> --end--
>

Thanks for getting back to me so quickly. I hope you don't mind the time lag.
I'm in the UK and finished work shortly after posting. This time, I'll check
again for messages when I get home.

For the time being, I don't want an InfoCentre although we may resort to that
and use Robert's instructions so that the reviewers can see something.

I'm eventually going to put the knowledge base on a CD and so I want it to run
in standalone mode. This 'fileserver' experiment is only for 3 reviewers and is
not a publish, just a review of where we are up to. Unfortunately, it doesn't
work.

I'm using a batch script to run the platform as standalone help the contents are
below. This runs on the original server but not on any other computers.

Thanks in advance for any help you can give me.

Richard

--start-cmd.bat---

set EH_DIR=%~dp0
set
CLASSPATH=%EH_DIR%plugins\org.eclipse.help.base_3.4.0.v200909170800.jar;%CLASSPA\
TH%
java org.eclipse.help.standalone.Help -clean -configuration "%temp%\config"
-data "%temp%\data" -command displayHelp

--end--

It's not clear to me what you mean by "run" and what you're trying to
accomplish. You want knowledge base created as an Eclipse help plugin to run on
a server and be accessible on your intranet and/or over the Internet?

Have you configured this as an Infocenter (server-based Eclipse help)?

Have you started the Infocenter service using something like helpbase.jar
org.eclipse.help.standalone.Infocenter?

Using a browser running on the server can you can load it using
http://localhost:8081/help or http://127.0.0.1:8081/help?

Using a browser running on the server can you can load it using
http://<serverIP>:8081/help ?

Using a browser running on some other computer can you can load it using
http://<serverIP>:8081/help ?

--- In eclipse_tw@yahoogroups.com, "rpineger" <marrocdanderfluff@...> wrote:
>
> Hi, I'm having trouble getting my Eclipse knowledge base to run from anywhere
other than the server on which it was created. Ideally we want to put it on a
fileserver for review by a few colleagues. We are reviewing the full
functionality, and so we want the standalone help. Unfortunately, it refuses to
run. It also refuses to run wherever it is copied such as to people's local
disks.
>
> I suspect that Windows XP now needs some kind of digital signing to be
implemented before it will run programs from foreign sources. Is this the case?
If so, does anyone know of any useful resources where I can read about it?
>
> Regards,
>
> Richard
>

Hi, I'm having trouble getting my Eclipse knowledge base to run from anywhere
other than the server on which it was created. Ideally we want to put it on a
fileserver for review by a few colleagues. We are reviewing the full
functionality, and so we want the standalone help. Unfortunately, it refuses to
run. It also refuses to run wherever it is copied such as to people's local
disks.

I suspect that Windows XP now needs some kind of digital signing to be
implemented before it will run programs from foreign sources. Is this the case?
If so, does anyone know of any useful resources where I can read about it?

Regards,

Richard

• META-INF (folder)
  
• MANIFEST.MF
• .PROJECT
• build.properties
• docs_toc.xml
• eclipse_toc.xml
• plugin.xml

• META-INF (folder)
  
• MANIFEST.MF
• .PROJECT
• build.properties
• docs_toc.xml
• eclipse_toc.xml
• plugin.xml

Hi Ted,

Your message reminded me of the time when you weren't seeing your CSS file being
applied to the "contents" topic pages that the Eclipse help auto-generates.

Did you find out what was causing that issue?

(I don't have an immediate insight on the inability for "hidden" to not work in
your setup. My expectation is the same as yours: if <tocOrder> is having an
effect, then <hidden> in the same helpData file ought to have an effect.)

Best regards,
Lee Anne

David  - thanks for your help. My content is chunked, so I'm on the right track.

I'll see how far I can get solo and then tap the docbook-apps list for help
if/when I need it.

Thanks again!

Andrew

--- In eclipse_tw@yahoogroups.com, David Cramer <david@...> wrote:
>
> That can certainly be done. Study the code in the DocBook xsls that
> generates the toc.xml file. What you'll want to do is generate something
> like that (but perhaps a properties file or mapping file, whatever you
> and the webapp developer agree on) that instead maps keys to file names.
> So maybe you'll have
>
> <section>
> <?chs somekey?>
> <title>Blah</title>
> ....
> </section>
> <section>
> <?chs someotherkey?>
> <title>Blah</title>
> ...
> </section>
>
> Then your customization of the docbook xsls will spit out a mapping file
> in the desired format, perhaps:
>
> somekey=ch01s01.html
> someotherkey=someid.html
>
> If every section is a chunk, it's pretty easy. If you've configured your
> docbook xsls so that not every section is a chunk, then you'll need some
> logic to figure out whether the section is a chunk or just part of a
> larger chunk. If it's part of a larger chunk, then you'll also need to
> emit anchors where the PIs are encountered so you can link to that spot
> in the page.
>
> To get help on the specifics of the customization, the docbook-apps
> mailing list would be a more appropriate place to direct your questions.
>
> David
>
>
> wanderconsulting wrote:
> >
> >
> > Ideally, I'd like to embed topic codes into my source XML and have
> > those codes referenced by the the application.
> >
> > For example, I could have a chapter in the XML called "User Profiles"
> > where I could add a reference code of "user_profiles". I would want to
> > code the application's help button to go to Infocenter and pass along
> > this code and have Infocenter launch into the User Profiles chapter.
> >
> > This way, the whole thing is topic-driven and my HTML file names could
> > change but the CSH would still work. Does this make sense?
> >
> > Is it achievable?
> >
> > --- In eclipse_tw@yahoogroups.com
> > <mailto:eclipse_tw%40yahoogroups.com>, David Cramer <david@> wrote:
> > >
> > > Correct, #1 applies only to HTML Help (.chm) output.
> > >
> > > For a web app, you can do whatever you want, as long as the web app
> > ends
> > > up being able to construct the right url to your infocenter. Probably,
> > > you'll keep the base url and the various target pages in a properties
> > > file in the webapp.
> > >
> > > David
> > >
> > > wanderconsulting wrote:
> > > >
> > > >
> > > > Thanks David.
> > > >
> > > > What I was hoping I could accomplish is this:
> > > >
> > > > 1- add tags to my DocBook content as per the instructions here:
> > > > http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp
> > <http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp>
> > > > <http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp
> > <http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp>>
> > > >
> > > > 2- publish DocBook XML to HTML
> > > >
> > > > 3- deploy HTML in Infocenter plugin
> > > >
> > > > 4- Create a URL to the Infocenter *with* reference to a specific
> > > > topicID and have the Infocenter open up the corresponding topic
> > > >
> > > > My sense is that step #1 - as documented in the above link - is
> > > > specific to HTML publishing only and won't contribute to my
> > subsequent
> > > > deployment in an Infocenter.
> > > >
> > > > Anyone doing CSH with Infocenter in this way?
> > > >
> > > >
> > >
> >
> >
>

That can certainly be done. Study the code in the DocBook xsls that
generates the toc.xml file. What you'll want to do is generate something
like that (but perhaps a properties file or mapping file, whatever you
and the webapp developer agree on) that instead maps keys to file names.
So maybe you'll have

<section>
<?chs somekey?>
<title>Blah</title>
....
</section>
<section>
<?chs someotherkey?>
<title>Blah</title>
...
</section>

Then your customization of the docbook xsls will spit out a mapping file
in the desired format, perhaps:

somekey=ch01s01.html
someotherkey=someid.html

If every section is a chunk, it's pretty easy. If you've configured your
docbook xsls so that not every section is a chunk, then you'll need some
logic to figure out whether the section is a chunk or just part of a
larger chunk. If it's part of a larger chunk, then you'll also need to
emit anchors where the PIs are encountered so you can link to that spot
in the page.

To get help on the specifics of the customization, the docbook-apps
mailing list would be a more appropriate place to direct your questions.

David


wanderconsulting wrote:
>
>
> Ideally, I'd like to embed topic codes into my source XML and have
> those codes referenced by the the application.
>
> For example, I could have a chapter in the XML called "User Profiles"
> where I could add a reference code of "user_profiles". I would want to
> code the application's help button to go to Infocenter and pass along
> this code and have Infocenter launch into the User Profiles chapter.
>
> This way, the whole thing is topic-driven and my HTML file names could
> change but the CSH would still work. Does this make sense?
>
> Is it achievable?
>
> --- In eclipse_tw@yahoogroups.com
> <mailto:eclipse_tw%40yahoogroups.com>, David Cramer <david@...> wrote:
> >
> > Correct, #1 applies only to HTML Help (.chm) output.
> >
> > For a web app, you can do whatever you want, as long as the web app
> ends
> > up being able to construct the right url to your infocenter. Probably,
> > you'll keep the base url and the various target pages in a properties
> > file in the webapp.
> >
> > David
> >
> > wanderconsulting wrote:
> > >
> > >
> > > Thanks David.
> > >
> > > What I was hoping I could accomplish is this:
> > >
> > > 1- add tags to my DocBook content as per the instructions here:
> > > http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp
> <http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp>
> > > <http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp
> <http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp>>
> > >
> > > 2- publish DocBook XML to HTML
> > >
> > > 3- deploy HTML in Infocenter plugin
> > >
> > > 4- Create a URL to the Infocenter *with* reference to a specific
> > > topicID and have the Infocenter open up the corresponding topic
> > >
> > > My sense is that step #1 - as documented in the above link - is
> > > specific to HTML publishing only and won't contribute to my
> subsequent
> > > deployment in an Infocenter.
> > >
> > > Anyone doing CSH with Infocenter in this way?
> > >
> > >
> >
>
>

I'm using DocBook xsltproc. I use an eclipse_extend.xsl file in processing which
creates all the topic files. It works great.

The reason I'm going this route even though the app is not from Eclipse is
because Infocenter is the only solution I've found where I can source in XML
(DocBook) and generate a "rich" web-based help experience (search, index,
navigation, hopefully CSH).

--- In eclipse_tw@yahoogroups.com, "rlauriston" <robert@...> wrote:
>
> What are you using to generate the HTML topic files for the Eclipse plug-in
you're running in the infocenter?
>
> The application is not being built with Eclipse Web Tools Platform, is that
correct? Personally I wouldn't pick an Eclipse infocenter to deliver help for a
non-Eclipse Web application.
>
> --- In eclipse_tw@yahoogroups.com, "wanderconsulting" <alight9010@> wrote:
> >
> > Ideally, I'd like to embed topic codes into my source XML and have those
codes referenced by the the application.
> >
> > For example, I could have a chapter in the XML called "User Profiles" where
I could add a reference code of "user_profiles". I would want to code the
application's help button to go to Infocenter and pass along this code and have
Infocenter launch into the User Profiles chapter.
> >
> > This way, the whole thing is topic-driven and my HTML file names could
change but the CSH would still work. Does this make sense?
> >
> > Is it achievable?
> >
> > --- In eclipse_tw@yahoogroups.com, David Cramer <david@> wrote:
> > >
> > > Correct, #1 applies only to HTML Help (.chm) output.
> > >
> > > For a web app, you can do whatever you want, as long as the web app ends
> > > up being able to construct the right url to your infocenter. Probably,
> > > you'll keep the base url and the various target pages in a properties
> > > file in the webapp.
> > >
> > > David
> > >
> > > wanderconsulting wrote:
> > > >
> > > >
> > > > Thanks David.
> > > >
> > > > What I was hoping I could accomplish is this:
> > > >
> > > > 1- add tags to my DocBook content as per the instructions here:
> > > > http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp
> > > > <http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp>
> > > >
> > > > 2- publish DocBook XML to HTML
> > > >
> > > > 3- deploy HTML in Infocenter plugin
> > > >
> > > > 4- Create a URL to the Infocenter *with* reference to a specific
> > > > topicID and have the Infocenter open up the corresponding topic
> > > >
> > > > My sense is that step #1 - as documented in the above link - is
> > > > specific to HTML publishing only and won't contribute to my subsequent
> > > > deployment in an Infocenter.
> > > >
> > > > Anyone doing CSH with Infocenter in this way?
> > > >
> > > >
> > >
> >
>

What are you using to generate the HTML topic files for the Eclipse plug-in
you're running in the infocenter?

The application is not being built with Eclipse Web Tools Platform, is that
correct? Personally I wouldn't pick an Eclipse infocenter to deliver help for a
non-Eclipse Web application.

--- In eclipse_tw@yahoogroups.com, "wanderconsulting" <alight9010@...> wrote:
>
> Ideally, I'd like to embed topic codes into my source XML and have those codes
referenced by the the application.
>
> For example, I could have a chapter in the XML called "User Profiles" where I
could add a reference code of "user_profiles". I would want to code the
application's help button to go to Infocenter and pass along this code and have
Infocenter launch into the User Profiles chapter.
>
> This way, the whole thing is topic-driven and my HTML file names could change
but the CSH would still work. Does this make sense?
>
> Is it achievable?
>
> --- In eclipse_tw@yahoogroups.com, David Cramer <david@> wrote:
> >
> > Correct, #1 applies only to HTML Help (.chm) output.
> >
> > For a web app, you can do whatever you want, as long as the web app ends
> > up being able to construct the right url to your infocenter. Probably,
> > you'll keep the base url and the various target pages in a properties
> > file in the webapp.
> >
> > David
> >
> > wanderconsulting wrote:
> > >
> > >
> > > Thanks David.
> > >
> > > What I was hoping I could accomplish is this:
> > >
> > > 1- add tags to my DocBook content as per the instructions here:
> > > http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp
> > > <http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp>
> > >
> > > 2- publish DocBook XML to HTML
> > >
> > > 3- deploy HTML in Infocenter plugin
> > >
> > > 4- Create a URL to the Infocenter *with* reference to a specific
> > > topicID and have the Infocenter open up the corresponding topic
> > >
> > > My sense is that step #1 - as documented in the above link - is
> > > specific to HTML publishing only and won't contribute to my subsequent
> > > deployment in an Infocenter.
> > >
> > > Anyone doing CSH with Infocenter in this way?
> > >
> > >
> >
>

Actually, I just realized that I'm only hiding docs in Eclipse Help, the help
that comes with our Eclipse application.

For the InfoCenter (which is served from our Web site), I don't need to hide
anything because I include only our product docs and no others.

So, I have 2 different helpData.xml files because on the Web site  the tocs are
ordered whereas in Eclipse, the non-product docs are hidden.

Are you able to remove the offending doc jars and plugins for your InfoCenter?

In my InfoCenter,  there is a reduced set of Eclipse files (down to about 63
plugins/jars) and a different config.ini file.
Thanks to Lee Anne Kowalski, I was able to get my Eclipse 3.4 InfoCenter up and
running with a very different config.ini than that for the Eclipse application.

Here is my InfoCenter config.ini file (be sure to change the eclipse.product
property if you test with this):

********************************************************

#This configuration file was written by:
org.eclipse.equinox.internal.frameworkadmin.equinox.EquinoxFwConfigFileParser
#Thu Sep 11 19:36:01 EDT 2008
#org.eclipse.update.reconcile=false
#osgi.launcherPath=.
#eclipse.p2.profile=SDKProfile
#osgi.instance.area.default=@.../workspace
#osgi.framework=file\:plugins/org.eclipse.osgi_3.4.2.R34x_v20080826-1230.jar
#eclipse.buildId=M20080911-1700
#osgi.bundles=reference\:file\:org.eclipse.equinox.simpleconfigurator_1.0.0.v200\
80604.jar@1\:start
#org.eclipse.equinox.simpleconfigurator.configUrl=file\:org.eclipse.equinox.simp\
leconfigurator/bundles.info
eclipse.product=com.activee.bpel.doc.ActiveVOS


osgi.bundles=org.eclipse.equinox.launcher,org.eclipse.equinox.launcher.win32.win\
32.x86,org.eclipse.equinox.common@2:start,org.eclipse.update.configurator@3:star\
t,org.eclipse.core.runtime@start


#osgi.bundles.defaultStartLevel=4

#osgi.splashPath=platform\:/base/plugins/org.eclipse.platform
#osgi.launcherIni=eclipse
#eclipse.p2.data.area=@.../../p2
#osgi.bundles.defaultStartLevel=4


************************************************

Another thought is that the InfoCenter simply doesn't support hidden files. Have
you checked Bugzilla?

I feel your pain.

Wendy

-----Original Message-----
From: eclipse_tw@yahoogroups.com [mailto:eclipse_tw@yahoogroups.com] On Behalf
Of Ted Kuster
Sent: Tuesday, October 20, 2009 11:35 AM
To: eclipse_tw@yahoogroups.com
Subject: Re: [eclipse_tw] Re: Hiding Eclipse help content from my Infocenter



Thanks, Wendy. Yes on the clean option, and yes on deleting those folders. I've
established that the helpData.xml file is hooked up right, because I can reorder
TOCs with it. But I can't hide anything: neither my own content nor other
content.
To add to the mystery, this is the second installation of Eclipse where this has
been true. Earlier this year I reinstalled the infocenter from scratch using
Eclipse 3.4. I had thought there might be a version discrepancy that could
account for this, but no.
Ted


On Tue, Oct 20, 2009 at 5:56 AM, Wendy Beren <wendy.beren@...
<mailto:wendy.beren@...> > wrote:






	 As a sanity check:

	  Are you restarting the Infocenter (or Eclipse Help) with the -clean option? 
Make sure you're deleting the configuration folders org.eclipse.core.runtime and
org.eclipse.help.base when testing Infocenter iterations.



	 As a test: try hiding your own content



	 Your helpdata.xml looks just about exactly like mine, and I'm able to hide tocs
and indexes.







	 From: eclipse_tw@yahoogroups.com <mailto:eclipse_tw@yahoogroups.com> 
[mailto:eclipse_tw@yahoogroups.com <mailto:eclipse_tw@yahoogroups.com> ] On
Behalf Of Ted Kuster
	 Sent: Tuesday, October 20, 2009 1:12 AM

	 To: eclipse_tw@yahoogroups.com <mailto:eclipse_tw@yahoogroups.com>

	 Subject: Re: [eclipse_tw] Re: Hiding Eclipse help content from my Infocenter





	 Peter,
	 Yes, mine looks exactly like that. I've tried everything I could think of, down
to messing with the indentation, looking for characters with weird encodings,
everything. It just doesn't work.
	 Earlier today, to make sure, I checked that I can reorder the TOC with the
<tocOrder> tag. Yup. The file is set up correctly.
	 Ted

	 On Mon, Oct 19, 2009 at 8:36 PM, Peter Desjardins <peter.desjardins.us
<http://peter.desjardins.us> @gmail.com> wrote:



	 That sounds a little familiar.  I think I had the same problem when I first set
it up.  My hazy memory is that it was a minute problem with the structure of
helpData.xml.  Does yours look like this?

	 Peter

	 <?xml version="1.0" encoding="utf-8"?>
	 <extensions>
	   <tocOrder>
	     <toc id="/com.company.document/toc.xml"/>
	   </tocOrder>
	   <hidden>
	     <toc id="/org.eclipse.pde.doc.user/toc.xml"/>


	     <toc id="/org.eclipse.platform.doc.user/toc.xml"/>

	     <toc id="/org.eclipse.jdt.doc.user/toc.xml"/>
	     <toc id="/org.eclipse.platform.doc.isv/toc.xml"/>
	     <toc id="/org.eclipse.jdt.doc.isv/toc.xml"/>
	   </hidden>
	 </extensions>

	 On Mon, Oct 19, 2009 at 5:11 PM, Ted Kuster <ted@...
<mailto:ted@...> > wrote:



		 That's interesting. I do have my helpData.xml file set up correctly (I can
reorder TOC items at will) but the <hidden> tag has no effect. It was ever thus;
since I started using the Infocenter 2 years ago, I've had to go into some
awkward contortions to paper over my inability to hide things from the TOC.
		 Ted

		 On Thu, Oct 1, 2009 at 12:17 PM, wanderconsulting <alight9010@...
<mailto:alight9010@...> > wrote:



		 I was able to get this to work. Here was the problem (user error):

		 In my plugin_customization.ini file, I had the following entry:

		 org.eclipse.help.base/HELP_DATA=helpData.xml

		 This is INCORRECT. It should be:

		 org.eclipse.help/HELP_DATA=helpData.xml

		 Once I straightened that out and restarted Infocenter, the Workbench help was
gone.

		 Thanks again for your help!





		 --
		 Hasta la victrola siempre






	 --
	 Hasta la victrola siempre






--
Hasta la victrola siempre

Ideally, I'd like to embed topic codes into my source XML and have those codes
referenced by the the application.

For example, I could have a chapter in the XML called "User Profiles" where I
could add a reference code of "user_profiles". I would want to code the
application's help button to go to Infocenter and pass along this code and have
Infocenter launch into the User Profiles chapter.

This way, the whole thing is topic-driven and my HTML file names could change
but the CSH would still work. Does this make sense?

Is it achievable?

--- In eclipse_tw@yahoogroups.com, David Cramer <david@...> wrote:
>
> Correct, #1 applies only to HTML Help (.chm) output.
>
> For a web app, you can do whatever you want, as long as the web app ends
> up being able to construct the right url to your infocenter. Probably,
> you'll keep the base url and the various target pages in a properties
> file in the webapp.
>
> David
>
> wanderconsulting wrote:
> >
> >
> > Thanks David.
> >
> > What I was hoping I could accomplish is this:
> >
> > 1- add tags to my DocBook content as per the instructions here:
> > http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp
> > <http://www.sagehill.net/docbookxsl/HtmlHelp.html#HHContextHelp>
> >
> > 2- publish DocBook XML to HTML
> >
> > 3- deploy HTML in Infocenter plugin
> >
> > 4- Create a URL to the Infocenter *with* reference to a specific
> > topicID and have the Infocenter open up the corresponding topic
> >
> > My sense is that step #1 - as documented in the above link - is
> > specific to HTML publishing only and won't contribute to my subsequent
> > deployment in an Infocenter.
> >
> > Anyone doing CSH with Infocenter in this way?
> >
> >
>