fish
A robust Sublime Text syntax package for fish
Details
Installs
- Total 9K
- Win 807
- OS X 5K
- Linux 3K
| Sep 19 | Sep 18 | Sep 17 | Sep 16 | Sep 15 | Sep 14 | Sep 13 | Sep 12 | Sep 11 | Sep 10 | Sep 9 | Sep 8 | Sep 7 | Sep 6 | Sep 5 | Sep 4 | Sep 3 | Sep 2 | Sep 1 | Aug 31 | Aug 30 | Aug 29 | Aug 28 | Aug 27 | Aug 26 | 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 | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Windows | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 3 | 1 | 0 | 0 | 1 | 0 | 3 | 1 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 3 | 0 | 0 | 1 | 2 | 2 | 0 | 2 | 0 | 0 | 0 | 0 | 1 | 0 | 1 |
| OS X | 1 | 3 | 4 | 3 | 1 | 2 | 0 | 1 | 2 | 0 | 4 | 2 | 1 | 3 | 3 | 3 | 2 | 2 | 1 | 2 | 6 | 2 | 3 | 3 | 1 | 2 | 1 | 1 | 5 | 1 | 1 | 3 | 3 | 1 | 4 | 2 | 2 | 2 | 6 | 2 | 2 | 3 | 3 | 3 | 1 | 3 |
| Linux | 0 | 2 | 3 | 2 | 0 | 1 | 0 | 3 | 3 | 1 | 3 | 0 | 1 | 2 | 3 | 3 | 0 | 1 | 2 | 4 | 1 | 0 | 1 | 0 | 4 | 1 | 4 | 0 | 2 | 1 | 4 | 3 | 0 | 1 | 1 | 1 | 0 | 0 | 2 | 1 | 2 | 2 | 1 | 2 | 0 | 0 |
Readme
- Source
- raw.githubusercontent.com
friendly interactive shell (fish)
A Sublime Text 2/3 package for the friendly interactive shell. It features a robust syntax highlighting scheme that mimics the native highlighting behaviour of fish.
All the syntax of fish 2.7 is completely implemented. fish 3.0 support is in development. Suggestions and bug reports are welcome.
ST2 support and ST3 support is separated between two branches:
- st2: Plugins only compatible with ST2, syntax uses tmLanguage scheme, and provides highlighting for fish 2.7 only.
- master: Plugins only compatible with ST3, syntax uses sublime-syntax scheme, and provides highlighting for fish 2.7 (and eventually fish 3.0).
The 2.x.x series of releases (on both ST support branches) only support fish 2.7.
The coming 3.x.x series of releases (on the master branch alone) will include support for fish 3.0.
Features
- Extensive syntax highlighting.
- Snippets for common constructs.
- Indentation and prettification of the active file (with
fish_indent):- Use
ctrl+alt+ior your build system shortcut (eg,ctrl+b) - Optional setting to run automatically on save
- More information here
- Use
Installation
Via Package Control
Install Package Control, then go to Command Palette (Ctrl+Shift+P) > Package Control: Install Package > fish.
Manual
Clone the repository to your Packages directory and rename it to fish.
cd /path/to/sublime/packages/directory
git clone https://github.com/Phidica/sublime-fish.git
mv sublime-fish fish
Open a .fish file and verify the selected syntax is “Friendly Interactive Shell (fish)”.
Screenshots
As of version 2.1.0, a fish script (for example, fish-shell/share/functions/ls.fish) will look something like:
Figure 1: Default Monokai colour scheme
Figure 2: Example custom Monokai colour scheme formatting additional scopes
Exposed scopes
| fish construct | Scope name |
|---|---|
| Unquoted string | meta.string.unquoted |
| Command name | meta.function-call.name |
| Parameters | meta.function-call.parameter.option/argument |
| File path (in argument) | meta.function-call.parameter.argument.path |
| File path (in redirection) | meta.function-call.operator.redirection.path |
| Process expansion | meta.function-call.parameter.argument.process-expansion and punctuation.definition.process |
| Variable expansion | meta.variable-expansion and punctuation.definition.variable |
| Command substitution | meta.parens.command-substitution and punctuation.section.parens.begin/end |
| Index expansion | meta.brackets.index-expansion and punctuation.section.brackets.begin/end |
| Brace expansion | meta.braces.brace-expansion and punctuation.section.braces.begin/separator/end |
| Wildcard expansion | meta.wildcard-expansion and keyword.operator.question-mark/single-star/double-star |
| Home directory expansion | keyword.operator.tilde |
Contribution
Requirements:
- PackageDev, only for ST2 development and changing the tmPreferences file.
ST2 development: The source file of the syntax is fish.YAML-tmLanguage. When editing this file, “compile” it with the PackageDev build system to automatically generate the fish.tmLanguage file which is used by Sublime Text 2.
ST3 development: The source file of the syntax is fish.sublime-syntax.
Guide for contributing is located here.
History
This project was forked from original groundwork laid by toru hamaguchi.