The DITA-FMx/XDocs connector presents the topic and map files with both
filename and title in either order.
Since we're on the subject of tools and file naming options ..
DITA-FMx provides numerous ways to automate the file naming for new
files using building blocks that can be assembled in many ways. In the
New DITA File dialog, you enter the title of the new file, and the
filename can be generated from that text using one of 6 title-based
building blocks. You can also use a building block that includes a
unique ID (which matches the ID of the new topic being created). There
are also building blocks for topic type, date, time, and others. All of
these can be combined as well as restricted to a specific number of
characters, as well as being able to include folder specifications (so
your new files end up in the right topic-based folder, if you choose to
go that route). Details are here ..
http://docs.leximation.com/dita-fmx/1.1/?ditafmx_ref_newfileoptions.html
Personally, I prefer to use unique IDs for filenames, and only access
the files through the map (where you see the topic titles rather than
the filenames). This lets you keep all of the files in one folder and
you never have to look at the file names. No matter what file naming
convention you use (unless it's unique IDs), it breaks down and causes
problems eventually.
Cheers,
...scott
--
Scott Prentice
Leximation, Inc.
www.leximation.com
+1.415.485.1892
Jim Owens wrote:
> As far as possible, make sure the file name matches the title of
the topic. So if your topic is "Inserting the Widget" then your file
name would be "inserting_the_widget.xml". I realize this may cause
problems later if the title changes, but that doesn't happen often and
you can usually make the change to the file name without too much
hassle (changing it in ditamaps, etc.).
>
Since this has come up, I was wondering if any DITA-aware CMS
offerings can present the topic title or map title for selection by
the user, instead of the file name. This would support the use of
GUIDs for the file names, which would guarantee uniqueness, and allow
users to adjust titles without having to manage ditamaps,
related-links, or xrefs.
_______________________________________________
You are currently subscribed to framers as [email protected].
Send list messages to [email protected].
To unsubscribe send a blank email to
[email protected]
or visit
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com
Send administrative questions to [email protected]. Visit
http://www.frameusers.com/ for more resources and info.
