diff options
| -rw-r--r-- | README.adoc | 2 | ||||
| -rw-r--r-- | docs/modules/install/pages/supported-platforms.adoc | 16 |
2 files changed, 17 insertions, 1 deletions
diff --git a/README.adoc b/README.adoc index 777a420a..53b85341 100644 --- a/README.adoc +++ b/README.adoc @@ -145,7 +145,7 @@ You can do so by setting the `RUBYOPT` environment variable as follows: Once you make this change, all your Unicode headaches should be behind you. If you're using an IDE like Eclipse, make sure you set the encoding to UTF-8 there as well. -Asciidoctor works best when you use UTF-8 as the default encoding. +Asciidoctor is optimized to work with UTF-8 as the default encoding. ==== == Installation diff --git a/docs/modules/install/pages/supported-platforms.adoc b/docs/modules/install/pages/supported-platforms.adoc index 140bf469..e66d199c 100644 --- a/docs/modules/install/pages/supported-platforms.adoc +++ b/docs/modules/install/pages/supported-platforms.adoc @@ -48,3 +48,19 @@ Windows Server 2019 |=== While the community tests Asciidoctor on a variety of Linux distributions, it's only officially tested on Ubuntu and Fedora. + +== System encoding + +Asciidoctor assumes you're using UTF-8 encoding. +To minimize encoding problems, make sure the default encoding of your system is set to UTF-8. + +If you're using a non-English Windows environment, you may bump into an `Encoding::UndefinedConversionError` when invoking Asciidoctor. +To solve this issue, we recommend overriding the default external and internal character encodings to `utf-8`. +You can do so by setting the `RUBYOPT` environment variable as follows: + + RUBYOPT="-E utf-8:utf-8" + +Once you make this change, all your Unicode headaches should be behind you. + +If you're using an IDE like Eclipse, make sure you set the encoding to UTF-8 there as well. +Asciidoctor is optimized to work with UTF-8 as the default encoding. |