Fixed H2s on doc page

Author: dantleech

documentation/index.md

@@ -2,20 +2,20 @@
 layout: default
 title: Documentation
 ---
-### Tutorials
+## Tutorials
 
 - [The Book](http://phpcr.readthedocs.org/en/latest/)
 - [Integrating with Symfony](/documentation/tutorial/integrating_with_symfony.html)
 
-### Reference
+## Reference
 
 - [API Reference](/doc/html/index.html)
 
-### Slides
+## Slides
 
 - [PHPCR Introduction by David Buchmann and Lukas Smith](/slides.html)
 - [PHPCR, Une Introduction by Daniel Leech (in French)](http://phpcrtalk.dantleech.com)
 
-### Other
+## Other
 
 - [PHPCR Shell](/documentation/phpcr-shell)

documentation/reference/jcr-sql2.md

@@ -0,0 +1,44 @@
+---
+layout: default
+title: JCR-SQL2 Reference
+---
+JCR-SQL2 is a query language similar to SQL which is used by JCR and thus also PHPCR.
+
+Some things to note:
+
+- Unlike most other SQL dialects, JCR-SQL2 only supports SELECT statements.
+- JCR-SQL2 selects from *node types* not *tables*.
+- `LIMIT BY` and `OFFSET` are not supported.
+- Namespaced node types should always be surrounded by square brackets (`[` and `]`).
+
+In the following examples I will use the PHPCR shell to execute the queries.
+
+## Basics
+
+The basic query grammer is defined as:
+
+    Query ::= 'SELECT' columns
+
+    'FROM' Source
+
+    ['WHERE' Constraint]
+
+    ['ORDER BY' orderings]
+
+This should be familiar to anybody with a background in SQL.
+
+So `WHERE` and `ORDER BY` are optional, and `SELECT` and `FROM` are mandatory.
+
+- `columns` can either be a wildcard (e.g. `*` or `selector.*`) or a list of column names
+or both.
+- `source` can be a simple node type name, or a join source.
+- `where` is a list of criteria for selecting the records
+- `order by` determines which fields will be used to order the result set and in which direction.
+
+The following are valid statements
+
+{% highlight sql %}
+SELECT title FROM [myCms:article];
+SELECT * FROM [myCms:article] ORDER BY title
+SELECT a.* FROM [myCms:article] AS a;
+{% endhighlight %}

documentation/tutorial/bootstrapping.rst

@@ -0,0 +1,46 @@
+Bootstrapping
+=============
+
+You will need to make sure your php classes are available. Usually this means activating an autoloader. For a standalone project, just use the file generated by composer at vendor/.composer/autoload.php
+PHPCR and Jackalope follow the PSR-0 standard. If you want your own autoloading, use a PSR-0 compatible autoloader and configure it to find the code folder.
+
+Once you have autoloading set up, bootstrap jackalope-jackrabbit like this:
+
+.. code-block:: php
+
+    <?php
+    require("vendor/autoload.php");
+
+    // factory (the *only* implementation specific part)
+    $factoryclass = '\Jackalope\RepositoryFactoryJackrabbit';
+    // the parameters would typically live in a configuration file
+    // see your implementation for required and optional parameters
+    $parameters = array('jackalope.jackrabbit_uri' => 'http://localhost:8080/server');
+
+    // end of implementation specific configuration
+    // from here on, the whole code does not need to be changed when using different implementations
+
+    $factory = new $factoryclass();
+    $repository = $factory->getRepository($parameters);
+    if (null === $repository) {
+        var_dump($parameters);
+        die('There where missing parameters, the factory could not create a repository');
+    }
+
+    // the login parameters would typically live in a configuration file
+
+    $workspacename = 'default';
+    $user = 'admin';
+    $pass = 'admin';
+
+    // create credentials and log in to get a session
+    $credentials = new \PHPCR\SimpleCredentials($user, $pass);
+    try {
+        $session = $repository->login($credentials, $workspacename);
+    } catch(\PHPCR\LoginException $e) {
+        die('Invalid credentials: '.$e->getMessage());
+    } catch(\PHPCR\NoSuchWorkspaceException $e) {
+        die("No workspace $workspacename: ".$e->getMessage());
+    }
+
+    // if we get here, we have a session object that can be used to read and write the repository

documentation/tutorial/importing_data.rst

@@ -0,0 +1,17 @@
+
+The Book
+========
+
+.. toctree::
+    :hidden:
+
+    database_layer
+    installation
+    routing
+    simplecms
+    static_content
+    structuring_content
+    handling_multilang
+
+.. include:: map.rst.inc
+