confignatlinkvocolaunimacroEnvironment variables
For all definitions you can now also use the Windows system environment variables. Enclose with % and all capitalise them. Its sensible use is to put them at the front of a file, folder or virtual drive definition. Slashes can be omitted.
Examples:
Variable | Meaning |
|---|
%HOME%
~ | pointing to your home folder, most often your path to My documents, see below
Tilde is a common shorthand notation for your home folder. |
%PROGRAMFILES% | pointing to the program files folder |
%APPDATA% | pointing to your app data folder |
%DESKTOP% | pointing to your desktop folder |
Natlink related Environment Variables
Starting with version 4.1whiskey also Natlink related environment variables are added. The interface is a bit tricky, but the _folders grammars uses them.
Variable | Example value |
|---|
%BASEDIRECTORY% | C:\NatLink\NatLink\MacroSystem |
%COREDIRECTORY% | C:\NatLink\NatLink\MacroSystem\core |
%DNSINIDIR% | C:\ProgramData\Nuance\NaturallySpeaking15 |
%DNSINSTALLDIR% | C:\Program Files (x86)\Nuance\NaturallySpeaking15 |
%DNSUSERDIRECTORY% | C:\ProgramData\Nuance\NaturallySpeaking15\Users\QNederlands\current |
%NATLINKDIRECTORY% | C:\NatLink\NatLink |
%UNIMACRODIRECTORY% | C:\NatLink\Unimacro |
%UNIMACROUSERDIRECTORY% | C:\Documenten\unimacro_qh |
%USERDIRECTORY% | C:\UserDirectory\dragonfly-macros |
%VOCOLAUSERDIRECTORY% | C:\Documenten\vocola_qh |
HOME and ~
The environment variable %HOME% is by default NOT set in Windows. In order to make the story above work, Unimacro takes for %HOME%: the My documents folder on your system.
Of course you can also set %HOME% yourself (in System properties, Advanced, Environment variables).
When you are using Emacs (VoiceCode) you probably have set the %HOME% variable this way in order to get proper access to your .emacs file.
For ~ also this folder is taken.
Show all these variables
You can show all the Environment variables and the Natlink specific variable via a Unimacro Shorthand Command. In Vocola you can enter in your (global) command file:
print all variables = Unimacro("PRINTALLENVVARIABLES");
print natlink variables = Unimacro("PRINTNATLINKENVVARIABLES");
Examples
Virtual drives |
|---|
md | %HOME% |
pf | %PROGRAMFILES% |
Folders |
|---|
md:/private or
~private or
~/private or
%HOME%/private | all pointing to the folder "private" in your documents |
%NATLINKDIRECTORY%/confignatlinkvocolaunimacro | the directory where the config program of Natlink is located. |
Files |
|---|
~/public/examples.doc | A file in the folder public of your home folder. |
|