Skip to main content

Customising presentation

2 replies [Last post]
Simon Fea
Offline
Joined: 2006-02-17

Hi from a newby, who is making progress, but would appreciate some advice.

I'm creating JavaHelp for a Java application that is just starting development - good news - I'm involved early on!

I have previous experience using RoboHelp and HTMLHelp Workshop, so I know what I'm in for.

I've been trialing the pre-release version of HelpBreeze 3.0 for this job.

We will probably want to 'improve' the presentation of Javahelp, but it'll be a while before the programmers get to the Help interface. However, I want to be able to demonstrate a prototype to prove I can control the output.

I created a window called "Simonz" with just one navigation button.

It sort-of works a little - encouraging, but frustrating.

Here is the presentation bit from my hs file:

Simonz

Simonz window

javax.help.BackAction

... and here is part of my TOC xml file

The problems:

If default is true, both topics appear in 'Simonz' window.
If default is false, both topics appear in a default window.

Simonz window does have my custom Back button, but the size and position of the window are ignored.

I can't disable the Favorites tab.

The JavaHelp demos (idedemo.jar etc.) can be opened from Windows (XP) with Javaw, but my trial.jar cannot (I have to run it from within HelpBreeze).

Any advice much appreciated.

Simon

Reply viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
Roger Brinkley

java-help@JAVADESKTOP.ORG wrote:
> It sort-of works a little - encouraging, but frustrating.
>
> Here is the presentation bit from my hs file:
>
>
>

> Simonz height=394 /> Simonz window image="BackArrow">javax.help.BackAction >

>
>
> ... and here is part of my TOC xml file
>
>
> > text="SecondTopic" target="SecondTopic" image=""
> presentationname="Simonz" />
>
> The problems:
>
> If default is true, both topics appear in 'Simonz' window. If default
> is false, both topics appear in a default window.

In the tocitem the presentationname doesn't mean anything without a
presentationtype.

> Simonz window does have my custom Back button, but the size and
> position of the window are ignored.

Bug in V2.0. Fixed in V2.0_01.

> I can't disable the Favorites tab.

You'll have to define all of the helpactions if you want to disable the
Favorites button. If you're talking about diabling the favorites
navigator just don't define it in the helpset file.

> The JavaHelp demos (idedemo.jar etc.) can be opened from Windows (XP)
> with Javaw, but my trial.jar cannot (I have to run it from within
> HelpBreeze).
>

I don't know what trail.jar is. If it's your helpset file then I
wouldn't expect it to work. The helpset files in the demos are
executable jar files. I don't believe that HelpBreeze creates executable
jar files. You can use the hsviewer to view the trail.jar though.

Binky

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

You may leave the list at any time by sending message with no subject and
"SIGNOFF JAVAHELP-INTEREST" in the body to LISTSERV@JAVA.SUN.COM. Archives
are available at http://archives.java.sun.com/archives/javahelp-interest.html.
Submit bug reports at http://java.sun.com/cgi-bin/bugreport.cgi.

Simon Fea
Offline
Joined: 2006-02-17

Thanks for your help.

What's the 'presentationtype' for a main window? I can only see examples of secondary windows in jhug.pdf. However, when I use that, my executable jar file (Trial.jar) crashes.

I think some of my problems are due to partly setting configuration in HelpBreeze and partly editing the hs and xml project files. I'll drop them a line to see what the recommended way to work would be.

HelpBreeze does allow you to create the executable jar file from within the tool by the way.

It looks like the JavaHelp download URL
http://java.sun.com/products/javahelp/download_binary.htm
is for version 2.0.

Can I get hold of V2.0_01 ?

Simon