# File naming rules for CotEditor scripts

This page explains the rules for naming script files.

Order of appearance
  By adding “number + closing parenthesis ())” at the head of the name, you can line up the files in numerical order.
  The part “number + )” won't be shown in the menu.

  example 1.
  File name | 01)Open File.scpt
  Appearance in the menu | Open File

Keyboard shortcuts
  By adding “dot (.) + modifier-key + shortcut-key” in front of the extension, you can assign a keyboard shortcut to the file.

  example 2.
  File name | Insert String.@e.scpt
  Appearance in the menu | Insert String (Command-E)
  example 3.
  File name | 03)Insert Date.@~Y.scpt
  Appearance in the menu | Insert Date (Option-Shift-Command-Y)

  Modifier-key notations

    Notation | Equivalent key
    --- | ---
    ^ | Control
    $ | Shift
    ~ | Option
    @ | Command

- Shortcut-keys (e.g. “e” in the example 2) are case sensitive. The one in uppercase indicates that “the Shift key should be pressed together” as in the example 3.
- A shortcut-key must come after modifier-keys, and must be one letter. Thus, you can't assign the keys such as F1 or Delete to scripts.
- When the keyboard shortcut you set is already taken by another function, the shortcut for the script will be ignored.

Separators
  A folder named “-” appears as a separator line in the menu. By adding “number + closing parenthesis ())” at the head of the folder name, you can put a separator between the menu items.

## See also

- Customizing the Script menu
- Working with UNIX scripts
- Working with AppleScript scripts