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.
Subject:Summary: HTML index (part 2 of 3) From:Ruth Simpson <ruths -at- MCCABE -dot- COM> Date:Wed, 21 Jan 1998 16:08:09 -0500
Susan Rowlett wrote:
> I haven't yet met this problem, but may someday. Can you change the
> <$pagenum> on Reference IX page to something else...what I'm not sure.
> Maybe some kind of symbol text. The theory would be that all the
> markers/jumps would be there but something other than a number would show.
> Of course, this would require generating an IX file, probably, which might
> not fit what you need to do.
Julie Allen wrote:
> We came up with one solution which allows multiple page
> references for an index entry - we replaced the page
> numbers with an image (a small green arrow) in the
> WebWorks template. This leaves you with a row of hot
> graphical links for index entries with multiple references.
>
> To get this to work we did the following:
>
> 1. In Frame, we set up the index so that page numbers have
> a character format 'index_pagenum':
>
> a) define a character tag index_pagenum
> b) on the IX reference page, make the IndexIX entry:
> <index_pagenum><$pagenum>
>
> When you generate the index, all page numbers will have the
> index_pagenum character tag.
>
> 2. In WebWorks, the hyperlink marker is mapped using the default
> GoToLinkFileandTag style:
> <A HREF="$LINKFILE(html, name);#$LINKTAG;">
>
> 3. In Webworks, we defined an IndexPageNum character style as:
> $DATA["<A HREF=\".*\">"];<IMG BORDER=0 SRC="jump.gif"></A>
>
> This takes the <A HREF...> part of the reference, replaces the
> page number text which comes after it with an image, and sticks
> a </A> tag on the end.
>
> We also made sure the Frame index didn't have commas separating
> multiple references (it looks funny when there are images instead
> of page numbers) by removing the comma from the SeparatorsIX
> definition on the IX reference page.
>
> After all that, people here voted to keep the page numbers, so
> we haven't ended up using this stuff. But I thought it was
> clever and looked good....
Sonya Keene wrote:
> I don't have a solution using WebWorks Publisher.
>
> WebMaker solves the problem this way: if an index entry has two or
> more page numbers in FrameMaker, WebMaker converts them to links
> numbered [1], [2], etc.
>
> For an example, see
>http://www.harlequin.com/products/dpp/webmaker/guide/
>
> and click on the Index button.
Maureen Ostrosky wrote:
> In response to your question about HTML indexes in framers, here's the
> answer I received from WebWorks. Essentially, wait until 4.0.
> Maureen Ostrosky
> Technical Editor
> Spyglass, Inc.
>
> > -----Original Message-----
> > From: Krista Osborne [SMTP:osborne -at- quadralay -dot- com]
> > Sent: Friday, December 19, 1997 11:09 AM
> > To: Ostrosky, Maureen
> > Subject: Re: Feature request/question
> >
> > Dear Ms. Ostrosky,
> >
> > In a continuing effort to provide Adobe FrameMaker users with the
> > best
> > and most advanced tools for publishing on-line documents, Quadralay
> > is in active development of WebWorks Publisher 4.0.
> >
> > This upcoming major release of WebWorks Publisher will mark a
> > dramatic advance in the evolution of on-line publishing. Users will
> > find
> > WebWorks Publisher 4.0's new user interface extremely easy to use and
> > the new optional Intelligent Wizard will guide users quickly through
> > the process of generating an initial project. Release 4.0 will
> > also greatly expand capabilities of producing documents in the
> > variety
> > of emerging on-line formats beyond HTML such as Microsoft HTML Help,
> > Netscape NetHelp, Sun Microsystems' JavaHelp and XML.
> >
> > As far as the handling of page numbers in indexes in version 4.0,
> > Publisher
> > will eliminate the page number and instead use the title of the
> > document it
> > refers to.
> >
> > For a more detailed preview of WebWorks Publisher 4.0's exciting
> > advances visit:
> >
> > http://www.quadralay.com/Publisher/4-0_prev.html
> >
> > All WebWorks Publisher users covered by annual maintenance will be
> > entitled to upgrade to this significant major release at no charge.
> >
> > Release of WebWorks Publisher 4.0 is anticipated in the first quarter
> > of 1998.
> >
> > At 08:39 AM 12/19/97 -0600, you wrote:
> > >I was wondering if you had any plans to update the handling of page
> > >numbers in indexes. For example, instead of listing specific page
> > >numbers (bein girrelevant online), changing the references to be 1
> > >(first page number for entry), 2 (second page number for entry), etc.
> > >See http://www.w3.org/TR/REC-html40/index/list.html for an example of
> > >this. We have had some requests for this type of online formatting.
> > >
> > >Thank you.
> > >
> > >Maureen Ostrosky
> > >Technical Editor
> > >Spyglass, Inc.
> > >
> > ______________________________________________________________________
> > ____
> >
> > Kris Osborne EMail:
> > osborne -at- quadralay -dot- com
> > Quadralay Corporation Phone: (512) 719-3399 X237
> > 9101 Burnet Road, Suite 105 Fax: (512) 719-3606
> > Austin, TX 78758 URL:
> > http://www.quadralay.com
> > Technical Questions: support -at- quadralay -dot- com
> > ______________________________________________________________________
> > ____