git clone https://github.com/Makopo/sublime-text-lsl LSL

[
    {
        "keys": ["super+l"],
        "command": "build",
        "context":[
            { "key": "selector", "operator": "equal", "operand": "source.lsl" }
        ]
    },
    {
        "keys": ["super+l"],
        "command": "build",
        "context":[
            { "key": "selector", "operator": "equal", "operand": "source.ossl" }
        ]
    }
]

cmd = [c.encode(sys.getfilesystemencoding()) for c in cmd]

"windows":
    {
        "encoding": "cp932",
        "cmd": ["$packages\\LSL\\windows\\lslint.exe", "-p", "$file"]
    },

For osx:

* These samples assume that LSL-PyOptimizer revision is 7282e53 (Feb 5, 2019) or later.
* In this example, output will be created as `SOURCE_FILE_NAME_optimized.SOURCE_EXTENSION`.
* [Official document](http://lsl.blacktulip-virtual.com/lsl-pyoptimizer/) says you need to use Python 2.7.
* Outputs are streamed as utf-8 so you need `PYTHONIOENCODING` environment variable to successfully decode them.

Save this file as `LSL-PyOptimizer.sublime-build`.

Now you'll find `LSL-PyOptimizer` in `Tools` -> `Build System`.

Select `Tools` -> `Build With...`(<kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>B</kbd> or <kbd>Command</kbd><kbd>Shift</kbd><kbd>B</kbd>) and choose `LSL-PyOptimizer`.

From now on, your source will be compiled with LSL-PyOptimizer. `Tools` -> `Build With...` again to switch back to lslint.

## Using lslint as Build System for files with non-ascii characters in their paths

lslint prints output in ascii characters. When calling lslint on the Build System, Python tries to decode the output as utf8, which translates most non-ASCII characters incorrectly. To avoid this, add an argument and specify your system encoding in `LSL.sublime-build`. The encoding value must be one of the codecs in [this list](https://docs.pythonlang.cn/3.3/library/codecs.html#id3).

"windows":
{
    "cmd": ["$packages\\LSL\\windows\\lslint.exe", "-p", "$file"],
    "encoding": "YOUR_CODEC"
},

## LSL/OSSL sidebar icons

Starting from Sublime Text 3062, you can assign file icons on the sidebar. However, since this plugin is not a theme, I can't provide this feature, instead you can assign your favorite icon to LSL/OSSL entries by yourself.

In short: scope "source.lsl" for LSL and "source.ossl" for OSSL.

1. Create or fetch a 16x16 image. FYI, you can find SecondLife icons in [BitBucket repository](https://bitbucket.org/lindenlab/viewer-release/src/5b51b28e057c/indra/newview/icons/release/?at=default).
2. Rename the image to "file_type_lsl.png".
3. You can even add secondary 32x32 image as "[email protected]". I don't know how it will be used though.
4. Create a file "icon_lsl.tmPreferences" with the following contents.
5. Put the file above and PNG image(s) into your active theme folder.

icon_lsl.tmPreferences:
```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
      <key>scope</key>
      <string>source.lsl</string>
      <key>settings</key>
      <dict>
          <key>icon</key>
          <string>file_type_lsl</string>
      </dict>
  </dict>
</plist>