IDE controls & keyboard shortcuts

Launch the IDE

Use a compatible browser (currently Chrome, Chromium and Edge) and one of these links, depending on which language you want the IDE to open in:

Customising the IDE

To customise start-up, you add further options after ? in the URL, separated by & and including no spaces, for example:

  • To specify a profile that reflects limits to the use of the IDE
    https://elan-lang.org?profile=1.0 Code does not parse as Elan.https://elan-lang.org?profile=1.0 Code does not parse as Elan.https://elan-lang.org?profile=1.0 Code does not parse as Elan.https://elan-lang.org?profile=1.0 Code does not parse as Elan.https://elan-lang.org?profile=1.0 Code does not parse as Elan.
  • To specify both a language and a CVD option:
    https://elan-lang.org?lang=python&cvd=1 Code does not parse as Elan.https://elan-lang.org?lang=python&cvd=1 Code does not parse as Elan.https://elan-lang.org?lang=python&cvd=1 Code does not parse as Elan.https://elan-lang.org?lang=python&cvd=1 Code does not parse as Elan.https://elan-lang.org?lang=python&cvd=1 Code does not parse as Elan.

Profiles

TODO

<

Watch the video: Navigate around the IDE

Always use the browser in 'full screen mode' – it makes more space available and is safer.

To change the text size, hold down the Ctrl key and use the mouse scroll wheel, or change the magnification via the browser's zoom menu.

If an area has a blue tinted background, it does not have browser 'focus' and will not respond to keyboard input. Use keyboard shortcuts or mouse or touch gestures to change the focus (which is indicated by a white background):

To focus on...Keyboard shortcutMouse gestureNotes
code editorCtrl+eClick on background within editorSee also Browse code
displayCtrl+dClick on the 'display' tabTo clear the display pane, use the clear button shown within it
infoCtrl+iClick on the 'info' tabTo clear the Info pane, use the clear button shown within it
helpCtrl+hClick on the 'help' tabto open a list of links to documents
worksheetCtrl+kClick on the 'worksheet' tab(Ctrl+w is interpreted by the browser as 'leave web site')
a buttonCtrl+bClick on the buttonCtrl+b puts focus on the first active button
Use Tab or Shift+Tab to navigate to another active button

Load, run, and save programs

Watch the video: Load, run, and save programs

Loading and saving

To access the demo or file menus via the keyboard:

  • If the menus are disabled, you need to stop the program currently running
  • press Ctrl+b then Tab to the menu (if needed)
  • press Enter to open the menu
  • press or to select the required menu item
  • press Enter to action the selected item
IntentionMenu actionNotes
load a demo programdemo then select desired program
load a program filefile > loadif the editor contains unsaved code, you will be warned
append a file to the current code in the editorfile > appendexternal code is always appended to the end of the current code, but may then be moved
auto save a program filefile > auto saveany subsequent edits will be saved to the file (whenever the code parses)
cancel auto-savingfile > cancel auto savethis action appears only after setting up auto save
save a program manuallyfile > manual savesaves the code to file but does not automatically save subsequent changes
create a standalone Html page incorporating your programfile > save as standalonethe saved .html file contains the compiled program, and will run automatically when opened

Running and stopping programs

To...Keyboard shortcutMouse gestureNotes
run a programCtrl+rClick on 'run' buttondisabled if there are any parse or compile issues.
stop a program that is runningCtrl+sClick on 'stop' buttonEnabled only when the program is running

If your program is doing intensive processing between interactions with you through the IDE, then clicking on the 'stop' button may not have an immediate effect. This is an unavoidable side effect within the browser, but you will be returned to editing after a short period. Avoid repeatedly clicking 'stop' as that might cause the browser tab to be closed.

See also Debugging programs

Debugging programs

Watch the video: Debugging programs

You can debug a running program with or without having set breakpoints.

Run in debug mode, pause, and step

To...Keyboard
shortcut
Mouse
gesture
Notes
debug a program, or resume debugging a paused programCtrl+gClick on 'debug' buttondisabled if there are any parse or compile issues.
pause a program that is runningCtrl+uClick on 'pause' buttonenabled only when program is being debugged
step to the next instruction in a paused programCtrl+pClick on 'step' buttonenabled only then program is paused

Browsing named values

Whenever the program is paused, all named values (variables, parameters and constant values) that are currently in scope have their values automatically listed in the Info pane. This list may be browsed as follows:

To...Keyboard
shortcut
Mouse
gesture
navigate to a specific line in the list when pausedTab, Shift+TabClick on the line
expand/collapse a specific name within the listEnterClick on the + or - at the start of the line

Using breakpoints

Before clicking on debug you can set breakpoints at one or more instructions where you want execution to pause. A red flash symbol appears at every instruction that has a breakpoint defined..

When run using debug the program will automatically pause at every breakpoint, and the in-scope named values will be listed in the Info pane.

To...Keyboard
shortcut
Mouse
gesture
set a breakpoint on a selected instructionCtrl+m on a selected instruction keyword then select set breakpointright-click for context menu, then select set breakpoint
clear existing breakpointsCtrl+m on a selected instruction keyword, then select clear breakpoint or clear all breakpointsright-click for context menu, then select clear breakpoint or clear all breakpoints

Apple macOS specific

Where a keyboard shortcut is shown with the Ctrl control key, users of Apple's macOS should use the ⌘ Command key instead.

Colour scheme for CVD

There are two ways in which to change the colour scheme for users with CVD:

  • Button file has menu option preferences which offers an alternative colour scheme via a small dialogue. Whether or not you tick the CVD option, clicking confirm automatically tries to reload the web page, so you will receive a warning (which you can cancel) if you have unsaved code. You can also just press Escape to remove the dialogue.
  • The URL provided to a pupil may include a CVD scheme, as described above in Launch the IDE.