Author: bdelacretaz
Date: Thu Aug 18 12:15:30 2016
New Revision: 1756768
URL: http://svn.apache.org/viewvc?rev=1756768&view=rev
Log:
SLING-5969 - update repoinit docs - tweaks
Modified:
sling/site/trunk/content/documentation/bundles/repository-initialization.mdtext
Modified:
sling/site/trunk/content/documentation/bundles/repository-initialization.mdtext
URL:
http://svn.apache.org/viewvc/sling/site/trunk/content/documentation/bundles/repository-initialization.mdtext?rev=1756768&r1=1756767&r2=1756768&view=diff
==============================================================================
---
sling/site/trunk/content/documentation/bundles/repository-initialization.mdtext
(original)
+++
sling/site/trunk/content/documentation/bundles/repository-initialization.mdtext
Thu Aug 18 12:15:30 2016
@@ -85,8 +85,6 @@ The language is self-explaining but plea
## Providing repoinit statements from the Sling provisioning model or other
URLs
-This requires the `org.apache.sling.provisioning.model` bundle, version 1.4.2
or later.
-
All bundles required for this feature need to be active before the
`SlingRepository` service starts.
From version 1.0.2 of the `org.apache.sling.jcr.repoinit` bundle, the
`o.a.s.jcr.repoinit.RepositoryInitializer` component uses an OSGi
@@ -105,6 +103,8 @@ Note that previous versions of the `org.
The `slingstart-maven-plugin`, from V1.4.2 on, allows for embedding so-called
"additional sections" in the Sling provisioning model by starting
their name with a colon.
+At runtime this requires the `org.apache.sling.provisioning.model` bundle,
version 1.4.2 or later.
+
The `o.a.s.jcr.repoinit` bundle can use this feature to execute `repoinit`
statements provided by Sling provisioning models, as in this
provisioning model example fragment:
@@ -118,15 +118,17 @@ To read repoinit statements from such an
model@repoinitTwo:context:/resources/provisioning/model.txt
Where _model_ means "use the provisioning model format", _repoinitTwo_ is the
name of the additional section to read statements from in the provisioning
-model (without the leading colon) and _context:/resources/..._ is the URL to
use to retrieve the provisioning model.
+model (without the leading colon) and _context:/resources/..._ is the URL to
use to retrieve the provisioning model.
+
+In this example the URL uses the _context_ scheme defined by the Sling
Launchpad, but any scheme can be used provided a suitable URL handler is active.
The section name in that reference is optional and defaults to _repoinit_. If
it's not specified the `@` should be omitted as well.
### References to URLs providing raw repoinit statements
-Configuring `RepositoryInitializer` like in this example, with the _raw_
prefix, means that its content is passed as is to the repoinit parser:
+Using a `RepositoryInitializer` reference like in this example, with the _raw_
prefix, means that its content is passed as is to the repoinit parser:
raw:classpath://some-repoinit-file.txt
-Which points to a `classpath:` URL to provide the raw repoinit statements.
+Which points to a `classpath:` URL to provide the raw repoinit statements in
this example, but again any valid URL scheme can be used.
