TCS 4 as DITA out-of-the-box solution

Sun Dec 16 21:44:49 PST 2012

Craig, Gillian and others,

Thanks for your post and suggestions. I am the FM product manager at Adobe and wanted to let you know that we will definitely consider the suggestions mentioned in this thread.

Also, though this post, I wanted to point out that now in FrameMaker 11, you can easily automatically generate cover page, TOC, index, List of figures, list of tables pages etc. through a settings file called ditafm-output.ini. You can auto-generate these components either by (1) directly generating the PDF from the ditamap or (2) by generating a book first from the ditamap.

*         For the first option, one needs to go to the setting file and turn on the flag called SavePDFViaBookRoute (i.e. make it 1). Afterwards, choose the relevant settings you want e.g. GenerateTOC=1, GenerateIndex=1 etc. Save and close, and generate the PDF. FM would create all the components in the PDF automatically as specified by you in the settings file. You can even choose different templates and specify various numbering options.

*         For the second option, setting the SavePDFViaBookRoute flag is not required. Rest of the process works the same way.

Useful resources

*         See the ditafm-output.ini overview and flag reference documentation for more details http://help.adobe.com/en_US/framemaker/ini/framemaker_11_ini_reference.pdf (Chapter 1 of the documentation). Online version of the documentation can be found here<http://help.adobe.com/en_US/framemaker/ini/index.html>. There are plenty of flags in this file to allow you to configure how the output gets generated

 *   To know more about how you can publish your DITAMAP to a professional PDF, while automatically generating TOC, Index etc., please see the blog post here<http://blogs.adobe.com/tcs/2012/10/uncategorized/iniref.html>

*         Also, see a related video here http://www.youtube.com/watch?v=mqSMLpaqKxg which shows this capability in action.

Hope it helps. Let us know how it goes.

Thx,
Kapil Verma
Sr. Product Manager - FrameMaker line of products

From: framers-bounces at lists.frameusers.com [mailto:framers-bounces at lists.frameusers.com] On Behalf Of Craig Ede
Sent: Tuesday, November 27, 2012 8:20 PM
To: gillian.flato at nexenta.com; framers
Subject: RE: TCS 4 as DITA out-of-the-box solution

I am currently working a contract for a company where we are writing DITA files using FM11 (not TCS 4). Producing DITA using FM 11 is fairly easy, but there as some caveats. The built in EDDs, etc. allow producing more-or-less adequate PDF using SaveAsPDF from ditamap files. To get TOCs, covers and other nicities, you have to save the ditamap as a composite FM file and then add the additional files into a FM book containing the composite file. Exactly how to massage paragraph formats to get the results you desire withing the composite FM file is not transparent. Structured documents are more difficult to change the formats in since the EDD is the source of that information.  (Any tips on how to get the notes that are warnings and cautions will be accepted with much happiness from anyone reading this.)

Another avenue to PDF (as well as HTMLHELP, javaHelp and other formats) comes through using the DITA Open Toolkit. This is now easy to install so you get what you need and the results are great for many of the formats. Most of the help systems offered come through without muss or fuss except for an occasional unrecognized character that can cause problems but is easily fixed). My boss was astounded at the ease of producing HTMLHelp in this way.

The DITAOpenToolkit PDF is equally easy to produce from a ditamap, but, of course, has a different look than the SaveAsPDF from FM11. This is because it uses CSS templates to format the output. The result is a terrible cover sheet, a great TOC, nice formatting of Warnings and the like. The regular notes icon is terrible; a finger pointing to the note that seems totally out of place [it reminds me of the similar character used by Walt Kelly in the world ballons for the P.T. Bridgeport character from POGO]. Wading into the OpenToolkits templates to modify the CSS is daughting, but doable. There are tips on this that pop up if you search the web, but, again, it is not particularly straightforward. Be sure to save the original copy of each template before modifying.

My experience with DITA is that it is great at reducing duplication in manuals, aids in breaking apart tasks that actually combined multiple tasks in one (thus making them both clearer and more reusable), and helps to identify material in manuals that just got in there because the designers of a machine were enamoured of explaining how the pieces of it work (even if that information is useless for any operator or maintainance task). I love it! However, I would take the statement that TCS 4 offers a  single out-of-the-box solution with a big grain of salt.

I am going to send a separate posting with some DITA codeview interface complaints for Adobe to consider as areas where improvement is desired (at least from this user).

Thanks.

Craig Ede
________________________________
From: Gillian.Flato at nexenta.com<mailto:Gillian.Flato at nexenta.com>
To: framers at lists.frameusers.com<mailto:framers at lists.frameusers.com>
Subject: TCS 4 as DITA out-of-the-box solution
Date: Mon, 26 Nov 2012 19:08:51 +0000
I went to a presentation last week given by Maxwell Hoffman from Adobe on TCS v4.x. He stated that TCS v4.x is an out-of-the-box DITA solution that contains DTDs, EDDs, etc, so you don't have to go to third-party solutions to obtain the necessary pieces.

Has anyone used TCS v4.x as a complete DITA solution? Are you liking it? Is it better or worse than using, for example, XMetal or Oxygen with 3rd-party scripts, etc.

Thank You,

Gillian Flato
Senior Content Developer
Skype: Gillian.B.Flato
Gillian.Flato at nexenta.com<mailto:Gillian.Flato at nexenta.com>

_______________________________________________ You are currently subscribed to framers as craigede at hotmail.com<mailto:craigede at hotmail.com>. Send list messages to framers at lists.frameusers.com<mailto:framers at lists.frameusers.com>. To unsubscribe send a blank email to framers-unsubscribe at lists.frameusers.com<mailto:framers-unsubscribe at lists.frameusers.com> or visit http://lists.frameusers.com/mailman/options/framers/craigede%40hotmail.com Send administrative questions to listadmin at frameusers.com<mailto:listadmin at frameusers.com>. Visit http://www.frameusers.com/ for more resources and info.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.frameusers.com/pipermail/framers-frameusers.com/attachments/20121217/cbccc91c/attachment.htm>