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-boun...@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.fl...@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/attachments/20121217/cbccc91c/attachment.html>

Reply via email to