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

12.3 Roundtrip Control Palette

The Roundtrip control palette allows users to see where the content which they are editing on the QuarkXPress page is located within the XML hierarchy, and also to navigate through that hierarchy. Additionally, as with the Roundtrip XML palette, there are several buttons on the palette which give

access to Atomik Roundtrip functions. Whereas the buttons on the Roundtrip XML palette are specific to whatever is selected in the Focus tab of that palette, the functions provided by the top row of buttons in the Roundtrip control palette apply to all the XML documents in the current frontmost document.

The XML document hierarchy is shown for the current location of the QuarkXPress cursor in the frontmost document. Effectively, the user is able to see the tags which surround the XML. The emboldened text shows which tag the QuarkXPress cursor is currently within. Additionally, the text at the top of the palette shows the QuarkXPress document name, and the name of the XML file with which they are working.

The user can navigate through the XML hierarchy using the navigation controls within the control palette.

This navigation is based around the concept of parent, child and sibling elements.

Previous sibling. Navigate to the preceding element within the XML file which is a sibling of this element.

  Next sibling. Navigate to the next element within the XML file  
   
  Parent. Navigate to the parent element of the this element. 
   
  Child. Navigate to the first of any child elements of this element. To  
   
   

The ‘Parent’ and ‘Child’ navigational buttons perform an additional useful purpose. The XML tags used by Roundtrip (represented by magenta carets on the QuarkXPress page on screen have no width, to ensure that they do not affect the flow of text. Because of this, it is not possible to determine on screen whether your cursor is inside or outside the XML tag, nor is it possible to click to either side of the marker to set the cursor’s relative position to the tag. However, you can determine the exact relative position of the cursor to the XML tags by looking at the control palette. Clicking the child and parent buttons will allow you to move the cursor to either side of the XML tags, giving you more precise control over the cursor’s position than can be achieved by simply clicking.

There are also a number of function buttons at the top of the Roundtrip control palette. Their functions are as follows.

  Open QuarkXPress document. Allows the user to open a  
   
   
   
  Export all XML. Allows the user to export all of the XML documents  
   
   
  Save all XML. Will save all of the XML used within the document.  
   
   
  Update all XML from document. This will update all of the XML  
   
   
   
  Update document from all XML. This will update the  
   
   
  Check validity of all XML. This will check the validity of all of the  
   
   
   
  Show Roundtrip XML palette. This will show the Roundtrip XML  
   
   
  Show Ruleset palette. This will show the ruleset palette, which  
   
   
   
  Roundtrip preferences. This will show the Roundtrip preferences  
   
   
  Show Entities Palette. This will show the entities palette.  
  Show Unicode Mappings This will show the Unicode Mappings  
   

your copy of Atomik Roundtrip, and enables you to enter your key code to validate your software..