Abella for Sublime Text 3
====
Support for the [Abella](https://abella-prover.org/) theorem prover in Sublime Text 3.

The develop of this plugin is mainly based on a [Coq plugin](https://github.com/whitequark/Sublime-Coq) for ST.

Installation
===
The recommended way to install Sublime Abella is to use Package Control.

It is also possible to install it using git. Navigate to the Sublime Text Packages folder, then run:

git clone git@github.com:JimmyZJX/SublimeAbella.git Abella

Usage
===
You need to open an Abella script file (*.thm) in ST3, and the following default key bindings should work:
|                  |                                                                    |
| ---------------- | ------------------------------------------------------------------ |
| Ctrl+Enter       | Start Abella (if necessary) and navigate to cursor                 |
| Ctrl+Down        | Navigate to the next statement                                     |
| Ctrl+Up          | Undo last statement                                                |
| Ctrl+Right       | Navigate to cursor (basically equivalent to Ctrl+Enter)            |
| Ctrl+Left        | Reload Abella, and go to cursor                                    |
| Ctrl+Shift+Down  | Navigate to the end                                                |
| Ctrl+Shift+Enter | Kill Abella and reset the state                                    |
| Ctrl+';'         | Lookup and show Theorem                                            |
| Alt+S            | Execute a "search" command, and update the proof script if succeed |
| Ctrl+B           | Compile the current file (this is the standard ST "build" command) |

And there are also shortcuts that help writing proofs:
|           |                                                  |
| --------- | ------------------------------------------------ |
| Ctrl+7    | (7 stands for "&", and) insert text " /\\ "      |
| Ctrl+'\\' | ('\\' stands for " \| ", or) insert text " \\/ " |
| Ctrl+'.'  | ('.' stands for ">", arrow) insert text " -> "   |

Notice that on OSX, the `ctrl` key is replaced by `cmd` (`super`).

### Auto-Next
When Abella plugin is started, inserting a '.' that ends just the next tactic automatically triggers a navigation to that tactic (same effect as `Ctrl+Enter/Down`).


Executable
===
The `abella` executable should be in PATH by default.

If you want to change the location, edit your user setting `abella.exec` and point to the currect **file**. The default value is `abella`, and you may change it to `/path/to/abella`.
The preference file can be found at [Preferences - Package Settings - Abella].

Highlighting
====

In order to get nice background highlighting for the proven parts of the file, add the following snippet to your color scheme file.

(If you are not sure what I'm talking about, install the plugin `PackageResourceViewer`, execute the command `PackageResourceViewer: Extract Package` and select `Color Scheme - Default`, then click `Preferences-Browse Packages`, find and edit `Color Scheme - Default/Monokai.sublime-color-scheme`)

For `tmTheme` syntax:

<details><summary>dark themes</summary><p>

```xml
<dict>
  <key>name</key>
  <string>Proven with Abella</string>
  <key>scope</key>
  <string>meta.abella.proven</string>
  <key>settings</key>
  <dict>
    <key>background</key>
    <string>#365A28</string>
    <key>foreground</key>
    <string>#51873C</string>
  </dict>
</dict>
```
</p></details>

<details><summary>light themes</summary><p>

```xml
<dict>
  <key>name</key>
  <string>Proven with Abella</string>
  <key>scope</key>
  <string>meta.abella.proven</string>
  <key>settings</key>
  <dict>
    <key>background</key>
    <string>#002800</string>
  </dict>
</dict>
```
</p></details>

For `sublime-color-scheme` syntax:

<details><summary>dark themes</summary><p>

```json
{
    "name": "Proven with Abella",
    "scope": "meta.abella.proven",
    "background": "#365A28",
    "foreground": "#51873C"
},
```
</p></details>

<details><summary>light themes</summary><p>

```json
{
    "name": "Proven with Abella",
    "scope": "meta.abella.proven",
    "background": "#002800",
},
```
</p></details>