Imitation

About

Imitation is a plugin for the gedit text editor, that allows the user to edit a document in multiple places simultaneously. It does this by enabling the user to place marks in different parts of a document that act as virtual text cursors. It is designed to aid repetitive programming tasks.

Imitation is best explained by a demo video:

History

To save some confusion over plugin names:

• Multi-edit (hyphen) was created by me for gedit 2
• Multi Edit (no hyphen) was based on my work but created by another author
• Imitation is a sequel to Multi-edit created by me for gedit 3

Download

Imitation (gedit 3) latest version (1.1)

• Currently: development finished, though feedback welcome
• 2012-08-30: Imitation 1.1 -- added option to auto-increment from one
• 2012-03-13: Imitation 1.0 -- unicode bug fix
• 2011-12-31: Imitation 0.2.1 -- minor bug fix
• 2011-12-13: Imitation 0.2 -- major bug fixes + auto-increment and config added
• 2011-12-05: Imitation 0.1 -- released for testing

Multi-edit (gedit 2) is still available (though no longer supported)

Install

An "install" script is included in the source code which will be the quickest option for most users (it does the following steps for you). However, if it does not work or you'd like to do things manually, just do the following:

1. Install the GSettings schema (needed for config)
   1. Locate your system's gschema directory (assuming /usr/share/glib-2.0/schemas)
   2. Place "org.gnome.gedit.plugins.imitation.gschema.xml" in the gschema directory
   3. Apply the changes by running "glib-compile-schemas /usr/share/glib-2.0/schemas"
2. Install the plugin
   1. Choose either the user (~/.local/share/gedit/plugins/) or system (/usr/lib/gedit/plugins) directory
   2. Place "imitation.plugin" (file) and "imitation" (folder) in the chosen directory
   3. Activate Imitation in gedit's preferences

Also make sure that you use the lib64 folder if gedit uses it, and make sure the files are readable by all.

Feedback

Any feedback is most welcome and appreciated. You can email jon@ this website.

Config

Imitation relies on GSettings for configuration, and GSettings currently uses dconf as the default backend. So you can simply use dconf-editor, and edit settings at the GSettings path /org/gnome/gedit/plugins/imitation. I might at some stage bother creating a config GUI but at the moment it doesn't seem necessary.

Usage

Imitation may seem a bit complex at first, but it is easy to learn, and powerful to use. There are two main aspects to Imitation: marking and editing.

Marking

Before you can start editing in imitation mode, you need to first mark the places you'd like to edit. Marking can be done in five different ways, depending on the key you press and whether you have selected any text or not.

• Mark toggle (<Control>e)
  This is the most basic way of placing marks. It toggles (add|remove) a mark at the cursor.
• Normal vertical marking (<Control>Page_Up|Down)
  • Without selection: line mode
  • With selection: column mode
• Alternate vertical marking (<Control><Shift>Page_Up|Down)
  • Without selection: word-offset mode (also sticks to end-of-lines if started from one)
  • With selection: matches mode selects the next match to selection (and the match number if multiple matches per line)

Unlike Multi-edit, Imitation's vertical marking will skip lines with less characters than the cursor's line offset. This is useful when there are blank lines between code segments.

Clearing all marks: Move the cursor (unless in sticky mode) or press Escape

Sticky mode: Using "mark toggle" will also trigger "sticky mode", where you can move your cursor around with marks staying in place. In vertical marking, they will be cleared as soon as you move your cursor, unless you enable sticky mode. Sticky mode stays enabled until you clear all marks.

Editing

For the most part editing with Imitation is mostly similar to editing with a normal cursor. There are however a few differences:

• Your normal cursor will no longer work (only marks will preform edits)
• Delete is limited to plain Backspace and Delete keys (no modifiers like <Control> etc)
• You can insert incrementing values using (in order of mark placement):
  • <Control>0: Integers starting at zero
  • <Control>1: Integers starting at one
  • <Control>a: ASCII lowercase a-z
  • <Control><Shift>a: ASCII uppercase A-Z