Setting up the ATLaS mode

This is a mode for the Editor WinEdt 1.414.

The mode is called ATLaS, and as you can guess, it installs support for writing ATLaS source. This mode is not very sophisticated: it only does a little Syntax Highlighting.

Here is what it looks like.

A snapshot of the mode.  
 
 
 

What do I need to do before I attempt to install this mode?

Well, you need the installation files, of course. These are packed into the file ATLaS-winedt.zip, and this is all you need to download.

Then you have to check whether you have a sufficiently recent WinEdt. Open the About... box (in the Help menu) and make sure you have at least "Build: 19981002". If not, you have to upgrade. See the Troubleshooting section at the end of this document about how to do this.

Make sure you have a recent Build.  
 
 
 

Installing the Mode

Unzip ATLaS.zip into the directory $WinEdtDirectory$\Contrib (for most users this would be
C:\Program Files\WinEdt\Contrib or C:\Program Files\WinEdt Team\WinEdt\Contrib
).
Then unzip the ATLaS.zip into an $WinEdtDirectory$\Contrib\ATLaS-Mode directory. (If you are using
Winzip
, just Extract to: $WinEdtDirectory$\Contrib, with tbe option `Use folder names' enabled).

Now, in WinEdt, click on Macros| Execute Macro (or Accessories| Execute Macro in earlier versions). Go to the newly created directory $WinEdtDirectory$\Contrib\ATLaS-Mode and choose the file ATLaS Mode.edt. This will execute the script and install the mode. If you do not have an Execute Macro entry in your Accessories menu see the Troubleshooting section at the end of this document.

Run the Execute Macro... menu command.  
 
 
 

What are these Backup-Files?

When starting the installation of the ATLaS Mode for the first time, it will automatically create some backup files. The backup files store these settings that the installation script will add something to (it will only add entries, so there should be no trouble).

These backup files are used when you want to undo the installation of the ATLaS Mode (see the next section about this).

If you are trying to install the mode a second time (or a third time, or ...), the installation script detects the old backup files. It then asks you what you want to do. It might be that you just started the script by accident. In this case you can abort the script, and nothing has ever happened. Don't read further here. If, however, you really are sure you want to run the script (e.g., to install a newer version of this mode), then say so.

Okay, you want to install the mode a second time. You are now asked what to do with the backup files: don't touch them, and preserve "clean" settings (settings without ATLaS Mode), or overwrite them. If you overwrite them, the backup files do not longer contain clean settings but settings after the first installation of the ATLaS Mode.

If the mode worked satisfactory, you can overwrite the backup files. If you think you need to install the mode a second time since something seems to have gone wrong, then do not overwrite the backup files.  
 
 
 

How can I undo the settings this script made?

For this purpose you will find a de-installation script called _Restore.edt in the same directory as the installation script. Simply use the Accessories| Execute Macro function and choose this file. The script will ask you whether you want to restore the settings from the backup files or not.
Note: You cannot use a _Restore.edt file from another mode! The files are not interchangeable.  
 
 
 

Troubleshooting

  • I do not have an Execute Macro entry in the Accessories menu!
  • Okay, you either have an old WinEdt (means you do not have "Build: 19981002" or later in Help| About...), in which case you need to upgrade anyway, or you re-installed your own winedt.ini-file after an upgrade of WinEdt.

    If you need to upgrade, you can get the most recent version of WinEdt from WinEdt's Homepage (beside others).

    Read also "Important Notes on Upgrading" before upgrading!

    If you re-installed your previous winedt.ini-file because you wanted to keep your settings, you can define this menu entry yourself. If your own modifications to WinEdt (which are stored in this winedt.ini-file) are rather small, consider keeping the original winedt.ini. This will make sure that you have the most up-to-date default settings (such as this menu entry you are here to read about).

    To set up the menu entry, click on Options| Menu Setup... and define a macro entry which reads [Exe("")]. The Menu Item Options are all unchecked. If you have difficulties doing this, you really should use the original winedt.ini.

  • I have read all the documentation, but it still does not work!
  • Well, in this case, you can either contact me via <colin.marquardt@gmx.de>, or ask on the WinEdt mailing list. See the WinEdt online help for information about how to subscribe. Do not bother Alex with questions about this mode!

 
 
Richard Luo lc@cs.ucla.edu 2002/9
Modified from C-mode by Colin Marquardt colin.marquardt@gmx.de
 
Copyright ©1998 Colin Marquardt. All rights reserved.