PDF Content reuse with Frame + DITA?
Scott Prentice
sp at leximation.com
Sun May 20 13:30:45 PDT 2007
Hi Gyanesh...
Each time you regenerate your book, the conditional settings in effect,
will define the content shown in the generated lists (Index and TOC
specifically).
The index is generated from index markers, and they will be used (or
not) depending on their conditional tagging. This isn't too bad if the
index markers are within a paragraph that is tagged with a condition,
but if you just want to conditionalize words within a marker, that's a
bit tougher .. in general you'd need to create duplicate markers with
different text, and conditionalize each marker accordingly. However this
is difficult to maintain since it's very hard to just tag a single
marker with a specific condition. There are a couple of plugins that
help with conditionalized or variable content in a marker (MarkerTools
and Index Tools Pro .. links below). It's a good practice to avoid
conditional content within index entries .. it's one thing to
include/exclude a marker in a specific output, but if you start messing
with words within a marker, you'll go nuts.
MarkerTools - http://www.leximation.com/tools/info/markertools.php
Index Tools Pro - http://www.siliconprairiesoftware.com/Products.html
The TOC is generated from the paragraph styles (headings) that you
specify, and it will only pull in the content that is in a "show" state.
As with markers, it's good to avoid conditionalizing specific words in
headings .. it can be done but you have to be careful to conditionalize
the spaces properly so you don't end up with too few or too many.
Variables will show/hide along with the surrounding content that is
tagged in a certain way. If you want to change the definition of a
variable for different output types, you can change the values in a
template and import that into all files into the book .. or use our
BookVars plugin to swap the definitions as needed.
BookVars - http://www.leximation.com/tools/info/bookvars.php
If you're using DITA, depending on the method you're using to create the
PDFs (through Frame or through the DITA-OT), you can still use
conditional tagging, or you can use the filtering attributes on each
element. With DITA, you'd typically set the filtering attributes on
elements to determine the product, audience, etc. and when you generate
your output, you'd filter out the elements that don't apply to that
version (similar to using conditional tags). There's a great plugin
(ABCM) for Frame that lets you apply conditions (and thus hide/show
content) based on attribute values. This is a must if you're producing
output through Frame and want to use attribute values to do the
filtering (it's free too!). (If you're generating your output through
the XSLT transformations in the DITA-OT, you'd do this filtering using a
ditavals file.)
ABCM - http://www.weststreetconsulting.com/WSC_ABCM.htm
Good luck!
...scott
Scott Prentice
Leximation, Inc.
www.leximation.com
+1.415.485.1892
Gyanesh Talwar wrote:
> Thanks Scott!
>
> I think i will settle for show/hide. And if I do, is there a way to
> handle index/toc/variables (such as name of the book) automatically?
> Or do I do that manually?
>
> And let's say I have to implement DITA. Can I still publish two
> different PDFs selectively? And how will I carry out the selection of
> text in Structured Frame?
>
> Thanks again!
>
> Gyanesh
>
>
> On 5/18/07, Scott Prentice <sp at leximation.com> wrote:
>> Hi Gyanesh...
>>
>> If your main goal is to publish two different sets of content from the
>> same FM source files, I'd think that your best bet is to just use
>> conditional text (show/hide) in unstructured FM files. There are
>> probably benefits you could gain by moving to structure and/or DITA (and
>> it can certainly be done with structure/DITA), but for what you're
>> talking about, conditional text is really all you need. Just create two
>> conditional tags and apply those tags to the content that is only for
>> one product or the other (just don't overlap conditions) .. anything
>> that is common to both would be left untagged. Use the conditional text
>> show/hide settings to show one and hide the other, then generate your
>> PDF.
>>
>> Cheers!
>>
>> ...scott
>>
>>
>>
>> Gyanesh Talwar wrote:
>> > Hello Framers,
>> >
>> > (Frame 7.2b144)
>> >
>> > For my product, I have 2 guides with similar content across different
>> > chapters. Can I publish two different PDFs from the same source (with
>> > selective content obviously).
>> >
>> > -> How will this be done? Using topic IDs?
>> > -> Is Show/hide a better option for this than Structured Frame?
>> > -> Is it viable to use DITA for this? Some other EDD ...or custome
>> made?
>> >
>> > TIA,
>> > Gyanesh
>> >
>> >
>> >
>> >
>>
>>
>
>
More information about the framers
mailing list