[l2h] bibliography not showing in table of contents

[Ross MOORE]

[Charset iso-8859-1 unsupported, filtering to ASCII...]
> I'm confused about how to get the bibliography showing in the table of
> contents. My bibliography appears in a file references.tex, which is
> included using \segment from the top-level file f9515.tex. However, the html
> table of contents doesn't show the Bibliography. I can get round this by
> \including the references file in the top level instead of \segment-ing it.
> However, then I find that the links from the chapters don't work, because I
> can't figure out what \internal command to use inside e.g. ch1.tex.
> 
> I would greatly appreciate any helpful pointers. I've included the
> bibliography, the top level file, the first chapter (very short) and the
> Makefile.

With the bibliography page already created, use \externallabels
to declare all the labelling information to be available with the 
main document.
Consult the manual to see how this works.

You will not get a Table-of-Contents entry, since the Bibliography is not
part of the same job. An alternative way to do this is available
with v99.2, but has not had much testing yet.


The segmentation procedure is just a formalisation of multiple jobs
with a simplified syntax for getting the labels of different parts.
i.e. \internal  is just a simplification of  \externallabels .


Hope this helps,

	Ross Moore

> 
> Nick Ellis
> CSIRO Marine Research	mailto:Nick.Ellis@marine.csiro.au
> PO Box 120			ph    +61 (07) 3826 7260
> Cleveland QLD 4163    	fax   +61 (07) 3826 7222
> Australia			http://www.marine.csiro.au
> 
> references.tex
> --------------
> \begin{htmlonly}
> \documentclass[12pt]{report}
> \usepackage{html}
> \usepackage{natbib,nharvard} 
> \end{htmlonly}
> \startdocument			% Mark the end of the preamble
> \newcommand{\canj}{Canadian Journal of Fisheries and Aquatic Sciences}
> \begin{thebibliography}{99}
> \harvarditem{Sainsbury}{1980}{Sain80} Sainsbury, K.~J. (1980). Effect of
> individual variability on the von Bertalanffy growth equation. {\it \canj
> \/} {\bf {\bf 37,}} 241--247.
> \end{thebibliography}
> 
> 
> top level file
> -------------- 
> \documentclass[12pt]{report}
> \usepackage{html}
> \usepackage{natbib,nharvard} 
> \pagestyle{myheadings}
> \begin{document}
> \setcounter{chapter}{0}
> \internal[sections]{ch1}         % Include section information
> \internal[contents]{ch1}         % Include table-of-content
> \tableofcontents
>   \include{ch0}
>   \segment{ch1}{chapter}{Estimation of Mortality and Growth Parameters from
> Length Frequency Data}
>   \segment{references}{chapter}{Bibliography}
>  %\include{references}
>   \include{ch6}
> \end{document}
> 
> ch1.tex
> -------
> \begin{htmlonly}
> \documentclass[12pt]{report}
> \usepackage{html}
> \usepackage{natbib,nharvard} 
> \input{ch1.ptr}		
> \end{htmlonly}
> %\internal{internals}   %my attempt at making the \include{references}
> version work
> \internal{references}
> \startdocument			% Mark the end of the preamble
> %begin{latexonly}
> \setcounter{chapter}{1}
> %end{latexonly}
> \setcounter{page}{1}
> \pagenumbering{arabic}
> \section{Introduction}
> Traditional methods assume a deterministic relationship between
> size and age for the population.  It is more realistic to assume
> there is individual variability in growth \citep*{Sain80}. 
> 
> Makefile
> --------
> #
> #  This sample makefile provides a starting point for building
> #  HTML documents which multiple segments and inter-segment
> #  dependencies.  This example is included with the V96.1
> #  version of latex2html.
> #
> 
> TOP 	  = f9515
> INT	  = internals.pl
> TEXES	  = ch1.tex references.tex ch0.tex ch6.tex
> SECTIONS  = $(TOP)/ch1.html $(TOP)/references.html
> TOPTITLE  = "Estimation of Population Parameters for Australian Prawn
> Fisheries"
> S1TITLE	  = "Estimation of Mortality and Growth Parameters from Length
> Frequency Data"
> REFTITLE	  = "Bibliography"
> 
> L2H 	  = latex2html -local_icons 
> LaTeX	  = latex
> DVIPS	  = dvips
> 
> COMMON	  = -dir $(TOP) -external_file $(TOP) 
> LTOP	  = $(L2H) -t $(TOPTITLE) $(TOP).tex
> LSEC1	  = $(L2H) $(COMMON) -prefix ch1 -info "" \
> 		-up_url $(TOP).html \
> 		-up_title $(TOPTITLE) \
> 		ch1.tex
> LREF	  = $(L2H) $(COMMON) -prefix references -info "" \
> 		-up_url $(TOP).html \
> 		-up_title $(TOPTITLE) \
> 		references.tex
> 
> all:	$(TOP).ps $(TOP)/$(TOP).html
> 
> $(TOP).dvi:	$(TOP).tex $(TOP).aux
> 	$(LaTeX) $(TOP).tex
> 
> $(TOP).aux:	$(TOP).tex $(TEXES)
> 	$(LaTeX) $(TOP).tex
> 
> $(TOP).ps:	$(TOP).dvi
> 	$(DVIPS) -o $@ $(TOP)
> 
> $(TOP)/$(TOP).html :	$(TOP).tex $(TOP).aux $(SECTIONS)
> 	$(LTOP)
> 
> $(TOP)/ch1.html:	ch1.tex $(TOP)/references$(INT)
> 	$(MAKE)	ch1.stamp
> 
> $(TOP)/references.html:	references.tex 
> 	$(MAKE)	references.stamp
> 
> ch1.stamp:	ch1.tex  $(TOP)/references$(INT)
> 	$(LSEC1)
> 	touch $@
> 
> references.stamp:	references.tex 
> 	$(LREF)
> 	touch $@
> 
> $(TOP)/ch1$(INT):
> 	$(LSEC1)
> 
> $(TOP)/references$(INT):
> 	$(LREF)
> 
> clean:	
> 	rm -rf $(TOP) $(TOP).dvi $(TOP).aux $(TOP).log $(TOP).toc \
> 	    $(TOP).lof $(TOP).ps ch1.ptr ch2.ptr ch1.stamp ch2.stamp \
> 	    ch3.ptr ch4.ptr ch3.stamp ch4.stamp ch5.ptr ch5.stamp
> references.ptr references.stamp
>