syntaxdb-atom-plugin

An atom plugin for SyntaxDB.

Coteh

186

0

1.0.4

MIT

GitHub

SyntaxDB Atom Plugin

Front

An atom package that provides a simple interface to search and view the SyntaxDB database.

Installation

For regular user installation, head over to the Atom package page and install it through there, or head over to Preferences -> Install in Atom and search for "syntaxdb-atom-plugin".

You can also install it via the command line by entering:

apm install syntaxdb-atom-plugin

How to Use

To use the atom package, make sure it's installed, then press Ctrl-Alt-S to activate the SyntaxDB search panel. To activate the language filter, which displays all concepts on the SyntaxDB database by language, press Ctrl-Alt-L.

Search View
SyntaxDB plugin search bar

On the search panel, type in a search query (eg. "for loop in Java") and press enter. A list view will then appear, displaying the results it has gathered from the SyntaxDB API. Selecting any of these results will bring up a results view for the entry, displaying its syntax as well as additional information.

Results View
Currently, the results view displays notes, syntax, example(s), and documentation about the specified syntax.

It is also possible to place the syntax example provided by SyntaxDB directly into your document. To do this, make sure the Example tab is currently selected, then press the "Place in Document" button. (or press shift-enter)

Placing Example into Document
Example of placing an example into a document.

Development

To install the package for development purposes, first clone the repository:

git clone https://github.com/Coteh/syntaxdb-atom-plugin.git

Navigate to root directory of project and install dependencies:

npm install

Then link the package:

apm link

This will create a symlink in your Atom packages folder to your clone of the repository, effectively installing it.

Whenever you make a change to the package, reload Atom window to see the changes.

Issues

Future Additions