Re: Poll: How do you differentiate commands, etc. in text?

["Yves Barbion" <yves -dot- barbion -at- gmail -dot- com>]

If you are already using Information Mapping (IMAP), and maybe XML, you may
want to move to the Darwin Information Typing Architecture (DITA). The DITA
content model and DTD's have all the domain elements you need for this
purpose.

One example is the element named <uicontrol>. The (excellent) DITA reference
says the following about the usage of the <uicontrol> element:

"uicontrol

The user interface control (<uicontrol>) element represents a button, entry
field, menu item, or other object that allows the user to control the
interface. This could also include a menu or dialog. For example, use the <
uicontrol> element inside a <menucascade> element when the menu item is
nested, such as *File* --> *New* . This element is part of the DITA user
interface domain, a special set of DITA elements designed to document user
interface tasks, concepts and reference information.

*Example*
Press the *<uicontrol>*OK*</uicontrol>* button."

And DITA has many more of these domain elements, like: command name
(<cmdname>), user input (<userinput>), system output (<systemoutput>),
window title <wintitle>, shortcut, screen, ...

For more information about DITA, see:

  - http://www.imap.dk/proddita.htm
  - http://dita.xml.org/




--
Yves Barbion
Technical Writer
Adobe-Certified FrameMaker Instructor
____________________________________

U&I Learning nv (formerly ATeK nv)
Molenaarsstraat 111
B-9000 Gent
Belgium
Tel.: +32 9 265 74 72
Fax: +32 9 265 74 84
www.uni-learning.com
____________________________________
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content 
delivery. Try it today!. http://www.webworks.com/techwr-l 

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy.  Watch the demo at http://www.DocToHelp.com/TechwrlList

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot- 

To unsubscribe send a blank email to 
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot-  Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.