[[PageOutline(2-5,Contents,pullout)]]
= !MetaTracker integration =

== Description ==

Provides links and macros for querying [http://www.gnome.org/projects/tracker/ MetaTracker], the desktop search program, (a.k.a Tracker) and embedding `file:///` links.

== Bugs/Feature Requests == 

Existing bugs and feature requests for MetaTrackerPluginMacro are [query:status!=closed&component=MetaTrackerPluginMacro&order=priority here].

If you have any issues, create a 
[/newticket?component=MetaTrackerPluginMacro&owner=spookylukey new ticket].

== Download and Source ==

Download plugin as an [http://files.lukeplant.fastmail.fm/public/MetaTrackerPlugin-0.11dev-py2.5.egg egg]. You can check out MetaTrackerPluginMacro (along with other code that can safely be ignored) from [http://hg.lukeplant.me.uk/python/luke/ an external repository] using Mercurial.

== Example ==

=== Embed single file links ===

Examples:

 * `file:sometag`

   Embeds a link to the first file matching the tag in the !MetaTracker database. This is especially useful if files have been tagged with unique IDs.  !MetaTracker can track such files even when they are moved or renamed.

 * `file:"/home/foo/bar"`

   Embeds a link to the file:

      `<a href="file:///home/foo/bar">bar</a>`

=== Tables of links ===

Do a word search using !MetaTracker:

 `[[MetaTrackerSearch(programming languages,rant)]]`  

This returns all files containing the text "programming languages"  '''AND''' "rant", formatted in a table.

There are also macros for searching tags in the same way, see bundled documentation.


== Recent Changes ==

[[ChangeLog(metatrackerpluginmacro, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:spookylukey] [[BR]]
'''Maintainer:''' [wiki:spookylukey] [[BR]]
'''Contributors:'''