====== Table Width Plugin ======

---- plugin ----
description: Allows to specify width of table columns
author     : Mykola Ostrovskyy
email      : dwpforge@gmail.com
type       : syntax
lastupdate : 2022-08-09
compatible : Frusterick Manners, Greebo, Hogfather, Igor, Jack Jackrum
depends    : 
conflicts  : 
similar    : tablelayout, wrap
tags       : tables
downloadurl: https://github.com/dwp-forge/tablewidth/archive/refs/tags/v.2022-08-09.zip
bugtracker : https://github.com/dwp-forge/tablewidth/issues
sourcerepo : https://github.com/dwp-forge/tablewidth
----

The plugin allows to specify width for a DokuWiki table and its columns. This is a simple extension to the original table syntax, not a [[plugin:exttab1|full-fledged rework of the syntax]].

===== Download and Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Syntax =====

The width has to be specified at the start of a line before the table. The first value is used as width of the table, the rest is for columns. If you want to omit some value use a dash instead. The widths can be specified in any CSS units:

<code>
|< 100% 50px - 5em 10em 10% >|
^ A  ^  B  ^  C  ^  D  ^  E  ^
| 1  |  2  |  3  |  4  |  5  |
</code>

The relative units (percentage) for the table width refer to the width of the page, and when used for columns they refer for the table width. For example, the width specification ''|< 50% 50% 50% >|'' makes the table half width of the page and two equal columns quarter of the page width each.

If there are more columns in the table than there are values in the width specification, the width will be applied to the columns from left to right:

<code>
|< 50em 20% >|
^ 20%              ^ 80%                          ^
| Specified width  | The rest of the table width  |
</code>


===== Version History =====

=== 2022-08-09 ===

  * Fixed PHP 8 compatibility


=== 2016-10-13 ===

  * Allow table width less than 50% on the default template


=== 2016-02-27 ===

  * Fixed PHP 7 compatibility


=== 2013-12-03 ===

  * Fixed compatibility issue with DokuWiki Binky release


=== 2010-11-18 ===

  * Fixed compatibility issue with DokuWiki 2010-11-07


=== 2009-02-14 ===

  * First public release


===== Bugs and Feature Requests =====

Please report bugs or feature requests at the [[https://github.com/dwp-forge/tablewidth/issues|bug tracker]].