Using your Own Home Page

In the demonstration example source, there is a placeholder ``home page'' located in

webpubdemo/other/index.html.

If you don't have a home page yet, you can modify this one to make it your own. It should be fairly self-explanatory, even if you don't already know HTML yet.

If you do have a home page (or even an entire website) already, you can just delete webpubdemo/other/index.html and point installation to your website. Then you have to add explicit links to each document subdirectory somewhere within your Web pages. In webpubdemo/other/index.html, the links to the examples are handled as follows:

    <H1>Online Publications</H1>
    <H4>(generated from LaTeX source using the tools described in this document)
    </H4>
    <P>
    <UL> 
    <LI><A HREF="TEST-INSTALLDIR/myconferencepaper/index.html">Example Conference Paper</A>
    <LI><A HREF="TEST-INSTALLDIR/myarticle/myarticle.html">Example Journal Article</A>
    <LI><A HREF="TEST-INSTALLDIR/mybook/mybook.html">Example Book</A>
    </UL>

Thus, each automatically installed document appears in its own subdirectory at the same directory level.

Any files in the webpubdemo/other directory will be copied (recursively, in the case of subdirectories) into the installation directory. Use this directory for images and other resources that are used by multiple documents. Document-specific extras can be handled by the document's Makefile, as the myarticle example illustrates:

    # File webpubdemo/myarticle/Makefile
    NAME = myarticle
    # Software (usually in Matlab) for generating all figures in the paper:
    EXTRAS_NAME = $(NAME)_extras
    OTHER_GOODIES = $(EXTRAS_NAME).tgz original.ps.gz
    include ../Makefile.tex

    rclean:: clean
	    - /bin/rm $(EXTRAS_NAME).tgz

    $(EXTRAS_NAME).tgz:
	    - /bin/rm $(EXTRAS_NAME).tgz
	    tar -hcvzf $(EXTRAS_NAME).tgz $(EXTRAS_NAME)

We see that there are two ``extras'' installed ``as is'' for this paper: (1) a compressed tarfile containing software source for computing the figures in the paper, and (2) a compressed PostScript file containing the original conference version of the paper.

Other goodies which can go here include sound examples, talk overheads, raw HTML files created outside of L^ATEX, and so on. Whatever you put here, remember to place explicit links somewhere in the body of the paper. In the myarticle example, the extra goodies are linked in as follows:

    The following related items are available from the
    \htmladdnormallinkfoot{Web version}{http://www.myplace.edu/\~{}mylogin/myarticle} 
    of this paper:
    \begin{itemize}
    \item Software used to generate all figures in this paper: 
    \htmladdnormallink{\texttt{myarticle\_extras.tgz}}{./myarticle\_extras.tgz}
    \item Original conference paper (Proc.\ IXXX-95):
    \htmladdnormallink{\texttt{myarticle\_original.ps.gz}}{./myarticle\_original.ps.gz}
    \end{itemize}

Note the use of the construct `\~{}' which is necessary to get a printed tilde (~) in the output.