1====== Citations for DokuWiki ======
2
3===== About =====
4
5This plugin gives you the ability to let users cite your work. This is required quite often in academia and journalism.
6
7The way to show the page with the different citations styles is by appending ''&do=cite'' to a wiki page's URL in addition to an optional revision number, for example ''rev=123456789''.
8
9Recent templates can add the button to the citations automatically to their menu. In the Configuration Manager you can disable it again.
10Otherwise you will need to add code to your template's **main.php** for the citation links to appear!
11
12===== Setup if not yet supported =====
13
14To display a permanent link or citation link at any point in your document, use the following code as an example:
15<code php>
16<?php if (function_exists('cite_getPermURL')) { ?><a href="<?php echo cite_getPermURL(); ?>" rel="nofollow">Permanent Link</a><?php } ?>
17<?php if (function_exists('cite_getCiteURL')) { ?><a href="<?php echo cite_getCiteURL(); ?>" rel="nofollow">Cite this Page</a><?php } ?>
18</code>
19
20My advice is to keep the ''%%rel="nofollow"%%'' intact as this ensures search engines don't index citations.
21
22Set the options for this plugin via the **Configuration Settings** menu from the DokuWiki admin menu. (It will be near the bottom of the page.)
23
24===== For template developers =====
25====Current menus====
26If you use the [[https://www.dokuwiki.org/devel:menus]], the button to the citation page is added automatically to the page tools.
27These menu icons are svg-based, so icons can be colored in the style of the template.
28
29====Old menus====
30The plugin also exports two functions for use with your template:
31
32  * **cite_getPermURL()** : A //permanent link// to a page revision
33  * **cite_getCiteURL()** : A //citation link// so that you can let others easily cite your work
34
35Please feel free to use those functions if you intend to make your template "citation aware".
36
37===== Support =====
38
39For further support or discussion, please see the official [[doku>plugin:cite|plugin]] page.
40
41If you find this plugin useful, please consider supporting the project via [[http://tjgrant.com/wiki/donate|Donations]] or [[https://github.com/sponsors/tatewake|Sponsorships]]; thank you!
42