DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:annotate

This is an old revision of the document!


annotate Plugin

Compatible with DokuWiki

  • 2018-04-22 "Greebo" yes
  • 2017-02-19 "Frusterick Manners" unknown
  • 2016-06-26 "Elenor Of Tsort" unknown
  • 2015-08-10 "Detritus" unknown

plugin Creates annotation boxes that function like toolipts. The boxes, initially hidden, open in place, on mouseover, immediately beneath the text being annotated and close out-of-sight on the click of a button.

Last updated on
2019-01-08
Provides
Syntax
Repository
Source

Tagged with annotate, annotation, tooltip

Installation

Install the plugin using the Extension Manager or the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.

Examples/Usage

This plugin creates scrollable information boxes that open when the mouse cursor moves over the text that requires explanation, which is marked like a DokuWiki tooltip, with double dotted underlining, as in “HTML”. The box stays open until the close button is clicked or until the user double clicks inside the box itself, or until another box is opened.

The text for the annotation can be entered directly into the current page or imported from a DokuWiki page. The syntax for these techniques is described below.

Syntax

The basic syntax

  <anno:num>text</anno><@anno:num>annotation</@anno>

num is a unique two digit number that identifies this annotation pair. The text is what is explained by annotation. In the browser this text will be identified by a double dotted underline. Please note that the mark-up for the text and the markup for the annotation are side-by-side:

  <anno:num>...</anno><@anno:num>...</@anno>    

Complete Syntax

1. <anno:10>text</anno><@anno:10>wiki text</@anno>
2. <anno:15>text</anno><@anno:15>{{ns:page}}</@anno>
3. <anno:20>text</anno><@anno:20><top>ns:page</top>wiki text<bottom>ns:page</bottom></@anno>
4. <anno:25>text</anno><@anno:25>wiki text<bottom>ns:pace:page</bottom></@anno>
5. <anno:30>text</anno><@anno:35><top>ns:page</top>wiki text</@anno>

  • text: text to be annotated
  • wiki text: the annotation entered directly into the current page
  • ns:page: wiki page (namespace:page) to be loaded into the annotation from a file in the wiki
  • top: marks off a header which will be loaded into the annotation from the specified wiki page
  • bottom marks off a footer which will be loaded into the annotation from the specified wiki page
  1. In this form, the entire annotation will consist of the wiki text
  2. In this form the entire annotation will consist of the page loaded into the annotation field from ns:page
  3. In this form the wiki text will be preceded by a header and followed by a footer
  4. In this form the annotation will consist of the wiki text followed by a footer
  5. In this form the annotation will consist of a header and the wiki text

What can and cannot be included in the annotations

Most DokuWiki syntax can be included in the annotations with the exception of block level elements. The latter includes code blocks, file blocks, geshi code blocks, code snippets, and quoting: >>. When these are inclluded, they end up outside the annotation block.

The annotations can include images, links, tables, ordered and unordered lists, headlines, and typographic markup, such as bold, italic, superscript, etc.

While tables, lists and headlines are block level elements, the plugin re-configures them for inclusion in the annotation field. This means that for these forms, there might be some differences from the styles of your template.

Development

Change Log

Discussion

Bugs and Issues

Use the DokuWiki forum or annotate's issues on github (see the Report Bugs link above).

plugin/annotate.1547046426.txt.gz · Last modified: 2019-01-09 16:07 by turnermm