System Administrator Guide 

Quark Publishing Platform Clients — Manual configuration

You can change a variety of configuration options for Quark Publishing Platform clients and Platform XTensions after installation. See the following topics for more information.

Creating and maintaining the log file (macOS only)

The setting to create and maintain the log file is mentioned in the com.quark.qpp.client.Quark.QPP.Client.config.plist file. This file can be found here: ~/Library/Preferences\Quark\QPP\{version}.

To change the location of the log file, define the new log location using the LogFileName attribute. The default log location is ~/Library/Logs/Quark Publishing Platform Client.Log

To change the log file size, define the new size using the LogFileSize attribute.

Users can enable and disable the logging of exceptions using the LogException attribute.

The supported values are:

  • (NO) Disables the exception logging

  • (YES) Enables the exception logging

Creating and maintaining the log file (Windows only)

The setting to create and maintain the log file is mentioned in the Quark.QPP.Client.config file. This file can be found where the application is installed. Users can enable and disable logging using the QPSLogIsEnabled attribute.

The supported values are:

  • 0 (NO)

  • 1 (YES)

To change the location of the log file, define the new log location using the QPSLogFile attribute. The default log location:

  • for Quark Publishing Platform client is AppData\Quark Inc\Quark Publishing Platform\{version}\Logs

  • for Platform Client related operations in QuarkXPress is AppData\Roaming\Quark Software Inc\QuarkXPress {version}\{version}\Logs

To change the size of the log file size, define the new size using the QPSLogFileSize attribute. The size is defined in Bytes. The default value of the Out of the Box config is 5242880 bytes.

Use the QPSLogFileMode attribute to specify how the log file is written.

Allowed values are:

  • 1 (CreateNew). Specifies that the operating system should create a new file. If the file already exists, a System.IO.IOException is thrown.

  • 2 (Create). Specifies that the operating system should create a new file. If the file already exists, it will be overwritten.

  • 3 (Open). Specifies that the operating system should open an existing file. If the file does not exist, a System.IO.FileNotFoundException is thrown.

  • 4 (OpenOrCreate). Specifies that the operating system should open a file if it exists, otherwise, a new file should be created.

  • 5 (Truncate). Specifies that the operating system should open an existing file. Once opened, the files should be truncated so that the file size is zero bytes.

  • 6 (Append). Opens the file if it exists and seeks to the end of the file, or creates a new file.

FileMode - OpenOrCreate (4) allows one to open a file with the following access : FileAccess.Read, FileAccess.Write, FileAccess.ReadWrite, FileAccess.Append. Attempting to read from a file opened with FileMode - Truncate (5) will throw an exception.

The QPSLogFileShare provides the option to restrict or share the log file created with other processes.

Allowed values are:

  • 0 (None). Declines sharing of the current file.

  • 1 (Read). The default value. Allows opening of the file for reading.

  • 2 (Write). Allows opening of the file for writing.

  • 3 (ReadWrite). Allows opening of the file for reading or writing.

  • 4 (Delete). Allows subsequent deleting of a file.

  • 16 (Inheritable). Makes the file handle inheritable by child processes.

To specify the maximum number of backup log files us the QPSLogFileBackupNumber attribute.

Creating and maintaining the log file (Quark XML Author for Platform)

The following configuration in the Quark.CMSAdapters.config file allows the system integrator or user to set the log file path:

<!-- Defines log file path.-->
    <add key="LogFilePath" value="%APPDATA%\Quark\XML Author\Logs\CMS Adapter Log.txt"/>

The setting to create and maintain the log file is mentioned in the Quark.QPP.Client.config file. This file can be found in the application folder. Users can enable and disable logging using the QPSLogIsEnabled attribute.

The supported values are:

  • 0 (NO)

  • 1 (YES)

To change the location of the log file, define the new log location using the LogFilePath attribute. The log location is AppData\Quark\XML Author\Logs\CMS Adapter Log.txt

To change the size of the log file size, define the new size using the QPSLogFileSize attribute. The size is defined in Bytes. The default value is 5242880 bytes.

