Interlinks
=========================

This plugin lets you add frequently used URLs to your markup using short keywords. Short URL format is 
``keyword>rest-of-url`` where ``keyword`` is defined in the settings.py. Later it is replaced with acutal URL in
the generated HTML output.


Requirements
--------------------
``interlinks`` requires BeautifulSoup

	pip install beautifulsoup4

Installation
--------------------

Install the plugin normally (plugins folder), then add interlinks in the settings.py:

	PLUGINS = ["interlinks"]
	
Usage
------------------

The interlinks are specified in the settings.py file as (example):

	INTERLINKS = {
	    'wikipedia_en': 'http://en.wikipedia.org/wiki/',
	    'wikipedia_es': 'http://es.wikipedia.org/wiki/',
	    'ddg': 'https://duckduckgo.com/?q='
	}

There's also a default key, ``this``, that is mapped to the ``SITEURL`` variable.

Then, in a blog post, you just create a normal link but adding the ``keyword>`` syntax in the url specification, followed by the rest of the url. 

Example 
-------------------
(markdown syntax)

	[Normal boring link](http://www.example.com). But this is a [cool link](this>) that links to this site.

	Search in [Wikipedia](wikipedia_en>python), ([here](wikipedia_es>python) in spanish). Also can [search](ddg>python) it.

All the above will be rendered as: 

	<p><a href="http://www.example.com">Normal boring link</a>. But this is a <a href="http://[yoursite]/index.html">cool link</a> that links to this site.</p>
	
	<p>Search in <a href="http://en.wikipedia.org/wiki/python">Wikipedia</a>, (<a href="http://es.wikipedia.org/wiki/python">here</a> in spanish). Also can <a href="https://duckduckgo.com/?q=python">search</a> it.</p>