Skip to content

Latest commit

 

History

History

first-steps

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
readme.md
readme.md
 
 

readme.md

First steps

  • If you have installed a standalone version of the Rexx Parser, open a terminal shell and run setenv (this will be . ./setenv.sh if you are running a Unix-like system).

  • If you are running the Rexx Parser as part of the net-oo-rexx software bundle, please follow the installation instructions of that bundle. You can then choose to test the Parser from a terminal session (after running setenv), or use ooRexxShell, a powerful, Swiss army knife shell developed by Jean-Louis Faucher, which is part of the net-oo-rexx distribution; ooRexxShell includes direct support for the Parser.

  • Change to the samples subdirectory. Run highlight.rex program passing sample.html as an argument:

    rexx highlight.rex ./sample.html

    You should see output similar to the following (line breaks have been added for readability):

    <!doctype html><html lang='en'>
  <head>
    <title>Test</title>
    <link rel='stylesheet' href='/rexx-parser/css/rexx-dark.css'>
  <head>
<body>
Sample text

<div class="highlight-rexx-dark">
<pre>
<span class="rx-kw">If</span><span class="rx-ws"> </span>
<span class="rx-var">a</span><span class="rx-ws"> </span>
<span class="rx-op">=</span><span class="rx-ws"> </span>
<span class="rx-var">b</span><span class="rx-ws"> </span>
<span class="rx-kw">Then</span><span class="rx-ws"> </span>
<span class="rx-var">c</span>
</pre>

Last line
</body>
</html>

  • Now look at the source of highlight.rex and inspect sample.html too. You have just seen the Rexx HTML highlighter in action!

  • Now, in the /samples directory, run elements.rex with ./hi.rex as an argument.

    rexx elements ./hi.rex

    You should see output similar to the following:

    elements.rex run on 15 Feb 2025 at 10:54:37

Examining hi.rex...

Elements marked '>' are inserted by the parser.
Elements marked 'X' are ignorable.
Compound symbol components are distinguished with a '->' mark.

[   from  :    to   ] >X 'value' (class)
 --------- ---------  -- ---------------------------
[    1   1:    1   1] >  ';' (a EL.END_OF_CLAUSE)
[    1   1:    1   4]    'SAY' (a EL.KEYWORD)
[    1   4:    1   5]  X ' ' (a EL.WHITESPACE)
[    1   5:    1   9]    'Hi' (a EL.STRING)
[    1   9:    1   9] >  ';' (a EL.END_OF_CLAUSE)
[    1   9:    1   9] >  '' (a EL.IMPLICIT_EXIT)
[    1   9:    1   9] >  ';' (a EL.END_OF_CLAUSE)
[    1   9:    1   9] >  '' (a EL.END_OF_SOURCE)
[    1   9:    1   9] >  ';' (a EL.END_OF_CLAUSE)
Total: 9 elements and 0 compound symbol elements examined.

  • You can now browse the Rexx Highligther page, if you please, where you will find several new programs to run.

  • If you want to implement your own Rexx highlighter (recommended! :)), you will find a nice utility to do so in the Highligther page. You will also need some CSS files. The ones I am using in this site (which are fairly incomplete, specially the light background one!) can be found in the css subdirectory.

  • Take a look at the HTML Highlighter page, and follow the links there, specially the features one.

  • For a beautiful highlighting example of a medium-sized (~750 lines) source program, see this program, which defines all the element categories, category sets and subcategories.

  • Take a look at the documentation about the Element API.

  • And, finally... please give feedback! Your feedback is important. Seriously! :) You can reach me at josep.maria.blasco@epbcn.com.