response

[git.ikiwiki.info.git] / doc / plugins / contrib / bibtex.mdwn

diff --git a/doc/plugins/contrib/bibtex.mdwn b/doc/plugins/contrib/bibtex.mdwn
index 33770377d606c70b7948665245070d0d0eabe163..e600f39639c073d4bb62c6bb60d6e8e5deac0c39 100644 (file)
--- a/doc/plugins/contrib/bibtex.mdwn
+++ b/doc/plugins/contrib/bibtex.mdwn
@@ -1,5 +1,11 @@
+[[!template id=plugin name=bibtex author="[[Matthias]]"]]
+
 # bibtex for ikiwiki #
 
+(get me at [github]!)
+
+[github]: https://github.com/ihrke/iki-bibtex
+
 This [ikiwiki]-plugin provides a 
   
     [[!bibtex ]]
@@ -7,17 +13,21 @@ This [ikiwiki]-plugin provides a
 directive for [ikiwiki]. 
 
 So far, it can display a raw or formatted bibtex-entry from a 
-bibtex-file (either checked into ikiwiki, or not).
+bibtex-file (either checked into ikiwiki, or not) and display a 
+list of all bibtex-keys used on a key.
 
 [ikiwiki]: http://ikiwiki.info/
 
-Get it at [github].
-
-[github]: https://github.com/ihrke/iki-bibtex
-
 Features:
 
+* three different output formats for citations:
+  + cite - Author (year)
+  + citation - Author1, Author2 (year): **Title.** *Journal*
+  vol(num). pp.
+  + raw - raw bibtex-entry preformatted
 * supports websetup
+* bibliography
+
 
 ## Requirements ##
 
@@ -34,9 +44,16 @@ format (authors (year): journal. volume (number), pages.).
 
 Combine with toggle-plugin to optionally display the raw bibtex
 
-    [[!bibtex key="Ihrke2011"]] [[!toggle id="bibtexentry" text="(entry)"]]
-    [[!toggleable  id="bibtexentry" text="""
+    [[!bibtex key="Ihrke2011"]] \[[!toggle id="bibtexentry" text="(entry)"]]
+    \[[!toggleable  id="bibtexentry" text="""
     [[!bibtex key="Ihrke2011" format="raw"]]
-    [[!toggle id="bibtexentry" text="(hide)"]]
+    \[[!toggle id="bibtexentry" text="(hide)"]]
     """]]
     
+Add a bibliography that includes all bibtex-directives from that page
+
+
+    ## Bibliography ##
+    [[!bibtex_bibliography ]]
+
+    ----