Known issues

Asciidoc toolchain offline installation

This section only applies to Windows.

If your network access is strictly controlled or if you have no access to the internet at all, the installation can fail. If you want to install the toolchain manually, you can do the following steps:

  1. Download the toolchain zip at https://www.wovalab.com/wp-content/uploads/AsciidocToolkit/RubyInstance.zip

  2. Extract the archive in the folder <User Application Data>\AppData\Local\Asciidoc For LabVIEW

  3. Test installation with the Check Asciidoctor Toolchain Installation

HTML or PDF rendering without an internet connection

This section only applies to Windows.

If the toolchain is correctly installed, you can generate simple documents without the need for an internet connection.

If your document contains diagrams, you will need an internet connection. If no connection is available, you can install the complete toolchain manually.

More information on the "how-to" process can be found in this discussion

Diagram rendering and proxy error

This section only applies to Windows.

Proxy settings can prevent you to get diagrams rendered when generating HTML or PDF files from your adoc file. To fix that you need to set the username/password in the http_proxy environment variable.

More information on the "how-to" process can be found in this issue

Diagram rendering and SSL error

This section only applies to Windows.

Depending of your network security policy, you may experience error 5000 due to SSL error.

Please follow the conversation here to see possible ways to manage this issue.