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:
- Creating place holders.
- 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.
- Open the QuarkXPress document “Tutorial5.qxp”.
- 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.
- Click on the Create Place holder button (
- ) 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.
- 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.
- 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).
- 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.
- 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.
- 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.
- Now click the ‘Import XML’ button (
- ) 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.