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.
Wow! My name got dropped! The wayback machine really works!
I can totally say that Rick's script still works wonders. It's worth the
money all the way. And Rick is wonderful, so there we are.
MadCap Software Product Consultant
Managing your content, one topic at a time
IM: sharonvburton -at- yahoo -dot- com
From: techwr-l-bounces+sharon=anthrobytes -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+sharon=anthrobytes -dot- com -at- lists -dot- techwr-l -dot- com] On
Behalf Of Combs, Richard
Sent: Tuesday, December 01, 2009 8:22 AM
To: Nancy Allison; techwr-l -at- lists -dot- techwr-l -dot- com
Subject: RE: Cross-reference style question
Nancy Allison wrote:
> I'm working in a long document that has internal TOCs at the beginning
> each chapter.
> They are presented in a simple list format, using the same x-ref
> that is used in sentences. It's quick and easy but possibly not really
> stylistically acceptable. By that I mean, not stylistically acceptable
> ME. I'm wondering if my ideas of acceptability are stuck in, say, the
> It looks like this:
> This chapter contains the following sections:
> -- "Opening Your Toaster Box" on page 37
> -- "Plugging in Your Toaster" on page 42
> -- "Burning Your Toast" on page 67
> Each bulleted item is a hyperlink and is formatted in blue ink, so
> when people read the PDF online, they know they can click to go
> that section. When the document is printed on a color printer, the
> blue, which may seem slightly odd, but the page number is provided so
> reader can find the section.
> Although it looks a bit kludgy to me, it is much easier to maintain
> having two lists marked with conditional text:
> --One has the blue hyperlink, no quotation marks, and no page numbers
> --One has the quotation marks and page numbers, but no hyperlink
> The two-formats-marked-with-conditional-text is what I have done in
> documents, but I'm wondering if I am making work for myself and anyone
> who has to maintain the docs.
I think your current setup is _superior_ to omitting the page numbers in
the online PDF. After all, people _print_ PDFs that they access online.
And then the blue link with no page numbers is pretty much useless to
Save the page-numberless hyperlinks for the online help.
Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at: http://www.doctohelp.com/
Help & Manual 5: The all-in-one help authoring tool. True single- sourcing --
generate 8 different formats and as many different versions as you need
from just one project. Fast and intuitive. http://www.helpandmanual.com/
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-