====== clearer Plugin ======

---- plugin ----
description: Clear floats
author     : Zaher Dirkey 
email      : zaherdirkey@yahoo.com 
type       : syntax
lastupdate : 2020-11-15
compatible : >Hrun, Hogfather
depends    : 
conflicts  : 
similar    : wrap, clearfloat
tags       : typography

downloadurl: https://github.com/parmaja/clearer/archive/master.zip
bugtracker : https://github.com/parmaja/clearer/issues
sourcerepo : https://github.com/parmaja/clearer
----

===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Syntax =====

Basic syntax:
<code>text \\\</code>
Note, no space characters to the right of the three backslashes.

===== Usage =====

Add three consequtive backslash ("\") at the end of a line. This will add to your html code after the current paragraph
<code>...</p><div class="clearer" ></div></code>
The HTML will output all floats currently in buffer. The next line of regular text will start below.

===== Example =====

A large image floating to the right should be accompanied by two sections of bulk text on the left. A third section of text should start after the the image. Like so:
  bulk text1 o----------o
  bulk text2 |          |
             |  image1  |
             |          |
             o----------o
  bulk text3
This can be achieved by:
<code>
  {{ image1}} 
  bulk text1 \\
  bulk text2 \\\
  bulk text3
</code>
The space after the curly brackets makes the image float to the right. The two backslashes after bulk text1 indicates a regular manual line break. The three backslashes at the end of bulk text2 forces bulk text3 to start below the bottom of the image.

===== Bugs and issues =====

==== Problems with PHP 7.0 ====

This plugin failed on our Dokuwiki instances after we migrated the servers to PHP 7.0 . We ended up using the plugin [[plugin:wrap]] to achieve the same effect.  --- [[user>KaiMartin|KaiMartin]] //2019-06-14 14:21//