Plugins ======= .. _complete_words: Complete words -------------- Similar to Eclipse behavior: cycles through possible word completions from opened documents. Default key: ``slash`` .. _edit_and_select: Edit and Select --------------- Provides features for easy text editing. * ``d`` deletes line under cursor with copying it into clipboard. * ``o`` shows cursor offset and cursor column position. Huh? Simply I need offset when write tests (parsing, code analyzing, etc.). * ``w`` smart select. Selects semantic blocks. Just try it. Have you ever need to select whole function definition or string in quotes or function parameters or function call with parameters or statement block? There is only one function for such tasks in Snaked. In conjunction with stock gtksourceview2 selection moving (``Up``, ``Down``) it allows forget about copy-paste. * ``w`` shrinks smart selection back. * ``f`` reformats selection to current right margin width. That's all for now. Planed feature functionality: * Smart string literals edit. * Automatic brackets and quotes pairing. * Automatic text wrap. * Maybe vertical selection. * Vim-like numbers incrementing/decrementing (``a``, ``x``). * Vim-like above line symbols copying (``y``). * Vim-like... Over 9000 other features. In order of first need. Maybe implement vim mode? Damn. Goto Dir -------- Default shortcut ``l`` opens editor file directory in file manager. Goto Line --------- ``l`` popups dialog with line number input. Hash Comment ------------ Comments and uncomments code with hashes. Useful for languages with appropriate comment symbols. Default key ``slash``. Python Flakes ------------- Background python code linter. Highlights problems like unused or undefined imports or variables. Also gives feedback about syntax errors. Quite handy plugin. Save positions -------------- Remembers current file position on editor close and restores it on open. Search ------ Simply search, like in other editors. .. image:: /images/search.* Replace entry supports back references (``\1`` or ``\g``) for regular expression groups in search field. Shortcuts ********* * ``f`` shows dialog. * ``Escape`` hides it. * ``Enter`` in search or replace text entry do actual searching. * ``j``, ``k`` navigate to next/previous match. * ``h`` highlights selection occurrences. To control `ignore case`, `regex` checkboxes and activate `Replace`/`Replace all` buttons you can use mnemonics: ``c``, ``x``, ``p`` and ``a``. .. _external-tools: External tools -------------- Plugin allows to run commands optionally piping selection or whole buffer's content to it and process it's stdout. .. image:: /images/external-tools.* * ``Name``: tool's name. You can use underscore ("_") to define mnemonic key and pango markup. * ``Langs``: comma separated list of languages for which this tool is intended. Leave field empty if tool should be available in all editors. * ``Command``: Shell command to execute. Following variables are supported: * ``%f`` — current filename * ``%d`` — current filename's directory * ``%p`` — current project directory Take note, you have not to quote it. * ``Stdin`` and ``Stdout`` should be self-explanatory. Default key to activate run menu is ``x``. Actual tool can be run by pressing it's mnemonic key or selecting it with cursor keys an hitting ``Enter``. Snippets -------- It is similar to vim's SnipMate plugin which are clone of TextMate's snippets, you may refer to these projects for syntax documentation. User snippet files are searched in ``~/.config/snaked/snippets``. You can configure it via preferences (``p``) item ``Snippets``. There is ability to attach several snippet sets to one editor via multiple contexts (preferences ``File types`` item). Missing features: * Variable/python commands/shell commands expansion via backticks. Spell check ----------- Attaches spell checker to current editor. You need ``pygtkspell`` installed (look at gnome-python-extras package for your distro). Spell check is activated/deactivated by ``F7`` key.