Single Sourcing with the Technical Communication Suite: Using FrameMaker to Manage Print and Help Authoring

1,787 views
1,720 views

Published on

Half-day workshop presented by Matt Sullivan at Documentation and Training West, May 6-9, 2008 in Vancouver, BC

This session is intended for those with help, web, and print delivery requirements. Adobe FrameMaker users or those looking to extend their help authoring capability by migrating to a FrameMaker-centric workflow will benefit most. We’ll use an existing documentation project to show development from cocktail napkin to full-featured output.

Published in: Technology, Business
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
1,787
On SlideShare
0
From Embeds
0
Number of Embeds
12
Actions
Shares
0
Downloads
19
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide
  • Single Sourcing with the Technical Communication Suite: Using FrameMaker to Manage Print and Help Authoring

    1. 1. 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. 2. Overview <ul><li>Concepting/Initial Doc Setup </li></ul><ul><li>Acrobat 3D Toolkit </li></ul><ul><li>Captivate Hybrid Project </li></ul><ul><li>RoboHelp Setup </li></ul><ul><li>Outputs </li></ul><ul><li>Revisions </li></ul>
    3. 3. Adobe Technical Communication Suite <ul><li>Integrated versions of applications </li></ul><ul><ul><li>FrameMaker 8 </li></ul></ul><ul><ul><li>Acrobat 3D </li></ul></ul><ul><ul><ul><li>A superset of Acrobat 8 Professional </li></ul></ul></ul><ul><ul><li>Captivate 3 </li></ul></ul><ul><ul><li>RoboHelp 7 </li></ul></ul><ul><li>New License $1,599 </li></ul><ul><li>Upgrade to TCS from any version of these four products for $999 </li></ul><ul><li>30-day fully functioning downloads available </li></ul>
    4. 4. Concept <ul><li>aim.com concept </li></ul><ul><ul><li>Video marketing message </li></ul></ul><ul><ul><li>Floats over existing web page </li></ul></ul><ul><ul><li>Delivered from streaming server </li></ul></ul><ul><li>Scan of napkin </li></ul>
    5. 5. Initial Organization in Outlining Program <ul><li>Natara Bonsai www.natara.com </li></ul><ul><ul><li>Allows easy reorganization of bullet points </li></ul></ul><ul><ul><li>Bullets convert to Heading1, Heading2, etc. </li></ul></ul><ul><ul><li>Syncs with Palm-based devices </li></ul></ul><ul><li>Screen Shot of Bonsai </li></ul>
    6. 6. FrameMaker <ul><li>No Overrides </li></ul><ul><ul><li>Format with Paragraph and Character tags only </li></ul></ul><ul><li>Naming Conventions </li></ul><ul><li>Assign Master Page automatically </li></ul><ul><li>Cross-reference formats </li></ul><ul><li>Improved Conditional Text </li></ul>
    7. 7. Graphics Import Options <ul><li>Always by reference </li></ul><ul><li>Native files if possible </li></ul><ul><ul><li>Illustrator </li></ul></ul><ul><ul><li>Photoshop </li></ul></ul><ul><li>Captivate demos </li></ul><ul><ul><li>With poster for print output </li></ul></ul><ul><li>3D objects </li></ul><ul><ul><li>With poster for print output </li></ul></ul>
    8. 8. Output from Frame <ul><li>Print </li></ul><ul><ul><li>PDF, then print (frees up FrameMaker faster) </li></ul></ul><ul><li>PDF (categorized into3 types) </li></ul><ul><ul><li>Screen only </li></ul></ul><ul><ul><li>Laser/bubble jet output </li></ul></ul><ul><ul><li>Commercial print </li></ul></ul><ul><li>HTML/XML </li></ul><ul><ul><li>Native conversion </li></ul></ul><ul><ul><li>Commercial solutions available </li></ul></ul>
    9. 9. Acrobat 3D Toolkit <ul><li>Map surfaces </li></ul><ul><li>Animate action </li></ul><ul><li>Create initial state </li></ul><ul><li>Works with U3D output </li></ul>
    10. 10. Captivate output <ul><li>Simultaneously captures actions and descriptions in multiple deliverables </li></ul><ul><ul><li>Demonstration </li></ul></ul><ul><ul><li>Training Simulation </li></ul></ul><ul><ul><li>Assesment Simulation </li></ul></ul><ul><ul><li>Hybrid as needed </li></ul></ul><ul><li>Delivered as SWF </li></ul>
    11. 11. Captivate <ul><li>Write script </li></ul><ul><li>Record action </li></ul><ul><li>Add/modify helper elements </li></ul><ul><ul><li>Captions </li></ul></ul><ul><ul><li>Buttons </li></ul></ul><ul><ul><li>Click boxes </li></ul></ul>
    12. 12. Captivate Scripts <ul><li>Develop scripts from outlines and print docs </li></ul><ul><li>Place scripts into Notes area </li></ul><ul><ul><li>Break script into object level chunks </li></ul></ul><ul><li>Record audio chunks from Captivate </li></ul><ul><ul><li>Allows naming of small, discreet files </li></ul></ul><ul><li>Edit in Captivate, or open directly in Soundbooth </li></ul>
    13. 13. Captivate Details <ul><li>Buttons and Click boxes explained </li></ul><ul><ul><li>Active and Inactive areas </li></ul></ul><ul><ul><li>Actions </li></ul></ul><ul><ul><li>Fade in, not out </li></ul></ul><ul><li>Apply to All is your friend </li></ul>
    14. 14. RoboHelp <ul><li>Import FM by reference </li></ul><ul><ul><li>Option only available as right-click for now </li></ul></ul><ul><li>Use Conditional Build Expressions to create multiple projects </li></ul><ul><ul><li>WebHelp/Verbose </li></ul></ul><ul><ul><li>WebHelp/Minimal Text </li></ul></ul><ul><li>Format using FM.css </li></ul>
    15. 15. Output from RoboHelp <ul><li>Create unique SSL’s for </li></ul><ul><ul><li>FlashHelp </li></ul></ul><ul><ul><li>WebHelp </li></ul></ul><ul><ul><ul><li>Send To RoboHelp Packager for AIR </li></ul></ul></ul>
    16. 16. Revise Content <ul><li>Change common and conditional text in FrameMaker </li></ul><ul><li>Force Update in RoboHelp </li></ul><ul><li>Batch Generate in RoboHelp </li></ul><ul><li>Convert to AIR and post new version </li></ul><ul><li>Access AIR app to see update </li></ul>

    ×