Use the QPSLogFileMode attribute to specify how the log file is written.

Allowed values are:

  • 1 (CreateNew). Specifies that the operating system should create a new file. If the file already exists, a System.IO.IOException is thrown.

  • 2 (Create). Specifies that the operating system should create a new file. If the file already exists, it will be overwritten.

  • 3 (Open). Specifies that the operating system should open an existing file. If the files does not exist, a System.IO.FileNotFoundException is thrown.

  • 4 (OpenOrCreate). Specifies that the operating system should open a file if it exists, otherwise, a new file should be created.

  • 5 (Truncate). Specifies that the operating system should open an existing file. Once opened, the files should be truncated so that the file size is zero bytes.

  • 6 (Append). Opens the file if it exists and seeks to the end of the file, or creates a new file.

FileMode - OpenOrCreate (4) allows one to open a file with the following access : FileAccess.Read, FileAccess.Write, FileAccess.ReadWrite, FileAccess.Append. Attempting to read from a file opened with FileMode - Truncate (5) will throw an exception.

The QPSLogFileShare provides the option to restrict or share the log file created with other processes.

Allowed values are:

  • 0 (None). Declines sharing of the current file.

  • 1 (Read). The default value. Allows opening of the file for reading.

  • 2 (Write). Allows opening of the file for writing.

  • 3 (ReadWrite). Allows opening of the file for reading or writing.

  • 4 (Delete). Allows subsequent deleting of a file.

  • 16 (Inheritable). Makes the file handle inheritable by child processes.

Suppressing the accessibility services warning - macOS

By default, an alert indicating that "Accessibility services are not enabled" may display at launch in Quark Publishing Platform Client for macOS. To prevent this warning from displaying:

  1. Control+click the Quark Publishing Platform Client application icon and choose Show Package Contents. A new window displays.

  2. Open the "Info.plist" file in a text editor.

  3. Locate the following lines:

    <key>QPPDisableAccessibilityWarning</key>
    <string>0</string>
  4. Change the zero in the <string> element to a 1.

Displaying revision comments

By default, when you display the View Revisions dialog box, you must expand each revision to see its revision comments. To make revision comments display automatically on macOS:

  1. Navigate to ~/Library/Preferences/Quark/QPP/[QPP Framework Version].

  2. Open the file named "com.quark.qpp.client.[Application Name].config.plist" in a text editor.

  3. Locate the following lines:

    <key>ExpandAllRevisionComments</key>
    <false/>
  4. Change the <false/> element to <true/>.

On Windows, open the "[application name].exe.config" file, locate the following line, and change the zero to a 1.

<add key ="ExpandAllRevisionComments" value="0"/>

Displaying first and last names

You can configure Quark Publishing Platform to show user names in one of three ways:

  • [username]

  • [username] ([first name] [last name])

  • [username] ([last name], [first name])

To change this setting:

  • For Quark Publishing Platform Client for macOS, open the file ~/Library/Preferences/Quark/QPP/[QPP Framework Version]/com.quark.qpp.client.{Application}.config.plist, locate the following text, and set the <string> value to 0 for [username], 1 for [username] ([first name] [last name]), or 2 for [username] ([last name], [first name]):

    <key>UserNameFormattingStyle</key>
    <string>0</string>
  • For Quark Publishing Platform Client for Windows, open the "Quark Publishing Platform Client.exe.config" file (in the Quark Publishing Platform Client application folder), locate the following text, and set the value attribute to DEFAULT for [username], FIRSTNAME_LASTNAME for [username] ([first name] [last name]), or LASTNAME_FIRSTNAME for [username] ([last name], [first name]).

     <add key="UserNameFormattingStyle" value="DEFAULT"/> 
  • For QuarkXPress for macOS, open the file ~/Library/Preferences/Quark/QPP/[QPP Framework Version]/com.quark.qpp.client.{Application}.config.plist, locate the following text, and set the <string> value to 0 for [username], 1 for [username] ([first name] [last name]), or 2 for [username] ([last name], [first name]):

    <key>UserNameFormattingStyle</key>
    <string>0</string>
  • For QuarkCopyDesk for macOS, open the file ~/Library/Preferences/Quark/QPP/[QPP Framework Version]/com.quark.qpp.client.{Application}.config.plist, locate the following text, and set the <string> value to 0 for [username], 1 for [username] ([first name] [last name]), or 2 for [username] ([last name], [first name]):

    <key>UserNameFormattingStyle</key>
    <string>0</string>
  • For QuarkXPress and QuarkCopyDesk for Windows, open the "Quark.QPP.client.config" file (in the application folder), locate the following text, and set the value attribute to DEFAULT for [username], FIRSTNAME_LASTNAME for [username] ([first name] [last name]), or LASTNAME_FIRSTNAME for [username] ([last name], [first name]).

     <add key="UserNameFormattingStyle" value="DEFAULT"/> 

