vscode_setup

topas-editor in VS Code

The topas-editor VS Code extension is the new recommended way to interact with TOPAS academic. It replaces jEdit.

topas-editor has a full set of TOPAS menus, short cut keys to interact with TOPAS, numerous power-editing commands, the ability to interact with other analysis packages, and full TOPAS syntax colouring. It works with TOPAS Academic, the Bruker version of TOPAS and tc.exe. The only jEdit feature not readily available is the ability to cursor-select beyond the end of a line.

Installation

topas-editor has been used on >1500 different PC’s, but you should still treat it as a test version. Email John when you find problems.

1. You can install topas-editor by going to the VS Code extensions market place (normally the four squares on the left panel of your VS Code window and typing “topas editor” in the search box that appears then install.

2. A dialog box should appear asking you to set a colour theme. I suggest “Topas light”. You should next be prompted to set up the the TOPAS menus. Confirm you are happy to install the TOPAS menus, then navigate and select the TOPAS directory. If this process doesn’t happen automatically type ctrl-tu.

3. You may find that VS Code puts a second theme selector box on the screen. If it does, just select the same theme as in step 2. If this messes up type ctrl-tl and reselect the theme.

4. You should be able to see TOPAS menus by clicking on the “triangle in circle icon” on the left.

5. Your VS Code screen should look something like the image below (tbc). The left and right hand views are “TOPAS Dark” and “TOPAS Light” themes.

6. Consider turning on the “auto update” feature so you get bug fixes and menu updates.

7. If you have your own custom menus they will get overwritten when topas-editor updates. Store them in a separate .json file and use the “Add my menus” command to reinstall them.

8. The topas-editor installation tries to not mess up any other VS code settings, if it does, look in the settings_old.json file.

Using topas-editor

Information on using the topas-editor extension is in its readme file. You can view this by clicking on the “Te” icon in the extensions panel of VS Code.

A step-by-step tutorial on Rietveld and Pawley refinements is here.