Single Sourcing with TCS: Using FrameMaker to Manage Print and Help Authoring Matt Sullivan, GRAFIX Training & Consulting 888 882-2819 [email_address] http:// www.grafixtraining.com/doctrainwest

2-day TCS Integration Classes Available at the STC meeting in Philly, see http://www.stc.org/55thConf/precon/certAdobe.asp Available in southern California, see http:// grafixtraining.com/pages/schedule.html Available remotely Only a 2-student minimum for live online training! http:// grafixtraining.com/pages/remote.html

Available at the STC meeting in Philly, see

http://www.stc.org/55thConf/precon/certAdobe.asp

Available in southern California, see

http:// grafixtraining.com/pages/schedule.html

Available remotely

Only a 2-student minimum for live online training!

http:// grafixtraining.com/pages/remote.html

Goal To show how traditional documentation methods can be used to control custom and conditionalized output including (not limited to): Print A variety of Help formats Adobe AIR

To show how traditional documentation methods can be used to control custom and conditionalized output including (not limited to):

Print

A variety of Help formats

Adobe AIR

AIM Concept aim.com concept Short video marketing message “ Ego-based” customers Chroma-keyed video floats over existing web page (like a weather reporter) Delivered from streaming server

aim.com concept

Short video marketing message

“ Ego-based” customers

Chroma-keyed video floats over existing web page (like a weather reporter)

Delivered from streaming server

Overview of Session Concepting and Initial Doc Setup Highlight Key FrameMaker Topics Acrobat 3D Toolkit Captivate Hybrid Project (Break) RoboHelp Setup Outputs Revisions

Concepting and Initial Doc Setup

Highlight Key FrameMaker Topics

Acrobat 3D Toolkit

Captivate Hybrid Project

(Break)

RoboHelp Setup

Outputs

Revisions

Adobe Technical Communication Suite Integrated versions of applications FrameMaker 8 Acrobat 3D A superset of Acrobat 8 Professional Captivate 3 RoboHelp 7 (RoboHelp Packager for AIR) New License $1,599 Upgrade to TCS from any version of these four products for $999 Don’t forget the Maintenance Contract and VLP Discounts 30-day fully functioning downloads available

Integrated versions of applications

FrameMaker 8

Acrobat 3D

A superset of Acrobat 8 Professional

Captivate 3

RoboHelp 7

(RoboHelp Packager for AIR)

New License $1,599

Upgrade to TCS from any version of these four products for $999

Don’t forget the Maintenance Contract and VLP Discounts

30-day fully functioning downloads available

Initial Organization in Outlining Program Natara Bonsai www.natara.com Allows easy reorganization of bullet points Bullets convert to Heading1, Heading2, etc. Output to RTF Syncs with Palm-based devices

Natara Bonsai www.natara.com

Allows easy reorganization of bullet points

Bullets convert to Heading1, Heading2, etc.

Output to RTF

Syncs with Palm-based devices

DTP and Help Naming Conventions Strive for no format overrides Format with Paragraph and Character styles only Consistent Naming Conventions for Paragraph Formats Character Formats Conditions Cross Reference Formats Master and Reference Pages Colors Styles InitialCap ALLCAP lower_case

Strive for no format overrides

Format with Paragraph and Character styles only

Consistent Naming Conventions for

Paragraph Formats

Character Formats

Conditions

Cross Reference Formats

Master and Reference Pages

Colors

Styles

InitialCap

ALLCAP

lower_case

FrameMaker Assign Master Pages automatically Ex: CoverPage, RotatedTables, FullPageGraphics MasterPageMaps Reference Page Cross-reference formats Complete units (Para’s or Sentences) Leverage Character Formats to highlight Hyperlink Conditional Text Including Build Expressions

Assign Master Pages automatically

Ex: CoverPage, RotatedTables, FullPageGraphics

MasterPageMaps Reference Page

Cross-reference formats

Complete units (Para’s or Sentences)

Leverage Character Formats to highlight Hyperlink

Conditional Text

