Atomik Roundtrip 2.1: Tutorials << >>

Chapter 8 Tutorial 5 : Place holders in Atomik Roundtrip

In this tutorial, you will learn about the Atomik Roundtrip place holders feature. Place holders are markers which Roundtrip puts into a document in order that, at a later date, text or pictures from an XML file can be imported into a document, and the place holders replaced by the contents of the XML file which they represented.

The key stages to this tutorial are:

  1. Creating place holders.
  2. Flowing XML text and pictures into place holders.


The objective of this tutorial is to introduce you to the functionality of place holders within Atomik Roundtrip, which can be used to facilitate automated document building.

  1. Open the QuarkXPress document “Tutorial5.qxp”.
  1. Open the appropriate QuarkXPress library “Tutorial5_pc.qxl” or “Tutorial5_mac.qxl”. A library palette will open on your screen. If you are not familiar with QuarkXPress libraries, you may wish to review your QuarkXPress documentation.
  2. Click on the Create Place holder button (
  1. ) in the Roundtrip XML palette. You will be asked to select a DTD and a ruleset. Select ‘Easy_Magazine.dtd’ and ‘Easy_Magazine.rls’ from the pop-up menus.
  2. A new item will be added to the Focus tab of the Roundtrip XML palette. Select this item (it should be the only item in the Focus tab of the Roundtrip XML palette), and then switch to the DTD tab of the Roundtrip XML palette. As you probably expect by now, you’ll see the structure of the Easy_Magazine.dtd DTD.
  3. In your library, you have multiple elements. Select the item which contains multiple text boxes arranged in an ‘article’ shape, and drag it onto the QuarkXPress document page. (Please see picture on the left if you are unsure which item to drag from the library).
  1. From the DTD tab of the Roundtrip XML palette, drag the GameTitle element to the first text box at the top of the group of boxes which you have just dragged onto the page. You will see a place holder inserted into this box. A place holder appears as text inside a magenta box, like so:

Note that you may not always see the entire placeholder marker, due to the size or shape of the text box.

  1. Now drag the standfirst element from the DTD to the second box down. In the largest of the boxes, drag the ReviewText element, and in the final box, to the left, drag the pullquote element. You now have place holders in all your boxes.
  1. Next, repeat steps 5, 6 and 7 above again, so that you’ve dragged a second group of elements onto the page, and assigned a second set of place holders to them. Notice that the place holders in your first group of elements are labelled ‘GameTitle 1’, ‘Standfirst 1’, etc, whilst those in the second group of elements are labelled ‘GameTitle 2’, ‘Standfirst 2’.

Atomik Roundtrip allows you to create sequential place holders, meaning that an XML file, like our sample file, which contains 4 game reviews, each containing various different (but identically named) elements, can be imported, with each review being imported into an appropriate set of boxes.

  1. Now click the ‘Import XML’ button (
  1. ) in the Roundtrip XML palette (or select import XML from the Roundtrip menu), and select the ‘Tutorial5.xml’ file. Ensure that the option ‘Flow XML into Placeholders on Import’ is selected.

Alternatively, you can click on the newly imported ‘Tutorial5.xml’ file (in the ‘Focus’ tab of the Roundtrip XML palette), then click the ‘Flow XML into place holders (

) button in the Roundtrip XML palette, or select ‘Flow XML into placeholders’ from the Atomik Roundtrip menu. Note: XML can also be flowed into the document automatically by activating the preference, ‘Flow XML XML into PlaceHolders on Import’ in Roundtrip Application Preferences.

      The text from the XML file which corresponds to the place holders which you’ve placed in your document is imported into the designated boxes, and, of course, styled correctly.

      Place holders can be used as a starting point for automated document building in a highly templated environment.