first import

sites/all/modules/context/context_layouts/README.txt

@@ -0,0 +1,85 @@
+
+Context layouts
+---------------
+Context layouts provides a formalized way for themes to declare and switch
+between page templates using Context. It is a continuation of an old Drupal
+themer's trick to switch to something besides the standard `page.tpl.php` file
+for a variety of special-case pages like the site frontpage, login page, admin
+section, etc.
+
+
+Requirements
+------------
+In order to use context layouts, your site must meet a few conditions:
+
+- Context and Context layouts modules are enabled (`admin/modules`).
+- You are using a theme which provides and has declared multiple layouts. (See
+  "Example themes" for themes you can try.)
+
+
+Basic usage
+-----------
+Once you have layouts enabled, you can have a context trigger the usage of a
+particular layout in either the admin interface (`admin/structure/context`) or
+inline context editor. Different layouts may have fewer or greater regions than
+the default page template, so adjust your blocks accordingly.
+
+
+Supporting context layouts in your theme
+----------------------------------------
+You can add layouts support to your theme by declaring additional layouts in
+your theme's info file. Here is an example:
+
+`example.info`
+
+    name = "Example"
+    description = "Example theme"
+    core = "6.x"
+    engine = "phptemplate"
+
+    regions[left] = "Left sidebar"
+    regions[right] = "Right sidebar"
+    regions[content] = "Content"
+    regions[footer] = "Footer"
+
+    ; Layout: Default
+    layouts[default][name] = "Default"
+    layouts[default][description] = "Simple two column page."
+    layouts[default][template] = "page"
+    layouts[default][regions][] = "content"
+    layouts[default][regions][] = "right"
+
+    ; Layout: Columns
+    layouts[columns][name] = "3 columns"
+    layouts[columns][description] = "Three column page."
+    layouts[columns][stylesheet] = "layout-columns.css"
+    layouts[columns][template] = "layout-columns"
+    layouts[columns][regions][] = "left"
+    layouts[columns][regions][] = "content"
+    layouts[columns][regions][] = "right"
+    layouts[columns][regions][] = "footer"
+
+Each layout is declared under `layouts` with the key as the identifier that will
+be used by context for this layout. You may use any reasonable machine name for
+each layout, but note that `default` is special -- it will be the default layout
+for your theme if no other layout is specified.
+
+The following keys can be declared for each layout:
+
+- `name`: The human readable name for this layout, shown in the admin UI.
+- `description`: A short description of your layout, same as above.
+- `stylesheet`: A stylesheet to be included with the layout. Optional.
+- `template`: The name of the template file for this layout, without the
+  `.tpl.php` extension.
+- `region`: An array of regions supported by this layout. Note that any of the
+  regions listed here **must also be declared** in the standard theme `regions`
+  array.
+
+
+Example themes
+--------------
+- Cube, a subtheme included with [Rubik][1] provides a variety of layouts.
+- [Ginkgo][2] the default theme included with Open Atrium.
+
+[1]: http://github.com/developmentseed/rubik/downloads
+[2]: http://github.com/developmentseed/ginkgo/downloads