Compatible with DokuWiki

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

• Download
• Report bugs

Adds syntax for latex-like figure captions and numbering

Last updated on

2022-11-09

Provides

Syntax

Repository

Source

Similar to caption, imagebox

Tagged with caption, figure, tables

By Ben van Magill, Till Biskup

A re-write of the caption plugin from Till Biskup. New plugin due to syntax change.

Fixes:

• No string searches to set reference links that appear before a label definition.
• Change syntax to allow multiple classes to be used eg. left, center, right.
• Add the ability to have subfigures/tables.
• Add an option to change caption tag syntax.
• Code easy to expand to caption label more tags if needed.
• Updated some css styles to use flexbox.

All documentation for this plugin can be found at https://github.com/bennvan/dokuwiki-plugin-latexcaption

The plugin provides two different syntax elements, similar to the blockquote plugin. One for the outer block/tag (figure, subfigure, table, subtable, codeblock, fileblock), and one for the caption. A caption cannot be used outside one of the main blocks.

A simple centered figure with only a caption number.

<figure center blank|fig_label>
{{image.jpg}}
<caption></caption>
</figure>

<figure opts|fig_label>
 <subfigure opts|subfig_label1>
   {{image1.jpg}}
   <caption>subfigure caption1</caption>
 </subfigure>
 <subfigure opts|subfig_label2>
   {{image1.jpg}}
   <caption>subfigure caption2</caption>
 </subfigure>
 <caption>Main Caption</caption>
</figure>

It is also possible to have more than one image in a figure/subfigure to group them with one caption:

<figure center>
  {{image1.jpg}}
  {{image2.jpg}}
<caption>A caption</caption>
</figure>

Reference anywhere in text using:

{{ref>fig_label}}

Set the counter anywhere on the page using:

<!-- Set the figure counter to 5 -->
{{setcounter>figure=5}} 

<!-- Set the table counter to 3 -->
{{setcounter>table=3}} 

• Signatures begin with abbreviated or advertised “labels” (“Figure” vs. “Fig.” / “Table” vs. “Tab.”).
• Caption tag syntax to avoid conflicts with bootswrapper plugin.

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.