Macromedia FrameMaker - 12.0 Instruction Manual

Using ADOBE

FRAMEMAKER® 12

Legal notices

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

Last updated 1/14/2014

Chapter 1: Getting Started

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

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

Services, downloads, and extras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

What’s new . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Chapter 2: FrameMaker Basics

User interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Accessibility features in FrameMaker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Opening, saving, and closing documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Chapter 3: Templates and Page Layout

Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Master pages and reference pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Page layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Multiflow documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

Line numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Create documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

iii

Chapter 4: Text

Adding and editing text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

Working with elements in structured documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Search for items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Check spelling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

Use the Thesaurus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

Multiple Undo/Redo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

Equations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

Working with multiple languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

Chapter 5: Tables

About tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

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

Text and graphics in tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Formatting tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

Table position and spacing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

Chapter 6: Graphics

Graphics and objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

Using color in text and objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

Anchored frames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

Hotspots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281

Last updated 1/14/2014

USING FRAMEMAKER 12

Contents

Object Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284

Using RoboScreenCapture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286

Chapter 7: Dynamic Documents

Markers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288

Hypertext and view-only documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289

Hypertext commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294

Create hypertext links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302

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

Test and troubleshoot hypertext documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306

Add hypertext links to generated files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

Cross-references . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310

Chapter 8: Books and Long Documents

About books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323

Create books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

Managing books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327

Generate and update books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336

Tables of contents or other lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

Creating indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

Formatting lists and indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

Footnotes and endnotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367

Conditional documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

Troubleshooting books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

Chapter 9: Working with Documents

Importing and linking files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391

Embedding objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411

3D object part links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

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

Export text and graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420

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

Managing files using WebDAV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425

Chapter 10: Editing Content

Identify changes by tracking edited text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430

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

Identify revised text with change bars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434

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

Compare versions to view changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437

Determine word and character count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440

Import PDF comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440

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

Direct OLE support in XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445

Chapter 11: Structured Authoring

Introduction to structured authoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446

Migrating from unstructured FrameMaker to XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453

Last updated 1/14/2014

USING FRAMEMAKER 12

Contents

Converting unstructured files to structured documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463

XML with FrameMaker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464

Enabling S1000D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

Error console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

Filter By Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

Banner text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484

Regular Expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485

XPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486

Chapter 12: Structured Authoring Using DITA

Why DITA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489

DITA support in FrameMaker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490

DITA options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492

DITA topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495

DITA maps and bookmaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498

DITA content references (conrefs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509

DITA cross-references and links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513

Find References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518

Assign IDs to elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518

Conditional processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519

Automating conversion of base files to specialized files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522

Using DITA Open Toolkit to Publish DITA content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523

Chapter 13: Generating Output

Multi-channel publishing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527

Publishing options in the Technical Communication Suite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543

Generating PDFs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544

Authoring for accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553

Generating print output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555

Generating hypertext outputs using XSLT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562

Generating Stand-alone HTML files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567

Chapter 14: Working with Content Management Systems

Adobe Experience Manager (AEM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585

Documentum® and SharePoint® . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592

Chapter 15: Scripting in FrameMaker

What is scripting? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604

Why use scripting? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604

Getting started with scripting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604

Chapter 16: Keyboard Shortcuts

About keyboard shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608

Navigating through documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610

Keys for screen modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610

Keys for views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611

Dialog boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611

Keys for selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614

Last updated 1/14/2014

USING FRAMEMAKER 12

Contents

Menu commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614

Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627

Book commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629

Keys for finding and changing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630

Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631

Document design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633

Document utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634

Text formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636

Character and Paragraph Designers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638

Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639

Track Text Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642

Editing text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643

Entering special characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644

Function keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645

Keys for drawing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645

Keys for editing objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647

Keys for adding color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649

Keys for equations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 650

Filter By Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663

Hierarchical element insert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664

Markers and variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664

Working with structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664

Element menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666

Other useful shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666

Last updated 1/14/2014

Chapter 1: Getting Started

Adobe FrameMaker is an automated multi-channel and multi-device publishing solution. FrameMaker enables publication departments accomplish multichannel publication tasks.

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, 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

• 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® 12 software, see the FrameMaker 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.

Last updated 1/14/2014

USING FRAMEMAKER 12

Getting Started

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

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, 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, your web browser opens a Help page

on the Adobe website.

• To view FrameMaker help when you are not connected to the Internet, download the Help PDF of FrameMaker 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 the Adobe Exchange 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.

Last updated 1/14/2014

USING FRAMEMAKER 12

Getting Started

Adobe downloads

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

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 TV 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 channel help you get started.

FrameMaker Developer Center

Visit FrameMaker Developer Center for articles written by internal and external RoboHelp users on various userrequested topics.

Previous FrameMaker Help

Download the documentation of older versions of FrameMaker from the FrameMaker Help hub page.

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/

Last updated 1/14/2014

USING FRAMEMAKER 12

Getting Started

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

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

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.

What’s new

Adobe® FrameMaker® 12 ships with a number of enhancements such as:

User interface enhancements

Choice of size and color of icons

You can use any of the following combinations of size and color of icons:

• Large colored icons

• Large greyscale icons

• Regular colored icons

Last updated 1/14/2014

USING FRAMEMAKER 12

Getting Started

• Regular greyscale icons

The greyscale icons are of better resolution than the previous versions.

Greyscale icons are of better resolution than previous FrameMaker versions

See the video: Toolbar Icons.

For more information, see “Icons” on page 17.

Currently Opened Files pod

FrameMaker provides Currently Opened Files pod that displays all the currently opened files as a list. Using the Currently Opened Files pod, you can:

1 Review and save files with unsaved changes

2 Search for a file with a specific name or files saved in a particular folder

3 Navigate across different files

4 Review the path of the various open files

5 Close specific files after saving or without saving

See the video: Currently Opened Files Pod.

For more information, see “Currently opened files pod” on page 56 and “Save and close currently opened files” on page 57.

Last updated 1/14/2014

USING FRAMEMAKER 12

Getting Started

New document samples

FrameMaker includes four new, contemporary samples. FrameMaker has the following samples with the theme Space Shuttle. You can access these samples using the template browser or the samples folder.

1 Parts Catalog: A sample book, illustrated catalog of a space shuttle’s parts. This sample includes:

• Book and chapter files along with cover, ToC, and index

• Settings (.sts) file for multichannel publishing

• Sample output files for two different products including PDF, htm, epub, mobi, chm, Responsive HTML5, and

WebHelp for each product

2 Reference Card: A two page multicolumn document: Unpack, Assemble, and Use your own space shuttle.

• A .fm file with the sample content

• An instructions file that has information on how you can customize the template and use it

• Settings (.sts) file for multichannel publishing

• Sample output files including pdf, htm, epub, mobi, chm, Responsive HTML5, and WebHelp

3 User Guide: Space ship operations manual including:

• Book and chapter files along with cover, ToC, and index.

• Sample output files

• Settings file for multichannel publishing

4 User Guide Structured: Space ship operations manual in DITA format. This sample includes

• Structured topic files and ditamap

• ditaval files for conditional processing

• Sample output files

• Settings file for multichannel publishing

You can access this template only through the samples folder:

AdobeFrameMaker12\Structure\xml\TravelDITA

Other user interface enhancements

Drag and drop to open files

You can now open files by dragging and dropping them in empty UI areas, toolbars, or menu bars.

Close button for pods and tab groups

Pods now have a button (on the top right side of the title bar) that you can click to close the pod or the tab group (group of pods).

For more information, see “Close pods and tab groups” on page 38.

Dimensions retained in for RM views

FrameMaker retains the dimensions of the following RM Views on relaunch:

• RM View for Book

• RM View for CMS Repository Browser

• RM View for DitaMap

Last updated 1/14/2014

USING FRAMEMAKER 12

Getting Started

FrameMaker retains the dimensions of the RM views and uses them as default dimensions of these RM views when you close and open them again.

For more information, see “Restore dimensions of RM views” on page 59

Authoring enhancements

Search based on regular expressions

Regular expressions are now available in the WYSIWYG and Author view.

You can search for and replace regular expressions using the Find/Change dialog box.

Select Regular Expression and enter the regular expression code to find in the plain text search of FrameMaker.

FrameMaker supports the Perl (this is the default),Grep, and Egrep syntax for regular expressions. However, you can change the syntax to Grep or Egrep by setting the

For more information, see “Regular expression search and replace” on page 153.

See the video, Regular expressions.

Create and insert QR codes into a document

You can now create and insert QR codes From within FrameMaker. You can assign specific actions such as invoking a URL, sending a text message, or calling a specified number to the QR code.

RegularExpressionSyntax flag in the maker.ini file.

To insert a QR code, click Special -> Insert QR Code.

For more information see “Working with QR codes” on page 415.

See the video, QR codes.

Text background color for paragraphs

In the previous release, FrameMaker supported background color for character tags. In this release, you can set background color for paragraphs as well. The background color in now applied with uniform height.

In the Advanced tab of Paragraph Designer, select a color in the Pgf Box drop-down and click Update. The selected color is applied to the Paragraph format.

For more information, see “Set background color of a paragraph box” on page 71.

Single sourcing enhancements

Conditional Tags pod

The new Conditional Tags pod makes it easier for you to create and manage conditional text settings by providing an improved and unified interface. You can conveniently create, edit, and delete conditional tags, apply and show/hide conditional tags, and search for various attributes (for example, tag name, styles, or color).

See the video: Conditional Tags Pod.

For more information, see “Conditional Tags pod” on page 374, “States of conditional tags” on page 375, and “Automatic validation and visual cues in the conditional expressions” on page 379.

Last updated 1/14/2014

USING FRAMEMAKER 12

Getting Started

Building complex conditional expressions with parenthesis support and UI guides

FrameMaker now allows you to use parentheses in Boolean condition expressions. This makes it easy to create complex conditional expressions.

FrameMaker also automatically validates the conditional expressions as you are building them. The Expression Builder UI highlights errors and provides you visual cues to identify the various relevant parts, such as conditional tag names and operators, in the build expressions.

See the video: Simplified Conditional Expressions.

For more information, see “Boolean expressions with parenthesis” on page 380 and“Automatic validation and visual

cues in the conditional expressions” on page 379.

XML Authoring and review enhancements

New FrameMaker mode for XML authorings

FrameMaker now provides a FrameMaker XML Author (FMXA) mode along with the Structured and FrameMaker modes.

The FMXA mode is geared for XML authoring and provides a lightweight user interface with a fully standardscompliant XML editor.

Note: FrameMaker XML Author is also available as a separate standalone product. For more information, see About FrameMaker XML Author.

FrameMaker provides a starter screen specific to the mode in which you have launched FrameMaker. For example, the starter screen for the Structured mode includes options to create structured documents and templates.

For more information, see “FrameMaker modes” on page 17.

MathML support

FrameMaker now provides support for MathML, which is an XML application for representing mathematical notation. This support is provided through out-of-the-box integration with MathFlow Editor by Design Science. FrameMaker includes 30-day trial licenses of the following MathFlow editors:

Last updated 1/14/2014

USING FRAMEMAKER 12

Getting Started

Style Editor

Structure Editor

You can select either of the editors through Edit -> Preferences -> MathML.

Last updated 1/14/2014

USING FRAMEMAKER 12

Getting Started

For more information, see “Using the MathFlow editor from Design Science” on page 201.

See the video, MathML in Unstructured documents.

See the video, MathML in Structured documents.

Enhanced XML editing

FrameMaker is now an even more powerful XML editor:

• FrameMaker-generated XML code now does not include processing instructions by default. This results in a less

cluttered XML.

• Closing tags are automatically updated in XML code view

• For XSLT pre- and-post processing, you can change the default processor to Saxon 2.0.

• Several improvements have been made to the way white space is handled in XML. For example:

• XML View now honors xml:space when you use pretty printing.

• Indentation of XML tags as created by some other XML editors does not cause extra white spaces in

FrameMaker XML.

Preview topicref content in Ditamap

You can preview your topic content from within a DITA map. You can expand topicrefs in the document view of the DITA map and view the content in the context of the DITA map. This way, you need not open the topics to view the content. You can also double-click the preview of the topicrefs to open the files then quickly edit them.

See the video: DITA: Instantly Expand Maps .

For more information, see “Preview DITA map content” on page 500.

Quick Element Insertion Toolbar

In this release, insert commonly used elements in your structured authoring environment by using the Quick Element Insertion toolbar.

Quick Element Toolbar

FrameMaker provides an out-of-the-box toolbar for the DITA element structure. However, you can customize this toolbar to associate the commands with any custom structured application.

You can assign different elements to the same icon, for example to specify different handling for DITA topics and tasks.

To enable the toolbar, select View -> Toolbars -> Quick Element Toolbar

Last updated 1/14/2014

USING FRAMEMAKER 12

Getting Started

For more information, see “Using the Quick Element Toolbar” on page 451.

See the video, Quick Element Toolbar.

Productivity enhancements

Smart Catalog

You can now quickly find and insert/apply valid elements, paragraph formats, character formats, conditional tags, and object styles at the insertion point.

For more information on Smart Catalog, see “Using Smart catalogs” on page 30.

See the video, Smart Catalogs.

Restore last session

FrameMaker allows you to restore last session that you were working on when you lasted exited FrameMaker or it crashed. By clicking an option on the welcome screen, you can quickly restore your last session and reinstate the following:

• View: XML Code, WYSIWYG, or Author

• Workspace

• The last document in focus

• The files open in the last session (Except the files open through the CMS connector)

• Page numbers in focus for different documents

• The scrollspace for the master, body and reference pages

• Tab order of the documents

• Palettes (such as Equation, Templates, and Thesaurus browser)

• stuctapps.fm file: The last read structapps.fm file (On restore, the last read structapps.fm file is read again)

See the video: Single Click Session Restore.

For more information, see “Restore last session” on page 58

New options to optimize FrameMaker startup time

FrameMaker has new preferences using which you can optimize the startup time. Using the Launch preferences, you can optimize the loading of the clients, fonts, language providers, and startup scripts according to your requirement.

For more information, see “Launch” on page 23.

Collaboration enhancements

Connector to Adobe Experience Manager

Adobe Experience Manager (AEM) offers web content management and digital asset management with optimized multi-channel media delivery. You can find more information on AEM

Last updated 1/14/2014

here.

USING FRAMEMAKER 12

Getting Started

AEM Connector

With the FrameMaker connector for AEM, you can connect to AEM and use it as a CMS and uses its digital asset management (DAM) capabilities. You can store your FrameMaker documents in the AEM DAM and with an easy interface to check-in and check-out the files and edit them inside FM. You can also search the AEM repository from within FrameMaker and view its tree structure.

For more information see “Adobe Experience Manager (AEM)” on page 585.

Enhancements to PDF-based review

In this release, you can change the source in FrameMaker while its PDF output is being reviewed and still be able to import review comments correctly.

You can make the following changes to the source FrameMaker content:

• Change the relative position (as per the line numbers) of the paragraph

• Change the text around (before/after) the commented text in the paragraph

See the video: PDF Review Enhancements.

Last updated 1/14/2014

USING FRAMEMAKER 12

Getting Started

For more information, see “Import PDF comments” on page 440

Integration with Dropbox

You can use FrameMaker integration with Dropbox to share and access content on-the-go and collaborate with both internal and external reviewers.

See the video: Dropbox.

For more information, see “Using Dropbox for review and collaborative writing” on page 436.

Publishing enhancements

Multi-Channel, multi-device publishing

FrameMaker now provides a stand-alone multi-channel, multi-device publishing solution that provides unmatched publishing flexibility along with powerful options to customize the output formats.

Publishing workflow

With FrameMaker, you can now publish your FrameMaker documents easily to the following formats:

• Responsive HTML5

• EPUB

• Amazon Kindle

• WebHelp

• Microsoft HTML Help (chm)

For more information on multi-channel publishing in FrameMaker, see “Multi-channel publishing” on page 527.

See the video, Multi-channel publishing.

Last updated 1/14/2014

USING FRAMEMAKER 12

Getting Started

DITA Open Toolkit integration

FrameMaker provides out-of-the-box support for DITA Open Toolkit (DITA-OT) version 1.8. Using DITA-OT in FrameMaker, by default you can generate the following output types:

• XHTML

• HTMLHELP

• PDF2

In addition, you can easily add the following output types by modifying the DITAFM.ini file: docbook, eclipsecontent, eclipsehelp, htmlhelp, javahelp, net.sourceforge, dita-ot.html, odt, pdf, pdf2, tocjs, troff, wordrtf, and xhtml.

See the video: DITA Output Via Toolkit.

For more information, see “Using DITA Open Toolkit to Publish DITA content” on page 523.

Last updated 1/14/2014

Chapter 2: FrameMaker Basics

User interface

Basics

The Welcome screens

FrameMaker displays a Welcome screen based on the current mode. FrameMaker has three starter screens for different modes:

Unstructured FrameMaker Welcome screen

Create new unstructured documents

Create new unstructured templates

Access learning resources

Last updated 1/14/2014

USING FRAMEMAKER 12

FrameMaker Basics

Create new structured documents

Create new structured templates, including DITA

Access learning resources

Structured FrameMaker Welcome screen

XML Author Welcome screen

Create new structured documents

Access learning resources

From the FrameMaker Welcome screens, you can perform the following tasks as relevant to the current mode of FrameMaker. For example, the Unstructured FrameMaker starter screens let you create only unstructured documents.

• Open recent documents

Last updated 1/14/2014

USING FRAMEMAKER 12

FrameMaker Basics

• Creating new FrameMaker documents, books, CMS connections, and (in structured and XML author modes)

DITA maps, DITA files, and XML files

• Access FrameMaker templates

• Access FrameMaker 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 pods, you can save the workspace settings for use later.

The FrameMaker 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 character, paragraph, and table designers; and

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.

FrameMaker modes

FrameMaker ships with the following modes:

FrameMaker: Use this mode to work with Unstructured FrameMaker documents.

Structured FrameMaker: Use this mode to work with structured FrameMaker documents. You need to use this mode

to create DITA complaint documents such as DITAMAP, DITA topics and concepts, and structured applications. For more information on structured authoring, see

FrameMaker XML Author Like the Structured FrameMaker mode, you can use this mode to work on XML documents.

“Structured Authoring” on page 446.

The difference between the two modes is that this mode is built specifically for XML authoring. This means that it does not include features such as structured application creation and multi-channel publishing.

Besides being a mode in FrameMaker, FrameMaker XML Author, also ships as a separate product. For details on FrameMaker XML Author, see About FrameMaker XML Author.

To change the mode in FrameMaker:

1 From the Edit menu, choose Preferences.

2 In the Preference dialog, go to the General tab.

3 In the Product Interface drop-down list, choose the mode.

4 Click OK to close the dialog.

To make the changes take effect, you will need to restart FrameMaker.

Icons

FrameMaker gives you choice of size and color for the icons.

Last updated 1/14/2014

USING FRAMEMAKER 12

FrameMaker Basics

Using preferences, you can set up to use any of the following icons for FrameMaker interface:

• Large colored icons

• Large grayscale icons

• Regular colored icons

• Regular grayscale icons

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

Icons according to various Interface settings in the Preferences dialog

The regular grayscale icons in FrameMaker 12 are also of better resolution than the earlier FrameMaker versions.

FrameMaker 12 icons have better resolution than earlier FrameMaker versions’ icons

See the video: Toolbar Icons.

Change FrameMaker icons

You can change FrameMaker 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 for the icon preferences to take effect.

Last updated 1/14/2014

USING FRAMEMAKER 12

FrameMaker Basics

Use your own icons

You can also add your own custom icons in FrameMaker.

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\FrameMaker\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

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/14/2014

USING FRAMEMAKER 12

FrameMaker Basics

General preferences A. Select structured or unstructured 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. Specify the number of minutes after which FrameMaker automatically saves the open file E. Select to display errors, if any, when you open a file in FrameMaker F. Text size smaller than the one specified in this field is displayed as XXXX G. Select to automatically lock and check-out a file when you download it H. Select to check in a file every time you save it I. Select to display learning resource links on the bottom of the starter page J. Select the type of cross-platform file naming for FrameMaker to follow K. Select to add a FrameImage facet to bitmap graphics imported by copying L. Select to prevent multiple people from opening the same file M. Select to remember missing font names N. Select the file types to be embedded in the PDF

Interface preferences

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

Last updated 1/14/2014

USING FRAMEMAKER 12

FrameMaker Basics

E F

IJKL

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 pod tab/pod icon to collapse it. When enabled, just click on another pod or in the document to collapse a pod. D. Select to hide all docked pods permanently E. Select to make FrameMaker application icon grayscale F. When you close pods they are hidden but are still active in memory. Deselect this option to remove pods when you close them. To display them again, choose them from FrameMaker menus. G. Select grayscale or colored icons for the interface H. Select large or small sized icons for the interface I. Opens composite documents as tabbed documents. Deselect to open composite document windows as floating windows. J. When you drag document windows and place them together, they tend to form tabs in a single document window. Select this option to prevent document tabbing. K. Floating document windows display the document name only in the title bar. Deselect to display document name in title bar and tab bar. L. 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/14/2014

USING FRAMEMAKER 12

FrameMaker 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. Select when you want FrameMaker to display dialogs with alerts D. Select to display non-input alerts, such as missing fonts, on session restore

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/14/2014

USING FRAMEMAKER 12

FrameMaker Basics

Pods A. In structured interface, you can specify either the paragraph styles or the element names. In unstructured FrameMaker, you can only specify paragraph styles. B. Specify the first paragraph style (Paragraph style or element in Structured Framemaker) C. Specify the second paragraph style (Paragraph style or element in Structured Framemaker)

Launch

The Launch preferences help you optimize the startup time of FrameMaker. 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/14/2014

USING FRAMEMAKER 12

FrameMaker 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 this option, none of the clients such MathFlow and PDF import comments are loaded on startup. C. Delay Load Language Provider: When you select this 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 not want FrameMaker to load on startup. Use commas to delimit. As you see here, S1000DUtilities and S1000Dmenu are set up not to load on startup. To work with S1000D, remove these two script names from the field and restart FrameMaker to load S1000D functionality in FrameMaker.

Dropbox

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

Last updated 1/14/2014

+ 642 hidden pages