Section Numbering in HTML Pages Output - does anyone have a work-around?

13 views
Skip to first unread message

Debbie Pulver

unread,
Feb 2, 2012, 11:44:45 AM2/2/12
to author-...@googlegroups.com

Hi friends,

 

We are slowly moving over to use of HTML Pages output instead of/as well as Word>PDF. However, my manager really, really wants the topics to have numbered headings so that he can easily refer people to a specific heading number. The AIT KB says that AIT does not support this option, but I am wondering if anyone out there has developed a workaround?

 

Thanks in advance,

 

Debbie

 

Debbie Pulver

Technical Documentation Team Leader

R & D Department

Teledata Networks

an Enablence Company

Tel (W): 972-(0)9-9601530

Tel (H): 972-(0)8-6570871

Cell: 972-(0)50-5644608

E-mail: debbie...@teledata-networks.com

Skype: Dvoireh

 

 

 

Please only print this e-mail if really necessary, and please recycle the paper afterwards!

 



NOTICE: This email and any files transmitted with it are Enablence and Teledata-Networks confidential and intended solely for the use of the individual or entity to whom they are addressed. If you have received this email in error please notify the sender. This message contains Enablence and Teledata-Networks confidential information and is intended only for the individual named. If you are not the named addressee you should not disseminate, distribute or copy this e-mail. Please notify the sender immediately by e-mail if you have received this e-mail by mistake and delete this e-mail from your system. If you are not the intended recipient you are notified that disclosing, copying, distributing or taking any action in reliance on the contents of this information is strictly prohibited.
image003.jpg
image004.jpg

Miriam Lottner

unread,
Feb 2, 2012, 12:12:14 PM2/2/12
to author-...@googlegroups.com

Wow, that is such a bad idea and so not web friendly….they can just tell you the page number XYZ.html etc, or use a meta tag.

You could always maintain them by hand on the HTML Heading of the Web tab, but that seems painful at best and impossible at worst.

 

I don’t know of another workaround.

 

I have never seen anyone use it. Newspapers that have gone webby don’t have page numbers, neither do KBs….what is his source for thinking this is a good idea?

Shabbat Shalom!

 

Miriam

 

Miriam Lottner | CEO 

T: 077.200.6818  M: 054-530-2308

mir...@tech-tav.com |  www.tech-tav.com | www.tech-tav.com/technical-writing-blog

 

tech-tav-sig-file.gif

image001.gif
image002.jpg
image003.jpg

Debbie Pulver

unread,
Feb 6, 2012, 3:48:49 AM2/6/12
to Israeli Author-it Users
Hi,

I agree that it's a bad idea. The problem is that my manager (CTO) is
often accosted in the corridor by people inside the company who are
looking for information. He likes to tell them "See section 5.3 in the
user manual". He thinks it's better and easier than telling them to
search for a term or topic. In some cases he could be right.

Another problem that has cropped up is that he wants the Next and
Previous buttons/links at both the beginning and the end of each
topic, but AIT only allows you to choose one of those options. Any
ideas?

Thanks,

Debbie

On Feb 2, 7:12 pm, "Miriam Lottner" <mir...@tech-tav.com> wrote:
> Wow, that is such a bad idea and so not web friendly..they can just tell you
> the page number XYZ.html etc, or use a meta tag.
>
> You could always maintain them by hand on the HTML Heading of the Web tab,
> but that seems painful at best and impossible at worst.
>
> I don't know of another workaround.
>
> I have never seen anyone use it. Newspapers that have gone webby don't have
> page numbers, neither do KBs..what is his source for thinking this is a good
> idea?
>
> Shabbat Shalom!
>
> Miriam
>
> Miriam Lottner | CEO
>
> T: 077.200.6818  M: 054-530-2308
>
> mir...@tech-tav.com |   <http://www.tech-tav.com/>www.tech-tav.com|
> <http://www.tech-tav.com/technical-writing-blog>www.tech-tav.com/technical-writing-blog
>
>  <http://www.tech-tav.com/> tech-tav-sig-file.gif
>
> From: Debbie Pulver [mailto:Debbie.Pul...@Teledata-Networks.com]
> Sent: Thursday, February 02, 2012 6:45 PM
> To: author-...@googlegroups.com
> Subject: [Author-it] Section Numbering in HTML Pages Output - does anyone
> have a work-around?
>
> Hi friends,
>
> We are slowly moving over to use of HTML Pages output instead of/as well as
> Word>PDF. However, my manager really, really wants the topics to have
> numbered headings so that he can easily refer people to a specific heading
> number. The AIT KB says that AIT does not support this option, but I am
> wondering if anyone out there has developed a workaround?
>
> Thanks in advance,
>
> Debbie
>
> Debbie Pulver
>
> Technical Documentation Team Leader
>
> R & D Department
>
> Teledata Networks
>
> an Enablence Company
>
> Tel (W): 972-(0)9-9601530
>
> Tel (H): 972-(0)8-6570871
>
> Cell: 972-(0)50-5644608
>
> E-mail: debbie.pul...@teledata-networks.com
>
> Skype: Dvoireh
>
> Please only print this e-mail if really necessary, and please recycle the
> paper afterwards!
>
> NOTICE: This email and any files transmitted with it are Enablence and
> Teledata-Networks confidential and intended solely for the use of the
> individual or entity to whom they are addressed. If you have received this
> email in error please notify the sender. This message contains Enablence and
> Teledata-Networks confidential information and is intended only for the
> individual named. If you are not the named addressee you should not
> disseminate, distribute or copy this e-mail. Please notify the sender
> immediately by e-mail if you have received this e-mail by mistake and delete
> this e-mail from your system. If you are not the intended recipient you are
> notified that disclosing, copying, distributing or taking any action in
> reliance on the contents of this information is strictly prohibited.
>
>  image001.gif
> 5KViewDownload
>
>  image002.jpg
> 3KViewDownload
>
>  image003.jpg
> 6KViewDownload

Miriam Lottner

unread,
Feb 6, 2012, 3:53:08 AM2/6/12
to author-...@googlegroups.com
Hi Debbie,

Isn't a good search engine one of the main reason for putting the help
online in the first place?

If he memorized the headings -why wouldn’t he also know the names of the
heading? If you tell someone to search for a specific topic heading, it will
be the first result in the search.

I don't really know what else to say, other than that he won't find another
help with headings numbers no matter how long he searches.

The next/previous buttons can be customized to show in both places. Shlomo
can do that for you if you need.

Be well,
Miriam

Miriam Lottner | CEO 
T: 077.200.6818  M: 054-530-2308

mir...@tech-tav.com |  www.tech-tav.com |
www.tech-tav.com/technical-writing-blog

Debbie Pulver

unread,
Mar 13, 2012, 8:47:17 AM3/13/12
to Israeli Author-it Users
Hello all,

I have found a solution - albeit not automated and requiring manual
hacking of the various TOC*.htm files after publishing. The heading
numbers will only appear in the TOC, but not in the topics themselves,
nor in hyperlinks. If you'd like to know how it's done, I can send you
a file which shows what to do.

Debbie
Reply all
Reply to author
Forward
0 new messages