Merge pull request silverstripe#76 from robert-h-curry/3.1-docs

Add markdown version of docs, upgrade docs to 3.1

docs/en/index.md

@@ -0,0 +1,10 @@
+# Subsites
+
+The SilverStripe subsites module allows you to manage multiple related sites through a single CMS interface. Because
+all sites run on a single installation of SilverStripe, they can share users, content and assets. They can all use the
+same templates, or each use different ones.
+
+This document assumes that you have full admin rights for your site.
+
+ 1. [Setting up subsites](set_up)
+ 1. [Working with subsites](working)

docs/en/set_up.md

@@ -0,0 +1,76 @@
+# Setting up
+
+## Creating subsites
+
+To view, edit and create subsites, go to the *Subsite* section of the CMS. Click *Search* to view a list of all
+existing subsites.
+
+![View subsites](_images/view-subsites.jpg)
+
+Click on a subsite name to edit its details. Click the red X to delete a subsite (you will be asked for confirmation.)
+To create a new subsite, click *Add Subsite*. This opens the *Subsite configuration* subsection.
+
+![Subsite configuration](_images/subsite-configuration.jpg)
+
+You can configure the following details for a subsite:
+
+ * *Name of subsite:* This is the display name for the site in the CMS (not public-facing)
+ * *Domains for this subsite:* Lets you add one or more domains for this subsite, e.g., subsite.co.nz, subsite.org.nz,
+subsite.com
+ * *Language:* Sets the language for the subsite. This affects the spellchecker (not the CMS interface language)
+ * *Default site:* If your site is accessed by a domain not listed in any subsites, this subsite is shown as default.
+ * *Enable public access:* Enables/disables the subsite. Corresponds to the *Active Subsite* column.
+ * *Theme:* Shows the list of available themes that exist in the themes directory. The subsite will use the templates
+and styles from the selected theme.
+ * *Disallow page types:* Lets you mark some page types to prevent being used within this subsite.
+ * *Copy structure from:* Gives you the option to select an existing subsite from which to copy pages and files (see
+ "Copying subsites" for more information about this)
+
+## Roles
+
+When creating roles, you can assign the following subsite-specific permissions:
+
+ * *Access to 'Subsites' section:* Shows the *Subsite* section in the CMS, allowing you to manage subsites for your
+site (ie, create, edit, view.)
+ * *Manage subsites for groups:* Ability to limit the permissions for a group to one or more subsites.
+ * *Manage assets for subsites:* Ability to select the subsite to which an asset folder belongs (also requires access to
+*Files* section)
+
+## Groups
+
+Groups can have access to all sites, or to one or more specific subsites. If you have different staff in charge of each
+subsite, you probably want to create a separate group for each subsite.
+
+The dropdown in the upper left corner of the CMS indicates which subsite you are currently on. While you are in the
+Security section of the CMS, the selection in the subsites dropdown defines what groups you see in the left-hand pane.
+
+![Group subsites dropdown](_images/group-subsites-dropdown.jpg)
+
+The choices are:
+
+ * Groups accessing all sites
+ * [your main site]
+ * [a specific subsite]
+ * All groups - i.e., all above combined
+
+Once you make a selection from the dropdown, you see the appropriate groups in the *Security* section. In the Security
+section, click a group and go to its *Subsites* tab to assign the subsites to which the group has access. Click *Only
+these subsites* to reveal a checklist of all available sites.
+
+![Group subsites access](_images/group-subsites-access.jpg)
+
+## Copying subsites
+Duplicating subsites can be useful if you want to create several subsites based on the same general site structure. You
+can set up a collection of pages, files, and images and use it as a template. When you create a new subsite, instead of
+starting from scratch you can copy it all from your existing subsite. This will copy all pages, files and images from
+that subsite into your new subsite.
+
+To create a new subsite template, create a new subsite described above under "Creating subsites" but don't add any
+domains. Add a name that will make it easy to see that it is a template. Select the new template from the subsites
+dropdown in the upper right and create the pages and add the files and images you'd like to become part of the
+template.
+
+When you create a new subsite, you can now choose to Copy structure from your template. All your pages, files and
+images will be copied over to your new subsite.
+
+![Group subsites dropdown](_images/copy-structure.jpg)

docs/en/working.md

@@ -0,0 +1,17 @@
+# Working with subsites
+
+## Managing content across subsites
+
+When you are in the *Pages* or *Files* sections of the CMS, select a subsite from the dropdown in the upper left to
+display the content for that site in the site tree.
+
+![Subsites dropdown](_images/subsites-dropdown.jpg)
+
+## Subsites virtual pages
+
+You can pull in the content from a page that resides on another subsite by creating a page of the type **Subsites
+Virtual Page**. Pick the subsite from which you want to pull the content, then select the page. As with regular virtual
+pages, your **Subsites Virtual Page** will display the content from the original page and get updated automatically if
+the original content changes.
+
+![Subsites virtual page](_images/subsites-virtual-page.jpg)