Basic Hitop.
1. Installing Hitop
The majority of Hitop users, run it on a Unix or GNU/Linux system, although it should be able to run on any computer with a recent version of g++, make and an STL implementation, which should include Amiga and Windows users. Ind, although it should compile on an Amiga, and probably on Windows.
Personally I have only tried it on GNU/Linux, and as such, I can't really help with installing on other platforms. Below, we look at installint on a GNU/Linux distribution, although the basic principle is the same on most platforms.
The Hitop source code is available from the Hitop website, at http://www.hitop.org/. At the time of writing the latest version is version 0.35, but hitop.org has older versions available for download too. We'll assume that you're running the latest version, which right now, is 0.35.
The file is available as a G-Zipped tar file, which can be extracted as follows:
tar xfvz hitop35.tgzThis will create a subdirectory called hitop-0.35 (or similar, depending on the version you are using.) Moving into this directory, you can compile hitop by using the following command:
makeCompilation can take some time, especially on older systems. When it's finished, you will need to log in as root, and run:
make installIf you can't log in as root, you can still run hitop, by copying the hitop to a suitable place in your home directory.
The ultimate check is to try running hitop. When executed, you should see a nice message like this:
hitop 0.35 ©1999-2001 David Marshall & Darren Edmundson
(2001-06-10) http://www.hitop.org/
Usage: hitop infile.hitop [outfile.html]Once that's done, you're ready to start hitoping!
Hitoplive
Hitoplive is a seperate program within the Hitop package, that is compiled when you compile Hitop. It is a cgi programme and should be put in an appropiate directory.
Hitoplive enables your hitop files to be created on the fly, enabling you to bypass the compilation steps when building your site.
Setting up Hitoplive is well beyond the relms of this tutorial, but if you can set it up, or you are a durger who uses fof, once installed, it is very easy to use.
Hitoplive files are exactly the same as Hitop files, expect they have a different file extension. Hitop files normally have the file extension .hitop, and Hitoplive files have .live, although templates usually have the .hitop to stop them being viewable in a browser.
HitopLive
Throughout the tutorial, we'll use boxes like
this to point out how things are done differently when using Hitoplive. It's
not that often, and they're not big changed.You can view your page in your browser, making sure you put in the full server name (for example, on my home computer, I would use http://binky.jibber.net/bods/index.live to view my site home page).
The only other thing you need to do is place an empty file called hitop.base in the root of your web directory (normally public_html. Every time you change your source file, to see the changes all you need to do is refresh your browser.
Throughout this tutorial, you can use Hitoplive instead of Hitop, and where necessary, we'll point out steps you may need to do, or not do, to use Hitoplive instead.
Whereas Hitop outputs error messages to your command line, any Hitoplive error messages will be shown in your browser.
Next Step
Now that you've got Hitop installed, it's time to start using it!
This work is licensed under a Creative Commons License.
