This is a groff preprocessor written in perl that will highlight your code for you. All of the syntax highlighting is done by GNU Source-highlight This way the highlighting can be modified and customized as needed. Currently the only macros supported are mm and ms macros.

This project is currently in alpha stages and still needs work before it is functional.

You will need the following programs installed:

• Perl (only tested on 5.3)
• GNU Source-highlight
• Groff

Edit the Makefile and set the PREFIX for ghighlight to be installed. Then

sudo make install

Inside your groff file add .SOURCE start and .SOURCE stop to start and stop a source code section. source-highlight will automatically detect the syntax based on the source code inside the block. The stop in .SOURCE stop is optional and can be replaced with .SOURCE

By default ghighlight uses black and white mode to enable color simple set the environmental GHLENABLECOLOR=1 warning color support is still buggy.

For global use add this to your bashrc or zshrc

export GHLENABLECOLOR=1

For one time use

GHLENABLECOLOR=1 && ghighlight INPUTFILE.ms | groff ... > OUTPUTFILE

FILE.ms

.NH
This Is A Heading
.LP
this is a paragraph

.\" start source code block
.SOURCE start
#! /usr/bin/env perl

my $version = 'This is a source code block';
print $line; 
.SOURCE stop
.\" end source code block

ghighlight FILE.ms | groff -T pdf -ms > output.pdf

To specify a syntax use .SOURCE <language>

.SOURCE c
#include <stdio.h>
#include <stdlib.h>

int main(int argc, char *argv[])
{
    int i = 0;
    printf("hello\n");
    return 0;
}
.SOURCE stop

An alternatives to .SOURCE is .\`` used like so

.`` c
#include <stdio.h>
#include <stdlib.h>

int main(int argc, char *argv[])
{
    int i = 0;
    printf("hello\n");
    return 0;
}
.``

if you are using ".so"-makros in your files, you must combine the files beforehand using soelim, e.g.:

soelim MAIN.ms | ghighlight | groff -Tpdf > MAIN.pdf

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

• Toggling (color instead of bold ) (using ENV ENABLECOLORS)
• Arguments to specify language in case source-highlight doesn't recognize it
• Correct error messages
• Support for mom macros

• Makefile now removes the .pl from ghighlight.pl

• Gavin Jaeger-Freeborn - Initial work - Gavinok

See also the list of contributors who participated in this project.

This project is licensed under the GNU General Public License - see the LICENSE file for details

• gperl written by Bernd Warken was used as the basis for this project
  • Contains a similar .`` macro for source code that inspired the preprocessor macro

• ugrid A troff pre-processor to highlight blocks of code. Fork of Vgrind and Vfontdrp.
• Mono Troff macros for the 21st century.
  • Contains a similar .`` macro for source code that inspired the preprocessor macro
• mom macros has support for in line code blocks.