Appendix D. Using AsciiDoc with non-English Languages

AsciiDoc can process UTF-8 character sets but there are some things you need to be aware of:

If you are generating output documents using a DocBook toolchain then you should set the AsciiDoc lang attribute to the appropriate language (it defaults to en (English)). This will ensure things like table of contents, figure and table captions and admonition captions are output in the specified language. For example:
```
$ a2x -a lang=es doc/article.txt
```
If you are outputting HTML directly from asciidoc(1) you’ll need to set the various *_caption attributes to match your target language (see the list of captions and titles in the [attributes] section of the distribution lang-*.conf files). The easiest way is to create a language .conf file (see the AsciiDoc’s lang-en.conf file).
You still use the NOTE, CAUTION, TIP, WARNING, IMPORTANT captions in the AsciiDoc source, they get translated in the HTML output file.
asciidoc(1) automatically loads configuration files named like lang-<lang>.conf where <lang> is a two letter language code that matches the current AsciiDoc lang attribute. See also Configuration File Names and Locations.


	You still use the NOTE, CAUTION, TIP, WARNING, IMPORTANT captions in the AsciiDoc source, they get translated in the HTML output file.