summaryrefslogtreecommitdiff
path: root/ikiwikireferenceplugin.mdwn
blob: fe9f32bbae25970efdc1fea80b034b910fb42713 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
#Ikiwiki Reference Plugin

### Goals

We would like to reference things in our pages with a bibliography, in the style of scientific papers.  MediaWiki (wikipedia) has this feature and ikiwiki does not. (If it does, and we are just unaware of it, please let us know!) 

So we—if we have time—will write a quick plug in to do just that.

##Syntax

The syntax will look something like this:
<pre>Some line of text.[[!ref name="refname" link="http://www.google.com" desc="A link to google"]]

[[!ref]]
</pre>

Which should produce something like this:

---

>Some line of text.<a name="returnRefName"><sup><a href="#refName">[1]</a></sup></a>
>
>1. <a href="#returnRefName">^</a> A link to google <http://www.google.com>

---

Probably producing html similar to this:

    Some line of text.<a name="returnRefName"><sup><a href="#refName">[1]</a></sup></a>
    
    <ol>
        <li><a href="#returnRefName">^</a> A link to google <a href="http://www.google.com">http://www.google.com</a></li>
    </ol>