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
- Added new syntax for Groovy and gsp (and Jenkinsfile)
- Fixed build issue under Windows where perl output redirected to a file is trimmed
- hrc/test/runtest.py: Updated to work with Python3
- hrc/test/runtest.pl: Force text diffs
- TODO: sort out test failures, shows 5 under Windows, 13 under MacOS X
- 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
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.gitor update git repository:
git pullRun build
build.cmd targetwhere 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'
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\jdkHere is an example on Debian Wheezy.
Install ant and jdk
apt-get install ant openjdk-6-jdkIf 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"
fiThis 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.
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:
- to build the library of schemes
build base - check that bin directory in the root of the project has colorer.exe (the utility for working with library of schemes); you can get it here: https://sourceforge.net/projects/colorer/files/console/
- in hrc/test directory start script
perl runtest.pl --full, or its alternativeruntest.py - script will check the result of coloring of reference files, the result is output to the console and fails.html file in hrc/test/time_of_test directory.
- 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
- Project main page: http://colorer.sourceforge.net/