Differences

This shows you the differences between two versions of the page.

--- plugin:clearer [2015-02-16 20:56] – Slightly more details KaiMartin
+++ plugin:clearer [2020-11-15 19:23] (current) – zaher
@@ Line 6: / Line 6: @@
 email      : zaherdirkey@yahoo.com
 type       : syntax
-lastupdate : 2012-06-09
+lastupdate : 2020-11-15
-compatible : >2009-02-14, 2008-05-05, Hrun
+compatible : >Hrun, Hogfather
 depends    :
 conflicts  :
@@ Line 17: / Line 17: @@
 sourcerepo : https://github.com/parmaja/clearer
 ----
 ===== Installation =====
-Download the archive and unpack it into ''<dokuwiki>/lib/plugins''.
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
-Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.
-===== Usage =====
-If you need to start the next line from the beginning, (leaving the long height of an image for example) just add three of \ the end of the line
-  o----------o text line 1
-  |          | text line 2
-  |   Image  |
-  |          |
-  o----------o
-  text line 3
-If you don't add it at the end of line it will not work.
 ===== Syntax =====
-Add three consequtive backslash ("\") at the end of line. This will output all floats currently in buffer. The next line of regular text will start below the last float.
 Basic syntax:
-<code>text line \\\</code>
+<code>text \\\</code>
 Note, no space characters to the right of the three backslashes.
-Example:
+===== 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}}text line 1\\
+  {{ image1}}
-   text line 2\\\
+  bulk text1 \\
-   text line 3
+  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//
-This will add to your html code after the current paragraph
-<code>...</p><div class="clearer" ></div></code>