WebHelp for XMEE 6.0 Fails

[mmoulder]

When I try to do a WebHelp output from XMEE 6.0 I get the following error:

Target `dita2webhelp' does not exist in this project.

Any thoughts?

Reply

[Derek Read]

This was an issue with the pre-release (beta) versions that a limited number of clients and partners may have. The issue should not affect the official (final) 6.0 release.

The problem with the version you have is that the WebHelp plug-in was not integrated with the DITA OT during (or prior to) installation. The issue may be correctable by running the Multiple HTML output once before trying to generate output using WebHelp (I believe this may trigger proper registration of our WebHelp plug-in). This may or may not be noted in the beta's release notes as we had a few betas and the release notes were still under construction.

However, the best solution would be to uninstall the version you are testing and install the final release of 6.0 (6.0.0.079) once you are able to obtain a copy. It does not have this issue.

Reply

[mmoulder]

This actually is the release version I got today from Sales.

Reply

[Derek Read]

I've done a fresh installation on two different machines today now to double check this and cannot reproduce the issue. You are running version 6.0.0.079?

Reply

[mzwecker]

I fixed this error by redeploying the toolkit.

When generating output, change cmd_dita_ot_per_user_version  =  1
to
cmd_dita_ot_per_user_version  =  0

Reply

[Derek Read]

Still can't reproduce this myself with a clean install.

I'll see if having had 5.5 installed and then installing 6.0 triggers it.

Reply

[mmoulder]

That fixed it by re-deploying the open toolkit. Thanks.

Reply

[simonbate]

Hi Derek, my version is Version#: 6.0.0.079. I see the exact same behavior.  And yes, I did have 5.5 installed previously on my machine.

Reply

[Derek Read]

The problem appears to be that anyone that had 5.5 installed and used it would have had a copy of the DITA OT deployed by 5.5.

When you uninstall 5.5 the software is removed, however, any files updated after the initial installation are left alone. The installer does not consider them files it “owns” (you might have modified them on purpose and want to keep them). This includes the DITA OT in your per-user folder, which is deployed separately for each user on your computer and which is very frequently modified to produce output that varies from the default DITA OT outputs.

If you install 6.0 and generate output it sees that you have a copy of the DITA OT already deployed in your per user folder and so it uses that. However, your copy does not have WebHelp (because it did not exist with 5.5).

Solution is to force the DITA OT to be redeployed.

Before you do this however, be aware that any changes you may have made to the DITA OT files sitting in your per user folder (typically C:Documents and Settings…) will be lost. If you do customize the DITA OT you should read this topic:

http://forums.xmetal.com/index.php/topic,237

For people that just use the DITA OT as is you can simply change the value for the parameter called cmd_dita_ot_per_user_version  = 

This parameter is in Tools > Configure Output > Advanced (tab)

Change the value for to be greater than currently shown (or if not set add the parameter with a value of at least 1). Then the next time you generate output you need to say “yes” when asked if you want to redeploy the DITA OT so that it is redeployed. The redeployed version will be the updated version that ships with 6.0 and that includes webhelp.

Reply

[simonbate]

Thanks, Derek, that did it.

Reply

[Author]

Posts