Fix default value test
[nautilus-actions.git] / README
blob6cf8a4b2f2f9051ba608940fc66a34f1da7ac435
1 Nautilus-Actions
3   Nautilus-actions is an extension for Nautilus file manager which
4   allows the user to add arbitrary program to be launched through the
5   Nautilus file manager popup menu of selected files.
7 Nautilus-Actions components.
9   Nautilus-Actions has three sort of components:
11   - A user interface, nautilus-actions-config-tool (NACT), which let you
12     manage your actions. With NACT, you are able to create, modify and
13     delete actions, to define menus and submenus, to order and reorder
14     items.
15     Import/export functions are also managed via NACT.
17   - Nautilus extensions as dynamically loadable plugins. These extensions
18     are automatically loaded by Nautilus when it starts. For now, two
19     extensions are provided:
20     . libnautilus-actions-menu.so is a plugin which takes care of displaying
21       actions in Nautilus context menus;
22     . libnautilus-actions-tracker.so is a plugin which tracks the current
23       Nautilus selection, and sends it in response to a DBus request. 
25   - Command-line utilities:
26     . nautilus-actions-new lets you create new actions from the command-line.
27     . nautilus-actions-schemas prints the full GConf schema on stdout.
28     . nautilus-actions-run lets you execute a predefined action, taking
29       into account the current Nautilus selection via a DBus call to the
30       libnautilus-actions-tracker plugin.
32 Nautilus-Actions plugins.
34   I/O Providers.
36     Nautilus-Actions itself uses plugins to load menus and actions from
37     the storage space. These plugins are installed in PKGLIBDIR, usually
38     something as /usr/lib/nautilus-actions/.
40     Starting with 3.0.2, the preferred default I/O provider is 'na-desktop',
41     which means that newly created actions and menus will be stored on
42     disk as .desktop files, in accordance with DES-EMA specification [1].
44   Importers/Exporters.
46     Nautilus-Actions also relies on plugins to import actions and menus,
47     and to export them, in several formats.
48     For now, Nautilus-Actions is able to import/export its items as:
49     . GConf schemas;
50     . GConf dump;
51     . XML. 
53 Nautilus-Actions documentation.
55   Documentation is provided in several formats:
56   - developer documentation is provided as xml and html files, as generated
57     by gtk-doc;
58   - NACT user's manuals and general documentation is provided as xml, pdf
59     and html files, as generated by gnome-doc-utils, docbook-utils or dblatex
60     tools.
62 [1] http://www.nautilus-actions.org/?q=node/377