Nikolay Rastegaev wrote:
> 
> 1. I create Multiple-topics document <dita> with hundred topics.
> 2. I create Book map with topicrefs
> 3. I resort topicrefs in book, but in result PDF I see topics in order
> as their are ordered in source <dita>-file, but not in needed order,
> as pointed in <bookmap>-file.
> 
> And next:
> If I don't create topicref from some topics from <dita>-file, they
> included in result document all the same.
> 
> This issue occurs only for PDF, ODT,.. but no occurs for HTML. HTML
> conversion works fine.
> 

--> My answer assumes that you are using XMLmind DITA Converter (ditac),
either the standalone executable or integrated in XMLmind XML Editor, to
convert your map. Note that we no longer support the DITA Open Toolkit.



--> Even if it's highly non-intuitive, this behavior, which happens only
when you have several topics in the same .dita file, seems to be the one
described in the DITA 1.1 spec.

Excerpts from http://docs.oasis-open.org/dita/v1.1/CS01/archspec/id.html
---
...
A topic architecture assembles topics into a deliverable by reference.
...
If the target contains multiple peer topics organized by a <dita>
element (as in the ditabase document type), then the reference is
resolved to the first topic in the target, except in the case of
topicrefs being resolved as inclusion directives (for example during PDF
output), in which case the entire target file is included, regardless of
whether a specific topic is targeted.
---

Let's suppose foo.dita contains topic t1, t2 and t3.

When converting to HTML:

<topicref href="foo.dita"/> or <topicref href="foo.dita#t1"/>

pulls just t1.

When converting to PDF:

<topicref href="foo.dita"/> or <topicref href="foo.dita#t1"/>

pulls t1, t2 and t3.

The solution is:

* Specify a single topic per .dita file and adjust your map accordingly

OR

* Use the same map for HTML and for PDF, ODT. Specify "-chunk single" to
get for PDF, ODT, etc, exactly the same behavior as for HTML.

More information in section "Recommendations" in
http://www.xmlmind.com/ditac/_distrib/doc/manual/manual-4.html#chunking



--> If you are using the ditac command-line, then specify command-line
option "-chunk  single".

See
http://www.xmlmind.com/ditac/_distrib/doc/manual/commandLine.html#commandLine



--> If you are using XXE, there is currently no way to easily change the
"Chunk mode" from "Automatic" to "Single chunk".

See
http://www.xmlmind.com/xmleditor/_distrib/doc/dita/preprocess_options.html#com.xmlmind.xmleditext.dita.PreprocessingOptionsEditor

Please edit XXE_install_dir/addon/config/dita/xslMenu.incl and add

---
        <argument>-chunk</argument>
        <argument>single</argument>
---

after

---
        <argument>-media</argument>
        <argument>print</argument>
---

in process command "dita.toPS" and also in process command "dita.toRTF".




 
--
XMLmind DITA Converter Support List
[email protected]
http://www.xmlmind.com/mailman/listinfo/ditac-support

Reply via email to