|
@@ -0,0 +1,46 @@
|
|
|
|
+Interlinks
|
|
|
|
+=========================
|
|
|
|
+
|
|
|
|
+This plugin allows you to include "interwiki" or shortcuts links into the blog, as keyword>rest-of-url
|
|
|
|
+
|
|
|
|
+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>
|