Documentation updates

Author: ivanlanin

README.md

@@ -0,0 +1,103 @@
+.. _containers:
+
+Containers
+==========
+
+Sections
+--------
+
+Every visible element in word is placed inside of a section. To create a
+section, use the following code:
+
+.. code:: php
+
+    $section = $phpWord->createSection($sectionSettings);
+
+The ``$sectionSettings`` is an optional associative array that sets the
+section. Example:
+
+.. code:: php
+
+    $sectionSettings = array(
+        'orientation' => 'landscape',
+        'marginTop' => 600,
+        'colsNum' => 2,
+    );
+
+Section settings
+~~~~~~~~~~~~~~~~
+
+Below are the available settings for section:
+
+-  ``orientation`` Page orientation, i.e. ‘portrait’ (default) or
+   ‘landscape’
+-  ``marginTop`` Page margin top in twips
+-  ``marginLeft`` Page margin left in twips
+-  ``marginRight`` Page margin right in twips
+-  ``marginBottom`` Page margin bottom in twips
+-  ``borderTopSize`` Border top size in twips
+-  ``borderTopColor`` Border top color
+-  ``borderLeftSize`` Border left size in twips
+-  ``borderLeftColor`` Border left color
+-  ``borderRightSize`` Border right size in twips
+-  ``borderRightColor`` Border right color
+-  ``borderBottomSize`` Border bottom size in twips
+-  ``borderBottomColor`` Border bottom color
+-  ``headerHeight`` Spacing to top of header
+-  ``footerHeight`` Spacing to bottom of footer
+-  ``colsNum`` Number of columns
+-  ``colsSpace`` Spacing between columns
+-  ``breakType`` Section break type (nextPage, nextColumn, continuous,
+   evenPage, oddPage)
+
+The following two settings are automatically set by the use of the
+``orientation`` setting. You can alter them but that’s not recommended.
+
+-  ``pageSizeW`` Page width in twips
+-  ``pageSizeH`` Page height in twips
+
+Section page numbering
+~~~~~~~~~~~~~~~~~~~~~~
+
+You can change a section page numbering.
+
+.. code:: php
+
+    $section = $phpWord->createSection();
+    $section->getSettings()->setPageNumberingStart(1);
+
+Headers
+-------
+
+Each section can have its own header reference. To create a header use
+the ``createHeader`` method:
+
+.. code:: php
+
+    $header = $section->createHeader();
+
+Be sure to save the result in a local object. You can use all elements
+that are available for the footer. See “Footer” section for detail.
+Additionally, only inside of the header reference you can add watermarks
+or background pictures. See “Watermarks” section.
+
+Footers
+-------
+
+Each section can have its own footer reference. To create a footer, use
+the ``createFooter`` method:
+
+.. code:: php
+
+    $footer = $section->createFooter();
+
+Be sure to save the result in a local object to add elements to a
+footer. You can add the following elements to footers:
+
+-  Texts ``addText`` and ``createTextrun``
+-  Text breaks
+-  Images
+-  Tables
+-  Preserve text
+
+See the “Elements” section for the detail of each elements.