VSCode Therion Language
Tools for the Therion cave surveying programme in VS Code.
Features
- Name completion
- Syntax Highlighting
- Formatting
- Useful commands and context menu items
Commands
Therion: Create scrap plan template
Create a new scrap from the current .th file complete with stations and centreline, ready for drawingTherion: Compile
Compile the current .thconfig fileTherion: Watch
Compile the current .thconfig file and recompile if there are changes to it or any nested input or source
Open in Default Application
Optional extra menu item that attempts to open a file using xdg-open on linux and open on mac.Open in Inkscape
Available when opening the context menu on a .th2 in the file explore. Opens the file in Inkscape.
Code Completion
Map and Scrap names
When typing in a Therion file you will get autocomplete suggestions for map and scrap names that are accessible in that file (i.e. can be found by following the chain of input commands).
Survey names
If you type an @ character you will get autocomplete suggestions for survey names that are accessible in that file (i.e. can be found by following the chain of input commands).
Scoping
The names of maps/scraps/surveys will be properly scoped so you will get the full survey path relative to where you are typing. Example:
my_passage.th
survey my_passage
input "scraps.th"
map my_passage_map
m[
suggestion: my_scrap
]
endmap
ensurvey
my_cave.th
survey my_cave
input "my_passage"
map my_cave_map
m[
suggestion: my_passage_map@my_passage
]
endmap
endsurvey
my_system.th
survey my_system
input "my_cave"
map my_system_map
m[
suggestion: my_cave_map@my_cave
suggestion: my_passage_map@my_passage_map.my_cave
]
endmap
equate 1@[
suggestion: 1@my_passage.my_cave
]
endsurvey
Configuration
There are a number of configuration options. The important ones are:
Therion: Therion Path
This should be the path to the therion exectuable/binary.
On Windows you should edit this. The path will probably be something like "C:\Program Files (x86)\Therion\therion.exe". The quotes are important.
On Linux you can likely leave this as therion as it normally is available on your path. If not it's often at /usr/bin/therion.
Other
WSL
When running in this extension remotely in WSL it is assumed that therion will be installed in WSL and any GUI programs (Inkscape / PDF readers) will be installed in Windows. It is possible to override this behaviour for inkscape using the Use WSL inkscape option.
Attribution
