====== block Plugin ====== ---- plugin ---- description: Create highly configurable boxes for text and image author : Myron Turner email : turnermm02@shaw.ca type : syntax lastupdate : 2021-01-23 compatible : Lemming, Anteater, Rincewind, Angua, Adora belle, Binky, Ponder stibbons, Hrun, Detritus, Elenor of tsort, Frusterick Manners, Greebo, Hogfather, Igor depends : conflicts : similar : wrap, box tags : style downloadurl: https://github.com/turnermm/Block-Plugin-for-Dokuwiki/tarball/master bugtracker : https://github.com/turnermm/Block-Plugin-for-Dokuwiki/issues sourcerepo : https://github.com/turnermm/Block-Plugin-for-Dokuwiki/ donationurl: http://mturner.org/userfiles/donate.php ---- ===== Installation ===== Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually. ===== Examples/Usage ===== {{http://www.mturner.org/userfiles/block.png }} This plugin has a toolbar icon which pops up a window with which you design your box, including border styles and colors, text color and box color, the width of the box in percentages, and the position of the box on the page. You can either start by selecting your text and then designing your box or you can create your box and add text to it. You can also include images in these boxes; however, image position depends on the Dokuwiki markup. The basic features of the box can be configured in the Configuration Manager. See below: [[#configuration_options]]. ===== Main Dialog Window of Design Tool ===== Syntax is taken care of by the pop-up design tool. {{ http://mturner.org/userfiles/doku/block_zpscju9mjvp.png }} ===== Syntax Specification ===== /** * * text * * width: percent of window size * alignment: number of pixels from left margin, (0 or 'c' centers block), 'r' floats right * border: CSS style: width type color * font-family: font name * font size: specify points or pixels * * Example: * * * This creates a block 80% of page width,centered on page, background of block is rgb(102, 51, 255), * text-color is rgb(255, 255, 153); the box border is 2px wide, dashed, its color is rgb(255, 102, 255). * The font is 10pt Comic Sans MS. * * Only width and alignment are required. In this case, if alignment is 'c' or 'r', then you must follow it with a colon: 'c:' */ /** * Default: * text * width: 80% * alignment: 10 px from left * background-color: white * text-color: black * border: 4px solid black * font: 10pt Arial, Helvetica, sans-serif */ ==== Rounded Corners ==== For rounded corners the syntax adds the ''rounded'' parameter to the end of the parameter list: This option can be selected from the dialog. ===== Configuration Options ===== ^ Option ^ Description ^ Default ^ Notes ^ | block_width | Block width | 80 | Number of pixels specified as integer | | bg | Background color | white | Any valid css value | | fg | Text Color | black | Any valid css value | | border_color | Border color | black | Any valid css value | | border_style | Border style | solid | Selected from drop-down menu | | border_width | Border With | 4px | specified as pixels: ''px'' | | font_family | Font or Font Family | Arial, Helvetica, sans-serif | Selected from drop-down menu | | font_size | Text size in points | 10pt | Specified as ''pt'', ''px'', or ''em'' | | block_align | Block Alignment | 10 | Either an integer representing number of pixels from left ((''0'' will give you centered)), or ''c'' for centered, or ''r'' for right aligned | ===== Change Log ===== {{rss>https://github.com/turnermm/Block-Plugin-for-Dokuwiki/commits/master.atom date count=10}} ===== FAQ ===== The block plugin does not work with the %%~~GOTO>[page]~~%% syntax of the [[plugin:goto]] plugin in the hogfather distribution and later. All other functions are OK. ===== Discussion ===== I am having problem with heading used inside block as it swallows everything following. Input =====heading===== produces

heading

Obviously one of the two
s is not terminated. I believe it is the second one
, because when not using heading inside the block, everything is ok. When adding a
after the block
it works fine (although cumbersome) except for the inserted (undesirable) vertical space. I guess that inserting one more
before the block is ended might help. But only in the case that a heading was used within the block. I am afraid that block is not really aware of what is inside. Would it be a solution to create the block_heading (or somethink like that) plugin which assumes that heading is used inside the block and which generates one more before the end? Or more elegantly to add to the current block plugin one more argument, specifying how many s (I believe one should be enough) are to be generated before the block end. Thanks for consideration :-) -------- I has an error when I clicked the menu button I had to change the line of the file "script.js", from var url = encodeURI('lib/plugins/block/exe/block.php'); to var url = encodeURI('lib/plugins/block/exe/block.php?'); > Thank you. I've updated the plugin. ---- How can I get two 'blocks' next to each other?\\ Or some text and then a block to the right of it?\\ Every time I try it, the block doesn't 'share' its line with anything else. Thanks >Try it with the wrap plugin >> Is there antother option except the wrap plugin? Because, when i try to use the wrap plugin, it doesn´t work. Whenever I try to type in the box, Windows puts the text in the text Find (aka Search) box. Result is no text can go into the box. >> Sorry I didn't see this eaarlier. But I can't reproduce this. The following page uses box throughout and from Windows: http://www.mturner.org/devel/doku.php --- [[user>turnermm|Myron Turner]] //2015-10-06 01:53// ---- Is there any way to include the caption in a block with an image?