Including Build Expressions

Graphics Import Options By reference, except screen captures Native files if possible Illustrator Photoshop 3D objects With poster for print output Captivate demos With poster for print output

By reference, except screen captures

Native files if possible

Illustrator

Photoshop

3D objects

With poster for print output

Captivate demos

With poster for print output

Output from Frame Print Create PDF, then print (frees up FrameMaker faster) PDF (loosely grouped into3 types) Screen only Laser/bubble jet output Commercial print HTML/XML Native HTML conversion Commercial solutions available

Print

Create PDF, then print (frees up FrameMaker faster)

PDF (loosely grouped into3 types)

Screen only

Laser/bubble jet output

Commercial print

HTML/XML

Native HTML conversion

Commercial solutions available

Extra FM Topics Use Character Tags on the TOC Reference Page to normalize TOC page numbers Create an extra List of Paragraphs to check overall organization of all Heading levels

Use Character Tags on the TOC Reference Page to normalize TOC page numbers

Create an extra List of Paragraphs to check overall organization of all Heading levels

Acrobat 3D Works with many native 3d formats output See Edit > Preferences > Convert to PDF

Works with many native 3d formats output

See Edit > Preferences > Convert to PDF

Acrobat 3D Toolkit Drag & Drop onto a shortcut or the open application to start editing Full control over selecting and viewing 3D structure Select using Scene Tree or any Tool Group Feature helps with organization

Drag & Drop onto a shortcut or the open application to start editing

Full control over selecting and viewing 3D structure

Select using Scene Tree or any Tool

Group Feature helps with organization

Acrobat 3D Controls and Toolbars Commonly used toolbars shown to the right  Ensure Folders are visible

Commonly used toolbars shown to the right 

Ensure Folders are visible

Map surfaces in Acrobat 3D With Folders visible, view Materials If necessary, select the Generate Thumbnails icon Drag surface onto selected object(s)

With Folders visible, view Materials

If necessary, select the Generate Thumbnails icon

Drag surface onto selected object(s)

Save/Save As dialog in Acrobat 3D Save as Universal 3D (.u3d) format to ensure compatibility with Frame 8 In Save dialog box select Settings General Tab Choose ECMA 1 st Edition Animation Tab Select Export Animation

Save as Universal 3D (.u3d) format to ensure compatibility with Frame 8

In Save dialog box select Settings

General Tab

Choose ECMA 1 st Edition

Animation Tab

Select Export Animation

Create Standalone Version of 3D PDF Drag U3D into Acrobat 3D

Drag U3D into Acrobat 3D

Place in FrameMaker Place as any other .ai, .psd, or export format Converts to PDF as fully articulating object Double-click Frame image to re-edit in Acrobat 3D Toolkit

Place as any other .ai, .psd, or export format

Converts to PDF as fully articulating object

Double-click Frame image to re-edit in Acrobat 3D Toolkit

Break

Captivate output Simultaneously captures actions and descriptions in multiple deliverables Demonstration Training Simulation Assessment Simulation Hybrid as needed Delivered as SWF

Simultaneously captures actions and descriptions in multiple deliverables

Demonstration

Training Simulation

Assessment Simulation

Hybrid as needed

Delivered as SWF

Captivate Write script Record action Add/modify helper elements Captions Buttons Click boxes

Write script

Record action

Add/modify helper elements

Captions

Buttons

Click boxes

Captivate Scripts Develop scripts from outlines and print docs Place scripts into Notes area Break script into object level chunks Record audio chunks from Captivate Allows naming of small, discreet files Edit in Captivate, or open directly in Soundbooth

Develop scripts from outlines and print docs

Place scripts into Notes area

Break script into object level chunks

Record audio chunks from Captivate

Allows naming of small, discreet files

Edit in Captivate, or open directly in Soundbooth

Captivate Details Buttons and Click boxes explained Active and Inactive areas Actions Fade in, not out Apply to All is your friend

Buttons and Click boxes explained

Active and Inactive areas

Actions

