Atomik Roundtrip 2.1: Reference > Chapter 12 Function Reference << >>

12.4 Roundtrip menu.

The Atomik Roundtrip menu contains almost all of the functions previously described which appear on the Roundtrip XML and Roundtrip Control palettes.

Focus displays a sub menu listing all of the XML documents, placeholders and rulesets in the current QuarkXPress document, just like the focus tab of the Roundtrip XML palette. Selecting an item from this sub-menu sets the focus for the Roundtrip XML palette and the other Roundtrip menu items.

Create has two sub-menus; ‘Create Ruleset’ and ‘Create Place Holder’.

Create Ruleset allows the user to create a new ruleset. The user will be asked to specify a DTD on which to base this ruleset’s structure, and to supply a name for the new ruleset. The ruleset will be stored in the folder specified for rulesets in the Atomik Roundtrip preferences.

Create Place Holder creates a new place holder document, and asks the user to select a DTD (from which the structure of the place holders will be determined) and a ruleset, which will be automatically applied to the XML which is flowed into the place holders.

Import XML allows you to bring in an XML file to the current QuarkXPress document. On import the user is given the option to select a ruleset, which will then be applied to all XML placed into the QuarkXPress document from this XML file. Alternatively, the user can select ‘No Ruleset’, in which case the XML content which is imported must be styled manually, or ‘Default Ruleset’ whereby Roundtrip will look for a ruleset whose name matches that of the DTD declared in the Doctype declaration of the XML file which is being imported. For example, if the XML file conforms to the DTD ‘Easy_Magazine.dtd’, Roundtrip will look for a ruleset named ‘Easy_Magazine.rls’.

Export XML will export an XML document which is currently stored within the QuarkXPress document. The user is asked to specify a location and filename to save this file at. Note that as this action is making a duplicate of the XML document which is stored within the QuarkXPress document, this process does not change the original XML file which was imported into QuarkXPress, unless you save with the same filename to the same location. The Export XML menu item has two sub-menus: “Export XML’ and ‘Export all XML’. The ‘Export XML’ button will export the XML for the XML file which currently has focus (i.e. it is selected in the Focus tab of the Roundtrip XML palette, or through the Roundtrip->Focus menu item). This is equivalent to clicking the ‘Export XML’ button on the Roundtrip XML palette. The ‘Export all XML’ button will export all of the XML stored in the current documents. This is equivalent to clicking the ‘Export All XML’ button on the Roundtrip Control palette.

Save XML saves an XML document which has been imported into QuarkXPress back to its original disk file, along with any changes which have been made in QuarkXPress, and updated into the XML file by selecting ‘Update XML from document’.The Save XML menu item has two sub-menus: ‘Save XML’ and ‘Save all XML’. The ‘Save XML’ button will save the XML for the XML file which currently has focus (i.e. it is selected in the Focus tab of the Roundtrip XML palette, or through the Roundtrip->Focus menu item). This is equivalent to clicking the ‘Save XML’ button on the Roundtrip XML palette. The ‘Save all XML’ menu option will export all of the XML stored in the current documents. This is equivalent to clicking the ‘Save All XML’ button on the Roundtrip Control palette.

Reload XML has two sub-menus, ‘Reload XML’ and ‘Reload all XML’. The ‘Reload XML’ button will reload the XML for the XML file which currently has focus (i.e. it is selected in the Focus tab of the Roundtrip XML palette, or through the Roundtrip->Focus menu item. This is equivalent to importing the XML file again (by clicking ‘Import XML’), but without having to locate and select the XML file again. The ‘Import all XML’ button will attempt to reload all of the XML stored in the current document.

Update XML from Page When a change is made on the QuarkXPress page, selecting ‘Update XML from Page’ writes the change back to the XML document which is stored within the QuarkXPress document, and shown in the Roundtrip XML palette. The ‘Update XML from document’ menu item has two submenus, ‘Update XML from document’, which updates the XML which currently has focus, ‘Update All XML from document’which updates all of the XML stored in the current QuarkXPress documents. This is equivalent to clicking the ‘Update All XML from document’ button on the Roundtrip Control palette.

Update Page from XML flows changes made to the focus XML document onto the QuarkXPress page, applying any ruleset rules as necessary. Note that when updating, only content which has changed will be updated. The ‘Update Document from XML’ menu has two sub-menus, ‘Update document from XML’ and ‘Update document from all XML’. ‘Update document from XML will update the content of the XML document which currently has focus into the QuarkXPress document. ‘Update document from all XML’ will update the QuarkXPress document with the current content of all the XML documents which it contains.

Flow XML into Place Holders Flows text from an imported XML file into place holders which have previously been defined. The QuarkXPress document must contain place holders, and an XML file must be selected in the Focus tab of the Roundtrip XML palette. If the “Flow XML into Place Holders on Import” check box in the Roundtrip Tab of the Preferences is checked, then simply importing an XML document will cause the content to be flowed into placeholders.

Check Validity of XML checks the validity of the XML file against its DTD. The results from this validation will be written to the Error tab of the Roundtrip XML palette. The ‘Check validity of XML’ menu option has two sub menus. ‘Check Validity of XML’ checks the validity of the XML document which currently has focus. ‘Check Validity of All XML’ checks the validity of all XML files in the current document.

Remove XML allows you to choose to remove XML: ‘From Layout’, ‘All From Layout’, ‘From Page’, ‘All From Page’, From Layout and Page’ or ‘All From Layout and Page’ from the frontmost QuarkXPress document that is open.

Compare XML with Page compares the content in the QuarkXPress document with the XML in the XML palette. Any XML element which has changed will be highlighted in bold.

Update Missing Pictures If your XML had references to image files which could not be resolved, a placeholder image will be placed into the document. Selecting this menu option will attempt to resolve the XML references to the image again, and replace the placeholder images with the correct images.

Application Preferences.. displays the QuarkXPress application preferences (just like selecting edit->preferences->application).

About Atomik Roundtrip.. shows detailed information about your copy of Atomik Roundtrip, and enables you to enter your key code to validate your software.

Show / Hide Roundtrip Control will show or hide the Roundtrip control palette.

Show / Hide Roundtrip XML shows or hides the Roundtrip XML palette. This is equivalent to selecting ‘Show Roundtrip XML’ from the View menu in QuarkXPress.

Show / Hide Roundtrip Ruleset shows or hides the ruleset palette, which allows you to edit ruleset entries (rules). Clicking on an element in the Structure tab of the Roundtrip XML palette will change the focus of this palette.

Show / Hide Entities shows or hides the entities palette.

Show / Hide Roundtrip Mappings shows or hides the Roundtrip (Unicode) Mappings palette.

Show / Hide Roundtrip Elements shows or hides the Roundtrip Elements palette.

12.5 Atomik Roundtrip Preferences

The Atomik Roundtrip preferences can be accessed by selecting ‘Preferences’ from the ‘QuarkXPress’ Menu (Mac) or the ‘Edit’ menu (Windows). The Roundtrip preferences are located in three sections in the Application Preferences dialog.

You will notice that the preferences are divided into three sections:

Roundtrip which contains general preferences regarding the operation of the Roundtrip software.

Roundtrip Folders which contains settings for defining which file system folders are used to store items required by Roundtrip.

Roundtrip Keys which contains settings for specifying which shortcut keys can be used to perform certain Atomik Roundtrip functions.