Changing the preview font and size (Windows only)

To change the font and size used for attribute values to a font other than the default search palette font and size, add the following key to the <appSettings> section of the “Quark Publishing Platform Client.exe.config” file, with the desired font and size in the “value” attribute:

<add key="FontName_Text Preview" value="Arial, 18"/>

Setting maximum number of assets to be fetched (Windows only)

To change the maximum number of assets fetched per collection when the user performs a Get Asset command or a Get Collection command, add the following key to the <appSettings> section of the “Quark Publishing Platform Client.exe.config” file, with the desired number in the “value” attribute:

<add key="MaximumAssetFetchPerCollection" value="50"/>

The default value is 50.

Specify whether to use Chunked Encoding (Windows only)

To specify whether or not to use Chunked Encoding when transferring files on HTTP, add the following key to the <appSettings> section of the “Quark Publishing Platform Client.exe.config” file. Supported values are 0 and 1.

<add key="UseChunkedEncoding" value="0"/>

The default value is 0.

Specify support for lazy loading when searching (Windows only)

To specify support for the lazy loading strategy for searching, add the following key to the <appSettings> section of the “Quark Publishing Platform Client.exe.config” file, with the desired strategy in the “value” attribute:

<add key="LazyLoadingMode" value="LAZY_LOADING_SCROLLBAR"/>

The supported values are:

  • NO_LAZYLOADING: All assets at once configured by the chunk size.

  • LAZY_LOADING_HYPERLINK: The results specified are retrieved based on the chunk size, when the results specified by the chunk size are retrieved, a hyperlink would appear to enable fetching the next chunk of results.

  • LAZY_LOADING_SCROLLBAR: The results specified are retrieved based on the chunk size, the scroll bar would enable fetching the next chunk of results.

The default value is LAZY_LOADING_SCROLLBAR.

Setting the lazy loading chunk size (Windows only)

To change the chunk size of the lazy loading search results to be fetched, add the following key to the <appSettings> section of the “Quark Publishing Platform Client.exe.config” file, with the desired size in the “value” attribute:

<add key="LazyLoadingChunkSize" value="50"/>

The default value is 50.

Setting the service time out values for all remote service references (Windows only)

To change the service timeout value for all remote service references, add the following key to the <appSettings> section of the “Quark Publishing Platform Client.exe.config” file, with the desired time (in seconds) in the “value” attribute:

<add key="ServiceTimeoutInSeconds" value="0"/>

The default value is 0. Use the default value specified in the Platform Server configuration.

Setting the service timeout value for publishing service (Windows only)

To change service timeout value for the publishing service, add the following key to the <appSettings> section of the “Quark Publishing Platform Client.exe.config” file, with the desired time (in seconds) in the “value” attribute:

<add key="PublishingServiceTimeoutInSeconds" value="600"/>

The default value is 600. A value of 0 denotes that the settings specified by ServiceTimeoutInSeconds will be in effect.

Specify the font size of the copy tasting row (Windows only)

To change the font size used for the copy tasting row, add the following key to the <appSettings> section of the “Quark Publishing Platform Client.exe.config” file, with the desired font size in the “value” attribute:

