DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:cite

Citations for DokuWiki

Compatible with DokuWiki

  • 2024-02-06 "Kaos" unknown
  • 2023-04-04 "Jack Jackrum" unknown
  • 2022-07-31 "Igor" unknown
  • 2020-07-29 "Hogfather" yes

plugin This plugin creates citations of multiple formats for your wiki pages.

Last updated on
2020-09-22
Provides
Action
Repository
Source

Similar to bibtex, harvcite

Tagged with bibtex, latex, quotes, references

License

It's not required, but please consider linking to this page from your site if you like this product.

Download

Before downloading or using this product, make sure you understand and accept the terms of the license.

After downloading, make sure to follow the install instructions or upgrading instructions below; trust me, they're worth reading.

  • Older downloads are available on request only.

Note: http://cloud.github.com/downloads/tatewake/dokuwiki-plugin-cite/cite-stable.tar.gz always points to the latest stable version!

Installation

Use the plugin manager to install, or…

  1. download the tarball/zip-file
  2. unpack it into <dokuwiki>/lib/plugins/
  3. login as admin and change the plugin in the configuration manager

using git:

% cd <dokuwiki>/lib/plugins/
% git clone git://github.com/tatewake/dokuwiki-plugin-cite.git cite

Debian install (or probably any other distribution):

# cd /usr/share/dokuwiki/lib/plugins/
# wget http://cloud.github.com/downloads/tatewake/dokuwiki-plugin-cite/cite-stable.tar.gz
# tar -xvzf cite-stable.tar.gz
# chown -Rv 33 cite/

Note: http://cloud.github.com/downloads/tatewake/dokuwiki-plugin-cite/cite-stable.tar.gz always points to the latest stable version!

About

This plugin gives you the ability to let users cite your work. This is required quite often in academia and journalism.

The way this is done is by appending “&do=cite” to a wiki page's URL in addition to an optional revision number, for example “rev=123456789”.

The plugin also exports two functions for use with your template, with URLs for a permanent link (cite_getPermURL) to a page revision and a citation link(cite_getCiteURL) so that you can let others easily cite your work.

<note warning>If you do not add the following code to your template's main.php, no citation links will appear!</note>

In main.php, add the following at the top of the file:

<?php if (file_exists(DOKU_PLUGIN.'cite/code.php')) include_once(DOKU_PLUGIN.'cite/code.php'); ?>

To display a permanent link or citation link at any point in your document, use the following code as an example:

<?php if (function_exists('cite_getPermURL')) { ?><a href="<?php echo cite_getPermURL(); ?>" rel="nofollow">Permanent Link</a><?php } ?>
<?php if (function_exists('cite_getCiteURL')) { ?><a href="<?php echo cite_getCiteURL(); ?>" rel="nofollow">Cite this Page</a><?php } ?>

My advice is to keep the rel="nofollow" intact as this ensures search engines don't index citations.

Set the options for this plugin via the Configuration Settings menu from the DokuWiki admin menu. (It will be near the bottom of the page.)

Upgrading

To upgrade, remove the original lib/plugins/cite folder, and install the new version as instructed above.

Discussion

Start all subtopics with H2.

Author and Publisher

It would be great to have options on the author and Publisher settings. We just can set it globally. It would be useful to retrieve the page author automatically (Dokuwiki @NAME@) and also to have a way to set a Publisher name by namespace. The meta plugin could be of great use to this if we can retrieve meta value to set author and publisher on a page basis. — typometre 2019-04-01 02:10

plugin/cite.txt · Last modified: 2020-09-22 23:01 by tjgrant@tatewake.com

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki