Keyboard functions and shortcuts¶

Save (Ctrl + S)¶

Like many typical programs, you can save your progress by pressing Ctrl + S (Cmd + S on OS X).

If there are no errors, you will see a Style saved note at the top of the window.

Style saved

If there is an error, the line that contains the error will be highlighted, and any other details known about the error will be listed.

Auto-complete (Ctrl + Enter)¶

The style editor offers an easy way to explore and determine the correct syntax for functions by way of an auto-complete function.

Auto-complete is activated by pressing Ctrl + Enter (Cmd + Enter on OS X). A drop-down list will display showing a list of possible options. The location of the cursor and the context will determine what goes in this list.

Auto-complete

This can also be useful during debugging, as you can verify if an option is in the right place by verifying that it appears in the appropriate list.

Not only does the auto-complete respect cursor location, but it also respects whether the expected option will be a list, a mapping, or a value.

When auto-complete is triggered on a list item (noted by the dash prefix), only list options will be shown:

Auto-complete on a list

Removing the dash and triggering auto-complete will show only mapping entries:

Auto-complete on a mapping

When auto-complete is triggered on a value with a finite number of possible values, the list of values will be shown:

Auto-complete on a named color

When auto-complete is triggered on a value with an infinite number of possible values, a hint will be shown:

Auto-complete on a number

Code folding (Ctrl + , / Ctrl + .)¶

It can sometimes be useful to hide and display certain portions of the code. This is known as “code folding”.

Code folding is activated by pressing Ctrl + , (Cmd + , on OS X). The code to be folded is dependent on where the cursor is.

When the cursor is on a line that contains a list entry (with the dash) the entire contents of that list entry will be folded.

List entry before folding

List entry folded

When the cursor is on a line that is inside a mapping (no dash), then the contents of the parent will be folded. In this case, the cursor will move to the parent line from the (now-hidden) original line.

Code that is folded is indicated by a at the end of a line, with a small arrow shown in the margin area to the left of the line. Placing the cursor on this line and pressing Ctrl + . (Cmd + . on OS X) will unfold the code. You can also click the icon to unfold the code. Attempting to navigate into the folded region using the arrow keys will also unfold the code.

As another indicator of code folding, the line numbers in the margin will become discontinuous.

Comment/uncomment selection (Ctrl + 3)¶

It may be useful to comment out a block of text so that it does not affect the style. This can be done by selecting the text to be commented and pressing Ctrl + 3. All lines selected (or partially selected) will then have a # added to the beginning of the line, indicating that the line is now commented out.

This can be reversed by selecting the commented text and pressing Ctrl + 3 again.

Select line (Shift + Up and Shift + Down)¶

As in many other programs, holding Shift and moving the cursor with the arrow keys will select all characters between the original cursor position and the new cursor position. By this method, Shift + Up will select the previous line and Shift + Down will select the next line. Shift + Left will select the previous character and Shift + Right will select the next character.

Increase/reduce indent (Tab and Shift + Tab)¶

Since proper indenting is so crucial to YSLD syntax, it can be useful to change the indentation of a block of text together. Selecting a block of text and then pressing Tab will increase the indentation of all selected lines by two spaces. Pressing Shift + Tab will decrease the indentation of all selected lines by two spaces.