Installing ImoLatE from new (Update mechanism v1, 2005nov26) This file (InstallImolate-New-README) describes how to install ImoLatE (the IMO LaTeX Environment) on a machine which doesn't have it. (If you want to update an existing installation, see the companion file InstallImolate-Update-README in the .tgz package you got this file from.) The source file you should have (and may have unpacked) is a tar-gzip file called imolate-.tgz, where is the version you are installing, e.g. imolate-v2.4.00.tgz . If you have a choice of versions, you should normally choose the most recent (highest number) one. VERSION NUMBER CONVENTIONS The is of the form v.., e.g. v2.4.00. I am adopting the Linux convention that odd-number minor versions are development versions and even-number ones are stable releases. Thus you will normally have an even . WHAT YOU WILL BE INSTALLING ImoLatE is software that helps people edit the journal WGN and other IMO publications such as the Proceedings of IMC and the Radio Meteor School. The package you are installing now just contains the software. When you start to edit articles, you will place them within the directory tree you are about to install. SYSTEM REQUIREMENTS CPU/OS: ImoLatE runs under Linux. I run it on a PC, but in principle it should run on any hardware platform with Linux (and probably other Unices, though it needs the bash shell). I have made no attempt to port it to the Macintosh or Windows. I suspect the latter lacks the operating system facilities to let it work. DISK SPACE: The current version of the software occupies about 50MByte. This is irrelevant, though, as the papers you will edit will occupy vastly more. I find that a typical issue of WGN occupies anything from a few hundred MBytes to, in bad cases, 1GByte (!) (The problem is images: these can easily occupy many MBytes. Each image tends to contribute three times: as the original image file, in a .ps of the individual paper, and in a .ps of the entire publication. PDFs are more compact and add less.) MEMORY (RAM) SIZE: Again, the ImoLatE suite is irrelevant: you will need enough RAM to run Latex, ghostview, editors, ... If you can run these, ImoLatE should not stretch your machine. CPU SPEED: I know of no absolute limitations. I find ImoLatE runs comfortably on a 1GHz CPU with 0.5GByte of RAM (enough to avoid swapping). Again, it is not ImoLatE that takes the time, but the programs it calls: principally things like dvips and dvipdf when they integrate large image files into the finished result. YOU, THE INSTALLER: Only a basic understanding of Linux is required. The entire process uses a command-line terminal, not click-and-drag. YOU, THE USER: After installation, ImoLatE also uses command-line rather than click-and-drag. You will need to know how to use LaTeX like this. WHERE TO INSTALL ImoLatE AND WHAT TO CALL IT You will have to choose a place in your filesystem to install this software. You probably already have preferences about how you like to organise your file space. You should choose a place where ImoLatE will fit comfortably into your structure. For sake of example, I will assume you choose astro (i.e. /home/ime/astro, if your login name is "ime"). In this chosen place, you will need to create a subdirectory to contain all the ImoLatE material, both software and the papers you edit. (Do not do this yet.) When you choose a name for it, the standard name is imolate (all lower-case letters). It causes no problems if you call it something different. INSTALLING ImoLatE 1. Move to the area where you want to place the ImoLatE directory, i.e. cd ~/astro Note that this is NOT the directory which will contain the ImoLatE system (probably called imolate), but one above it. NB- do not create a subdirectory for imolate yet. 2. Copy or move the .tgz file (with the ImoLatE distribution) here. 3. Unpack it. It will produce several file with names beginning with "InstallImolate" (listed below). Check first that you have no files of these names, or they will be over-written. It is unpacked with the command tar -xzf imolate-.tgz e.g. tar -xzf imolate-v2.4.00.tgz if it is for version 2.4.00. 4. Check the files you have unpacked. There should be several files and one directory. To help you manage them, they all begin with the stem "InstallImolate", so `dir' lists them together. They are: InstallImolate-New-README README file for a new installation. This is the file you are reading now. InstallImolate-Update-README README file for an update. InstallImolate-Update Shell script to perform the updating. (NB- there is no equivalent for a new installation as it is so simple.) InstallImolate-NewVersionNo Text file with the version number and release date of the version being installed. InstallImolate-Files Directory with the source of all the material to install or update. 5. Create the imolate system. This is all in the directory InstallImolate-Files, so all you need do is rename it: mv InstallImolate-Files imolate (assuming you decide to call it imolate). 6. Tidy up. The InstallImolate-* files are no longer needed. If you want to keep the help file you are reading now, it would be sensible to move it into your new imolate system: mv InstallImolate-New-README imolate The unwanted files can be deleted: rm -i InstallImolate-* The "-i" switch causes rm to ask you before deleting each file. If you are sure you have no files of your own with names beginning InstallImolate-, you can omit this switch. 7. Installation is now complete. There is no need to modify any environment variables (e.g. set up in ~/.profile) when you log in - ImoLatE works without needing any of that. You can now cd imolate and begin finding out how to use it. There is a README file (though not yet very helpful). 8. Adding existing WGN or IMC Proceedings material What you have installed is just the software. You may wish to have the papers from existing publications, e.g. back issues of WGN or IMC Proceedings. You will have to obtain these separately, but they will fit straight into the directory tree you have installed. If you list the files in the imolate subdirectory, you will find (amongst others): imc for the IMC Proceedings (currently, the Radio Meteor School proceedings are also being housed here); wgn for the Journal WGN. (Others, e.g the Radio Meteor School, may be added later.) If you obtain copies of WGN or IMC files, they fit inside one of these. 9. Finally, I would be grateful if you send me an email to tell me you've installed it. I would like to keep a list of people using it so I can inform them of changes. Please email me at c.trayner@leeds.ac.uk . Chris Trayner 2005 November 27