
-----------------------------------------------------------
GridWorks Cookbook/Addon Recipe/Module for PmWiki 2.2.122+
-----------------------------------------------------------

About:
======
General utility css grid markup for wiki pages. 

Features:
=========
1. Allow css grid to be loaded/used from within wiki pages.

Installation:
================================================
HOW TO USE/INSTALL GridWorks v.1.x in PmWiki
================================================
1. a. Download gridworks-latest.tgz and
      place ''gridworks'' folder into cookbook/
   b. Download and extract css grid framwork files
      in path http://your-domain-name/pub/lib/
      Available "css grid framworks" are:
        1. gridworks.960gs.tgz
        2. gridworks.unsemantic.tgz
        3. gridworks.griddle.tgz
        4. gridworks.blueprintcss.tgz
        5. gridworks.purecss.tgz

2. a. Make an entry in your config.php file

    if (file_exists("cookbook/gridworks/gridworks.php")) {
        $EnableGridWorks = 1;
        include_once('cookbook/gridworks/gridworks.php');
    }

2. b. Make an entry in local/config.php file for adapter you wish to use

    if (file_exists("cookbook/gridworks/adapter/adapter.960gs.php")) {
        include_once('cookbook/gridworks/adapter/adapter.960gs.php');
    }
    OR
    if (file_exists("cookbook/gridworks/adapter/adapter.unsemantic.php")) {
        include_once('cookbook/gridworks/adapter/adapter.unsemantic.php');
    }
    OR
    if (file_exists("cookbook/gridworks/adapter/adapter.griddle.php")) {
        include_once('cookbook/gridworks/adapter/adapter.griddle.php');
    }
    OR
    if (file_exists("cookbook/gridworks/adapter/adapter.blueprintcss.php")) {
        include_once('cookbook/gridworks/adapter/adapter.blueprintcss.php');
    }
    OR
    if (file_exists("cookbook/gridworks/adapter/adapter.purecss.php")) {
        include_once('cookbook/gridworks/adapter/adapter.purecss.php');
    }

3. Options for directives.

(:grid columns=12 gutter=10 fluid=0 resetcss='reset,text' loadmethod=js :)

  3.1. columns=12|16|24 (default = 16) (960gs, blueprintcss)

  3.2. gutter=10|20 (default = 20) (960gs, blueprintcss)

  3.3. fluid=0|1 (960gs)
        Fluid set to '1' loads only one stylesheet for given columns.
        (i.e. percentage based)

  3.4. resetcss='main,text,all,normalize'
        Loads extra css files.
        reset.css and text.css (960gs, unsemantic, purecss)
        normalize.css (griddle)

  3.5. loadmethod=js|mq|mqcombo
        Method of loading css, i.e Javascript(AdaptJs) or MediaQueries.
        js - (960gs, unsemantic, blueprintcss)
        mq - (960gs, griddle, blueprintcss)
        mqcombo - for unsemantic, griddle, purecss.

  3.6. tablet=0|1 (unsemantic)
        For adapter unsemantic, it loads grid css for tablets.

  3.7. rtl=0|1 (unsemantic)
        Loads Left-to-right config/orientation files.

  3.8. loadcss=all (blueprintcss)
        blueprintcss: forms,grid,print,reset,screen,typography,all,noprint
        Loads various css files.

  3.9. iecompat=0|1 (blueprintcss)
        Loads IE compat/related files.


/* USAGE
///////////////////////////////////////////////////

(:grid columns=12 gutter=10 fluid=0 resetcss='reset,text' loadmethod=js :)

///////////////////////////////////////////////////


Upcoming implementations:
-------------------------
https://www.w3.org/TR/css-grid-1/
https://www.w3.org/TR/css-line-grid-1/
https://www.w3.org/TR/css-grid-2/
https://www.w3.org/TR/mediaqueries-3/   (now a TR)
https://www.w3.org/TR/mediaqueries-4/
https://www.w3.org/TR/mediaqueries-5/
https://www.w3.org/TR/css-flexbox-1/
https://www.w3.org/TR/css-multicol-1/


