From ba039426031b3553ea58c8aefa55068d8b332004 Mon Sep 17 00:00:00 2001
From: damjan <damjan@sgalinski.de>
Date: Tue, 1 Sep 2015 17:41:25 +0200
Subject: [PATCH] [TASK] Writing the documentation

---
 README.md | 113 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 113 insertions(+)
 create mode 100755 README.md

diff --git a/README.md b/README.md
new file mode 100755
index 0000000..86cd13b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,113 @@
+SGalinski.TypoScriptReferenceFrontend
+
+## Setup Notes
+
+### Prerequisite
+
+SGalinski.TypoScriptReferenceFrontend is Flow package, so you need first a flow project:
+
+Use `composer create-project --dev --keep-vcs typo3/flow-base-distribution ProjectName`
+You can use any project name you wish. If you already have Flow project, you can skip this step.
+
+### Install
+
+The project can be installed by composer, or downloaded from git:
+ 
+#### A) Install by composer
+
+Change into `ProjectName` directory
+
+  TODO: Setup composer.json to install from git repository
+  
+Use `composer require ...` and `composer update` to install the package.
+
+#### B) Download from git
+
+  cd Packages/Application
+  git clone git@gitlab.sgalinski.de:typo3/TypoScript-Forger.git SGalinski.TypoScriptReferenceFrontend
+  cd typo_script_backend
+
+### Supply the necessary routes
+
+Edit Routes.yaml of your project (`ProjectName/Configuration/Routes.yaml`)
+
+#### If you are using WMDB.Forger package in same project
+
+It is important to include SGalinski.TypoScriptReferenceFrontend subRoutes before WMDB.ForgerSubroutes to avoid
+route conflicts. 
+The prefix 'ts' in uriPattern: 'ts/<SGalinski.TypoScriptReferenceFrontend>' has purpose to avoid the conflict.
+
+<pre>
+-
+  name: 'TypoScriptReferenceFrontend'
+  uriPattern: 'ts/<SGalinski.TypoScriptReferenceFrontend>'
+  subRoutes:
+    SGalinski.TypoScriptReferenceFrontend:
+      package: SGalinski.TypoScriptReferenceFrontend
+
+-
+  name: 'Forger'
+  uriPattern: '<WMDB.ForgerSubroutes>'
+  subRoutes:
+    WMDB.ForgerSubroutes:
+      package: WMDB.Forger
+
+##
+# Flow subroutes
+#
+
+-
+  name: 'Flow'
+  uriPattern: '<FlowSubroutes>'
+  defaults:
+    '@format': 'html'
+  subRoutes:
+    FlowSubroutes:
+      package: TYPO3.Flow
+</pre>
+
+#### In empty project Routes.yaml looks like this
+
+Uri prefix can be added if needed.
+
+<pre>
+-
+  name: 'TypoScriptReferenceFrontend'
+  uriPattern: '<SGalinski.TypoScriptReferenceFrontend>'
+  subRoutes:
+    SGalinski.TypoScriptReferenceFrontend:
+      package: SGalinski.TypoScriptReferenceFrontend
+
+##
+# Flow subroutes
+#
+
+-
+  name: 'Flow'
+  uriPattern: '<FlowSubroutes>'
+  defaults:
+    '@format': 'html'
+  subRoutes:
+    FlowSubroutes:
+      package: TYPO3.Flow
+</pre>
+
+### Configure view
+
+To be able to integrate SGalinski.TypoScriptReferenceFrontend package with other packages 
+(for example to use existing menu from other package), view configuration in main project is needed.
+
+Here is view configuration for integration with WMDB.Forger package.
+
+ProjectName/Configuration/Views.yaml:
+
+  -
+    options:
+      layoutRootPaths:
+        'WMDB.Forger/Layouts': 'resource://WMDB.Forger/Private/Layouts'
+      partialRootPaths:
+        'WMDB.Forger/Partials': 'resource://WMDB.Forger/Private/Partials'
+        'SGalinski.TypoScriptReferenceFrontend/Partials': 'resource://SGalinski.TypoScriptReferenceFrontend/Private/Partials'
+  #    templateRootPaths:
+  #      'WMDB.Forger/Templates': 'resource://WMDB.Forger/Private/Templates'
+  #      'SGalinski.TypoScriptReferenceFrontend/Templates': 'resource://SGalinski.TypoScriptReferenceFrontend/Private/Templates'
-- 
GitLab