<add key="CopyTastingRowFontSize" value="25"/>

Specify the icon for a file extension (Windows only)

To associate an icon with a specified file extension, add the following key to the <appSettings> section of the “Quark Publishing Platform Client.exe.config” file, with the path to the desired icon in the “value” attribute:

<add key="icon_<file extension>" value="Path of icon"/>

The key specifies the "file extension" and the value specifies the file path.

Controlling password retention (macOS only)

You can configure Quark Publishing Platform clients to remember the user name but not the user password between logins. To configure this option:

  • For Quark Publishing Platform Client, open the file ~/Library/Preferences/Quark/QPP/[QPP Framework Version]/com.quark.qpp.client.{Application}.config.plist, locate the following text, and change <false/> to <true/>:

    <key>RememberPassword</key>
    <false/>
  • For QuarkXPress for macOS, open the file ~/Library/Preferences/Quark/QPP/[QPP Framework Version]/com.quark.qpp.client.{Application}.config.plist, locate the following text, and change <false/> to <true/>:

    <key>RememberPassword</key>
    <false/>
  • For QuarkCopyDesk for macOS, open the file ~/Library/Preferences/Quark/QPP/[QPP Framework Version]/com.quark.qpp.client.{Application}.config.plist, locate the following text, and change <false/> to <true/>:

    <key>RememberPassword</key>
    <false/>

Using Mac clients with a proxy server

If you want macOS clients outside of the firewall to be able to connect to Quark Publishing Platform Server through a proxy server, do the following:

  • For Quark Publishing Platform Client, open the ~/Library/Application Support/Quark/QPP/[QPP Framework Version]/com.quark.qpp.client.{Application}.config.plist file, locate the following text, and change <false/> to <true/>:

    <key>UseProxy</key>
    <false/>
  • For QuarkXPress for macOS, open the ~/Library/Application Support/Quark/QPP/[QPP Framework Version]/com.quark.qpp.client.{Application}.config.plist file, locate the following text, and change <false/> to <true/>:

    <key>UseProxy</key>
    <false/>
  • For QuarkCopyDesk for macOS, open the ~/Library/Application Support/Quark/QPP/[QPP Framework Version]/com.quark.qpp.client.{Application}.config.plist file, locate the following text, and change <false/> to <true/>:

    <key>UseProxy</key>
    <false/>

Using Windows clients with a proxy server

To use a Windows client with a proxy server:

  1. Open the "[application name].exe.config" file and locate the following line:

    <!-- <add key="ProxyAddress" value="http://<proxyname>:<portnumber>"/> -->
  2. Uncomment the line and insert the appropriate proxy details.

  3. Save and close the file.

Mirroring the collection hierarchy on Check Out/Get

By default, Quark Publishing Platform clients mirror the collection hierarchy on their local drive when they check out or get an asset. However, you can change this option.

Turning off collection mirroring: macOS

To turn off collection mirroring on macOS:

  1. For Quark Publishing Platform Client, open the file ~/Library/Preferences/Quark/QPP/[QPP Framework Version]/com.quark.qpp.client.Quark Publishing Platform Client.config.plist, locate the following text, and change <true/> to <false/>:

    <key>MirrorCollectionHierarchy</key>
    <true/>
  2. For QuarkXPress, open the file ~/Library/Preferences/Quark/QPP/[QPP Framework Version]/com.quark.qpp.client.QuarkXPress.config.plist, locate the following text, and change <true/> to <false/>:

    <key>MirrorCollectionHierarchy</key>
    <true/>
  3. For QuarkCopyDesk, open the file ~/Library/Preferences/Quark/QPP/[QPP Framework Version]/com.quark.qpp.client.QuarkCopyDesk.plist, locate the following text, and change <true/> to <false/>:

    <key>MirrorCollectionHierarchy</key>
    <true/>

Turning off collection mirroring: Windows

