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

API Blueprint

by apiaryio ST2/ST3 Trending

API Blueprint Sublime Text plugin

Details

  • 2017.05.29.14.55.47
  • github.​com
  • github.​com
  • 5 months ago
  • 2 hours ago
  • 3 years ago

Installs

  • Total 9K
  • Win 2K
  • OS X 5K
  • Linux 1K
Oct 20 Oct 19 Oct 18 Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 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
Windows 3 5 2 2 1 2 3 3 5 3 6 5 3 1 4 6 3 7 2 0 1 3 4 9 3 5 3 2 3 3 3 11 1 2 1 4 4 5 3 0 1 2 3 1 0 1
OS X 3 14 6 4 6 1 3 6 4 2 6 5 3 3 8 3 2 5 8 0 2 3 2 3 6 7 2 2 5 5 6 4 4 2 2 11 4 8 5 4 1 0 12 8 5 5
Linux 0 3 0 2 3 0 0 5 2 1 4 0 0 1 3 3 4 3 0 0 1 1 3 1 2 2 0 1 3 1 2 2 1 0 2 1 1 2 1 0 0 1 2 1 2 0

Readme

Source
raw.​githubusercontent.​com

API Blueprint Sublime Text Plugin

This is the official API Blueprint plugin for Sublime Text with following features:

  • Syntax highlighting for the API Blueprint format
  • Compiling blueprint into its AST media-type
  • Live linting of blueprints as you type using SublimeLinter3

This plug-in works both with Sublime Text 2 and 3. However linting is supported on Sublime Text 3 only.

Requirements

Drafter

In order for this plugin to work properly you need to have the API Blueprint command line tool drafter installed.

To install Drafter on OS X using run the following command:

$ brew install --HEAD \
  https://raw.github.com/apiaryio/drafter/master/tools/homebrew/drafter.rb

Refer to Drafter installation notes for details on installing on OS X & Linux or Windows.

SublimeLinter3 (optional)

This plugin offers linting of your blueprints using the SublimeLinter3 plugin framework. In order for linting to work please install SublimeLinter3.

Markdown Highlighting (optional)

Note the API Blueprint Sublime Text syntax support relies on Markdown highlighing support in the color scheme used. For best results use a color scheme that supports Markdown-specific scopes (e.g. markdown: heading) such as Monokai extended, and install Sublime Markdown Extended.

Installation

Using Package Control

With Package Control:

  1. Run “Package Control: Install Package” command, find and install API Blueprint plugin.
  2. Restart SublimeText editor (if required)

From the Source

With Drafter installed run the following command in your Sublime Text 3 packages directory:

$ git clone https://github.com/apiaryio/api-blueprint-sublime-plugin.git  "API Blueprint"

Depending on your OS (and Sublime Text version) the packages directories are: + Linux: ~/.config/sublime-text-3/packages + OS X: ~/Library/Application\ Support/Sublime\ Text\ 3/Packages + Windows: %APPDATA%\Sublime Text 3\Packages

Using the Plugin

Commands

You can access the commands either using the command palette (CTRL+SHIFT+P or CMD+SHIFT+P) or via shortcuts.

Shortcuts

  • ALT+SHIFT+B: Parse the active file and open result AST including any possible parser messages in a new tab.

Acknowledgements

License

MIT License. See the LICENSE file.