Differences

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

--- plugin:clearer [2013-04-03 05:40] – [clearer Plugin] Fix downloadurl 122.212.225.106
+++ plugin:clearer [2020-11-15 19:23] (current) – zaher
@@ Line 2: / Line 2: @@
 ---- plugin ----
-description:
+description: Clear floats
 author     : Zaher Dirkey
 email      : zaherdirkey@yahoo.com
 type       : syntax
-lastupdate : 2012-06-09
+lastupdate : 2020-11-15
-compatible : >2009-02-14, 2008-05-05
+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.
+===== Syntax =====
+Basic syntax:
+<code>text \\\</code>
+Note, no space characters to the right of the three backslashes.
 ===== 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
+Add three consequtive backslash ("\") at the end of a line. This will add to your html code after the current paragraph
-  |          | text line 2
+<code>...</p><div class="clearer" ></div></code>
-  |   Image  |
+The HTML will output all floats currently in buffer. The next line of regular text will start below.
-  |          |
-  o----------o
-  text line 3
-If you don't add it at the end of line it will not work.
-===== Syntax =====
+===== Example =====
-Add three of \ at the end of line to break it and start the new line
+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.
-Basic syntax:
+===== Bugs and issues =====
-<code>text line \\\</code>
-Example:
+==== Problems with PHP 7.0 ====
-<code>
+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//
-  {{image1}}text line 1\\
-   text line 2\\\
-   text line 3
-</code>
-This will add to your html code after the current paragraph
-<code>...</p><div class="clearer" ></div></code>