To turn off collection mirroring on Windows:

  1. For Quark Publishing Platform Client, open the "Quark Publishing Platform Client.exe.config" file, locate the following key, and set value to 0.

    <add key="MirrorCollectionHierarchy" value="1"/>
  2. For QuarkXPress, open the "Quark.QPP.Client.config" file, locate the following key, and set value to 0.

    <add key="MirrorCollectionHierarchy" value="1"/>
  3. For QuarkCopyDesk, open the "Quark.QPP.Client.config" file, locate the following key, and set value to 0.

    <add key="MirrorCollectionHierarchy" value="1"/>

Configuring publishing channels

You can control which publishing channels are supported by Quark Publishing Platform.

Configuring publishing channels: macOS

To configure publishing channels on macOS:

  1. For all Mac OS clients, open the following file:

    ~/Library/Preferences/Quark/QPP/[QPP
    Framework  Version]/com.quark.qpp.publishing.preferences.v7.plist
  2. Locate the following key, which specifies the list of publishing channels that are honored by the client, and add or remove channels.

    <key>EnabledPublishingChannels</key>
    <array>
      <string>qxpPdf</string>
      <string>qxpEpub</string>
      <string>qxpAppStudio</string>
      <string>qxpAppStudioPackage</string>
      <string>busDocPdf</string>
      <string>busDocHtml</string>
      <string>busDocQxp</string>
      <string>busDocAppStudio</string>
      <string>busDocAppStudioPackage</string>
      <string>ditaDocPdf</string>
      <string>ditaDocWordRTF</string>
      <string>ditaDocHtml</string>
      <string>collectBusdocForOutput</string>
      <string>collectDitaForOutput</string>
      <string>smartDocHtml5Publication</string>
      <string>busDocHtml5Publication</string>
      <string>visioDocPdf</string>
      <string>fetchVisioPage</string>
      <string>fetchPowerPointSlide</string>
    </array>
  3. Add or remove the desired publishing channels.

Configuring publishing channels: Windows

To configure publishing channels on Windows:

  1. For Quark Publishing Platform Client, open the "Quark Publishing Platform Client.exe.config" file and locate the following key, which specifies the list of publishing channels that are honored by the client.

    <add key="EnabledPublishingChannels" 
    value="qxpPdf,qxpEpub,qxpAppStudio,qxpAppStudioPackage,
    busDocPdf, busDocHtml,busDocQxp,busDocAppStudio, 
    busDocAppStudioPackage, ditaDocPdf,ditaDocWordRTF,ditaDocHtml,
    qxpAppStudio, collectBusdocForOutput, collectDitaForOutput, smartDocHtml5Publication,
    busDocHtml5Publication, visioDocPdf, fetchVisioPage, fetchPowerPointSlide"/>
  2. Add or remove the desired publishing channels.

  3. For QuarkXPress and QuarkCopyDesk, open the "Quark.QPP.Client.config" file and make the same changes.

Configuring Delivery Channels

You can control which delivery channels are supported by Quark Publishing Platform.

Configuring delivery channels: macOS

To configure delivery channels on macOS:

  1. For all macOS clients, open the following file:

    ~/Library/Preferences/Quark/QPP/[QPP
    Framework Version]/com.quark.qpp.publishing.preferences.v5.plist
     
     
  2. Locate the following lines:

    <key>EnableDeliveryChannels</key>
    <false/>
  3. Change the <false/> element to <true/>

  4. Locate the following key, which specifies the list of delivery channels that are honored by the client:

    <key>EnabledDeliveryChannels</key>
    <array>
     <string>checkInToSharepoint</string>
    <string>checkInToFileNet</string>
    <string>sendEmail</string>
     <string>checkInToDocumentum</string>
    <string>sendToFileSystem</string>
    <string>sendToFTPServer</string>
    </array>
  5. Add or remove the desired delivery channels.

Configuring delivery channels: Windows

To configure publishing channels on Windows:

  1. For all Windows clients, open the following file:

    ~application name.exe.config
     
  2. Locate the following lines:

    <add key ="EnableDeliveryChannels" value="0">
  3. Change the 0 to a 1.

  4. Locate the following line, which specifies the list of delivery channels that are honored by the client:

    <add key="EnabledDeliveryChannels"
    value="checkInToSharepoint,
           checkInToFileNet,
           sendEmail,
           checkInToDocumentum,
           sendToFTPServer,
           sendToFileSystem"/>
  5. Add or remove the desired delivery channels.

