TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Unless you have so many that you fill up the marker window, you should
place only one index marker at each heading. In the marker window, use a
semicolon to separate the different entries. That keeps it cleaner.
Marker placement isn't important from FrameMaker's perspective as long
as it's on the first line of the paragraph so hyperlinks can jump to the
text prettily when you click them. However, I typically put index
markers at the very end of headings for two reasons:
- First, because cross-reference markers are automatically put at the
beginning of a line, and I don't want the two marker types to
accidentally hide each other.
- Second, because we use Header/Footer$1 and $2 markers in headings to
give us some of the header information in our "chunked" files. Those are
typically located in the middle of the heading paragraph, wherever they
happen to land. Many of the header/footer markers are conditionalized,
so I also wind up with markers that indicate hidden conditional text. It
can get a little hairy if I'm inconsistent with the placement.
Always putting index markers at the end gives me a fighting chance of
knowing if I missed an index entry for a particular heading. If I don't
see a marker at the end of a heading, I find out if that was
intentional.
Hope that helps.
Donna
- CONFIDENTIAL-
This email and any files transmitted with it are confidential, and may also be legally privileged. If you are not the intended recipient, you may not review, use, copy, or distribute this message. If you receive this email in error, please notify the sender immediately by reply email and then delete this email.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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
Easily create HTML or Microsoft Word content and convert to any popular Help file format or printed documentation. Learn more at http://www.DocToHelp.com/TechwrlList
---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
