DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:columns

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
plugin:columns [2015-03-11 20:00] 59.95.121.99plugin:columns [2023-06-18 00:39] (current) – Fix compatibility list dwp-forge
Line 2: Line 2:
  
 ---- plugin ---- ---- plugin ----
-description: Arrange information in multiple columns. +description: Arrange information in multiple columns 
-author     : Michael Arlt +author     : Mykola Ostrovskyy 
-email      : michael.arlt@sk-schwanstetten.de+email      : spambox03@mail.ru
 type       : syntax type       : syntax
-lastupdate : 2012-10-13 +lastupdate : 2023-06-16 
-compatible : HrunPonder StibbonsBinkyWeatherwax+compatible : hrundetritusFrusterick MannersGreebo, Hogfather, Igor, Jack Jackrum
 depends    :  depends    : 
 conflicts  conflicts 
-similar    :  +similar    : wrap 
-tags       : boxes +tags       : boxes, columns 
-downloadurl: http://dwp-forge.googlecode.com/files/columns-2012-10-13.zip +downloadurl: https://github.com/dwp-forge/columns/archive/v.2023-06-16.zip 
-bugtracker : http://code.google.com/p/dwp-forge/issues/list+bugtracker : https://github.com/dwp-forge/columns/issues 
-sourcerepo : http://code.google.com/p/dwp-forge/source/browse/+sourcerepo : https://github.com/dwp-forge/columns
 ---- ----
  
-===== Description =====+This is a reworked and extended version of the original plugin developed by [[michael.arlt@sk-schwanstetten.de|Michael Arlt]].
  
-You can arrange your information in multiple columns. Column breaks must be inserted manually. I use a table with one %%<td>%% for each column. This worked best together with the [[plugin:s5|S5 presentations]] plugin from Andreas Gohr.+The plugin allows to organize Wiki page contents into multiple columns using manually inserted column breaksWidth of the columns and text alignment within them are fully configurable. For creation of complex layouts,  sections of columns can be nested one into another.
  
  
-===== Syntax =====+===== Download and Installation =====
  
-==== Columns3 CURRENT VERSION ====+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
  
