[[PageOutline(2-5,Contents,pullout)]]

= Plug-in to extract URL from TracWiki links in Plug-ins and Macros =

== Description ==

This plug-in provides the function `extract_url` which can be used in Trac plug-ins and macros to extract the URL of any TracWiki link for e.g. generation of links in produced HTML code.

= Usage =
{{{
#!python
from tracextracturl import extract_url
# ...
  url = extract_url (env, context, wikilink, raw=False)
}}}
The argument `raw` controls if the returned link should point to a brows-able (False) or download-able (True) target. The second one can be used in image or similar tags.


== Bugs/Feature Requests == 

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

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

== Download and Source ==

Download the [download:extracturlplugin zipped source], check out [/svn/extracturlplugin/0.11 here] using Subversion, or [source:extracturlplugin browse the source] with Trac.

== Example ==

{{{
#!python
from tracextracturl import extract_url

def MyMacro(WikiMacroBase):
  def expand_macro (self, formatter, name, content):
     # e.g. wikilink = 'wiki:WikiStart'
     url = extract_url(self.env, formatter.context, wikilink)
}}}


== Recent Changes ==

[[ChangeLog(extracturlplugin, 3)]]

== Author/Contributors ==

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