Please add attribute chunk="by-topic" to the root element of your 
document. This will make ditac use topic ID for output filename.

For an even finer-grain control on the name of the file ditac generates, 
please specify attribute copy-to="MY_BASE_NAME.dita" on some of your 
topicrefs.

Note that I have described above is part of the DITA standard and should 
work with any DITA processor.

See http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/chunking.html

See also in order to learn about ditac (minor) specificities with 
respect to chunking:

Appendix B. Limitations and implementation specificities

http://www.xmlmind.com/ditac/_distrib/doc/manual/limitations.html#limitations__I_h3xpo7_


On 08/02/2012 06:52 PM, Lea Hayes wrote:
> At the moment it is possible to specify a custom file extension when
> generating documentation by using "_.html" or "_.htm", etc.
>
> I have decided to follow the convention of giving each topic a GUID for
> the id attribute. It would be highly beneficial if generated files used
> the topic ID instead of the dita topic filename because it would avoid
> issues with browser bookmarking/favourites/seo.
>
> The following file structure seems most appropriate for my needs:
>
> /user-guide/chapter-name/super-section/overview.dita
> /user-guide/getting-started/installation/overview.dita
>
> Except this generates files with the convention "overview_1.htm",
> "overview_2.htm" which will likely lead to broken URLs in the future
> (where favourites/bookmarks are saved).
>
> Obviously postfixes will still be required to resolve ambiguity in cases
> where the same topic ID has been assigned to multiple topics. In my
> scenario this cannot happen because each newly created topic is assigned
> a unique GUID. Also it would be nice if generated links did not include
> the hash reference when not required because this results with links
> like
> "aaf1c496-0c0d-4404-a8e0-5e7c6a178b14.htm#aaf1c496-0c0d-4404-a8e0-5e7c6a178b14"
> which need only be "aaf1c496-0c0d-4404-a8e0-5e7c6a178b14.htm" (unless
> sub element is cross-referenced).
>
> Many of the online user documentation that I have seen recently seems to
> follow this technique.
 
--
XMLmind DITA Converter Support List
[email protected]
http://www.xmlmind.com/mailman/listinfo/ditac-support

Reply via email to