History: Making columns for wiki content
Source of version: 30 (current)
Copy to clipboard
{maketoc}
!Bootstrap grid in Tiki13
From Tiki 13 we use the responsive Bootstrap CSS Framework to determine the layout of Tiki.
The floated box method previously described here has been made obsolete by the switch to Bootstrap CSS grid compatibility. How to have columns in wiki content using the new Bootstrap method is described below. To see the previous Tiki floating box method, check the page history for earlier versions of the page content.
The method described here uses the Bootstrap layout method without any "shortcuts". It may not be possible - or practical - to duplicate the compactness of the old floating box syntax, but that hasn't really been experimented with yet.
As in Bootstrap the full width of a div is a part of 12 gutters, a number of 1 to 12 elements can be put besides each other, each in a div, using the column classes of Bootstrap. The column classes determine the relative with of the elements and the "breakpoints" based on device width (@media queries), when the elements get vertically stacked (mobile device, tablet, smartphone or shrinking the browser width).
__Some examples:__
Please mind, that adding the width parts of the class name (the number) must give 12 when added (6+6 or 4+4+4 or 2+2+2+6 or 3+4+3+2 etc.)
The ~np~{DIV(class=row)}~/np~ wraps together the 12-gutter side by side elements and "clearfixes" the content to the following part of the page (or custom module or template, if used with html -> div class="row").
"content" refers to arbitrary elements like text, modules, wikiplugins ...
3 Elements equal width (three times -4), 'side by side' - switching to 'vertically stacked' at lower than medium (-md-) with:
{CODE()}
{DIV(class=row)}
{DIV(class=col-md-4)}content{DIV}
{DIV(class=col-md-4)}content{DIV}
{DIV(class=col-md-4)}content{DIV}
{DIV}
{CODE}
2 Elements equal width (twice -6), 'side by side' - switching to 'vertically stacked' at lower than large (-lg-) with:
{CODE()}
{DIV(class=row)}
{DIV(class=col-lg-6)}content{DIV}
{DIV(class=col-lg-6)}content{DIV}
{DIV}
{CODE}
4 Elements different width, 'side by side' - switching to 'vertically stacked' at lower than small (-sm-) with:
{CODE()}
{DIV(class=row)}
{DIV(class=col-sm-3)}content{DIV}
{DIV(class=col-sm-3)}content{DIV}
{DIV(class=col-sm-2)}content{DIV}
{DIV(class=col-sm-4)}content{DIV}
{DIV}
{CODE}
! Examples
!! Two columns
{DIV(class="row")}{DIV(class="col-md-6")}{MODULE(module=random_pages)/}{DIV}{DIV(class="col-md-6")}{MODULE(module=random_pages)/}{DIV}{DIV}
is produced by:
{CODE(wrap="1")}{DIV(class="row")}{DIV(class="col-md-6")}{MODULE(module=random_pages)/}{DIV}{DIV(class="col-md-6")}{MODULE(module=random_pages)/}{DIV}{DIV}{CODE}
!! Three columns
{DIV(class="row")}{DIV(class="col-md-4")}{MODULE(module=random_pages)/}{DIV}{DIV(class="col-md-4")}{MODULE(module=random_pages)/}{DIV}{DIV(class="col-md-4")}{MODULE(module=random_pages)/}{DIV}{DIV}
produced by
{CODE(wrap="1")}{DIV(class="row")}{DIV(class="col-md-4")}{MODULE(module=random_pages)/}{DIV}{DIV(class="col-md-4")}{MODULE(module=random_pages)/}{DIV}{DIV(class="col-md-4")}{MODULE(module=random_pages)/}{DIV}{DIV}{CODE}
and
!! Four columns
{DIV(class="row")}{DIV(class="col-md-3")}{MODULE(module=random_pages)/}{DIV}{DIV(class="col-md-3")}{MODULE(module=random_pages)/}{DIV}{DIV(class="col-md-3")}{MODULE(module=random_pages)/}{DIV}{DIV(class="col-md-3")}{MODULE(module=random_pages)/}{DIV}{DIV}
produced by
{CODE(wrap="1")}{DIV(class="row")}{DIV(class="col-md-3")}{MODULE(module=random_pages)/}{DIV}{DIV(class="col-md-3")}{MODULE(module=random_pages)/}{DIV}{DIV(class="col-md-3")}{MODULE(module=random_pages)/}{DIV}{DIV(class="col-md-3")}{MODULE(module=random_pages)/}{DIV}{DIV}{CODE}
Boxes can have any content, not just a module, like this :
{DIV(class="row")}{DIV(class="col-md-6")}{DIV(class="panel panel-default panel-body")}Lorem Ipsum is slechts een proeftekst uit het drukkerij- en zetterijwezen. Lorem Ipsum is de standaard proeftekst in deze bedrijfstak sinds de 16e eeuw, toen een onbekende drukker een zethaak met letters nam en ze door elkaar husselde om een font-catalogus te maken. Het heeft niet alleen vijf eeuwen overleefd maar is ook, vrijwel onveranderd, overgenomen in elektronische letterzetting. Het is in de jaren '60 populair geworden met de introductie van Letraset vellen met Lorem Ipsum passages en meer recentelijk door desktop publishing software zoals Aldus PageMaker die versies van Lorem Ipsum bevatten.{DIV}{DIV}{DIV(class="col-md-6")}{DIV(class="panel panel-default panel-body")}Lorem Ipsum é um texto modelo da indústria tipográfica e de impressão. O Lorem Ipsum tem vindo a ser o texto padrão usado por estas indústrias desde o ano de 1500, quando uma misturou os caracteres de um texto para criar um espécime de livro. Este texto não só sobreviveu 5 séculos, mas também o salto para a tipografia electrónica, mantendo-se essencialmente inalterada. Foi popularizada nos anos 60 com a disponibilização das folhas de Letraset, que continham passagens com Lorem Ipsum, e mais recentemente com os programas de publicação como o Aldus PageMaker que incluem versões do Lorem Ipsum.{DIV}{DIV}{DIV}
produced by:
{CODE(wrap="1")}{DIV(class="row")}{DIV(class="col-md-6")}{DIV(class="panel panel-default panel-body")}Lorem Ipsum is slechts een proeftekst uit het drukkerij- en zetterijwezen. Lorem Ipsum is de standaard proeftekst in deze bedrijfstak sinds de 16e eeuw, toen een onbekende drukker een zethaak met letters nam en ze door elkaar husselde om een font-catalogus te maken. Het heeft niet alleen vijf eeuwen overleefd maar is ook, vrijwel onveranderd, overgenomen in elektronische letterzetting. Het is in de jaren '60 populair geworden met de introductie van Letraset vellen met Lorem Ipsum passages en meer recentelijk door desktop publishing software zoals Aldus PageMaker die versies van Lorem Ipsum bevatten.{DIV}{DIV}{DIV(class="col-md-6")}{DIV(class="panel panel-default panel-body")}Lorem Ipsum é um texto modelo da indústria tipográfica e de impressão. O Lorem Ipsum tem vindo a ser o texto padrão usado por estas indústrias desde o ano de 1500, quando uma misturou os caracteres de um texto para criar um espécime de livro. Este texto não só sobreviveu 5 séculos, mas também o salto para a tipografia electrónica, mantendo-se essencialmente inalterada. Foi popularizada nos anos 60 com a disponibilização das folhas de Letraset, que continham passagens com Lorem Ipsum, e mais recentemente com os programas de publicação como o Aldus PageMaker que incluem versões do Lorem Ipsum.{DIV}{DIV}{DIV}{CODE}
!! Mix of modules and other divs
{DIV(class="row")}{DIV(class="col-md-6")}
!! Lorem Ipsum
Lorem Ipsum is slechts een proeftekst uit het drukkerij- en zetterijwezen. Lorem Ipsum is de standaard proeftekst in deze bedrijfstak sinds de 16e eeuw, toen een onbekende drukker een zethaak met letters nam en ze door elkaar husselde om een font-catalogus te maken.{DIV}{DIV(class="col-md-6")}
{MODULE(module=random_pages)/}{DIV}{DIV}
produced by
{CODE(wrap="1")}{DIV(class="row")}{DIV(class="col-md-6")}
!! Lorem Ipsum
Lorem Ipsum is slechts een proeftekst uit het drukkerij- en zetterijwezen. Lorem Ipsum is de standaard proeftekst in deze bedrijfstak sinds de 16e eeuw, toen een onbekende drukker een zethaak met letters nam en ze door elkaar husselde om een font-catalogus te maken.{DIV}{DIV(class="col-md-6")}
{MODULE(module=random_pages)/}{DIV}{DIV}{CODE}
! Tiki 12
The Bootstrap grid layout can work as well in Tiki 12 if the grid CSS rules are gotten from bootstrap.css (available at [http://getbootstrap.com]) and put in a theme stylesheet or separate CSS file that's imported by the theme stylesheet. There's no need to use other files such as Javascript files simply to have the grid layout.
In Tiki 12, you may also be able to use a Tiki 13 version of templates/layouts/.../layout_view.tpl, to have the grid rules applied to the module zones and left, right and main columns of the page.