====== BlockQuote Plugin ======

---- plugin ----
description: Write quotations in a semantically correct way
author     : Anika Henke (previous author: Gina Häußge)
email      : anika@selfthinker.org
type       : syntax, action
lastupdate : 2020-09-27
compatible : Detritus, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather, Igor, jack jackrum 
depends    : 
conflicts  : 
similar    : styler
tags       : quotes

downloadurl: https://github.com/dokufreaks/plugin-blockquote/archive/master.zip
bugtracker : https://github.com/dokufreaks/plugin-blockquote/issues
sourcerepo : https://github.com/dokufreaks/plugin-blockquote
donationurl: 

screenshot_img : https://trello.com/1/cards/6443003898c5d0719e719b7d/attachments/644300c91b35fab8965ec052/download/dokuwiki-plugin-blockquote.png
----

With the blockquote plugin you can write semantically correct quotations (by using the HTML tags ''blockquote'' and ''q''). In contrast to the default wiki syntax for quotes, the content of the quote can contain any wiki syntax. Thus, also nested quotes are possible.

===== Configuration =====

You can remove the plugin's specific styling by de-activating the ''addStyling'' config option.

===== Syntax =====

The plugin provides three different tags to write quotations and corresponding information:

  * ''<blockquote>'' marks up block quotations (i.e. quotes including at least one paragraph or more), an alternative syntax is ''<QUOTE>''
  * ''<q>'' marks up inline quotations (i.e. inside a paragraph or a list etc), an alternative syntax is ''<quote>''
  * ''<cite>'' marks up where a quote is cited from

:!: **Please note:** An old version of the plugin used to allow the citation as a parameter of the blockquote tag (e.g. ''<blockquote John Smith>''). That functionality has been removed from the plugin. Instead you can use attributes from the [[plugin:wrap|Wrap plugin]] in all of those tags, if that plugin is installed. If you'd like to keep the functionality, please move the words into a ''<cite>'' tag within the ''blockquote'' tag as in the first example below.

==== Examples ====

<code>
<blockquote>
There is nothing either good or bad, but thinking makes it so.

<cite>William Shakespeare, "Hamlet", Act 2 scene 2</cite>
</blockquote>
</code>

<code>
He said <q>That's life!</q> and moved on.
</code>
{{https://trello.com/1/cards/6443003898c5d0719e719b7d/attachments/644300c91b35fab8965ec052/download/dokuwiki-plugin-blockquote.png?recache|'blockquote' Example}}

Examples using attributes from the Wrap plugin:

<code>
<cite hi>Albert Einstein</cite> once said:

<blockquote column 30% :de>
"Autoritätsdusel ist der größte Feind der Wahrheit."
</blockquote>
</code>

<code>
She said <q :fr>‹C'est la vie!›</q> and smiled.
</code>
{{https://trello.com/1/cards/6443003898c5d0719e719b7d/attachments/644300bd752a1c4c37c7843d/download/dokuwiki-plugin-blockquote-with-wrap-plugin.png?recache|Examples using attributes from the Wrap plugin}}