Fork me on GitHub

About

This plugin extends XML/HTML tag autocompletion provided by Geany. It automatically inserts a matching snippet after you type an opening tag.

Usage

Enable the plugin in the Plugin Manager and add snippets you need to your snippets.conf. For example, to get an HTML definition list template automatically inserted after you type "<dl>", add the following snippet to the [HTML] section:

dl=<dl>\n\t<dt>%cursor%</dt>\n\t<dd>%cursor%</dd>\n</dl>

The plugin will automatically catch up snippets supplied with Geany (for example, "table").

Notes:

You can use this plugin together with tag autocompletion provided by Geany. Tags, for which you defined snippets, will be completed by the plugin; Geany will deal with other tags.

Requirements

For compiling the plugin yourself, you will need the GTK (>= 2.8.0) libraries and header files. You will also need its dependency libraries and header files, such as Pango, Glib and ATK. All these files are available at http://www.gtk.org.

And obviously, you will need have Geany installed. If you have Geany installed from the sources, you should be ready to go. If you used a prepared package e.g. from your distribution you probably need to install an additional package, this might be called geany-dev or geany-devel.

Furthermore you need, of course, a C compiler and the Make tool. The GNU versions of these tools are recommended.

Installation

Compiling and installing the code is done by the following three commands:

$ ./configure
$ make
$ make install

For more configuration details run:

$ ./configure --help

If there are any errors during compilation, check your build environment and try to find the error, otherwise contact one of the authors.

Running the built-in test suite

This stage is completely optional and does not affect the work of the plugin. It is useful for plugin developers so that they are sure the innards of the plugin are working as expected.

To run the tests, you have to compile a test executable and run it using the commands below. These commands will only work if you are using a Unix environment and GCC compiler. Before running the commands, go to the source code directory (xmlsnippets/src).

$ gcc -Wall -DTEST -ggdb `pkg-config --cflags --libs glib-2.0` *.c -o xmlsnippets
$ ./xmlsnippets

The executable will warn you about the tests which failed. Ignore non-warning informational messages like those starting with ** Message:.

License

This plugin is distributed under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found in the file COPYING included with the source code.

Ideas, questions, patches and bug reports

Report them to the Geany mailing list (see http://www.geany.org/Support/MailingList).

Docs for previous versions