TOPLEAF: Guidelines for upgrading from version 6 to version 7 of the plugin

[gjn2066]

Version 7 of the TopLeaf plugin will shortly be released. When that happens, there are some special guidelines for [u]existing[/u] version 6 users. Most important is to know that the new plugin utilises the newer DITA Toolkit, so both XMetaL and the plugin have to be the same version (6 or 7).

Current plugin users should upgrade as follows:

• Before you start, you need to download the Plugin installer, and obtain a new (free) v7 license key from JustSystems (make sure you have your v6 key info handy).
• Upgrade your XMetaL immediately before upgrading the plugin. You'll probably want to clear the local system copy at {USER}AppDataRoamingSoftQuad beforehand.
• Uninstall the current plugin [u]and[/u] your current TopLeaf.
• Remove or rename the default DITAmap stylesheet. On Windows 7 systems this is typically found in:
       C:ProgramDataTopLeafDITAmap
  Since the installation supplies a new default stylesheet, it cannot proceed until the old stylesheet (along with any local modifications) has been either manually removed or saved under a different name.
• Run the installer (XMTP7.exe).
• Run TopLeaf directly from the Start menu and enter the new key. If it doesn't open the dialog directly you can use [u]Help > Enter License Keys[/u].

Your existing local stylesheets should continue to work normally, but if you have any difficulty with the upgrade, or notice any changes in your output, please mail a description of the problem to [email protected] and we'll get back to you.

Further information, and a link to the installer, is included in the official release note.

Reply

[cms]

Hi

I just upgraded to XMetaL 7 and TopLeaf 7. However, when I try to generate a TopLeaf PDF, the build fails with the following line:

C:UsersblahblahblahAppDataRoamingSoftQuadXMETAL~1DITA_OTbuild_topleaf.xml:133: Composition failed: error 1136

It looks like the block of code this error refers to has to do with pre-processing.

Any ideas what I should try next? Thanks!

Reply

[gjn2066]

The plugin for XMetaL 7.0 has not yet been released, though it will be in about 10 minutes 🙂

Suggest you download the new plugin and re-install following the procedure set out in this thread.

Reply

[jlm05]

I'm not able to find any more information about updating the keys for users who create and maintain stylesheets.

A coworker generated a PDF using the TopLeaf 7 plugin with our existing stylesheets. The stylesheets worked, but the PDF included the watermark.

Once I have the updated key for version 7, do I have to open all of the existing stylesheets so they are “tagged” as being created using a full v7 license, meaning that all of the writers would have to replace their stylesheets even though they haven't really been changed yet?

Reply

[gjn2066]

Several points:

(1) Upgrade for existing v6 users is free. Contact JustSystems for v7 license keys, preferably before you start upgrading. I will ask JS if they wish to address this issue directly.

(2) As you pointed out, the watermarking is a property of the stylesheet, not the system running it. If the stylesheet was created on a fully licensed system, then it should continue to run without watermarking on any TopLeaf Plugin (licensed or not). However, if you change the stylesheet on a basic (unlicensed) system, then you could well see watermarking. Therefore, do not access the stylesheets until you have installed the new keys.

[However, if all you did was upgrade a basic system and try to run a job without touching the stylesheet, then I will need to have a closer look!]

(3) The v7 Plugin can run v6 stylesheets, but the reverse is not true (ie. v6 cannot use v7 stylesheets). In particular, you should NOT have to re-open the stylesheets in v7. They should just work. Get back to me if this is not the case or if the above explanations do not work for you.

Geoff

Reply

[jlm05]

The person who tested the upgrade never touches the stylesheets. I created those stylesheets on a fully licensed TopLeaf system (for XMetal V6).

She only every generates guides using the plugin.

She upgraded XMetal and the TopLeaf plugin, then generated a guide using one of the existing custom stylesheets.

The guide looked OK generally, but had the watermark and also the index was missing completely.

Janice

Reply

[gjn2066]

I'll try to duplicate the effect here and get back to you.

Reply

[gjn2066]

OK, we now know what's causing this and a solution will be available shortly.

Apologies for the inconvenience, watch this space.

Geoff

Reply

[Author]

Posts