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:
-
Download the toolchain zip at https://www.wovalab.com/wp-content/uploads/AsciidocToolkit/RubyInstance.zip
-
Extract the archive in the folder
<User Application Data>\AppData\Local\Asciidoc For LabVIEW -
Test installation with the Check Asciidoctor Toolchain Installation
HTML or PDF rendering without an internet connection
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 (error 5000)
Proxy settings can prevent you from getting 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 (error 5000)
Depending on your network security policy, you may experience error 5000 due to an SSL error.
Since version 1.9, you can disable SSL verification the Init function. This should prevent you from getting the error.
| If the option is not solving the issue, you can glance at the conversation here to see alternative ways to manage this issue. |
chcp error when rendering an adoc file
| This section only applies to Windows. |
On Windows, the chcp command is used to handle special characters in adoc file path you want to render.
You may have an error labeled 'chcp' is not recognized as an internal or external command if the PATH variables are not correctly set.
To prevent that error check that: %SystemRoot%, %SystemRoot%\system32, and %SystemRoot%\System32\Wbem are set in System variables.