Setting preferences for Quark XML Author for Platform

The following settings are also applicable for the Platform Adapter for Microsoft Office.

Setting the Check-out location

To set the Check-out location preference, use the CheckOutLocation key under the <appSettings> section of the “Quark.CMS.Adapters.config” file. This sets the initial preference on first launch of the application.

To change the Check-out location Go to File > Preferences > General and browse to the location you want to set as the Check-out location.

This preference can be reset in this way:

  • Reset to Default : User can change the preferences by changing the CheckOutLocation key under the appSettings section of the “Quark.CMS.Adapters.config” file and using the Advanced > Reset to Default feature.

Setting the file deletion preference on Save and Close

To set the File Deletion preference, use the FileDeletionOption key under the <appSettings> section of the “Quark.CMS.Adapters.config” file. This sets the initial preference on first launch of the application.

To change the file deletion preference Go to File > Preferences > General and select one of the following values:

  1. Delete without Warning

  2. Never Allow Deletion

  3. Ask Before Deletion

This preference can be reset in the following way:

  • Reset to Default : User can change the preferences by changing the FileDeletionOption key under the appSettings section of the “Quark.CMS.Adapters.config” file and using the Advanced > Reset to Default feature.

Setting the quick search preference

To set the Quick Search preference, use the QuickSearchOption key under the <appSettings> section of the “Quark.CMS.Adapters.config” file. This sets the initial preference on first launch of the application.

To change the quick search preference, go to File > Preferences > Search and select one of the following values:

  1. Name

  2. Content

  3. Name and Content

This preference can be reset in the following way:

  • Reset to Default: User can change the preferences by changing the QuickSearchOption key under the appSettings section of the “Quark.CMS.Adapters.config” file and using the Advanced > Reset to Default feature.

Setting the display revision comments preference on Save and Close

To set the Display Revision Comments preference, use the RevisionCommentsDisplayOption key under the <appSettings> section of the “Quark.CMS.Adapters.config” file. This sets the initial preference on first launch of the application.

To change the file deletion preference Go to File > Preferences > Search and select one of the following values:

  1. Always

  2. Never

  3. New Assignments Only

This preference can be reset in the following way:

  • Reset to Default: User can change the preferences by changing the RevisionCommentsDisplayOption key under the appSettings section of the “Quark.CMS.Adapters.config” file and using the Advanced > Reset to Default feature.

Configuring the Platform Adapters for Microsoft Office components for web sharing

The web sharing configuration is only recommended for standalone server installations and not for external web container deployments or EAR based deployments. If web sharing configuration is required under those scenarios you will need to work with Quark Technical Support.

This chapter gives instruction on installing the following Microsoft Office components:

  • Quark Publishing Platform Adapter for Microsoft Office - Word

  • Quark Publishing Platform Adapter for Microsoft Office - Excel

  • Quark Publishing Platform Adapter for Microsoft Office - PowerPoint

The deployment location will be in the "Quark Publishing Platform Server" webapps folder on the Platform server machine.

The following steps need to be completed before installing any of the components:

  1. Copy and extract the archive "Platform<version and build>_Adapter_for_Office.zip".

  2. From the extracted archive, copy/overwrite all files from the folder "webapps\ROOT" to the "Quark Publishing Platform Server\webapps\ROOT" folder.

  3. Copy the contents of the folder "webapps\clientinstallers" to the "Quark Publishing Platform Server\webapps\clientinstallers" folder.

Then perform the steps in the following sections to install the individual components.

Configuring the Quark Publishing Platform Adapter for Microsoft Office - Word

