This wiki is out of date, use the continuation of this wiki instead

Tutorial:Setting up Fenix with ConTEXT

From FenixWiki

Jump to: navigation, search


Setting up Fenix with ConTEXT.

It is assumed Fenix Binaries are downloaded in a certain folder, thus in which fxi.exe and fxc.exe will be. With the Run and Lookup setup sections, a file is required: ConTEXTBatches.zip. It is required that this archive is extracted into the folder previously mentioned, the one containing fxi.exe and fxc.exe.

Here and there this folder will be denoted as XXXXXX. You will need to replace XXXXXX with the path to the directory you extracted the binaries to.

For example, you extracted the binaries to D:\Fenix\Executables\, then you will need to replace XXXXXX with D:\Fenix\Executables (watch that last \, there only needs to be one).

Contents

[edit] Advantages

ConTEXT is a pretty handy text editor. It has quite a range of possibilities and the highlighter file is very up to date. When it is setup like described below, certain files are only needed in one directory: the fxi/fxc directory. These certain files contain: include files (*.inc), Fenix header files (*.fh) and DLL's (*.dll). Actually, any file can be included/imported if it's in the fxi/fxc directory. This brings advantages like saving disk space, updating a certain file is much easier and automatically affects all programs using it, not just one.

[edit] Syntax Highlighter

  1. Place fenix.chl in the folder ConTEXT\Highlighters
  2. Restart ConTEXT
  3. File -> New
  4. Go to Tools -> Set Highlighter -> Customize Types..., select Foxpro, click on Edit and change "prg" to "prg2"; select Object Pascal, click on Edit and change "inc" to "inc2".

You can meddle with the colours all you like: Options -> Environment Options -> Colors. You can also edit the colours in fenix.chl, if you find this easier. This can be handy for changing all backgrounds in a quick way.

Should you add native Fenix keywords to the highlighter, which were forgotten, be so kind as to notify of the addition on the Fenix.chl discussion page.

[edit] Hotkeys

The setting up here happens in Options -> Environment Options -> [Execute Keys]. To add hotkeys for Fenix, click on the button Add and enter prg,inc,fh for extensions. Noted are generally used hotkeys between brackets, but this can be altered.

[edit] Lookup on this wiki (F9/F12)

  1. Download fxw.bat (ConTEXTBatches.zip: extract into fxi/fxc folder), if not done already.
  2. Setup Lookup hotkey:
    1. Execute: XXXXXX\fxw.bat.
    2. Parameters: %w.
    3. Save: Nothing.
  • Replace XXXXXX by the path to the directory you placed fxw.bat in, without (double)quotes.

This will allow you to hit a button (F9-F12) to lookup the word currently under your cursor in ConTEXT on FenixWiki. Alternatively you can use %? instead of %w, to enter the word you're looking for. A possible setup is %w on F9 and %? on F12.

[edit] Compile (F10)

  1. Download the new fxc.bat (ConTEXTBatches.zip: extract into fxi/fxc folder) and replace the old one by it, if not done already.
  2. Setup Compile hotkey:
    1. Execute: XXXXXX\fxc.bat (NOTE: for Bennu 0.93 use XXXXXX\bgdc.bat instead)
    2. Start in: %p
    3. Parameters: XXXXXX -g %n.
    4. Save: All files before execution.
    5. Enable Use short DOS names (if you tend to use spaces in paths/filenames, so enabling is safest)
    6. Enable Capture console output.
    7. Compiler output parser rule: Error in file %n at line %l:*.
    8. Enable Scroll console to the last line.
  • Replace XXXXXX by the path to the directory containing fxc.bat and fxc.exe, without (double)quotes.
  • Note that you can include codefiles and libraries located in the XXXXXX directory automatically now.

[edit] Run (F11)

  1. Setup Run hotkey:
    1. Execute: XXXXXX\fxi.exe. (NOTE: for Bennu WIP2 and later use XXXXXX\bgdi.exe instead)
    2. Parameters: "%p%F.dcb".
    3. Save: Nothing.
    4. Enable Use short DOS names (if you tend to use spaces in paths/filenames, so enabling is safest)
  • Replace XXXXXX by the path to the directory containing fxi.exe, without (double)quotes.

[edit] File Associations

The setting up here happens in Options -> Environment Options -> [File Associations].

Repeat the following for the extensions wanted (prg, inc, fh):

  1. Click on the button Add and enter an extension.
Personal tools