-Following a number of requests, the plugin is re-designed to support headings and vertical alignment of the columns contentIn order to support the new features syntax of the plugin is extended with extra attributes that should be specified in front of the column width:+  * [[https://github.com/dwp-forge/columns/archive/v.2023-06-16.zip|columns-2023-06-16]]
  
-<code> +===== Syntax =====
-<columns 100% first column attributes 50% ->+
  
-Content of the first column. +==== Basics ====
- +
-<newcolumn second column *-* attributes> +
- +
-Content of the second column. +
- +
-</columns> +
-</code>+
  
-With this extra attributes the columns declaration gets more and more cluttered. To prevent that you can specify column attributes in the ''%%<newcolumn>%%'' tagIn this case the order of the attributes and column width is not important:+The minimal syntax is simply add two lines around your information and enter your column breaks.
  
 <code> <code>
-<columns 100% first column attributes 10% second column attributes 50% third column attributes 25%>+<columns 100% 50% - ->
  
-Content of the first column.+First column text (50% width).
  
 <newcolumn> <newcolumn>
  
-Content of the second column.+Second column text.
  
 <newcolumn> <newcolumn>
  
-Content of the third column.+Third column text.
  
 </columns> </columns>
 </code> </code>
  
 +The first attribute of the ''%%<columns>%%'' tag is the width of the column set. The following attributes are for the columns. If you do not want to specify a value for the table- or column-width use "''-''" instead.
  
-=== Headings ===+The column breaks are specified with ''%%<newcolumn>%%'' tag, which may also take optional attributes described below. In the original plugin the breaks were specified with ''%%~~NEWCOL~~%%'' and for compatibility reasons it is still possible to [[#Configuration|configure]] the plugin to use this tag, but some of the newer features will be disabled.
  
-The headings are specified the using the standard DokuWiki syntax:+ 
 +==== Extended Syntax ==== 
 + 
 +Apart from the width, each column may have a number of additional attributes that specify formatting of the column contents. These attributes should be specified in front of the column width:
  
 <code> <code>
-<columns 100% 50% ->+<columns 100% first column attributes 50% second column attributes ->
  
-===== Heading ===== +First column text.
- +
-Content of the first column.+
  
 <newcolumn> <newcolumn>
  
-Content of the second column.+Second column text.
  
 </columns> </columns>
 </code> </code>
  
-By default plugin puts the content within a column without explicitly specifying the section levelThis works fine when the entire columns block belongs to a single section but can produce unexpected results when the headings are used within the block:+With these extra attributes the columns declaration gets more and more cluttered. To prevent that you can specify column attributes in the ''%%<newcolumn>%%'' tagIn this case the order of the attributes and column width is not important:
  
 <code> <code>
-====== Level 1 Heading ======+<columns 100% first column attributes 50%>
  
-<columns 100% 50% ->+First column text.
  
-Implicit level 1 content.+<newcolumn second column 25% attributes>
  
-===== Level 2 Headline 1 ===== +Second column text.
- +
-Level 2 content.+
  
 <newcolumn> <newcolumn>
  
-Implicit level 1 content that should be in level 2 section. +Third column text.
- +
-===== Level 2 Headline 2 ===== +
- +
-Level 2 content.+
  
 </columns> </columns>
 </code> </code>
  
-You can force the beginning of the second column to be in level 2 by specifying "''continue''" attribute (or shorthand "''%%...%%''"):+ 
 +==== Column Alignment ==== 
 + 
 +By default the text in the columns is justified but alignment for each column can be specified explicitlyThere are few ways to soThe most simple one is by adding asterisks on either side of the column width specification. The asterisk indicates non-justified side of the text block, so to achieve left alignment add the asterisk on the right side.
  
 <code> <code>
-====== Level 1 Heading ======+<columns 100% 25% 25%* *-* *->
  
-<columns 100% 50% ->+First column with justified text.
  
-Implicit level 1 content.+<newcolumn>
  
-===== Level 2 Headline 1 =====+Second column is aligned on the left side.
  
-Level 2 content.+<newcolumn>
  
-<newcolumn continue>+Third column is center-aligned.
  
-Level 2 content.+<newcolumn>
  
-===== Level 2 Headline 2 ===== +Fourth column is aligned on the right side.
- +
-Level 2 content.+
  
 </columns> </columns>
 </code> </code>
  
- +Alternatively the alignment can be specified with separate attributes. This approach allows to define both horizontal and vertical alignment. There are four attributes for horizontal alignment (''left'', ''center'', ''right'' and ''justify'') and three for the vertical (''top'', ''middle'' and ''bottom''). There may be multiple alignment attributes per column:
- +
-=== Alignment === +
- +
-The vertical alignment is specified with new alignment attributes. There are four horizontal alignment attributes (''left'', ''center'', ''right'' and ''justify'') and three vertical alignment attributes (''top'', ''middle'' and ''bottom''). There may be multiple alignment attributes per column:+
  
 <code> <code>
 <columns 100% left 50% right bottom -> <columns 100% left 50% right bottom ->
  
-Aligned on the left side.+First column is aligned on the left side.
  
 <newcolumn> <newcolumn>
  
-Aligned to the right-bottom corner.+Second column is aligned to the right-bottom corner.
  
 </columns> </columns>
Line 148: Line 133:
 <columns 100% l 50%> <columns 100% l 50%>
  
-Aligned on the left side.+First column is aligned on the left side.
  
 <newcolumn rb> <newcolumn rb>
  
-Aligned to the right-bottom corner.+Second column is aligned to the right-bottom corner.
  
 <newcolumn m *-*> <newcolumn m *-*>
  
-The old alignment syntax is still supported. +Simple alignment syntax is still supported. 
-Content of this column is centered both ways.+Contents of the third column is centered both ways.
  
 </columns> </columns>
 </code> </code>
  
-==== Columns2 : OBSOLETE ==== 
  
-The syntax is mostly identical to the original version, except that the new column keyword has to be specified within angle brackets((The syntax can be made fully compatible with the original version of plugin by un-checking "Wrap the new column tag" check box in the Configuration Settings.)):+==== Headings ==== 
 + 
 +The headings within column sets are specified the using the standard DokuWiki syntax:
  
 <code> <code>
 <columns 100% 50% -> <columns 100% 50% ->
  
-information in column 1 (50% width)+===== Heading ===== 
 + 
 +Content of the first column.
  
 <newcolumn> <newcolumn>
  
-information in column 2+Content of the second column.
  
 </columns> </columns>
 </code> </code>
  
-By default the text in columns is justified. This can be changed by adding asterisks on either side of the column width specification. The asterisk indicates non-justified side of the text block, so to achieve left alignment add the asterisk on the right side.+By default plugin puts the content within a column without explicitly specifying the section level. This works fine when the entire column set belongs to a single section but can produce unexpected results when the headings are used within the set:
  
 <code> <code>
-<columns 100% 2525%* *-* *-> +====== Level 1 Heading ====== 
-Justified text+ 
 +<columns 100% 50% -> 
 + 
 +Implicit level 1 content. 
 + 
 +===== Level 2 Headline 1 ===== 
 + 
 +Level 2 content. 
 <newcolumn> <newcolumn>
-Aligned on the left side + 
-<newcolumn> +Implicit level 1 content that should be in level 2 section. 
-Center-aligned + 
-<newcolumn> +===== Level 2 Headline 2 ===== 
-Aligned on the right side+ 
 +Level 2 content. 
 </columns> </columns>
 </code> </code>
  
-==== Columns1 OBSOLETE ====+You can force the beginning of the second column to be in level 2 by specifying ''continue'' attribute (or shorthand ''%%...%%''):
  
-Simply add two lines around your information and enter your column breaks.+<code> 
 +====== Level 1 Heading ======
  
-The first parameter is the width of the table. The following parameters are for the columns+<columns 100% 50% ->
-If you do not want to specify a value for the tableor column-width use "-" instead.+
  
-<code> +Implicit level 1 content.
-<columns 100% 50% - ->+
  
-information in column (50% width)+===== Level 2 Headline =====
  
-~~NEWCOL~~+Level 2 content.
  
-information in column 2+<newcolumn continue>
  
-~~NEWCOL~~+Level 2 content.
  
-information in column 3+===== Level 2 Headline 2 ===== 
 + 
 +Level 2 content.
  
 </columns> </columns>
 </code> </code>
- 
- 
  
  
Line 227: Line 224:
  
  
-===== Localisation =====+===== Configuration =====
  
-The keywords can be customized - see DokuWiki: administration -> configuration.+The plugin adds a section to DokuWiki [[plugin:config|configuration page]]There are three settings that can be configured:
  
-^Language  ^Start      ^End         ^Next Column     ^ +  * ''plugin.columns.kwcolumns'' --- Name of the columns section tag. Default value depends on the Wiki language. 
-|English   |<columns |</columns |~~NEWCOL~~      | +  * ''plugin.columns.kwnewcol'' --- Name of the new column tag. Default value depends on the Wiki language. 
-|German    |<spalten>  |</spalten>  |~~NEUESPALTE~~  | +  * ''plugin.columns.wrapnewcol'' --- A flag indicating if the new column tag is wrapped into angle brackets. The flag is checked by default. By un-checking it you can make the plugin syntax fully compatible with the original version of plugin but you will loose number of advanced features. 
-|Spanish   |<columnas> |</columnas> |~~NUEVACOLUMNA~~|+ 
 + 
 +===== Technical Details ===== 
 + 
 +The plugin wraps contents of the columns set into an HTML table. This results in a number of limitations: 
 + 
 +  * Explicit column breaks are required to separate the table cells. 
 +  * The table may overlap with Table of Contents and I see no way to make the text in the table cells to flow around TOC. The only option seems to be to disable TOC with ''%%~~NOTOC~~%%''
 +  * It was reported that table borders show up in exported PDF. (2010/09/24) 
 + 
 +In principle, the headings should not be supported within any syntax mode except of the ''[[devel:syntax_plugins#Syntax Types|baseonly]]'', namely within plugin modes. So what the plugin does is against the rules, and you can expect some glitches here and there. For instance, I can imagine some compatibility problems with plugins that manipulate the instruction list around ''section_open'' and ''section_close'' instructions (e.g. [[plugin:uparrow|Uparrow]], [[plugin:editsections|Edit Section Reorganizer]]). Yet, it should behave better than Micheal's original plugin. One manifestation of such "better behavior" is that headings from the column sets show up in the TOC. 
 + 
 +The following work in combination with [[https://www.dokuwiki.org/plugin:editsections2|editsections2]]:
  
 <code> <code>
-$lang['kwcolumns'] + 
-$lang['kwnewcol']+===== HeadlineP ===== 
 + 
 +text corresponding to the previous part of the page (not displayed as columns) 
 + 
 +<columns> 
 +random character (not space) 
 +===== Headline1 ===== 
 + 
 +text corresponding to headline 1 
 + 
 +<new column> 
 +random character (not space) 
 +===== Headline2 ===== 
 + 
 +text corresponding to headline 2 
 + 
 +<new column> 
 +random character (not space) 
 +===== Headline3 ===== 
 + 
 +text corresponding to headline 3 
 + 
 +</columns> 
 +random character (not space) 
 + 
 + 
 +===== HeadlineR ===== 
 + 
 +text corresponding to the remaining of the page (not displayed as columns)
 </code> </code>
  
 +The EDIT buttons are then displayed correctly at the beginning of each column and corresponding sections. (using ''.'' as //random character//) may minimize the "scar" left using this workaround
 +===== Version History =====
  
-===== Download / Installation =====+==== 2023-06-16 ====
  
-Install the [[http://dwp-forge.googlecode.com/files/columns-2012-10-13.zip|current release]] with the plugin manager. Have a look at the DokuWiki plugin configuration.+  * Fixed compatibility with DokuWiki Jack Jackrum.
  
-^ 2012-10-13  | [[http://dwp-forge.googlecode.com/files/columns-2012-10-13.zip|Download]]  | Columns3 +==== 2021-04-04 ====
-^ 2009-01-31  | [[http://dwp-forge.googlecode.com/files/columns-2009-01-31.zip|Download]]  | Columns2 +
-^ 2007-10-22  | [[http://it-arlt.de/plugins/columns.zip|Download]]  | Latest version of the original plugin by Michael Arlt  |+
  
 +  * Fixed PHP8 compatibility.
  
-===== Change History =====+==== 2016-09-07 ====
  
-==== Columns3 ====+  * Support ODT export using redesigned [[plugin:odt|ODT plugin]].
  
-=== 2012-10-13 ===+==== 2016-02-27 ==== 
 + 
 +  * Fixed PHP7 compatibility. 
 + 
 +==== 2015-05-30 ==== 
 + 
 +  * Fixed default text alignment (justify). 
 + 
 +==== 2012-10-13 ====
  
   * Fixed compatibility with Adora Belle default template.   * Fixed compatibility with Adora Belle default template.
  
-=== 2012-09-23 ===+==== 2012-09-23 ====
  
   * Fixed compatibility issue with PHP 5.4.   * Fixed compatibility issue with PHP 5.4.
-  * Improved compatibility with DokuWiki Angua+  * Improved compatibility with DokuWiki Angua.
  
-=== 2009-08-30 ===+==== 2009-08-30 ====
  
   * Added CSS style sheet for printing   * Added CSS style sheet for printing
   * More appropriate placement of the section edit buttons. If columns start with a heading, the buttons are placed at the end of the column where the section text ends instead of the start of the next column.   * More appropriate placement of the section edit buttons. If columns start with a heading, the buttons are placed at the end of the column where the section text ends instead of the start of the next column.
  
-=== 2009-08-22 ===+==== 2009-08-22 ====
  
   * Added support for [[#ODT Export|ODT export]]   * Added support for [[#ODT Export|ODT export]]
Line 276: Line 322:
   * Fixed broken page layout if the first heading happens to be inside of a column   * Fixed broken page layout if the first heading happens to be inside of a column
  
-=== 2009-03-29 ===+==== 2009-03-29 ====
  
   * Added section continuation support   * Added section continuation support
Line 282: Line 328:
   * Fixed in-line columns handling   * Fixed in-line columns handling
  
-=== 2009-03-15 (beta) ===+==== 2009-03-15 (beta) ====
  
   * Added support for headings within the columns   * Added support for headings within the columns
Line 289: Line 335:
   * The plugin is split into syntax and action plugins   * The plugin is split into syntax and action plugins
  
-==== Columns2 ==== +==== 2009-01-31 ====
- +
-=== 2009-01-31 ===+
  
   * Fixed alignment of tables within a column   * Fixed alignment of tables within a column
  
-=== 2008-10-08 ===+==== 2008-10-08 ====
  
   * Added nesting support   * Added nesting support
   * Removed extra margin at the bottom of the columns block, which together with paragraph margin of the column content often caused double margin   * Removed extra margin at the bottom of the columns block, which together with paragraph margin of the column content often caused double margin
  
-=== 2008-09-29 ===+==== 2008-09-29 ====
  
   * Added Spanish localization (thanks to Digna Gonzalez Otero)   * Added Spanish localization (thanks to Digna Gonzalez Otero)
   * Added Russian localization   * Added Russian localization
  
-=== 2008-09-14 ===+==== 2008-09-14 ====
  
   * Added extended syntax to specify text alignment in the columns   * Added extended syntax to specify text alignment in the columns
   * To make the syntax fully compatible with the original plugin, the angle brackets around the new column keyword can be disabled from the configuration manager   * To make the syntax fully compatible with the original plugin, the angle brackets around the new column keyword can be disabled from the configuration manager
  
-=== 2008-08-23 ===+==== 2008-08-23 ====
  
   * Fixed issue with the backlinks   * Fixed issue with the backlinks
Line 316: Line 360:
   * Slightly different syntax: the new column keyword is wrapped in angle brackets (i.e. ''<columns> ... <newcolumn> ... </columns>'')   * Slightly different syntax: the new column keyword is wrapped in angle brackets (i.e. ''<columns> ... <newcolumn> ... </columns>'')
  
-==== 2007-10-22 ====+==== 2007-10-22 (Michael Arlt) ====
  
   * First public release   * First public release
Line 322: Line 366:
  
  
-===== Thanks to ... =====+===== Bugs and Feature Requests =====
  
-Andreas Gohr for DokuWiki and nowS5!+Please report bugs or feature requests at the [[https://github.com/dwp-forge/columns/issues]].
  
  
-===== License ===== 
- 
-This product is released under the [[http://www.gnu.org/licenses/gpl.html|GPL 2]] 
- 
-===== Bugs / Feature Requests ===== 
- 
-Please report bugs or feature requests at the [[http://code.google.com/p/dwp-forge/issues/list|bug tracker]]. 
- 
- 
-===== Discussion ===== 
- 
-==== Border in Adora Belle ==== 
- 
-Is there a parameter to remove border ? 
- 
----- 
- 
-Version 2012-10-13 has been tested on Adora Belle default template. The border should be gone. Make sure that cache is [[:caching#purging_the_cache|purged]]. --- [[user>pan One|Mykola Ostrovskyy]] //2012/12/05 08:01// 
- 
- 
-==== Not supported? ==== 
- 
-  * **DokuWiki version:** Release 2010-11-07a "Anteater" 
-  * **PHP version:** 5.3.3-1ubuntu9.3 
- 
-==== Old syntax support ==== 
- 
-Does not work for me at all. It is installed, I see the plugin in admin. But the plugin is doing nothing at all, just as if it were not installed. I can see ~~NEWCOL~~ as plainly as any other text.  --- //Anonymous 2010/01/12 00:19// 
- 
----- 
- 
-Since version 2008-08-23 the default syntax of the column separator is ''<newcolumn>''. You can enable the legacy ''~~NEWCOL~~'' syntax on the configuration page but some of the new features will not be supported.  --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2010/01/14 08:24// 
- 
-==== Continue for Heading Levels Not Working? ==== 
- 
-I can't get the "continue" or "..." feature to work. Even the example shown above doesn't work. I took the <<code>> tags out, previewed it, and it behaves exactly like the previous example that's supposed to demonstrate the problem. Has anyone gotten this to work? (And what happened to the signature button in the editor?) --- //DGM2 2009/11/05// 
- 
----- 
- 
-I did. Though, I guess, this is not really representative. It always works on developer's machine ;-) 
- 
-If you really sure that you found a bug, please report it to the [[http://code.google.com/p/dwp-forge/issues/list|bug tracker]]. 
- 
-(The signature button doesn't show up if you are logged out) --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2009/11/06 18:08// 
- 
- 
-==== Breaking Bottom Toolbar ==== 
- 
-Not sure if this is where to put this - but it seems that this plugin breaks the bottom toolbar - and the Edit / Old revisions / Subscribe / etc buttons all show as form buttons, rather than the 'normal' style. 
-I tested with the examples above, and they all seem to do it. 
-> It seems it has something to do with using headers (of any level) within the columns - remove those and it all formats OK. -Nick W 2009/08/04 09:11 
- 
----- 
- 
-I don't see it. Could you send me screen shots and HTML of correctly rendered page (without headings) and the broken one (with headings)? Preferably create a new page and try to reproduce the problem with minimal text/markup. What do you use in terms of software (browser, versions of DokuWiki, PHP, plugin)? --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2009/08/04 19:00// 
- 
----- 
- 
-Fixed in version 2009-08-22. --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2009/08/22 17:04// 
- 
- 
-==== Fatal error when using columns plugin against DokuWiki-2009-02-14b ==== 
- 
-Installing the columns plugin in above-mentioned DokuWiki version results in the following error on every page: 
- 
-Fatal error: Call to a member function on a non-object in .../dokuwiki/lib/plugins/columns/action.php on line 255 
- 
-//[[none|Pekka <pekka@gmx.de>]] 2009/07/18// 
- 
----- 
- 
-I can confirm this. Same for me.\\ 
-<hgi@gmx.at> 2009/07/24 
- 
----- 
- 
-As far as I can tell this has nothing to do with 2009-02-14b. At least I was able to reproduce it with 2009-02-14. The problem seems to be caused by a mismatch of the number of columns in the ''%%<columns ... >%%'' tag with the actual number of columns. The plugin chokes when there are to many columns in the tag. 
- 
-I will make a new release. Hopefully soon, but I want to figure out what is the [[#Conflict with Include Plugin|story with include plugin]] first. In the mean time you can try to fix your syntax if it's indeed broken. --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2009/07/26 18:54// 
- 
----- 
- 
-Fixed in version 2009-08-22. --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2009/08/22 17:04// 
- 
- 
-==== Support for ODT plugin ==== 
- 
-Hello. Thanks for this great plugin! 
- 
-Could you please add support for the [[plugin:odt|ODT plugin]]? This is a great plugin to export wiki content in a static file. I guess this plugin may receive pure XHTML as input, but doesn't get display different columns by now. 
- 
-I'd be happy to help testing... but am too bad a coder to hack your code to that extend. Thanks! 
- 
---- [[mailto:berteh@hotmail.com|berteh]], 3rd of June 2009 
- 
----- 
- 
-Implemented in version 2009-08-22. --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2009/08/22 17:04// 
- 
- 
-==== Conflict with Include Plugin ==== 
- 
-When using the include plugin, PARSER_HANDLER_DONE is triggered multiple times. This may lead to the reuse of internal variables in the columns plugin - which are not valid anymore. 
- 
-Therefore I made the following modifications in action.php: 
- 
-    function action_plugin_columns() { 
- $this->reset(); 
-    } 
-  
- /** 
- * Reset class vars 
- */ 
-    function reset() { 
- $this->block = Array(); // empty block array 
- $this->block[0] = new columns_root_block(); 
-        $this->currentBlock = $this->block[0]; 
-        $this->currentSectionLevel = 0; 
- } 
- 
-And calling  
- $this->reset(); // reset in case PARSER_HANDLER_DONE is triggered multiple times for a page (may happen with include plugin) 
-at the end of handle() 
- 
-//--- Anonymous 2009/06/06// 
- 
----- 
- 
-Fixed in version 2009-08-22. Thanks for the patch. --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2009/08/22 17:04// 
- 
- 
-==== Section editing ==== 
- 
-When the %%</column>%% command is added after a heading, if a person tries to edit using section edit, that close tag will appear in a section of text where the opening tags are not present, and it creates an error. Is there any way to avoid this? 
-Is there a way to add some kind of interim tag like %%<same column>%% that could go after headings to allow section edit? (I don't know, I'm new here....) --- //Anonymous 2009/03/27 00:49// 
- 
----- 
- 
-Fixed in version 2009-03-29.  --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2009/04/04 13:21// 
- 
- 
-==== Headings ==== 
- 
-The new release does not process headlines inside columns. e.g. the following code results on the plain ===== Headline =====: <code><columns 100% 50% - > ===== Headline ===== <newcolumn> nonono </columns></code> --- //[[rodrigor@rodrigor.com|Rodrigo Reboucas]] 2008/10/12 16:27// 
- 
----- 
- 
-I'm not sure it's a bug per definition. AFAIK, there is no error in the plugin that would cause it. It seems that DokuWiki has a limitation that doesn't allow to include headings into other modes. 
- 
-While the headings look like a nice feature at the first glance, there are number of questions that arise when you consider it in detail: 
-  * If there are two columns in a block and the first one uses heading, should the left margin associated with the heading level be applied also to the contents of the second column? 
-  * If there is a nested columns block in the first column, should the margin be applied to every nested column? 
-  * What about text after the columns block (out of plugin scope), should the margin be applied there? 
- 
-While you can come up with some answers to these questions, it seems to be too complicated and against the DokuWiki rules. So for now keep the headings out of columns. --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2008/10/13 8:30// 
- 
----- 
- 
->> I started using the 2007-10-22 release, now without problems with headings. You can see an example here: http://meninosdarede.org.br/site/ajude  --- //[[rodrigor@rodrigor.com|Rodrigo Reboucas]] 2008/10/13 12:54// 
- 
----- 
- 
-> While you can come up with some answers to these questions... 
- 
-So your answer is no margin. Works fine with your template but will look not so nice with the default one. 
- 
-The 2007-10-22 release also has a number of problems and I'm afraid it won't be easy to take best of both. Though, never say never. If more people will ask I might reconsider ;-) --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2008/10/13 20:32// 
- 
----- 
- 
->> If it?s just a question of feedback: Enabling headings would be more as a nice feature. In future versions of DokuWiki you?ll have the same problem. Maybe margins for headings can be overwritten by your CSS. Mainly I think it?s a question of structuring the text optically -- so far I think your plugin is very very interesting! --- //[[none|Stefan]] 2008/12/28// 
- 
- 
- 
----- 
- 
->>> Seconded. No headings is a deal breaker for me. I've started using the 2007 release as well, but it would be nice to have the new syntax and some of the features from columns2. I think headings/margins should function exactly as they do in the 2007 release. --- //Enki 2009/02/06 15:50// 
- 
----- 
- 
-> Headings in columns would be really useful, please fix it. --- //[[kolan_nick@mail.ru|Kolan]] 2009/02/27 15:14// 
- 
----- 
- 
->> my 2 cents: also thinking headings are needed within columns --- //[[vipo@gmx.at|Vipo]] 2009/03/12 21:44// 
- 
----- 
- 
-Okay, I got the message :-) 
- 
-In principle, the headings should not be supported within any syntax mode except of the ''[[devel:syntax_plugins#Syntax Types|baseonly]]'', namely within plugin modes. So what I do here is against the rules, and you can expect some glitches here and there. For instance, I can imagine some compatibility problems with plugins that manipulate the instruction list around ''section_open'' and ''section_close'' instructions (e.g. [[plugin:uparrow|Uparrow]], [[plugin:editsections|Edit Section Reorganizer]]). Yet, it should behave better than Micheal's original plugin. One manifestation of such "better behavior" is that headings from the columns now show up in the TOC, which you probably will have to disable on default template as it overlaps with the columns. I would appreciate if somebody would suggest better HTML to fix this, but for now this is the best I could do. 
- 
-Anyway, you got the point: UAYOR. --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2009/03/15 12:17// 
- 
- 
-==== Nested Blocks ==== 
- 
-Nice plugin but could be awesome if you could use it in nested blocks. Thanks for your work :D. 
- 
---- [[zeth_69@hotmail.com|Angelo Anfossi]] 2008/10/04 23:18 
----- 
- 
-If you mean "columns within columns", it's implemented in release of 2008-10-08. --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2008/10/08 17:22// 
----- 
- 
-==== Alignment ==== 
- 
-Having poked at this for a few minutes, I don't believe what you're doing is ever going to produce the alignments you appear to be attempting to achieve. The default settings you add to the Config (local.php) have no alignment styling, at all, and the outputted HTML reflects this. The 0.5em padding assigned to CSS1, CSS2, and CSS3 are not going to produce actual alignments.  
- 
-It is certainly possible to achieve real alignments by editing the config and adding either a "textAlign:center", for instance, or a "text-Align:right". But then those alignments apply to all tables, throughout the entire wiki site, which is not the implied intent. I think that, to allow alignment to be applied to specific tables and columns, you need another layer of manipulation, which would append the appropriate textAlign property to the default style for the given "CSS" column type.  
- 
-The basic functionality works nicely (in the latest version, at least), though, so thank you for that --- //[[david.mcneill@ge.com|DGM2]] 2008/09/16 01:32// 
----- 
- 
-I believe there is a bit of confusion here. The alignment feature has been added to the branched version (release 2008-09-14). The ''text-align'' is added to the table cell ''style'' attribute at the rendering time. Though, you seems to be talking about the original version of the plugin (the "current release" link up there). Unfortunately Michael doesn't have time at the moment to support the plugin (hence the branch) and the "current release" link is out of date. --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2008/09/28 23:20// 
----- 
- 
-Alignment does not seem to work at all with the latest DW; Anteater. Straight copypasta of the code examples above does nothing to text alignment.  --- [[user>twingate|Thomas Wingate]] //2011/02/14 19:42// 
-==== Vertical alignment ==== 
- 
-Is it possible to vertically-align content in the columns? Any tips please email me :) laurence dot diver at gmail dot com 
---- //[[laurence.diver@gmail.com|Laurence]] 2008/10/30 14:49// 
----- 
- 
-> Please dont just mail him, document it here, I need it too -- //[[dokuwiki@janhoo.de|Jan]] 2009/02/03// 
- 
----- 
- 
-Any suggestions for the syntax? The only thing I could come up with so far is to assume that default is top alignment and then use '-' for middle and '_' for bottom. 
- 
-<code> 
-<columns 100% - -*-* _*-> 
-top-left 
-<newcolumn> 
-middle-center 
-<newcolumn> 
-bottom-right 
-</columns> 
-</code> 
- 
-But this looks too cryptic to me. --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2009/02/06 15:26// 
----- 
- 
-Hello all, I just wanted to let people know that some plugins seems to conflict with the default vertical alignment (top) and cause middle vertical alignment.  Just modify the plugin's CSS (xxxx/lib/plugins/columns/style.css) by doing something like: 
-<code css> 
-div.dokuwiki table.columns-plugin { 
-    border: 0; 
-    border-spacing: 0; 
-    border-collapse: collapse; 
-    margin: 0; 
-    vertical-align: top; /*this is the addition*/ 
-} 
-</code> 
- 
-This also appears to affecting printing, so add this line to print.css in your template's directory: 
-<code css> 
-div.dokuwiki table.columns-plugin td { vertical-align: top;} 
-</code> 
-- //TMedWeb 2009/06/29// 
- 
----- 
- 
-Thanks for the suggestion but it would be great if you could elaborate a bit more. The very next CSS rule forces the alignment: 
- 
-<code css> 
-div.dokuwiki table.columns-plugin td { 
-    vertical-align: top; 
-    padding: 0 0.5em 0 0.5em; 
-} 
-</code> 
- 
-Furthermore, I'm not sure that applying the ''vertical-align'' property to the table rather then to the cells makes much sense. But I'm not that great at CSS, so I could be wrong. Is it some kind of compatibility hack? --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2009/07/26 19:38// 
- 
----- 
- 
-Style sheet for printing is added in version 2009-08-30. --- //[[spambox03@mail.ru|Mykola Ostrovskyy]] 2009/08/30 18:26// 
- 
- 
-==== Basic Columns ==== 
- 
-It works if I put NEWCOL rather than ~~NEWCOL~~ (I got ~~ appearing as text). The default language is pt-br. 
- 
-// Please give me all information from both (the correct and incorrect) variants: What did you put in the configuration dialog? What do you put in the text? Please type the complete line with "$conf['plugin']['columns']['kwnewcol'] = ..." from your conf/local.php; // 
- 
-In the text 
-<code> 
-<columns 100% 50% 15% - > 
-information in column 1 (50% width) 
-NEWCOL 
-information in column 2 (15% width) 
-NEWCOL 
-information in column 3 
-</columns> 
-</code> 
-In the configuration settings, I am going with the default (that is left blank). Check it at [[http://complex.if.uff.br/playground/playground|Playground]]. 
- 
----- 
- 
-The same here - NEWCOL works better - ~~ are not displayed. Language is: pl. The settings are default. 
- 
-//There is a small bug in .../columns/lang/en/lang.php - change line 10 from 'NEWCOL' to '~~NEWCOL~~' \\ 
-Please tell me if the problem is fixed then. You can change it in the preferences too. If you enter ~~NEWCOL~~ it should work, too. \\ 
-After this you must adjust your pages to the new pattern.// 
- 
-> backlinks simply do not work with those links that occur inside a column. The metadata is not updated, the references aren't detected during the rendering, I can't find the way to deal with the problem, did anyone experience this? I am running the latest version of DokuWiki. 
- 
->Found a bug: when putting links to non-existing pages in one of the columns, the link is red ... no problem. But when you now click on it + create the page + go back to the page with the columns ... the link remains red. It only turns into the color of a valid pages //after// editing the page with the columns. I've just tested this on the playground-link provided in the first discussion comment in this page and it's the same there. In other words, not just because of my installation. Is it possible to give this some attention ... I plan on using this plugin heavily. 
- 
-//I don't have any idea to fix this. This maybe a problem because I do not understand all of DokuWiki which I use. Any help is welcome. Michael// 
- 
->> this is just a caching issue and has nothing to do with the column plugin. Of course, the cache of the column page is not changed if a different (the target) page is edited or created 
- 
->>> You'll notice that links on wiki pages are "updated" once a new page was created. To omit that in the column plugin you could use the following in your handler function: <code=php> $renderer->info['cache'] = false; </code> --- //[[chi@chimeric.de|Michael Klier]] 2008/03/13 11:58// 
- 
->>>> Michael, I tried to solve this caching-issue using the way described by you above. Sadly it doesn't work. I tried to add the line in several different ways at several places in the code (although I assume it should be added to the method: <php> function render($mode, &$renderer, $data) </php> //before// the existing code), but nothing works. Can you maybe explain it a bit more or take a look at the code yourself? --- //[[mischa@the-evil.pointclark.net|Mischa The Evil]] 2008/04/16 23:30// 
- 
->>>>> Same problem here. In addition, <nowiki>~~NOCACHE~~</nowiki> at top of the page doesn't help either.[[stinkywinky@gmx.net|StinkyWinky]] 2008/05/20 14:26 
- 
->>>>>> Please publish your code here (or on your own site), that makes it easier and quicker to review your code without having to go to the trouble of installing the plugin. --- //[[chris@jalakai.co.uk|Christopher Smith]] 2008/05/21 11:15// 
- 
->>>>>>> [[#source_code|Here]] is the code ... If possible leave a hint using email... this will improve response time... //[[michael.arlt@sk-schwanstetten.de|Michael Arlt]] 2008/06/10 23:39// 
- 
->>>>>>>> I would really like to use this plugin more but the cache issue and it having problems outputting properly formatted XHTML is worrisome - [[vtingey@msl.ubc.ca|Vince]] 2008/08/21 
- 
- 
-  * The columns plugin is working unstable with [[plugin:indexmenu]]. Apache error_log message is shown as following.  
-<code> 
-[client 220.130.131.238] PHP Fatal error:  Allowed memory size of 16777216 bytes exhausted (tried to allocate 35 bytes) in /var/www/html/dev/inc/parser/parser.php on line 98, referrer: http://www.everplast.net/dev/everplast/reinforcedhose/video?do=edit&rev= 
-</code> 
-After tracing the source code, I guess the error could be from that parser cannot found end tag. Does anyone have workaround solution or patch code? 
- 
- --- //[[tryweb@ichiayi.com|Jonathan Tsai]] 2008/07/11 09:26// 
- 
->This is not an error of DokuWiki or the Columns plugin. It is an error caused by the PHP-configuration. Your PHP-setup is limited to use not more then 16MB of memory. This error shows you that the limit has been reached. 
->See the [[http://nl3.php.net/manual/en/ini.core.php#ini.memory-limit|PHP manual]] for more info about the related configuration-directive (//''memory_limit''//). 
-> --- //[[mischa_the_evil@hotmail.com|Mischa The Evil]] 2008/07/12 05:21// 
- 
->> Actually, the problem is no more appearing after using columns-2008-09-14 branch version. Thanks a lot! 
->> --- //[[tryweb@ichiayi.com|Jonathan Tsai]] 2008/09/14 22:18// 
- 
-In release 2008-09-14 the backlinks works and the caching issue has gone! Many thanks to Mykola Ostrovskyy! [[stinkywinky@gmx.net|StinkyWinky]] 2008/09/19 07:59 
- 
-==== Columns in PDF ==== 
- 
-When using the columns plugin on a page and then exporting the page to pdf, the columns part gets a black line around it. Like a table. 
- 
-I tried to prevent this by adding the css lines to the dw2pdf\user\user.css but it still renders with a black line.. 
- 
-Does anyone know how to solve this? 
- 
- --- [[user>Theo-K]] //2010/09/24 10:36// 
- 
-===== Language Files ===== 
-==== Spanish ==== 
-=== lang.php === 
-<code php> 
-<?php 
-/** 
- * spanish language file 
- * 
- * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html) 
- * @author     Digna Gonzalez Otero <digna.gonzalezotero [at] gmail [dot] com> 
- */ 
- 
-$lang['kwcolumns'] = 'columnas'; // define the wiki syntax keywords 
-$lang['kwnewcol'] =  'NUEVACOLUMNA';  // define the wiki syntax keywords 
- 
-//Setup VIM: ex: et ts=4 enc=utf-8 : 
-?> 
-</code> 
-=== settings.php === 
-<code php> 
-<?php 
-/** 
- * Spanish language file 
- * 
- * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html) 
- * @author     Digna Gonzalez Otero <digna.gonzalezotero [at] gmail [dot] com> 
- */ 
- 
-$lang['css1'] = 'Atributos CSS de la primera columna'; 
-$lang['css2'] = 'Atributos CSS del resto de las columnas'; 
-$lang['css3'] = 'Atributos CSS de la ultima columna'; 
-$lang['kwcolumns'] = 'Patron de reconocimiento de DokuWiki (por defecto: columnas) - Se debe especificar en la pagina wiki con  &lt;palabra&gt;...&lt;/palabra&gt;'; 
-$lang['kwnewcol' = 'Patron de nueva columna de DokuWiki (por defecto: ~~NUEVACOLUMNA~~)'; 
- 
-//Setup VIM: ex: et ts=2 enc=utf-8 : 
-?> 
-</code> 
- 
-===== **Columns isn´t compatible to Rincewind?** ===== 
-Hallo Columns is´t compatible to the new DokuWiki Rincewind, is it correct?  
-Thank you.  
-Best Regards Max 
- 
----- 
- 
-It wasn't verified yet. Do you see some particular issue? --- [[user>pan One|Mykola Ostrovskyy]] //2011/07/27 10:24// 
-\\ 
-\\ 
- 
-===== Columns isn´t compatible to PHP5.4.6? ===== 
- 
-Hi, columns doesn't seem to be compatible to the latest php Version. Is this plugin still maintainedand this will be changed?\\ 
-Thanks you in advance.--- [[egg-stream@gmx.de|Martin]] //2012/09/05//\\ 
- 
----- 
- 
-Fixed in version 2012-09-23. --- [[user>pan One|Mykola Ostrovskyy]] //2012/09/23 22:14// 
- 
-===== Problems with TOC ===== 
- 
-I use this plugin as the beginning of the page as two columns, with a drawing on the first and the title in the second and looks good, but I get TOC over the columns and not on them, which is very ugly, because there is a blank TOC size above the title. How would you fix this problem?. I have the latest update of DokuWiki and Monobook template. R. Serra 2013/06/14 
- 
----- 
- 
-This is a known issue, but my CSS skills are not good enough to fix it properly. For now the only option is ''%%~~NOTOC~~%%''. --- [[user>pan One|Mykola Ostrovskyy]] //2013/06/18 00:14// 
plugin/columns.1426100437.txt.gz · Last modified: 2015-03-11 20:00 by 59.95.121.99

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki