Pages: 1
Print
Author Topic: DITA Open Toolkit "Deployment" in XMetaL Author Enterprise 5.5 thru 8.0  (Read 9745 times)
Derek Read
Program Manager (XMetaL)
Administrator
Member

Posts: 2621



WWW
« on: March 17, 2009, 01:26:14 PM »

Symptom:
If you make changes to the XSLT/XSL-FO/configs in the DITA Open Toolkit installed with the 5.5 and later releases of XMetaL Author Enterprise they may not take effect when you generate output.

Cause:
In order to support Windows Vista, Windows 7 and limited users on XP, the DITA OT that we install is actually copied to a per-user location before generating output for the first time.

Solution:
Strategies for dealing with this are covered within another thread:
http://forums.xmetal.com/index.php?topic=224.msg687#msg687
« Last Edit: August 25, 2016, 01:00:05 PM by Derek Read » Logged
Derek Read
Program Manager (XMetaL)
Administrator
Member

Posts: 2621



WWW
« Reply #1 on: April 19, 2012, 12:51:11 PM »

Suggested Steps for DITA OT Developers:

To modify and test the DITA OT that we install basic steps are as follows:
  1) Make changes to installed copy in C:\Program Files\Common Files\XMetaL Shared\DITA_OT\
  2) Redeploy the DITA OT to the user's per-user folder (%appdata%) *
  3) Generate output using the XMetaL Author UI (this runs the deployed copy).

* This set of slides might give more insight: http://www.slideshare.net/XMetaL/dita-open-toolkit-deployment-with-xmetal-author-enterprise-6

* Basic steps for redeploying the DITA OT are to do one of these things:

A) Delete the folder %appdata%\SoftQuad\XMetaL Shared\DITA_OT\

Note that most end users cannot see their %appdata% folder (it is hidden by default). So, most people should use the following procedure (B) instead.

B) Use the XMetaL UI to force redeployment (essentially this does the same as A above):
  1. Launch XMetaL Author Enterprise.
  2. Select Tools > Configure Output to open the Configure Output Options dialog.
  3. On the Advanced tab find this parameter and increase the value (in this example from 1 to 2):
    cmd_dita_ot_per_user_version = 1
  4. Click OK to dismiss the Configure Output Options dialog.
  5. Either generate output or select Tools > Configure Output again.
  6. When asked if you would like to upgrade the DITA-OT version select OK.
      The DITA OT will be re-deployed from the installed version
      (%Program Files%\Common Files\XMetaL Shared) overwriting any existing
      copy in %appdata%\SoftQuad\XMetaL Shared
« Last Edit: August 25, 2016, 01:00:23 PM by Derek Read » Logged
Derek Read
Program Manager (XMetaL)
Administrator
Member

Posts: 2621



WWW
« Reply #2 on: May 28, 2014, 01:20:59 PM »

Starting with XMetaL Author Enterprise 9 the DITA OT is both installed and run from the following location by default: %programdata%\SoftQuad\XMetaL\Shared\DITA_OT

On most installations of Windows 7 and 8 that will typically be here: C:\ProgramData\SoftQuad\XMetaL\Shared\DITA_OT

Note that though you should have full read/write access to the %programdata% folder it is a hidden folder in most Windows installations.
« Last Edit: August 25, 2016, 01:02:23 PM by Derek Read » Logged
Pages: 1
Print
Jump to:  

email us