ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Delphin Assistant

by adoxography ST3

Sublime enhancements for grammar engineering with DELPH-IN tools

Details

Installs

  • Total 152
  • Win 115
  • OS X 25
  • Linux 12
Aug 25 Aug 24 Aug 23 Aug 22 Aug 21 Aug 20 Aug 19 Aug 18 Aug 17 Aug 16 Aug 15 Aug 14 Aug 13 Aug 12 Aug 11 Aug 10 Aug 9 Aug 8 Aug 7 Aug 6 Aug 5 Aug 4 Aug 3 Aug 2 Aug 1 Jul 31 Jul 30 Jul 29 Jul 28 Jul 27 Jul 26 Jul 25 Jul 24 Jul 23 Jul 22 Jul 21 Jul 20 Jul 19 Jul 18 Jul 17 Jul 16 Jul 15 Jul 14 Jul 13 Jul 12 Jul 11
Windows 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 1 3 1 0 1 3 0 0 0 0 0 2 0 0 0 0 0 0 0 0 0 0 1 0 0 0 1
OS X 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0
Linux 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

Delphin Assistant

This package lets Sublime Text 3 handle certain file types maintained by the DELPH-IN Consortium elegantly.

Features

  • Syntax highlighting for TDL, [incr tsdb()] testsuites, and VPM files
  • Commenting shortcut with CTRL+/
  • [incr tsdb()] test snippet

[incr tsdb()] syntax:

TDL syntax:

Installation

The recommended installation method is to use Sublime's Package Control.

The package can also be installed directly; assuming you have git installed, the commands for the various operating systems are:

  • Windows: git clone https://github.com/adoxography/delphin-assistant "%APPDATA%/Sublime Text 3/Packages/"
  • OS X: git clone https://github.com/adoxography/delphin-assistant "~/Library/Application Support/Sublime Text 3/Packages/"
  • Linux: git clone https://github.com/adoxography/delphin-assistant ~/.config/sublime-text-3/Packages/

After installation, all relevant features are available in files with the extensions .tdl, .vpm, and .tsdb for TDL files, VPM files, and [incr tsdb()] testsuites, respectively.

Usage

[incr tsdb()] syntax

All [incr tsdb()] tests are expected to begin with the following four lines, in order: * Source * Vetted * Judgment * Phenomena

To ensure that these lines are created in the correct order, the package comes with a test snippet which will generate the shell of a test for you: just type “test” and press TAB while in a .tsdb file.

Subsequent lines are open to user customization. The Delphin Assistant reads from the first line it finds in the testsuite that begins with Lines: to determine the number of lines that should follow the four lines mentioned earlier. By default, it will highlight any line labelled orth-seg or gloss by token, such that odd-numbered tokens are a different colour than even-numbered tokens. To adjust which lines should be token-separated, browse to Preferences -> Package Settings -> Delphin Assistant -> Settings and in your user settings, create a key/value pair for "tsdb_tokenized_lines". Note that the value must be an array.

By default, tokens will be separated by whitespace and the following characters: !#$%&()*+,-./:;<=>?@[]^_\`{|}~\. These characters can be changed by adjusting the "tsdb_split" value in your Delphin Assistant user preferences. Note that splitting on the single quote (') is not supported at this time.

Compiling a [incr tsdb()] testsuite

[incr tsdb()] testsuites can be compiled and added to an existing grammar from within Sublime, using the make_item script written by Emily Bender and contributors. To compile a testsuite, press CTRL+SHIFT+P to open the command palette, and type 'Compile [incr tsdb()] testsuite'. You will be prompted for a folder name; the compiled item file will be saved in this folder (relative to the [incr tsdb()] testsuite file). If you want any specific mappings done during compilation, override the tsdb_make_map setting of the Delphin Assistant package settings and add one JSON object per mapping to the array, with values specified for from and to. (An example mapping is provided in the default package settings.)

You can also specify a skeleton folder within an existing grammar. If such a folder is specified, the item file will be saved relative to the skeleton folder, and all of the housekeeping (moving the Relations file, editing Index.lisp) will be taken care of for you. To specify a skeleton folder, override the tsdb_skeleton_dir setting of the Delphin Assistant package settings.

Removing a compiled [incr tsdb()] testsuite

Compiled [incr tsdb()] testsuites can also be removed using the command palette using the 'Delete [incr tsdb()] testsuite' command. You will be prompted with a list of compiled testsuites; selecting one will cause its folder and entry in Index.lisp to be removed. This functionality is only available if testsuites are being compiled into a skeleton directory.

This plugin is developed and maintained independently of the DELPH-IN Consortium.