Colorer schemes

The library of schemes is a basic set of descriptions of syntaxes and styles of the coloring, used by Colorer library. The project contains files and scripts for creation of library of schemes.

Improvements of translation of this file to English are welcome

Structure

• hrc - basic set of descriptions of syntaxes (hrc-files) and their generators
• hrd - basic set of styles of a coloring (hrd-files), their generators and additions
• shared - shared colorer xml schemes
• javalib - required java libs

How to build from source

Common

To build the library of schemes, you will need:

• git
• ant 1.8 or higher
• java development kit 6 (jdk) or higher
• perl

Download the source from git repository:

git clone https://github.com/colorer/Colorer-schemes.git

or update git repository:

git pull

Run build

build.cmd target

where the target is one of the values

• base - simple build of the schema library. Folder 'build/base'
• base.pack - build the schema library with the hrc-files packed into an archive. Folder 'build/basep'
• base.far - build the schema library for distribution with FarColorer distribution kit. Folder 'build/basefar'
• base.update - archive base.pack. Folder 'build'

Features of build under Windows

Before starting the build scripts, make sure that the PATH environment variable contains the path to jdk and ant. Also you need the environment variable JAVA_HOME set. For example:

set PATH=v:\apps\jdk\bin;v:\apps\ant\bin;%PATH%
set JAVA_HOME=v:\apps\jdk

Features of build under Linux

Here is an example on Debian Wheezy.

Install ant and jdk

apt-get install ant openjdk-6-jdk

If the apt config contains APT::Install-Recommends "False";, then you must also install ant-optional.

In the file /usr/share/ant/bin/ant comment out lines

# Add the Xerces 2 XML parser in the Debian version
if [ -z "$LOCALCLASSPATH" ] ; then
  LOCALCLASSPATH="/usr/share/java/xmlParserAPIs.jar:/usr/share/java/xercesImpl.jar"
else
  LOCALCLASSPATH="/usr/share/java/xmlParserAPIs.jar:/usr/share/java/xercesImpl.jar:$LOCALCLASSPATH"
fi

This action corrects the error Warning: XML resolver not found; external catalogs will be ignored when building schemes. See detailed description of the error in Debian bug-tracker.

Develop

Descriptions of syntaxes (scheme) are divided into static and generated. Static are in a directory hrc/hrc, generated in hrc/src.

After scheme change, it is necessary test changes for regressions. For this purpose it is necessary:

1. to build the library of schemes build base
2. check that bin directory in the root of the project has colorer.exe (the utility for working with library of schemes)
3. in hrc/test directory start script perl runtest.pl --full, or its alternative runtest.py
4. script will check the result of coloring of reference file, the result is output to the console and fails.html file in hrc/test/time_of_test directory.
5. after the analysis of divergences in case of mistakes it is necessary to correct the scheme. If the current coloring is considered correct, it is necessary to replace the reference file with the new one. Reference files reside in hrc/test/_valid. New files reside in hrc/test/time_of_test

Also before modification of a repository it is recommended to edit the hrc/hrc/CHANGELOG file

Links

• Project main page: http://colorer.sourceforge.net/