Install The Athena User's Guide

Athena's documentation is no longer included in the horae package. The User's Guide must be built and installed if you want to be able to view the document from within Athena. Once everything settles down, there will be a pre-built document package on SourceForge, but for now you need to do the following.

Installing with root access

• In the directory where you checked out the Athena User's Guide, issue this command to install all the CPAN prerequisites:

    sudo ./install_prereqs

  Answer yes to any questions you are asked.

• You should consider using your package manager to install the Template Toolkit before running the install_prereqs script. TT is a rather lengthy build -- most linux distributions include TT, so you should just go ahead and use the pre-built package. (In the Ubuntu universe, for example, the package is called libtemplate-perl.)

  Once TT and the required perl modules are installed, issue the following commands in the directory where you checked out the user's guide:

    ./configure
    ./bin/build -a
    ./bin/pod -a
    sudo ./install

Installing to your own diskspace

• In the directory where you checked out horae, start cpan and do

  force install Bundle::AugBundle

  Once that has completed successfully, do the following:

    ./configure
    ./bin/build -a
    ./bin/pod -a
    ./install

The last step moves the html and pod versions to the location where Athena can find them. The installation requires that Horae already be installed so that the correct location can be determined.

You can also build the PDF document if you have the latex interpreter installed on your computer:

  ./bin/tex -a
  cd tex
  pdflatex athena.ltx
  pdflatex athena.ltx

You have to run pdflatex twice to get the cross-referencing correct.

The package script makes the zip file containing the html, pod, css, data, and image files which will eventually find its way to SourceForge.