Complete from File

Define files with words or sentenses that will be shown as completion items. Group these files by languageID. A particular file can be used for multiple languageIDs.

Some languages show the suggestions automatic and for some you have to request suggestions with the command:
Trigger Suggest (key: ctrl+space, commandID: editor.action.triggerSuggest)

The files can contain empty lines and comments: lines starting with // or #.

Configuration

The extension has the following settings:

• complete-from-file.documents : [object] Every key is a description text of the languageIDs and files used. The properties of these objects are:
  • documentSelectors : An array of DocumentFilter objects. It determines in which files a suggestion is provided.
    Example: [{ "language": "plaintext", "scheme": "file" }]
    In the documentation you can find a list of language identifiers. There are more language identifiers if you have additional language extensions installed.
  • files : An array of strings. Each string is a file path containing lines that are shown as completion items. The strings can contain variables. If the string after variable substitution is identical to the file system path of the file as used by VSC the changes of these word files are detected and used. You can change and add these files without restarting VSC.
• complete-from-file.minimalCharacterCount : [int] (Optional) How many characters to type before a completion suggestion is made. (default: 3)

Example

An example configuration is

  "complete-from-file.documents": {
    "markdown completions": {
      "documentSelectors": [{ "language": "markdown", "scheme": "file" }],
      "files": [
        "${workspaceFolder}${pathSeparator}markdown-complete.txt",
        "${userHome}${pathSeparator}completions${pathSeparator}markdown-complete.txt"
      ]
    },
    "text files": {
      "documentSelectors": [{ "language": "plaintext", "scheme": "file" }],
      "files": [
        "${workspaceFolder}${pathSeparator}plaintext-complete.txt"
      ]
    }
  }

Variables

The extenstion supports the following variables:

• ${env:name} : get the value for environment variable name
• ${pathSeparator} : the character used by the operating system to separate components in file paths
• ${userHome} : the path of the user's home folder
• ${workspaceFolder} : the path of the workspace folder opened in VS Code containing the current file.
• ${workspaceFolder:name} : the path of the workspace folder with the specified name opened in VS Code