====== Ad-Hoc Wrap Plugin ======

---- plugin ----
description: Selected and modernized styles and functions of the Wrap plugin, re-implemented on top of the Ad-Hoc HTML plugin.
author     : sascha-leib 
email      : ad@hominem.info 
type       : syntax, render
lastupdate : 2023-04-05
compatible : Kaos, Igor, Jack Jackrum
depends    : adhoctags
conflicts  : wrap
similar    : wrap
tags       : 

downloadurl: https://github.com/saschaleib/dokuwiki-plugin-adhocwrap/archive/refs/heads/main.zip
bugtracker : https://github.com/saschaleib/dokuwiki-plugin-adhocwrap/issues
sourcerepo : https://github.com/saschaleib/dokuwiki-plugin-adhocwrap
donationurl: style,alert,box,boxes,outline,info,blocks,layout,grid,rtl,darkmode,

screenshot_img : https://fallacies.online/img/AdHocWrap.png
----

:!: This plugin is still under development and some features may not yet work as expected, or may be changed or even removed in future versions. You are welcome to test this and report bugs back to the author. Be careful when using it in a production environment.

===== Installation =====

:!: **Important** This plugin requires the [[plugin:adhoctags|Ad-Hoc HTML]] plugin, which must be installed before this one. Because it replicates functionality of the [[plugin:wrap|Wrap]], the latter must be disabled or uninstalled.

Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to the latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====


This plugin replicates styles and layout options of the //Wrap// plugin, but modernizes the styles and offers more flexible options. 

See the plugin in action on the [[https://fallacies.online/wiki/playground/adhocplugins#ad-hoc_wrap|demo page]]. The sample page shows all relevant styles available with the plugin.

For example, you can add an info box as follows:

> <code html5>
<WRAP info>
  **Information:** Text here.
</WRAP>
</code>

Another aspect is page layouts. You can create them like this:

> <code html5>
<WRAP grid-2-columns>
 <div>
  === Column 1 ===
  ...
 </div>
 <div>
  === Column 2 ===
  ...
 </div>
</WRAP>
</code>

More examples, including the results, can be seen on the [[https://fallacies.online/wiki/playground/adhocplugins#ad-hoc_wrap|demo page]].