[ 
https://issues.apache.org/jira/browse/UNOMI-592?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17553015#comment-17553015
 ] 

Woonsan Ko commented on UNOMI-592:
----------------------------------

According to my searches below, it seems to be reasonable to recommend using 
{{set MAVEN_OPTS=”-Dfile.encoding=UTF-8”}} in the manual:
# https://github.com/asciidoctor/asciidoctor-maven-plugin/issues/412
# https://boneman.tistory.com/entry/AsciiDoc-Plugin-%EC%98%A4%EB%A5%98

By the way, the Asciidoctor community suggests using {{chcp 65001}} on 
non-English Windows users below, but it doesn't work with the Maven env from my 
experiements:
- https://asciidoctor.org/#requirements

> Recommend setting unicode encoding to avoid asciidoctor-plugin build error on 
> non-English Windows machine
> ---------------------------------------------------------------------------------------------------------
>
>                 Key: UNOMI-592
>                 URL: https://issues.apache.org/jira/browse/UNOMI-592
>             Project: Apache Unomi
>          Issue Type: Improvement
>         Environment: Non-English Windows OS
>            Reporter: Woonsan Ko
>            Priority: Minor
>
> Building on a non-English Windows machine, it is very likely to see a build 
> error due to an encoding issue like the following example:
> {quote}
> [ERROR] Failed to execute goal 
> org.asciidoctor:asciidoctor-maven-plugin:1.6.0:process-asciidoc (output-html) 
> on project unomi-manual: Execution output-html of goal 
> org.asciidoctor:asciidoctor-maven-plugin:1.6.0:process-asciidoc failed: 
> unknown encoding name - MS949 -> [Help 1]
> {quote}
> It would be nice to recommend setting UTF-8 encoding for non-English Windows 
> devs.



--
This message was sent by Atlassian Jira
(v8.20.7#820007)

Reply via email to