FAQ

Frequently Asked Questions

Welcome to our FAQs.

Why do I get the build error invalid byte sequence in UTF-8?

In case you get a build error like this:

[ERROR] Failed to execute goal org.asciidoctor:asciidoctor-maven-plugin:1.5.0:process-asciidoc (generate-docbook) on project oasp-docgen: Execution generate-docbook of goal org.asciidoctor:asciidoctor-maven-plugin:1.5.0:process-asciidoc failed: (ArgumentError) invalid byte sequence in UTF-8

Then you have different options:

• support asciidoctor (maven plugin) to properly deal with encodings

• remove the specific characters. As the error reporting is very poor, you can find it like this (in windows using cygwin):

  grep --color='auto' -P -n "[^a-zA-Z0-9 <>,\[,\],\(,\),\",_,*,/,:,.,=,\-,+,\{,\},;,@,\?,$,\!,#,',|,\\\,%,\&,\`,^]" *.asciidoc

• run maven with the option -Dfile.encoding=UTF-8