Table of Contents

Blockquote Plugin

Description

The blockquote plugin provides an environment for (semantically correct by using the blockquote XHTML tag) quotes. In contrast to the default wiki markup for quoting, the content of the quote can contain any wiki markup which then gets interpreted as it would outside of the quote environment. Thus, also nested quotes are possible.

In case you come across any bugs in this plugin, don't hesitate to report them.

The Darcs repository of the plugin can be found here.

Updates

Last updated: 2008/05/04

Syntax

The plugin provides two additional pairs of markup tags, the blockquote and the cite markup. The blockquote allows an additional citation source to be given after the blockquote keyword in the opening tag. The cite markup was mainly created to allow the addition of more complex citation sources (including links, text formatting etc) inside the blockquote environment, although it can also be used standalone. See the examples below.

If blockquotes you insert only look like the usual quotes as available from DokuWiki core, this will most probably be due to a caching issue. Please try Shift-Reloading in your browser, and if this doesn't help take a look at "Purging the Cache" in the DokuWiki documentation before asking for help here. Thanks!

Examples

Loads of markup

The following code

<blockquote>
Test with loads of markup...

Another paragraph with a little [[http://nowhere|link]] to nowhere. Oh, and while we are at it, what about some **bold**, some //italic// and some __underlined__ text? And finally, an itemization:

  * item 1
    * item 1.1
    * item 1.2
  * item 2
    - ordered item 2.1
    - ordered item 2.2
      - ordered item 2.2.1
  * item 3

Works :-)
</blockquote>

results in

Test with loads of markup…

Another paragraph with a little link to nowhere. Oh, and while we are at it, what about some bold, some italic and some underlined text? And finally, an itemization:

  • item 1
    • item 1.1
    • item 1.2
  • item 2
    1. ordered item 2.1
    2. ordered item 2.2
      1. ordered item 2.2.1
  • item 3

Works :-)

The cite attribute

The following code

<blockquote J. Random Hacker>Test with a cite attribute...</blockquote>

results in

Test with a cite attribute…

The cite command

The following code

<blockquote>Test with a cite command...<cite>J. Random Hacker, [[http://localhost/~jrhacker]]</cite></blockquote>

results in

Test with a cite command…

J. Random Hacker, http://localhost/~jrhacker

Installation

When updating from 2007/10/27, please first delete the old installation of the plugin, otherwise not all components might be registered properly.

With plugin manager

Let the manager do the dirty work, just give him this link to eat: plugin-blockquote.tar.gz

Without plugin manager

  1. Download the plugin: plugin-blockquote.tar.gz
  2. Extract it into your dokuwiki plugin folder (eg lib/plugins)