Fade in, not out

Apply to All is your friend

Captivate Print Image Can show the result of steps Select best slide background of finished steps Export to .gif image Select Edit > Preferences > Project > Start and End Click ellipse for Loading Screen & select .gif exported above

Can show the result of steps

Select best slide background of finished steps

Export to .gif image

Select Edit > Preferences > Project > Start and End

Click ellipse for Loading Screen & select .gif exported above

Add Playbar to SWF Force Captivate to produce single SWF including playbar Select Project > Skin > Borders Uncheck Show Borders Increase project height to accommodate player Select Project > Resize Project Deselect Maintain Aspect Ratio Increase Height by 32 pixels Do not scale, place in Top Center, use White background

Force Captivate to produce single SWF including playbar

Select Project > Skin > Borders

Uncheck Show Borders

Increase project height to accommodate player

Select Project > Resize Project

Deselect Maintain Aspect Ratio

Increase Height by 32 pixels

Do not scale, place in Top Center, use White background

RoboHelp Import FM by reference Option currently available as right-click on HTML directory in Project Manager

Import FM by reference

Option currently available as right-click on HTML directory in Project Manager

Map Critical Styles Edit Style Mappings for headings that split into topics

Edit Style Mappings for headings that split into topics

fmstyles.css Create placeholder topic Conditionalize if desired Verify fmstyles.css is applied to placeholder Forces fmstyles to show in project manager All Frame-generated CSS files use fmstyles for base Edit fmstyles.css as needed Reuse or replace the CSS as needed

Create placeholder topic

Conditionalize if desired

Verify fmstyles.css is applied to placeholder

Forces fmstyles to show in project manager

All Frame-generated CSS files use fmstyles for base

Edit fmstyles.css as needed

Reuse or replace the CSS as needed

Conditional Builds Use Conditional Build Expressions to create multiple projects WebHelp-Verbose WebHelp-Minimal Text

Use Conditional Build Expressions to create multiple projects

WebHelp-Verbose

WebHelp-Minimal Text

Output from RoboHelp Create unique SSL’s for FlashHelp WebHelp Send To RoboHelp Packager for AIR

Create unique SSL’s for

FlashHelp

WebHelp

Send To RoboHelp Packager for AIR

Duplicating Layouts Right-Click the format to duplicate Confirm format type Set options as needed Create Conditional Build Expressions from Conditions used in document

Right-Click the format to duplicate

Confirm format type

Set options as needed

Create Conditional Build Expressions from Conditions used in document

Batch Generate Right-Click on a layout Select SSL’s as needed Click Generate Batch Generate settings are saved with XPJ

Right-Click on a layout

Select SSL’s as needed

Click Generate

Batch Generate settings are saved with XPJ

Adobe Integrated Runtime (AIR) Input is WebHelp from RoboHelp 7 Output is an Application Installer A bit like PDF and Flash rolled into content that autoupdates when connected to the web

Input is WebHelp from RoboHelp 7

Output is an Application Installer

A bit like PDF and Flash rolled into content that autoupdates when connected to the web

RoboHelp Packager for AIR Must have output from RoboHelp 7 as the source material Uses the WebHelp folder from SSL as target Requires Digital ID, but allows low-tech bypass

Must have output from RoboHelp 7 as the source material

Uses the WebHelp folder from SSL as target

Requires Digital ID, but allows low-tech bypass

AIR Formatting Options Ships with 2 skins & 2 themes

Ships with 2 skins & 2 themes

AIR Content Settings Controls output of MiniTOC Search Capability Custom Resource Tabs Has Live Preview

Controls output of

MiniTOC

Search Capability

Custom Resource Tabs

Has Live Preview

Revise Content Change common and conditional text in FrameMaker Update/Force Update in RoboHelp Batch Generate in RoboHelp Convert to AIR and post new version Access AIR app to see update

Change common and conditional text in FrameMaker

Update/Force Update in RoboHelp

Batch Generate in RoboHelp

Convert to AIR and post new version

Access AIR app to see update