OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

dita-help message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: RE: [dita-help] Eclipse Installation

Thanks for the great information, Jeff.


>> I'm not sure I want to provide a full set of installation instructions in the Guide; do we do this for any of the other technologies?<<


I don’t necessarily think it belongs in the Guide, but from the point of view of making it easy for authors to create Eclipse Help from DITA source, somebody has to make the process more simple. Surely a lot of people who would like to use Eclipse Help give up when the encounter terms such as “platform runtime binaries”, “drops”, “tool plug-ins”, “package”, etc. This probably should be a task for the Eclipse community, but someone needs to do it!


Tony Self



From: Jeff Antley [mailto:jantley@us.ibm.com]
Sent: Friday, 4 June 2010 12:56 AM
To: tself@hyperwrite.com
Cc: dita-help@lists.oasis-open.org
Subject: Re: [dita-help] Eclipse Installation


The phrase "platform runtime binary" on the page about setting up Eclipse help as a standalone application (http://help.eclipse.org/galileo/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_standalone.htm) doesn't line up well with anything on the initial downloads pages, so I understand the frustration.  It does take some digging.

From the Eclipse downloads page (http://eclipse.org/downloads/ ), click the Projects tab, look under "Eclipse Project", and the last entry is "Eclipse Platform".   You can click "Eclipse Project" or the Eclipse Platform link; they go to the same downloads page for the core Eclipse Project.  On the Eclipse Projects downloads page, you'll pick the release you want  (latest release, near the top, is a safe choice), which then takes you to the holy grail.

On the Release Build page, notice that you have several options, depending on what you want from the Eclipse Project.  Scroll about halfway down the page, and finally we see a section named Platform Runtime Binary.  Choose your download based on your OS.

According to the definitions page (reached by clicking the + next to the section title):
"Platform Runtime Binary:  These drops contain only the Eclipse Platform with user documentation and no source and no programmer documentation. The Java development tools and Plug-in Development Environment are NOT included. You can use these drops to help you package your tool plug-ins for redistribution when you don't want to ship the entire SDK."

Note that you can also start from an SDK and create an instance of Eclipse that only contains the plugins needed to run the help as a stand-alone application; see the instructions at the bottom of the "Standalone help" page (in the section entitled "[Optional] Installing a minimal stand-alone help system").

I'm not sure I want to provide a full set of installation instructions in the Guide; do we do this for any of the other technologies?

Jeff Antley  ::  jantley@us.ibm.com
IBM 501  ::  N126  ::  RTP NC 27709
919-254-6397  ::  Fax 919-254-8169

To achieve anything in this game, you must be prepared to dabble on the boundary of disaster.  -- Stirling Moss


"Tony Self" <tself@hyperwrite.com>




06/03/2010 08:03 AM


[dita-help] Eclipse Installation


Hi everyone

In one of my consultancy jobs, the client wants to use Eclipse Help as a
standalone (ie, not related to an Eclipse application) Web delivery option.
However, they have found it difficult to set up the necessary Eclipse
runtimes. To be more specific, it seems to be quite difficult for someone
not intimately familiar with the Eclipse environment to work out what needs
to be installed. As an example, it seems that you may have to download and
install the "Platform Runtime Binary"... what the Dickens does that mean?

In the Help Technologies Guide, Jeff Antley has written a very useful
overview of Eclipse Help and the CS plug-in, but I'm wondering if we need to
go further, and provide clear installation instructions. Perhaps we also
need to put together a minimum Eclipse setup for supporting Help. Unless
this has already been done, in which case we could point to it.

I think Stan has encountered some similar difficulties. What does everyone
think about this issue? Jeff, do you have any advice or suggestions?


Tony Self

To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  Follow this link to all your TCs in OASIS at:

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]