Author: sseifert
Date: Tue Jul 11 15:09:33 2017
New Revision: 1801624
URL: http://svn.apache.org/viewvc?rev=1801624&view=rev
Log:
add info about file name escaping
Modified:
sling/site/trunk/content/documentation/bundles/content-loading-jcr-contentloader.mdtext
Modified:
sling/site/trunk/content/documentation/bundles/content-loading-jcr-contentloader.mdtext
URL:
http://svn.apache.org/viewvc/sling/site/trunk/content/documentation/bundles/content-loading-jcr-contentloader.mdtext?rev=1801624&r1=1801623&r2=1801624&view=diff
==============================================================================
---
sling/site/trunk/content/documentation/bundles/content-loading-jcr-contentloader.mdtext
(original)
+++
sling/site/trunk/content/documentation/bundles/content-loading-jcr-contentloader.mdtext
Tue Jul 11 15:09:33 2017
@@ -214,6 +214,12 @@ Nodes, Properties and in fact complete s
By default, the `sling-jcr-contentloader` bundle tries to extract certain file
types during content loading. These include `json`, `xml`, `zip`, and `jar`
files. Therefore all available extractors are used for content processing.
However if some files should be put into the repository unextracted, the
`ignoreImportProviders` directive can be used with a comma separated list of
extensions that should not be extracted, like
`ignoreImportProviders:="jar,zip"`. Please note that the value needs to be put
into quotation marks if more than one value is used like in the example.
+### File name escaping
+
+When the node name you want to import with the JCR ContentLoader contains
characters that are not allowed in typical file systems (e.g. a ":" is not
allowed on windows file systems), you can URL-encode the file name. It uses the
[Java
URLDecoder](https://docs.oracle.com/javase/8/docs/api/java/net/URLDecoder.html)
internally.
+
+Example: `jcr%3Acontent.txt` will be loaded into a node named
`jcr:content.txt`.
+
### Workspace Targetting
By default, initial content will be loaded into the default workspace. To
override this, add a `Sling-Initial-Content-Workspace` bundle manifest header
to specify the workspace. Note that *all* content from a bundle will be loaded
into the same workspace.
