Macromedia FrameMaker - 12.0 XML Author Instruction Manual

Using ADOBE

FRAMEMAKER® 12 XML AUTHOR

Legal notices

For legal notices, see http://help.adobe.com/en_US/legalnotices/index.html.

Last updated 1/16/2014

Chapter 1: Getting Started

Activation and registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1

Help and support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2

Services, downloads, and extras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3

Chapter 2: About FrameMaker XML Author

Author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

Collaborate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

Review . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6

Feature Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6

Chapter 3: FrameMaker XML Author Basics

User interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Accessibility features in FrameMaker XML Author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Opening, saving, and closing documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Restore last session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

iii

Chapter 4: Variables, line numbers, and document creation

Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Line numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Create documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Chapter 5: Text

Adding and editing text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Working with elements in structured documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

Search for items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Check spelling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Use the Thesaurus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Multiple Undo/Redo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Equations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Working with multiple languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

Chapter 6: Tables

About tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Insert, move, or remove a table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Text and graphics in tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Chapter 7: Graphics

Graphics and objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

Using color in text and objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

Anchored frames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

Hotspots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

Object Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178

Using RoboScreenCapture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

Content s

Chapter 8: Dynamic Documents

Markers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

Create hypertext links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

Create ways to start, open, and close applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Test and troubleshoot hypertext documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

Cross-references . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

Chapter 9: Books and Long Documents

About books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Create books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Managing books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Footnotes and endnotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

Conditional documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

Troubleshooting books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

Chapter 10: Working with Documents

Importing and linking files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223

Embedding objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

3D object part links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

Interactive Links for 3D/Multimedia Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

Export text and graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

Smart paste hypertext and MS® Word contents as structured content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Managing files using WebDAV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

Chapter 11: Editing Content

Identify changes by tracking edited text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Track changes at book or map level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

Using Dropbox for review and collaborative writing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

Compare versions to view changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

Determine word and character count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

Import PDF comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

Roundtripping tables, equations, and anchored frames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

Direct OLE support in XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

Chapter 12: Structured Authoring

Introduction to structured authoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

XML with FrameMaker XML Author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

Error console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

Filter By Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

Banner text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290

Regular Expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292

XPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292

Chapter 13: Structured Authoring Using DITA

Why DITA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

DITA support in FrameMaker XML Author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

DITA options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298

DITA topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

Content s

DITA maps and bookmaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