To install the Platform Adapter for Microsoft Word:

  1. Extract the contents of the archive "Word Adapter.zip" file from the webapps\clientinstallers folder on the Platform server machine to the webapps\clientinstallers\Word Adapter folder.

  2. Open the "ConfigureAdapter.bat" file located in the clientinstallers/Word Adapter folder.

  3. Update the HostName/IP and the Port, and then run the Batch file.

Configuring the Quark Publishing Platform Adapter for Microsoft Office - Excel

To install the Platform Adapter for Microsoft Excel:

  1. Extract the contents of the archive "Excel Adapter.zip" file from the webapps\clientinstallers folder on the Platform server machine to the webapps\clientinstallers\Excel Adapter folder.

  2. Open the "ConfigureAdapter.bat" file located in the clientinstallers/Excel Adapter folder.

  3. Update the HostName/IP and the Port, and then run the Batch file.

Configuring the Quark Publishing Platform Adapter for Microsoft Office - PowerPoint

To install the Platform Adapter for Microsoft Excel:

  1. Extract the contents of the archive "PowerPoint Adapter.zip" file from the webapps\clientinstallers folder on the Platform server machine to the webapps\clientinstallers\PowerPoint Adapter folder.

  2. Open the "ConfigureAdapter.bat" file located in the clientinstallers/PowerPoint Adapter folder.

  3. Update the HostName/IP and the Port, and then run the Batch file.

Update published ClickOnce deployments

To update a published ClickOnce deployment package, use the Manifest Generation and Editing Tool (mage.exe), which is installed with Microsoft Visual Studio.

Update the package and the application manifest
  1. Go to Application Files\Quark.CMSAdapters.Office.<component>_%HighestVersion% and delete the "Quark.CMSAdapters.Office.<component>.vsto" file. ,where component is Word, Excel or PowerPoint.

  2. Make updates to the configuration files as required.

  3. Run the Mage tool. Using the Visual Studio Command Prompt from Visual Studio Tools, type mage.exe.

  4. in Mage, open the application manifest "Quark.CMSAdapters.Office.<component>.dll.manifest" in the \Application Files\App_%HighestVersion%\folder.

  5. Select Files and check the When populating add the .deploy extension to any file that does not have it option. Then click on the Populate button, and save the file by either clicking Save or File > Save.

  6. Click Yes in the Validation dialog.

  7. Provide the certificate file location path and its password (if any) by selecting the Sign with certificate file option. Click OK.

Update VSTO
  1. To update the "Quark.CMSAdapters.Office.<component>.vsto" present in the package folder use the following command:

    mage -Update "<path>\Quark.CMSAdapters.Office.<component>.vsto" -AppManifest "<path>\Quark.CMSAdapters.Office.<component>.dll.manifest" -CertFile "<certificate Path>\<certificate>.pfx" -Password "<password>"

  2. Copy the "Quark.CMSAdapters.Office.Word.vsto" file from the package folder to \Application Files\App_%HighestVersion%\.

Manual configuration for QuarkXPress and QuarkCopyDesk XTensions

The QuarkXPress and QuarkCopyDesk XTensions have xml based preferences stored in the QPPXPressXT.xml and QPPCopyDeskXT.xml files in the application preference folder.

In Windows, the QuarkXPress preference folder is located: C:\Users\<username>\AppData\Local\Quark\QuarkXPress 2016 and the QuarkCopyDesk preference folder is located: C:\Users\<user name>\AppData\Local\Quark\QuarkCopyDesk 2016

In macOS, the QuarkXPress preference folder is located: /Volume/users/username/Library/Preferences/Quark/QuarkXPress 2016. The QuarkCopyDesk preference folder is located: /Volume/users/username/Library/Preferences/Quark/QuarkCopyDesk 2016.

Most of the preferences are set using the user interface, but setting the location of the Platform menu items is done manually.

To set the location of the Platform menu items:

  • Set the location attribute in the PlatformMenuItemsLocation node, under the <Basic> section of the “QPPXPressXT.xml” and "QPPCopyDeskXT.xml" files. Set to one of the following values:

    1. 0 File Menu (Default Value)

    2. 1 Platform Menu

    3. 2 to show in both file and Platform Menu