There is already a good code parser I use for syntax highlight of NON doxygen supported languages, it is called source-highlight

it would be fine if doxygen would support external code parser as filter-proc… example:

\code{filter:my/path/to/filter.bash}

 … my non standard code…

\endcode

The filter should take the code on stdin and output html on stdout

I arrange to use source-highlight like snippet with output in html, and an aliases for import into doxygen documentation

ALIASES += "htmlcode{4}=\b Example from <tt> \1\fileextension </tt> \b → \4  ^^ <div class=\"htmlcode\"> \htmlinclude \1_\3.\2.html </div>"

In my makefile I use

$(top_srcdir)/sbin/source-highlight.bash --dir $(abs_builddir)/docs --regex ErrorNoRaise_example $(abs_srcdir)/*/server.*

The wrapper is quite simple

## usage …
##
## > used in directory "example" to create a "html-output-file" in "docs" directory 
## > from the code between "server_example"
##
## source-highlight.bash --dir docs --regex server_example vb/MyServer.vb

error() {
  echo "ERROR: $@" 1>&2
  [[ -r "$TARGET_FILE" ]] && rm "$TARGET_FILE"
  exit 1
}

usage() {
  error "source-highlight.bash --dir TARGET-DIR --regex REGEX-RANGE SOURCE-FILE..."
}

TARGET_DIR="."
REGEX_RANGE=""
TARGET_FILE=""

while (( $# > 0 )) ; do
  case "$1" in
    --stdout) TARGET_FILE="stdout"
              shift 1
    ;;
    --dir)    TARGET_DIR="$2"
              shift 2
    ;;
    --regex)  REGEX_RANGE="$2"
              shift 2
    ;;
    -*)       usage ;;
    *)        break ;;
  esac
done

test ! -d "$TARGET_DIR" && mkdir -p "$TARGET_DIR"

if [[ "$REGEX_RANGE" != "" ]] ; then
  REGEX_RANGE_CMD="--regex-range \\[$REGEX_RANGE\\]"
else
  REGEX_RANGE_CMD=""
fi

for SOURCE_FILE ; do

  EXTENSION="${SOURCE_FILE##*.}"
  if [[ "$TARGET_FILE" != "stdout" ]] ; then
    TARGET_FILE="${SOURCE_FILE##*/}"
    TARGET_FILE="$TARGET_DIR/${TARGET_FILE%.*}${REGEX_RANGE:+_}${REGEX_RANGE}.$EXTENSION.html"
    TARGET_CMD="--output $TARGET_FILE"
  else
    TARGET_CMD=""
  fi

  test -r "$SOURCE_FILE" || error "SOURCE_FILE='$SOURCE_FILE' not readable"

  [[ "$TARGET_FILE" != "stdout" && -r "$TARGET_FILE" && "$TARGET_FILE" -nt "$SOURCE_FILE" ]] && continue

  echo "work on… $SOURCE_FILE"

  if [[ ! -z "$REGEX_RANGE" ]] ; then
    (( $(grep --fixed-strings --count "[$REGEX_RANGE]" $SOURCE_FILE) != 2 )) && \
      error "range '$REGEX_RANGE' was not found '2' times in '$SOURCE_FILE'"
  fi

  source-highlight $REGEX_RANGE_CMD --data-dir="$NHI1_HOME/etc/lang" --out-format=html-css --input "$SOURCE_FILE" $TARGET_CMD ||
    error "TARGET_FILE='$TARGET_FILE' not createable"

done

exit 0

Support YAML syntax highlighting #7551

Description

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions