.. include:: /Includes.rst.txt

..  _tables-directive:

===============
Table directive
===============

.. contents::

Table with caption and column width
===================================

..  table:: Example Table
    :widths: 30, 70
    :width: 100%
    :caption: My table caption

    +--------------+--------------+
    | Data 1       | Data 2       |
    +==============+==============+
    | Row 1, Col 1 | Row 1, Col 2 |
    +--------------+--------------+
    | Row 2, Col 1 | Row 2, Col 2 |
    +--------------+--------------+

Large, complex table, break-none
================================


..  table:: Example Table
    :width: 100%
    :caption: My table caption
    :break: none

    +----------+------------+----------+-----+------+----------------------+--------------------+----------------+----------------+-------+------------------+----------------+----------------+------------------------+
    | https:// | subdomain. | example. | com | :80  | /en                  | /about-us/our-team | /john-doe      | /publications/ | index | .xhtml           | ?utm_campaign= | seo            | #start                 |
    +==========+============+==========+=====+======+======================+====================+================+================+=======+==================+================+================+========================+
    | Protocol | Subdomain  | Domain   | TLD | Port | Site Language Prefix | Slug               | Enhanced Route                                             |                |                |                        |
    +----------+------------+----------+-----+------+----------------------+--------------------+-----------------------------------------+------------------+----------------+----------------+------------------------+
    |          | Hostname                    |      |                      |                    | Route Enhancer                          | Route Decorator  | Query string   | argument value | Location Hash / Anchor |
    +----------+-----------------------------+------+----------------------+--------------------+-----------------------------------------+------------------+----------------+----------------+------------------------+
    |                                               |  Route / Permalink                                                                                     |                                                          |
    +-----------------------------------------------+--------------------------------------------------------------------------------------------------------+----------------+----------------+------------------------+
    | URL (no arguments, unlike the URI)                                                                                                                     |                |                |                        |
    +--------------------------------------------------------------------------------------------------------------------------------------------------------+----------------+----------------+------------------------+
    | URI (everything)                                                                                                                                                                                                  |
    +-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+


Large, complex table, break-line (default)
==========================================

..  table:: Example Table
    :width: 100%
    :caption: My table caption

    +----------+------------+----------+-----+------+----------------------+--------------------+----------------+----------------+-------+------------------+----------------+----------------+------------------------+
    | https:// | subdomain. | example. | com | :80  | /en                  | /about-us/our-team | /john-doe      | /publications/ | index | .xhtml           | ?utm_campaign= | seo            | #start                 |
    +==========+============+==========+=====+======+======================+====================+================+================+=======+==================+================+================+========================+
    | Protocol | Subdomain  | Domain   | TLD | Port | Site Language Prefix | Slug               | Enhanced Route                                             |                |                |                        |
    +----------+------------+----------+-----+------+----------------------+--------------------+-----------------------------------------+------------------+----------------+----------------+------------------------+
    |          | Hostname                    |      |                      |                    | Route Enhancer                          | Route Decorator  | Query string   | argument value | Location Hash / Anchor |
    +----------+-----------------------------+------+----------------------+--------------------+-----------------------------------------+------------------+----------------+----------------+------------------------+
    |                                               |  Route / Permalink                                                                                     |                                                          |
    +-----------------------------------------------+--------------------------------------------------------------------------------------------------------+----------------+----------------+------------------------+
    | URL (no arguments, unlike the URI)                                                                                                                     |                |                |                        |
    +--------------------------------------------------------------------------------------------------------------------------------------------------------+----------------+----------------+------------------------+
    | URI (everything)                                                                                                                                                                                                  |
    +-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+



Large, complex table, break-word
================================


..  table:: Example Table
    :width: 100%
    :caption: My table caption
    :break: word

    +----------+------------+----------+-----+------+----------------------+--------------------+----------------+----------------+-------+------------------+----------------+----------------+------------------------+
    | https:// | subdomain. | example. | com | :80  | /en                  | /about-us/our-team | /john-doe      | /publications/ | index | .xhtml           | ?utm_campaign= | seo            | #start                 |
    +==========+============+==========+=====+======+======================+====================+================+================+=======+==================+================+================+========================+
    | Protocol | Subdomain  | Domain   | TLD | Port | Site Language Prefix | Slug               | Enhanced Route                                             |                |                |                        |
    +----------+------------+----------+-----+------+----------------------+--------------------+-----------------------------------------+------------------+----------------+----------------+------------------------+
    |          | Hostname                    |      |                      |                    | Route Enhancer                          | Route Decorator  | Query string   | argument value | Location Hash / Anchor |
    +----------+-----------------------------+------+----------------------+--------------------+-----------------------------------------+------------------+----------------+----------------+------------------------+
    |                                               |  Route / Permalink                                                                                     |                                                          |
    +-----------------------------------------------+--------------------------------------------------------------------------------------------------------+----------------+----------------+------------------------+
    | URL (no arguments, unlike the URI)                                                                                                                     |                |                |                        |
    +--------------------------------------------------------------------------------------------------------------------------------------------------------+----------------+----------------+------------------------+
    | URI (everything)                                                                                                                                                                                                  |
    +-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+