DITA content references (conrefs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314

DITA cross-references and links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318

Find References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323

Assign IDs to elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323

Conditional processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

Us ing DITA Open Toolk it t o Pu bli sh DITA content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326

Chapter 14: Working with Content Management Systems

Adobe Experience Manager (AEM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

Documentum® and SharePoint® . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337

Chapter 15: Scripting in FrameMaker XML Author

What is scripting? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350

Why use scripting? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350

Getting started with scripting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350

Chapter 16: Keyboard Shortcuts

About keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

Navigating through documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

Keys for screen modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

Keys for views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

Dialog boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

Keys for selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

Menu commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

Tab le s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368

Book commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

Keys for finding and changing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

Document utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374

Tex t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

Track Text Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378

Editing text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379

Entering special characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380

Function keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381

Keys for drawing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382

Keys for editing objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384

Keys for adding color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386

Keys for equations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386

Filter By Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400

Hierarchical element insert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400

Markers and variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401

Working with structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401

Element menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402

Other useful shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403

Last updated 1/16/2014

Chapter 1: Getting Started

Before you begin working with your software, take a few moments to read an overview of activation and the many resources available to you. You have access to instructional videos, plug-ins, templates, user communities, seminars, tutorials, RSS feeds, and much more.

Resources

Before you begin working with FrameMaker XML Author, take a few moments to read an overview of activation and the many resources available to you. In addition to the links below, you have access to instructional videos, plug-ins, templates, user communities, seminars, tutorials, RSS feeds, and much more online.

• “Activation and registration” on page 1

• Adobe TV instructional videos for FrameMaker XML Author

• Adobe FrameMaker discussion forum

• Framers -- An email list for FrameMaker discussions

Activation and registration

To review complete system requirements and Adobe Recommendations for your Adobe® FrameMaker XML Author® 12 software, see the product page at

Install the software

1 Close any Adobe applications open on your computer.

2 Insert the installation disc into your disk drive, and follow the onscreen instructions.

Help with installation

For help with installation issues, see the Installation Support Center at www.adobe.com/go/learn_fm_install_en.

License activation

During the installation process, your Adobe software contacts an Adobe server to complete the license activation process. No personal data is transmitted. For more information on product activation, visit the Adobe website at

www.adobe.com/go/activation.

Register

www.adobe.com/products/framemaker.

❖ To register, follow the onscreen instructions in the Registration dialog box, which appears when you first start the

software.

If you postpone registration, you can register at any time by choosing Help > Registration.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

Getting Started

Help and support

Visit the Adobe Support website at www.adobe.com/support/framemaker to access documentation, along with tutorials and troubleshooting information. You can also access customer support information from this page.

Online Help also includes a link to the complete, updated PDF version of Help.

Adobe Community Help

Adobe Community Help is an integrated environment on Adobe.com that gives you access to community-generated content moderated by Adobe and industry experts. Think of Community Help as collections of related items rather than books. Adobe continually curates and adds to these collections.

Bookmark the FrameMaker Help hub page to find the best content on the web about FrameMaker XML Author, including these resources:

• Videos, tutorials, tips and techniques, blogs, articles, and examples for designers and developers.

• Complete online Help, which is updated regularly.

• All other content on Adobe.com, including knowledgebase articles, downloads and updates, Adobe Developer

Connection, and more.

Viewing online Help content

• When you launch Help from within the product, your default web browser (Internet Explorer, Safari, Chrome,

Firefox, etc.) will launch with the product Help content displayed.

• You can then use your browser’s native functionality to search, bookmark, comment, or rate the content.

Accessing Help content

• When you are connected to the Internet and you select help in FrameMaker XML Author, your web browser opens

a Help page on the Adobe website.

• To view FrameMaker XML Author help when you are not connected to the Internet, download the Help PDF of

FrameMaker XML Author on your computer.

For more information on the offline Help, see Offline Help.

Services, downloads, and extras

You can enhance your product by integrating various services, plug-ins, and extensions in your product. You can also download samples and other assets and see various resources to get your work done.

Adobe Exchange

Visit t he Ado b e E xchan ge at www.adobe.com/go/exchange to download samples as well as plug-ins and extensions from Adobe and third-party developers. The plug-ins and extensions can help you automate tasks, customize workflows, create specialized professional effects, and more.

Adobe downloads

Vi si t www.adobe.com/go/downloads to find free updates, trials, and other useful software.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

Getting Started

Adobe Labs

Adobe Labs at www.adobe.com/go/labs gives you the opportunity to experience and evaluate new and emerging technologies and products from Adobe. At Adobe Labs, you have access to resources such as these:

• Prerelease software and technologies

• Code samples and best practices to accelerate your learning

• Early versions of product and technical documentation

• Forums, wiki-based content, and other collaborative resources to help you interact with like-minded users

Adobe Labs fosters a collaborative software development process. In this environment, customers quickly become productive with new products and technologies. Adobe Labs is also a forum for early feedback. The Adobe development teams use this feedback to create software that meets the needs and expectations of the community.

Adobe forums

To reach out to experts in the Adobe RoboHelp community, visit http://forums.adobe.com/community/framemaker. If you comment on a Help page, the comment is automatically posted on the forum. The experts and other users can respond to your comment.

Adobe TV

Visit Adobe T V at http://tv.adobe.com to view instructional and inspirational videos. The Technical Communications channel features videos relevant for technical communicators. The videos on the FrameMaker XML Author channel help you get started.

FrameMaker Developer Center

Vi si t FrameMaker Developer Center for articles written by internal and external RoboHelp users on various user- requested topics.

Other resources

Online Help also includes a link to the complete, updated PDF version of Help.

Visit the Adobe Support website at www.adobe.com/support to learn about free and paid technical support options.

Visit the following resources to interact with the FrameMaker community.

• Adobe Forums: http://forums.adobe.com/community/framemaker

• Adobe Blogs: http://blogs.adobe.com/

• Adobe TV: http://tv.adobe.com/product/framemaker/

Services, downloads, and extras

You can enhance your product by integrating various services, plug-ins, and extensions in your product. You can also download samples and other assets to Help you get your work done.

Adobe downloads

Vi si t www.adobe.com/go/downloads to find free updates, trials, and other useful software.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

Getting Started

Adobe Labs

• Prerelease software and technologies

• Code samples and best practices to accelerate your learning

• Early versions of product and technical documentation

• Forums, wiki-based content, and other collaborative resources to Help you interact with like-minded users

Adobe TV

Visit the technical communications channel on Adobe TV at http://tv.adobe.com/channel/technical-communication for instructional videos on authoring.

Last updated 1/16/2014

Chapter 2: About FrameMaker XML Author

FrameMaker XML Author (FMXA) is an XML authoring solution. It is a fully standards-compliant XML editor. In FMXA, you can create XML content based on a standard such as DITA or any custom structure with the easy-touse and familiar FrameMaker interface.

FMXA is provided for content creators who are authoring entirely in XML. FMXA ships with the WYSIWYG view for writers who prefer not to work in the XML environment, However, for content createors comfortable with raw XML authoring, FMXA also includes the XML and code views. FMXA excludes the FrameMaker functionality that is not specific to XML authoring. For this reason, XML authors will work with a lightweight user interface but with all the FrameMaker tools required for XML authoring.

Author

FMXA is targeted at XML authors - content creators who have the need to author in an XML environment but do not require features such as publishing, template creation, and structure app development. Content creators are provided with the full capabilit y to author in any of the FrameMaker views: WYSIWYG, XML or C ode vie w (

view, and WYSIWYG view” on page 33). You can also add equations to your documents “Using the FrameMaker XML Author Equation Pod” on page 91 or “Using the MathFlow editor from Design Science” on page 122.

For a complete list of features, see the FMXA “Feature List” on page 7.

“XML view, Author

Collaborate

Since the features in FMXA are a subset of the complete FrameMaker feature set, users of both these products can work in a collaborative environment.

An XML document created either in FrameMaker or FMXA will work seamlessly in the other environment. This means that the decision to choose one environment over the other depends completely on the needs of the user. If the content creator and subject matter experts in a team do not require full FrameMaker capability, they can choose FMXA and still exchange XML documents with the FrameMaker users. FrameMaker users on the team can be tasked with publishing (such as Multi-channel publishing), creating the structured apps, and managing templates.

FMXA allows for integration with a variety of industry-standard CMS:

1 Ships with a native connector to “Adobe Experience Manager (AEM)” on page 330

2 rovides connectors to: “Documentum® and SharePoint®” on page 337

FMXA also allows you to share and maintain topics and related files using Dropbox. For details, see “Using Dropbox

for review and collaborative writing” on page 261.

For a complete list of features, see the FMXA “Feature List” on page 7.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

About FrameMaker XML Author

Review

FMXA is targeted at reviewers working in an XML environment. XML authors can create their content in this environment. The content can then be sent to subject matter experts. While PDF is often used as a means for document review, FMXA provides reviewers with the tool to review, comment, and use track changes. to enhance the review process. PDF review, on the other hand can be used for a larger review audience. After completing a PDF review, you can also use the FMXA

For a complete list of features, see the FMXA “Feature List” on page 7.

“Import PDF comments” on page 265 feature.

Feature Overview

From the complete FrameMaker feature set, FMXA takes a large set of features to enable XML authoring. In this regard, it excludes features that are not required by an XML author. For example, FMXA does not include the functionality to create and work with unstructured FrameMaker documents. However, it does include WYSIWYG, Author, and XMLCode views. This allows content creators to perform a large majority of the tasks that they are used to performing in FrameMaker.

While FMXA and FrameMaker are provided as solutions for XML authoring, FrameMaker also supports the FM and MIF formats.

FMXA & FrameMaker

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

About FrameMaker XML Author

Feature List

Featur e FMXA FrameMaker

Authoring

Open, edit, save FM and MIF files No YES

Create, edit, save XML files Yes YES

Enter and modify attributes Yes YES

Validate XML content Yes YES

WYSIWYG, Author, and XML Code Views Yes YES

XPath and XSLT support Yes YES

MathML support Yes YES

FrameMaker book files with XML components Yes YES

Read structured applications Yes YES

Filter content based on attributes and conditional tags Yes YES

DITA support

DITA 1.2, and 1.1 support Yes YES

Filter contents based on DITAVal Yes YES

Create and assemble DITA map Yes YES

Create composite document from DITA map No YES

S1000D support Yes YES

DocBook support No YES

Design and format

Design FrameMaker templates No YES

Prepublish setup: page numbering, book update, adding TOC, index etc. No YES

Create templates and conditional tags No YES

Create or edit Master Page No YES

Create structured applications and edit structapps.fm No YES

Create TOC, indexes, and list of references No YES

Designers and catalogs: paragraph, character, table, object No YES

Publishing

Format menu: fonts, characters, paragraphs, page layouts No ** YES

Publish to PDF No YES

Mutlichannel publishing (HTML5, EPUB 3, MOBI, KF8, etc.) No YES

Review and collaboration

Integration with Microsoft Sharepoint Yes YES

Integration with EMC Documentum Yes YES

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

About FrameMaker XML Author

Feature FMXA FrameMaker

Integration with Adobe Experience Manager Yes YES

Integration with Dropbox Yes YES

Integration APIs for other CMS Yes YES

PDF based reviews Yes YES

Miscellaneous

Attribute config file maker No YES

Conversion tables No YES

Last updated 1/16/2014

Chapter 3: FrameMaker XML Author Basics

User interface

Basics

The Welcome screen

A Welcome screen is displayd each time you open FMXA:

XML Author Welcome screen

From the Welcome screen, you can perform the following tasks:

• Open recent documents

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

•

Creating new FrameMaker XML Author documents, books, CMS connections, DITA maps, DITA files, and XML files

• Access FrameMaker XML Author learning resources

• Access support, product updates, and forums

• Restore last session

Workspace overview

A particular arrangement of elements, such as pods that you use frequently while working on documents, is called a workspace. You can dock, stack, minimize, or make these elements free-floating in your workspace. You can select from several preset workspaces or create one of your own. Once you have arranged the panels and pods, you can save the workspace settings for use later.

The FrameMaker XML Author interface has the following components.

• The Application bar across the top contains a workspace switcher, menus, and other application controls.

• The document window displays the file you’re working on. Document windows can be tabbed and, in certain cases,

grouped and docked.

• Pods help you monitor and modify your work. Examples include marker, variables, cross-references pods. You can

minimize, group, stack, or dock pods.

• The status bar shows text formatting and pagination information for the current document.

Icons

FrameMaker XML Author gives you choice of size and color for the icons. Using preferences, you can set up to use any of the following icons for FrameMaker XML Author interface:

• Large colored icons

• Large grayscale icons

• Regular colored icons

• Regular grayscale icons

Note: Large icons’s size is 26x26pixels and regular icons’ size is 18x18pixels.

Icons according to various Interface settings in the Preferences dialog

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

FrameMaker XML Author 12 icons

Change FrameMaker XML Author icons

You can change FrameMaker XML Author icons between colored\greyscale and large\small.

1 Select Edit > Preferences.

2 In the Preferences dialog, select Interface and choose the preferences for icons.

3 Restart FrameMaker XML Author for the icon preferences to take effect.

Use your own icons

You can also add your own custom icons in FrameMaker XML Author.

1 Locate the toolbar.xml file relevant to your view and mode and open it.

2 Create and place all the icon files in AppData\Roaming\Adobe\FrameMakerXMLAuthor\12\.

3 Locate the Action element relevant to the icon you want to customize. The Action element code looks like the

following:

4 Add the base name of the icon in the base attribute of images element.

5 Create at least 2 icon images for normal and rollover state of the icon.

For example if the icon name is xyz the image names will be xyz_C_S.png and xyz_R_C_S.png. (Here, C= color, S=regular, and R=rollover.) If, however, your icon preferences are set to have large or greyscale icons instead of regular and color, you will use M and L in the icon names.

You can have 8 image files for the following possible combinations of preferences with the base name as xyz:

Preferences Icon names

Size Color Normal Rollover

Large (L) Colored (C) xyz_C_L.png xyz_R_C_L.png

Grayscale (M) xyz_M_L.png xyz_R_M_L.png

Regular (S) Colored (C) xyz_C_S.png xyz_R_C_S.png

Grayscale (M) xyz_M_S.png xyz_R_M_S.png

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

6 You can further add more icon files for icon states, such as dark_normal and dark_rollover by specifying attributes

with data in the relevant element. For example:

<ACTION command="CenterPara"> <images base="P_TextAlignCenter_Md" dark_normal="<icon_name>.png"  dark_rollover="<icon_name>.png" dark_normal_l="<icon_name>.png" dark_rollover_l="<icon_name>.png" />

Preferences dialog

The preferences dialog (Edit > Preferences) has the following settings:

General preferences

Use these preferences to specify settings, such as:

• Product interface

• File saving, naming, and backup

• Handling of embedded objects

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

General preferences A. FrameMaker XMLAuthor interface B. Specify the diagonal size of your monitor C. Select to create a backup file when you save a file for the first-time D. if any, when you open a file in FrameMaker XML Author F. to automatically lock and check-out a file when you download it H. resource links on the bottom of the starter page J. to add a FrameImage facet to bitmap graphics imported by copying L. remember missing font names N.

Specify the number of minutes after which FrameMaker XML Author automatically saves the open file E. Select to display errors,

Text size smaller than the one specified in this field is displayed as XXXX G. Select

Select to check in a file every time you save it I. Select to display learning

Select the type of cross-platform file naming for FrameMaker XML Author to follow K. Select

Select to prevent multiple people from opening the same file M. Select to

Select the file types to be embedded in the PDF

Interface preferences

Use this dialog box to specify whether FrameMaker XML Author should auto-collapse panels to icons or always open documents as tabs.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

E F

IJKL

FrameMaker XML Author Basics

Default interface properties A. Select tool tip appearance type: Normal, Fast, or Hidden B. Switch between dark or light levels of UI brightness C. When disabled, you must click on the panel tab/panel icon to collapse it. When enabled, just click on another panel or in the document to collapse a panel. D. all docked panels permanently E.

Select to make FrameMaker XML Author application icon grayscale F. When you close panels they are hidden

Select to hide

but are still active in memory. Deselect this option to remove panels when you close them. To display them again, choose them from FrameMaker XML Author menus. G. documents as tabbed documents. Deselect to open composite document windows as floating windows. J. place them together, they tend to form tabs in a single document window. Select this option to prevent document tabbing. K. windows display the document name only in the title bar. Deselect to display document name in title bar and tab bar. L.

Select grayscale or colored icons for the interface H. Select large or small sized icons for the interface I. Opens composite

When you drag document windows and

Floating document

Select to open all

documents as tabbed documents. Deselect to open document windows as floating windows.

Alerts

These settings control the display of warnings.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

Alerts A. Select to show warnings on actions that clear the history B. Specify if you want the warning to appear once for a history clearing command or every time you run that command C. input alerts, such as missing fonts, on session restore

Select when you want FrameMaker XML Author to display dialogs with alerts D. Select to display non-

Pods

The pod location criteria determine what should be displayed in the pod list area for an instance by way of identifying its location in the document.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

Pods A. Specify the element names. In FMXA, you can only specify elements styles. B. Specify the first element style C. Specify the second element style

Launch

The Launch preferences help you optimize the startup time of FrameMaker XML Author. Using the Launch preferences, you can optimize the loading of the clients, fonts, language providers, and startup scripts according to your requirement.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

Launch preferences A. Load Adobe Fonts On Startup: Deselect this if you do not require Adobe fonts in a session. B. Delay Load Clients: When you select thi s option , none of the clients such MathFlow and PDF import comments are loaded on startup. C. option, only the English language is loaded on startup. D.

Don't Load Startup Scripts: Specify the startup script names in this field that you do

Delay Load Language Provider: When you select this

not want FrameMaker XML Author to load on startup. Use commas to delimit.

Dropbox

The Dropbox preferences, help you set up the Dropbox app to work with FrameMaker XML Author.

The Dropbox preferences A. Dropbox Folder path: Once you have installed Dropbox, the default path is automatically there as an option in the drop-down. B. Delete files from Dropbox after copying locally: When selected, when you select (File > Dropbox > ) Save Locally or Save Locally With Dependencies, the files are deleted from the Dropbox folder on your machine. C.

Create folder structure for dependencies while uploading or downloading: FrameMaker XML Author creates a folder structure in the Dropbox folder for dependencies similar to the one being uploaded, but not when . When this option is selected, FrameMaker XML Author creates a folder structure similar to the

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

Documentum®

Use these preferences to set up Documentum® file versioning, specify DFS SDK path, and add custom CMS properties to FrameMaker XML Author for Documentum®.

Documentum® CMS preferences

A. Specify how existing objects are overwritten and saved B. Enter the name of a custom attribute to add C. Select to show hidden objects D.

Select to show private cabinets E. Specify the path to DFS SDK

Sharepoint

Use these preferences to set up Sharepoint file versioning and add custom CMS properties to FrameMaker XML Author for Sharepoint.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

Sharepoint preferences A. Specify how existing objects are overwritten and saved B. Enter the name and type of a custom attribute to add

Dictionary

Use these preferences to specify Proximity or Hunspell dictionaries for Spelling, Hyphenation, and Thesaurus for various languages.

Spelling options

Use these preferences to set up Spelling Checker.

Spelling Options A. Auto Spell check B. Select all that you want spell checker to find C. Select all that you want spell checker to ignore D. Click to get default spelling options

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

XML

Use these preferences to set up syntax colors and other display options for XML content in FrameMaker XML Author.

XML preferences A. Select the color preferences for various parts of XML syntax B. Select the font family for displaying the xml tags and content C. Select to display line numbers in the document D.

Select to word wrap

MathML

Use these preferences to set up the MathFlow Editor install path and specify the licence file path. You can also select the Style or Structure editor from this dialog.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

MathML preferences A. Specify the MathFlow editor installation path B. Specify the license file C. Specify the font size of the equations D. Specify the DPI of the image of the equation E & F.

Select from the Style or Structure editors

Tabbed documents

When you open more than one file, the document windows are tabbed. You can open documents as floating windows by clearing the Open Documents As Tabs option in the Interface Preferences dialog box.

Documents appear as tabs in the document view.

However, when you add a generated file, such as a Table Of Content, the generated file appears minimized in the lower left corner of your workspace. There are multiple ways in which you can organize floating and tabbed document windows.

• To dock a document window in a group of document windows, drag the window into the group.

• To rearrange the order of tabbed document windows, drag a window’s tab to a new location in the group.

• To undock a document window from a group of windows, drag the window’s tab out of the group.

Note: When you minimize a floating document window, it covers a part of the FrameMaker XML Author status bar. You cannot move the minimized window to a new location.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

Tips on working with the new interface

Adjust the UI brightness Adjust the UI brightness by using the UI Brightness slider under > Interface.

Combine document windows To consolidate all document windows, floating, minimized, or docked, right-click the

tab bar of the docked document window and select Consolidate All To Here from the menu.

Float document windows Click Arrange Documents icon on the top Application bar and select Float All In Windows.

This arranges all the document windows as cascaded floating panels.

Tile documents Use the Arrange Documents icon to tile document windows vertically or horizonta lly. This is specially

useful for manually comparing documents and layering them side by side.

Bring hidden pods to the front Sometimes while working with floating document windows or when switching

workspaces, the pods may seem difficult to bring to the front.

• Undock the pods by dragging them out using the pod title bar.

• Dock all floating document windows. Right-click the docked tab bar and select Consolidate All To Here or drag and

dock the floating document windows.

Minimize pods to icons Right-click on the pods tab bar and select Collapse To Icons from the menu. This option is

available only if the pods are floating and not docked. To collapse docked pods, click anywhere in the tab bar.

Reopen the pods Choose View > Pods and click any pod name. The entire group of pods open at the bottom of the

workspace.

Reopen a panel Choose Windows and select Panels and select the panel you want to reopen.

Collapse all open panel groups to icons Right-click the tab bar of the panel group and select Collapse To Icons.

Exit the full screen mode Right-click outside the text frame in the document window and select Toggle Screen Mode.

Using Smart catalogs

You can use the Smart catalog as a convenient shortcut to the catalogs available in FrameMaker XML Author. For example, to add a list in a document, use the Smart catalog to quickly search for and select the type of list (dl, li, ol).

To use the Smart catalog

1 Place the cursor at the required location in the document.

For elements and attributes, place the pointer at the element insertion location in the structure view.

2 Press the Smart catalog shortcut key. See, the “Smart catalog shortcut keys” on page 23 defined below.

The Smart catalog dialog displays. The focus of the pointer is now within the text box at the top of the dialog.

3 To search for an item in the current catalog, start typing either the name of the item or the description. As you type,

the list in the dialog is narrowed down.

For example, if you want to insert a list element in a structured document, you can type the name of the list element: ul, ol, or dl. You can, however, also type the description of the element, list, and the dialog list is narrowed down to all the available list items in element catalog.

Note: The list of displayed items in the dialog is limited to 10. If the list exceeds 10, you can use the scrollbar to navigate up and down the list.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

Smart catalog shortcut keys

Shortcut Smart Catalog

Ctrl + 1 Element catalog

Ctrl + 2 Wrap element

Ctrl + 3 Change element

Ctrl + 4 Apply condition

Ctrl + 5 Remove condition

Ctrl + 7 Attributes catalog

To use the Hierarchical Element insert

Make the following configuration changes:

1 Open the maker.ini file location at:

%appdata%\Adobe\FrameMakerXMLAuthor\12

2 Set the following flag to ON:

EnableOldSmartInsert

Customize and manage workspaces

Workspaces in FMXA allow you to set up a custom view of the application with the toolbars, pods, and catalogs displayed and positioned as you want them. For example, you can choose to place the Structure View pod on the right side of the application window and the Elements catalog on the left side. You can choose to only hide all toolbars.

FMXA ships with the Authoring workspace. This is the default workspace for FMXA. However, you can create and manage custom workspaces for your specific requirements.

Save a custom workspace

1 Configure the workspace the way you want it and choose Save Workspace from the workspace switcher on the

Application bar.

2 Type a name for the workspace and click OK.

FrameMaker XML Author remembers the last used workspace across sessions. If you were working in the Review workspace and you close and relaunch FrameMaker XML Author, it loads the custom workspace.

Switch workspaces

❖ Select a workspace from the workspace switcher in the Application bar.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

Use the workspace switcher to switch between workspaces designed for your workflow.

Reset a workspace

By saving the current configuration of panels as a named workspace, you can restore that workspace even if you move or close a panel. The names of saved workspaces appear in the workspace switcher in the Application bar.

❖ Select the Reset Workspace option from the workspace switcher in the Application bar.

Rename a custom workspace

1 Select Manage Workspace from the workspace switcher in the Application bar.

2 Select the workspace and click Rename.

3 Type a new name and click OK twice.

Delete a custom workspace

❖ Select Manage Workspace from the workspace switcher in the Application bar, select the workspace, and then click

Delete.

Interface view options

Display pages more quickly

❖ Do the following:

• Open the document by bypassing the update of imported graphics, cross-references, and text insets. (Opening a

document without updating references makes a document open faster but can slow down the display of individual pages.)

• Turn off the display of graphics by choosing View > Options, deselecting the Graphics option, and clicking Set.

Important: If you deselect the Graphics option and generate a PDF, the graphics do not appear in the PDF.

• Display small text as gray bars by choosing File > Preferences > General, entering a point size in the Greek Screen

Text Smaller box, and clicking Set. Whenever text in your document is in a point size smaller than the size you specified, it appears on the screen as a gray bar.

Last updated 1/16/2014

USING FRAMEMAKER XML AUTHOR 12

FrameMaker XML Author Basics

Change the preset display units

Some text boxes in dialog boxes require a unit of measurement (such as points or inches) for the value you enter. You can specify the default units for font size and line spacing (font size units) and for other measurements (display units). The default units of measurement appear after the values in the text boxes. If you enter a value without a unit of measurement, FrameMaker XML Author uses the default unit.

• To change the preset units, make the appropriate window is active. Select View > Options. Select the values for

Display Units and Font Units, and then click Set.

• To enter different units in a box, make the appropriate window active. Enter an abbreviation for the unit along with

the numeric value. Use cm for centimeters, mm for millimeters, " or in for inches, pc, pi, or pica for picas, pt or point for points, dd for didots, cc or cicero for ciceros, Q for Q units (refers to font size and line spacing for the

Japanese language only).

FrameMaker XML Author converts the entry to the preset display units when you click a command button in the dialog box. For example, if your document display units are picas and you want to set a paragraph indent of 1 inch, enter 1" in the First Indent box. When you click Apply, the measurement changes to the number of picas that corresponds to 1 inch.

Change the spacing of ruler or grid intervals

1 Make the appropriate document window or book window active. If a book window is active, select the documents

you want to affect.

2 Select View > Options. Select a new setting from the Rulers menu or the Grid menu, and click Set.

Show or hide visual guides

You c an sh ow se v e ra l of t he se v i su al guides in a document window:

• Borders around text frames, graphic frames, and imported objects

• Markers, paragraph returns, and other symbols in running text

• Rulers along the top and left side of the window

You can also show a grid of horizontal and vertical lines for drawing, resizing, and aligning graphics. All visual guides are nonprinting, so you do not need to hide them when you print.

1 Make the appropriate document window or book window active. If a book window is active, select the documents

you want to affect.

2 Do the following:

• To show or hide borders, select View > Borders.

• To show or hide the text symbols, select View > Text Symbols.

• To show or hide the rulers, select View > Rulers.

• To show or hide grid lines, select View > Grid Lines.

• To show the element boundaries, select View > Element Boundaries or Element Boundaries (As Tags) in

Structured FrameMaker XML Author. FrameMaker XML Author automatically toggles these two options.

Last updated 1/16/2014

+ 378 hidden pages

Macromedia FrameMaker - 12.0 XML Author Instruction Manual

Legal notices

Contents

Chapter 1: Getting Started

Activation and registration

Install the software

Help with installation

License activation

Register

Help and support

Adobe Community Help

Services, downloads, and extras

Adobe Exchange

Adobe downloads

Adobe Labs

Adobe forums

Adobe TV

FrameMaker Developer Center

Other resources

Services, downloads, and extras

Adobe downloads

Adobe Labs

Adobe TV

Chapter 2: About FrameMaker XML Author

Author

Collaborate

Review

Feature Overview

Feature List

Chapter 3: FrameMaker XML Author Basics

User interface

Basics

The Welcome screen

Workspace overview

Icons

Use your own icons

Preferences dialog

General preferences

Interface preferences

Alerts

Pods

Launch

Dropbox

Documentum®

Sharepoint

Dictionary

Spelling options

MathML

Tabbed documents

Tips on working with the new interface

Using Smart catalogs

To use the Smart catalog

To use the Hierarchical Element insert

Customize and manage workspaces

Save a custom workspace

Switch workspaces

Reset a workspace

Rename a custom workspace

Delete a custom workspace

Interface view options

Display pages more quickly

Change the preset display units

Change the spacing of ruler or grid intervals

Show or hide visual guides