You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jackrabbit.apache.org by tr...@apache.org on 2015/04/03 20:23:59 UTC
svn commit: r1671120 [1/3] - in /jackrabbit/site/trunk: ./
src/site/markdown/ src/site/markdown/jcr--api/
src/site/markdown/standalone-server/ src/site/markdown/status/
src/site/resources/css/
Author: tripod
Date: Fri Apr 3 18:23:58 2015
New Revision: 1671120
URL: http://svn.apache.org/r1671120
Log:
JCR-3865 Use markdown to generate Jackrabbit Site (wip)
Added:
jackrabbit/site/trunk/src/site/markdown/jcr--api/
jackrabbit/site/trunk/src/site/markdown/jcr--api/level-1.jpg
- copied unchanged from r1670829, jackrabbit/site/trunk/attic/content/JCR/jcr-api.data/level-1.jpg
jackrabbit/site/trunk/src/site/markdown/jcr--api/level-2.jpg
- copied unchanged from r1670829, jackrabbit/site/trunk/attic/content/JCR/jcr-api.data/level-2.jpg
jackrabbit/site/trunk/src/site/markdown/jcr--api/level-adv.jpg
- copied unchanged from r1670829, jackrabbit/site/trunk/attic/content/JCR/jcr-api.data/level-adv.jpg
jackrabbit/site/trunk/src/site/markdown/standalone-server/
jackrabbit/site/trunk/src/site/markdown/standalone-server/standalone500.png
- copied unchanged from r1670829, jackrabbit/site/trunk/attic/content/JCR/standalone-server.data/standalone500.png
jackrabbit/site/trunk/src/site/markdown/status/
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-april-2005.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-april-2005.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-april-2006.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-april-2006.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-december-2006.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-december-2006.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-december-2007.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-december-2007.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-december-2008.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-december-2008.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-december-2009.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-december-2009.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-december-2010.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-december-2010.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-december-2011.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-december-2011.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-january-2006.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-january-2006.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-july-2005.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-july-2005.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-july-2006.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-july-2006.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-june-2007.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-june-2007.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-june-2008.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-june-2008.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-june-2009.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-june-2009.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-june-2010.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-june-2010.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-june-2011.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-june-2011.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-march-2006.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-march-2006.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-march-2007.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-march-2007.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-march-2008.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-march-2008.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-march-2009.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-march-2009.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-march-2010.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-march-2010.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-march-2011.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-march-2011.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-may-2006.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-may-2006.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-october-2004.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-october-2004.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-october-2005.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-october-2005.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-september-2006.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-september-2006.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-september-2007.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-september-2007.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-september-2008.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-september-2008.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-september-2009.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-september-2009.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-september-2010.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-september-2010.md
jackrabbit/site/trunk/src/site/markdown/status/jackrabbit-status-september-2011.md
- copied, changed from r1670829, jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-september-2011.md
Removed:
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-april-2005.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-april-2006.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-december-2006.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-december-2007.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-december-2008.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-december-2009.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-december-2010.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-december-2011.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-january-2006.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-july-2005.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-july-2006.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-june-2007.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-june-2008.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-june-2009.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-june-2010.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-june-2011.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-march-2006.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-march-2007.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-march-2008.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-march-2009.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-march-2010.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-march-2011.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-may-2006.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-october-2004.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-october-2005.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-september-2006.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-september-2007.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-september-2008.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-september-2009.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-september-2010.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-status-september-2011.md
Modified:
jackrabbit/site/trunk/pom.xml
jackrabbit/site/trunk/src/site/markdown/articles.md
jackrabbit/site/trunk/src/site/markdown/frequently-asked-questions.md
jackrabbit/site/trunk/src/site/markdown/getting-started-with-apache-jackrabbit.md
jackrabbit/site/trunk/src/site/markdown/index.md
jackrabbit/site/trunk/src/site/markdown/jackrabbit-history.md
jackrabbit/site/trunk/src/site/markdown/jcr--api.md
jackrabbit/site/trunk/src/site/markdown/news-archive.md
jackrabbit/site/trunk/src/site/markdown/standalone-server.md
jackrabbit/site/trunk/src/site/resources/css/site.css
Modified: jackrabbit/site/trunk/pom.xml
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/pom.xml?rev=1671120&r1=1671119&r2=1671120&view=diff
==============================================================================
--- jackrabbit/site/trunk/pom.xml (original)
+++ jackrabbit/site/trunk/pom.xml Fri Apr 3 18:23:58 2015
@@ -104,10 +104,10 @@
<resource>
<directory>src/site/markdown</directory>
<includes>
- <include>*.png</include>
- <include>*.jpg</include>
- <include>*.jpeg</include>
- <include>*.gif</include>
+ <include>**/*.png</include>
+ <include>**/*.jpg</include>
+ <include>**/*.jpeg</include>
+ <include>**/*.gif</include>
</includes>
</resource>
</resources>
Modified: jackrabbit/site/trunk/src/site/markdown/articles.md
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/src/site/markdown/articles.md?rev=1671120&r1=1671119&r2=1671120&view=diff
==============================================================================
--- jackrabbit/site/trunk/src/site/markdown/articles.md (original)
+++ jackrabbit/site/trunk/src/site/markdown/articles.md Fri Apr 3 18:23:58 2015
@@ -1,45 +1,53 @@
-Title: Articles
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Articles
+========
This page contains links to the latest articles and presentations on JCR
and Jackrabbit. It is meant as an entry point for any newcommers to JCR and
Jackrabbit.
For a complete version of this list and also an extensive list of tools and
-applications built on Jackrabbit, please visit the [links page](http://wiki.apache.org/jackrabbit/JcrLinks)
- on the wiki.
+applications built on Jackrabbit, please visit the [links page](http://wiki.apache.org/jackrabbit/JcrLinks) on the wiki.
+
+
+General
+-------
+* Java Community Process: [JSR 170](http://jcp.org/en/jsr/detail?id=170) and [JSR 283|http://jcp.org/en/jsr/detail?id=283]
+* An easy way to see Jackrabbit in action is to go through the [First Hops](first-hops.html) tutorial.
+
+
+Articles
+--------
+* Bertrand Delacretaz, "[Java Content Repository: The Best Of Both Worlds](http://java.dzone.com/articles/java-content-repository-best)" (January, 2010) Javalobby
+* Bertil Chapuis, "[JCR or RDBMS - why, when, how?](http://www.scribd.com/doc/11163161/JCR-or-RDBMS-why-when-how)" (December, 2008) scribd.com
+* Jochen Toppe, "[JCR Primer](http://jtoee.com/jsr-170/)" (December, 2008) Jochen Toppe's Blog
+* Thomas Hug, "[JCR appears in Top 10 Technologies](http://ctpjava.blogspot.com/2008/09/top-10-java-technologies-at-cambridge.html)" (September, 2008) CTP Java Community
+* Douglas Jose, "[Adding JCR support to your existing web application](http://ctpjava.blogspot.com/2008/09/adding-jcr-support-to-your-existing-web.html)" (September, 2008) CTP Java Community
+* David Dossot, "[Content Oriented Integration Solutions With Mule and JCR](http://www.theserverside.com/tt/articles/article.tss?l=COISWithMuleandJCR)" (June, 2008) TheServerSide.COM
+* Michael Duerig, "[JCR with Scala](http://dev.day.com/microsling/content/blogs/main/scalajcr.html)" (January, 2008) dev.day.com
+* Michael Marth, "[Scripting a Java Content Repository with JRuby](http://dev.day.com/microsling/content/blogs/main/jrubyjcr.html)" (January 2008) dev.day.com
+
+
+Interviews
+----------
+* David Nuescheler, "[on JCR and REST](http://www.infoq.com/articles/nuescheler-jcr-rest)" (InfoQ, June 2008)
+
-<a name="Articles-General"></a>
-## General
-* Java Community Process: [JSR 170](http://jcp.org/en/jsr/detail?id=170)
- and [JSR 283|http://jcp.org/en/jsr/detail?id=283]
-* An easy way to see Jackrabbit in action is to go throught the [First Hops](first-hops.html)
- tutorial.
-
-<a name="Articles-Articles"></a>
-## Articles
-* Bertrand Delacretaz, "[Java Content Repository: The Best Of Both Worlds](http://java.dzone.com/articles/java-content-repository-best)
-" (January, 2010) Javalobby
-* Bertil Chapuis, "[JCR or RDBMS - why, when, how?](http://www.scribd.com/doc/11163161/JCR-or-RDBMS-why-when-how)
-" (December, 2008) scribd.com
-* Jochen Toppe, "[JCR Primer](http://jtoee.com/jsr-170/)
-" (December, 2008) Jochen Toppe's Blog
-* Thomas Hug, "[JCR appears in Top 10 Technologies](http://ctpjava.blogspot.com/2008/09/top-10-java-technologies-at-cambridge.html)
-" (September, 2008) CTP Java Community
-* Douglas Jose, "[Adding JCR support to your existing web application](http://ctpjava.blogspot.com/2008/09/adding-jcr-support-to-your-existing-web.html)
-" (September, 2008) CTP Java Community
-* David Dossot, "[Content Oriented Integration Solutions With Mule and JCR](http://www.theserverside.com/tt/articles/article.tss?l=COISWithMuleandJCR)
-" (June, 2008) TheServerSide.COM
-* Michael Duerig, "[JCR with Scala](http://dev.day.com/microsling/content/blogs/main/scalajcr.html)
-" (January, 2008) dev.day.com
-* Michael Marth, "[Scripting a Java Content Repository with JRuby](http://dev.day.com/microsling/content/blogs/main/jrubyjcr.html)
-" (January 2008) dev.day.com
-
-<a name="Articles-Interviews"></a>
-## Interviews
-* David Nuescheler, "[on JCR and REST](http://www.infoq.com/articles/nuescheler-jcr-rest)
-" (InfoQ, June 2008)
-
-
-<a name="Articles-Presentations"></a>
-## Presentations
-* Michael Marth and David Nuescheler, "[Kickstarting JCR: TheServerSide.com as a Content Application](http://www.slideshare.net/uncled/theserverside-kickstarting-jcr)
-" (March 27, 2008) [TSSJS'08|http://javasymposium.techtarget.com/lasvegas/persistence.html#DNueschelerJCR]
+Presentations
+-------------
+* Michael Marth and David Nuescheler, "[Kickstarting JCR: TheServerSide.com as a Content Application](http://www.slideshare.net/uncled/theserverside-kickstarting-jcr)" (March 27, 2008) [TSSJS'08|http://javasymposium.techtarget.com/lasvegas/persistence.html#DNueschelerJCR]
Modified: jackrabbit/site/trunk/src/site/markdown/frequently-asked-questions.md
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/src/site/markdown/frequently-asked-questions.md?rev=1671120&r1=1671119&r2=1671120&view=diff
==============================================================================
--- jackrabbit/site/trunk/src/site/markdown/frequently-asked-questions.md (original)
+++ jackrabbit/site/trunk/src/site/markdown/frequently-asked-questions.md Fri Apr 3 18:23:58 2015
@@ -1,14 +1,33 @@
-Title: Frequently Asked Questions
-## General
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Frequently Asked Questions
+==========================
-### What is JCR?
+General
+-------
+
+### What is JCR?
JCR is the acronym of the Content Repository for Java technology API, a standard interface for accessing content repositories.
JCR version 1.0 was specified in Java Specification Request 170 ([JSR 170](http://jcp.org/en/jsr/detail?id=170)),
and version 2.0 is currently under work in [JSR 283|http://jcp.org/en/jsr/detail?id=283].
### What is a content repository?
-
A content repository is an information management system that provides
various services for storing, accessing, and managing content. In addition
to a hierarchically structured storage, common services of a content
@@ -18,7 +37,6 @@ although most existing CMSs contain a cu
implementation, often based on the file system or a relational database.
### What is Apache Jackrabbit?
-
Apache Jackrabbit is a fully featured content repository that implements
the entire JCR API. The Jackrabbit project was started when Day Software,
the JSR-170 specification lead, licensed their initial implementation of
@@ -27,24 +45,23 @@ official reference implementation (RI) a
(TCK) released along with the final JCR API.
### What do I do if I have a question?
-
-Please ask questions on the [Jackrabbit mailing lists](http://jackrabbit.apache.org/mailing-lists.html)
-. There is the users list for questions around using JCR and Jackrabbit and
+Please ask questions on the [Jackrabbit mailing lists](http://jackrabbit.apache.org/mailing-lists.html).
+There is the users list for questions around using JCR and Jackrabbit and
the dev list for the development of Jackrabbit itself and for people
starting to extend Jackrabbit or other advanced topics.
-## Building Jackrabbit
+Building Jackrabbit
+-------------------
### How do I build the Apache Jackrabbit sources?
+See the [Building Jackrabbit](building-jackrabbit.html) page for detailed build instructions.
-See the [Building Jackrabbit](building-jackrabbit.html)
- page for detailed build instructions.
-## Using Jackrabbit
+Using Jackrabbit
+----------------
### How do I do X with JCR/Jackrabbit?
-
See the JCR specification, the JCR API documentation, or the Examples page
on the Jackrabbit wiki for information on how to perform various operation
using the JCR API.
@@ -54,16 +71,13 @@ covered by the JCR API, see the Examples
javadocs, or contact the Jackrabbit mailing list.
### How do I use transactions with JCR?
-
See the mailing list announcement for a simple example on using the JTA
support in Jackrabbit. For a more complete explanation of the transaction
features, please see section 8.1 Transactions of the JCR
specification.
### How do I create new workspaces in Jackrabbit?
-
-The JCR 2.0 API has two [Workspace.createWorkspace()](http://www.day.com/maven/jsr170/javadocs/jcr-2.0/javax/jcr/Workspace.html#createWorkspace(java.lang.String))
- methods for that.
+The JCR 2.0 API has two [Workspace.createWorkspace()](http://www.day.com/maven/jsr170/javadocs/jcr-2.0/javax/jcr/Workspace.html#createWorkspace(java.lang.String)) methods for that.
The JCR 1.0 API does not contain features for creating or managing
workspaces, so you need to use Jackrabbit-specific functionality for
@@ -73,9 +87,9 @@ programmatically.
The manual way is to create a new workspace directory within the repository
home directory and to place a new workspace.xml configuration file in that
folder. You can use the configuration file of an existing workspace as an
-example, just remember to change the name of the workspace in the
+example, just remember to change the name of the workspace in the
Workspace name="..." tag. See the [Jackrabbit Configuration](jackrabbit-configuration.html)
- page for configuration details. Note also that you need to restart the
+page for configuration details. Note also that you need to restart the
repository instance to access the new workspace.
The programmatic way is to acquire a Workspace instance using the normal
@@ -83,157 +97,143 @@ JCR API and to cast the instance to the
can then use the createWorkspace(String) method to create new workspaces.
### How do I delete a workspace in Jackrabbit?
-
There is currently no programmatic way to delete workspaces. You can delete
a workspace by manually removing the workspace directory when the
repository instance is not running.
### How do I deploy Jackrabbit into Tomcat?
-
* Download [jcr-1.0.jar](http://www.day.com/maven/javax.jcr/jars/jcr-1.0.jar) and put it into `<tomcat-install-dir>/shared/lib`.
* Get the WAR distribution from the [Downloads](downloads.html) page and deploy it into Tomcat.
* Point your browser to `http://**localhost:8080/jackrabbit-webapp-<version>`
-## Access control
-h3. How do I use LDAP, Kerberos, or some other authentication mechanism
- with Jackrabbit?
+Access control
+--------------
+
+### How do I use LDAP, Kerberos, or some other authentication mechanism with Jackrabbit?
Jackrabbit uses the Java Authentication and Authorization Service (JAAS)
-for authenticating users. You should be able to use any JAAS
-LoginModule implementation (e.g. the LoginModules in
-thecom.sum.security.auth.modulepackage) for authentication. See the JAAS
-documentation for configuration instructions.
+for authenticating users. You should be able to use any JAAS LoginModule
+implementation (e.g. the LoginModules in thecom.sum.security.auth.modulepackage)
+for authentication. See the JAAS documentation for configuration instructions.
### How do I manage the access rights of authenticated users?
-
The current JackrabbitSimpleAccessManager class only supports three access
-levels: anonymous, normal, and system. Anonymous users have read
-access while normal and system users have full read-write access.
+levels: anonymous, normal, and system. Anonymous users have read
+access while normal and system users have full read-write access.
You need to implement a custom AccessManager class to get more fine-grained
access control.
-## Persistence managers
+Persistence managers
+--------------------
### What is a persistence manager?
-
-A persistence manager (PM) is an internal Jackrabbit component
-that handles the persistent storage of content nodes and
+A persistence manager (PM) is an internal Jackrabbit component
+that handles the persistent storage of content nodes and
properties. Each workspace of a Jackrabbit content repository
uses a separate persistence manager to store the content in that
workspace. Also the Jackrabbit version handler uses a separate
persistence manager.The persistence manager sits at the very bottom layer
-of the Jackrabbit system architecture. Reliability, integrity and
- performance of the PM are crucial to the overall
+of the Jackrabbit system architecture. Reliability, integrity and
+performance of the PM are crucial to the overall
stability and performance of the repository. If e.g. the data
that a PM is based upon is allowed to change through external
-means the integrity of the repository would be at risk (think of
-referential integrity / node references e.g.).
+means the integrity of the repository would be at risk (think of referential
+integrity / node references e.g.).
In practice, a persistence manager is any Java class that
-implements the PersistenceManager interface and the associated
-behavoural contracts. Jackrabbit contains a set of built-in
-persistence manager classes that cover most of the deployment
-needs. There are also a few contributed persistence managers that
+implements the PersistenceManager interface and the associated
+behavioural contracts. Jackrabbit contains a set of built-in
+persistence manager classes that cover most of the deployment
+needs. There are also a few contributed persistence managers that
give additional flexibility.
### What is a Jackrabbit file system?
-
-A Jackrabbbit file system (FS) is an internal component that
+A Jackrabbit file system (FS) is an internal component that
implements standard file system operations on top of some underlying
- storage mechanism (a normal file system, a database, a webdav server,
- or a custom file format). A file system component is any Java class
- that implements the FileSystem interface and the
-associated behavioral contracts. File systems are used in
-Jackrabbit both as subcomponents of the persistence managers and
-for general storage needs (for example to store the full text
+storage mechanism (a normal file system, a database, a webdav server,
+or a custom file format). A file system component is any Java class
+that implements the FileSystem interface and the
+associated behavioral contracts. File systems are used in
+Jackrabbit both as sub-components of the persistence managers and
+for general storage needs (for example to store the full text
indexes).
### Can I use a persistence manager to access an existing data source?
-
No. The persistence manager interface was never intended as being
a general SPI that you could implement in order to integrate
external data sources with proprietary formats (e.g. a customers
-database). The reason why we abstracted the PM interface was to
-leave room for future performance optimizations that would not
-affect the rest of the implementation (e.g. by storing the raw
+database). The reason why we abstracted the PM interface was to
+leave room for future performance optimizations that would not
+affect the rest of the implementation (e.g. by storing the raw
data in a b-tree based database instead of individual file).
### How smart should a persistence manager be?
-A persistence manager should not be intelligent, i.e. it should
-not interpret the content it is managing. The only thing it
-should care about is to efficiently, consistently, and reliably
-store and read the content encapsulated in the passed NodeState
-and PropertyState objects. Though it might be feasible to write a
-custom persistence manager to represent existing legacy data in a
-level-1 (read-only) repository, I don't think the same is
-possible for a level-2 repository and I certainly would not
+A persistence manager should not be intelligent, i.e. it should
+not interpret the content it is managing. The only thing it
+should care about is to efficiently, consistently, and reliably
+store and read the content encapsulated in the passed NodeState
+and PropertyState objects. Though it might be feasible to write a
+custom persistence manager to represent existing legacy data in a
+level-1 (read-only) repository, I don't think the same is
+possible for a level-2 repository and I certainly would not
recommend it.
-## Query
-
-h3. I've configured textFilterClasses but my query still doesn't work,
-what's wrong?
+Query
+-----
+### I've configured textFilterClasses but my query still doesn't work, what's wrong?
Make sure you changed existing workspace.xml files as well. The workspace
element in repository.xml only acts as a template for new workspaces.
Verify that you also put the jar files into the classpath that jackrabbit
depends on for text extraction. You can find all required jar files inside
-the jackrabbit-webapp war file (the *WEB-INF/lib* folder). Go to the [downloads](downloads.html)
- page to get the war file.
+the jackrabbit-webapp war file (the *WEB-INF/lib* folder).
+Go to the [downloads](downloads.html) page to get the war file.
Some documents may still not be searchable for various reasons: the
document is corrupt, bug in one of the libraries that extract text,
document is encrypted or otherwise protected, etc.
-h3. Why doesn't {{//*\[jcr:contains(@jcr:data, 'foo')](jcr:contains(@jcr:data,-'foo').html)
-}} return matches for binary content?
-
+### Why doesn't `//*\[jcr:contains(@jcr:data, 'foo')](jcr:contains(@jcr:data,-'foo').html)` return matches for binary content?
Extracted text from binary content is only indexed on the parent node of
-the @jcr:data property. Use jcr:contains() on the nt:resource node.
+the `@jcr:data property. Use jcr:contains()` on the nt:resource node.
Examples:
//element(*, nt:resource)[jcr:contains(., 'foo')]
//element(*, nt:file)[jcr:contains(jcr:content, 'foo')]
-### Can I use the Lucene field syntax in jcr:contains()?
-
+### Can I use the Lucene field syntax in `jcr:contains()` ?
No, you cannot. Even though Jackrabbit uses a Lucene index, the fields for
JCR properties do not map 1:1 to Lucene fields. Instead you can use the
following:
-
//element(*, book)[jcr:contains(@title, 'jackrabbit') and jcr:contains(@text, 'query')]
-h3. My XPath query returns no results when I add a path constraint, what's
-wrong?
-
+### My XPath query returns no results when I add a path constraint, what's wrong?
You probably forgot to prefix your statement with */jcr:root*.
JSR 170 says in section 6.6.4.3:
-{quote}
-The context node of an XPath query is the XML node relative to which the
-query expression is evaluated.
-
-A relative XPath statement (one that does not have a leading /) will be
-interpreted relative to the root node of the workspace, which, in the XML
-document view is the top-most XML element, <jcr:root>. This means that one
-should not include jcr:root as the first segment in a relative XPath
-statement, since that element is already the default context node.
-
-An absolute XPath (one with a leading /), in contrast, will be interpreted
-relative to a position one level above <jcr:root>. This means that an
-absolute XPath must either begin with // or with /jcr:root in order to
-match anything at all.
-{quote}
-### How do I force a consistency check on the search index?
+> The context node of an XPath query is the XML node relative to which the
+> query expression is evaluated.
+>
+> A relative XPath statement (one that does not have a leading /) will be
+> interpreted relative to the root node of the workspace, which, in the XML
+> document view is the top-most XML element, <jcr:root>. This means that one
+> should not include jcr:root as the first segment in a relative XPath
+> statement, since that element is already the default context node.
+>
+> An absolute XPath (one with a leading /), in contrast, will be interpreted
+> relative to a position one level above <jcr:root>. This means that an
+> absolute XPath must either begin with // or with /jcr:root in order to
+> match anything at all.
+### How do I force a consistency check on the search index?
Forcing a consistency check may be useful when you think the index is
inconsistent. You need to add two parameters to the SearchIndex section in
the workspace.xml configuration file:
@@ -247,7 +247,6 @@ Then restart Jackrabbit and watch the lo
messages. Don't forget to remove the parameters again when you are done.
### Why is the size of my query result -1?
-
A JCR implementation may return -1 when the size is unknown. Starting with
2.0 Jackrabbit will return -1 for some query statements when there is
potential for a more optimized query execution. If you still want a size
Modified: jackrabbit/site/trunk/src/site/markdown/getting-started-with-apache-jackrabbit.md
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/src/site/markdown/getting-started-with-apache-jackrabbit.md?rev=1671120&r1=1671119&r2=1671120&view=diff
==============================================================================
--- jackrabbit/site/trunk/src/site/markdown/getting-started-with-apache-jackrabbit.md (original)
+++ jackrabbit/site/trunk/src/site/markdown/getting-started-with-apache-jackrabbit.md Fri Apr 3 18:23:58 2015
@@ -1,50 +1,68 @@
-Title: Getting Started with Apache Jackrabbit
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Getting Started with Apache Jackrabbit
+======================================
To get started with Jackrabbit you should first become familiar with the
-JCR API. Download the [JSR 170 specification](http://jcp.org/aboutJava/communityprocess/final/jsr170/index.html)
-, browse the [API documentation|http://www.day.com/maven/jsr170/javadocs/jcr-1.0/]
-, check our introduction to JCR levels, or read some of the JCR
+JCR API. Download the [JSR 170 specification](http://jcp.org/aboutJava/communityprocess/final/jsr170/index.html),
+browse the [API documentation](http://www.day.com/maven/jsr170/javadocs/jcr-1.0/),
+check our introduction to JCR levels, or read some of the JCR
articles to understand the content repository model that Jackrabbit
-implements. You can also take a look at the various JCR and
+implements. You can also take a look at the various JCR and
Jackrabbit applications to get an idea of what to do with a content
repository.
- If you are interested in using Jackrabbit, you should check the Jackrabbit
-architecture and try out the First Hops examples we have
+If you are interested in using Jackrabbit, you should check the Jackrabbit
+architecture and try out the First Hops examples we have
prepared. You can either download a binary release or build Jackrabbit
- from sources.
+from sources.
- Take a look at the Frequently Asked Questions or browse the
+Take a look at the Frequently Asked Questions or browse the
archives of the user and development mailing lists (see also the searchable
archives at The Mail Archive, Gmane, and Nabble) for answers to questions
-not covered by the documentation pages. See the Mailing Lists page
-if you want to subscribe or unsubscribe the Jackrabbit mailing
+not covered by the documentation pages. See the Mailing Lists page
+if you want to subscribe or unsubscribe the Jackrabbit mailing
lists.
- Apache Jackrabbit is an open source project and welcomes all
-contributions. You can participate by answering questions on the
+Apache Jackrabbit is an open source project and welcomes all
+contributions. You can participate by answering questions on the
mailing list, filing bug reports for any problems or improvement ideas
- you come up with, contributing to the Jackrabbit Wiki, or writing
+you come up with, contributing to the Jackrabbit Wiki, or writing
documentation and code. See the How the ASF works page for background
- information on the Apache Software Foundation and the way we work.
+information on the Apache Software Foundation and the way we work.
-<a name="GettingStartedwithApacheJackrabbit-ContentRepositoryforJavaTechnologyAPI(JCR)"></a>
-## Content Repository for Java Technology API (JCR)
- Jackrabbit is a complete implementation of the JCR API, so the
-primary API for Jackrabbit application developers is to be found in
-the JCR section of the Documentation.
+Content Repository for Java Technology API (JCR)
+------------------------------------------------
+Jackrabbit is a complete implementation of the JCR API, so the
+primary API for Jackrabbit application developers is to be found in
+the JCR section of the Documentation.
-<a name="GettingStartedwithApacheJackrabbit-JackrabbitarchitectureandDeploymentModels"></a>
-## Jackrabbit architecture and Deployment Models
- Find out more about the Jackrabbit Architecture or learn more
-about the Jackrabbit deployment Options be it as an embedded
-content repository to be delivered with you are application, a
+Jackrabbit architecture and Deployment Models
+---------------------------------------------
+Find out more about the Jackrabbit Architecture or learn more
+about the Jackrabbit deployment Options be it as an embedded
+content repository to be delivered with you are application, a
shared repository for example in a J2EE environment or a classical content
repository server setup.
-<a name="GettingStartedwithApacheJackrabbit-NodeTypes"></a>
-## Node Types
- To learn about the content modeling system used in Jackrabbit, read the
+Node Types
+----------
+To learn about the content modeling system used in Jackrabbit, read the
section on node types.
Modified: jackrabbit/site/trunk/src/site/markdown/index.md
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/src/site/markdown/index.md?rev=1671120&r1=1671119&r2=1671120&view=diff
==============================================================================
--- jackrabbit/site/trunk/src/site/markdown/index.md (original)
+++ jackrabbit/site/trunk/src/site/markdown/index.md Fri Apr 3 18:23:58 2015
@@ -28,139 +28,142 @@ transactions, observation, and more.
Apache Jackrabbit is a project of the [Apache Software Foundation](http://www.apache.org/)
-## Apache Jackrabbit News
+Apache Jackrabbit News
+----------------------
-#### March 26th, 2015: Apache Jackrabbit 2.10.0 released
+##### March 26th, 2015: Apache Jackrabbit 2.10.0 released
Apache Jackrabbit 2.10 is an incremental feature release based on and compatible with earlier stable Jackrabbit 2.x releases.
See the downloads page for more details.
-#### March 10th, 2015: Apache Jackrabbit Oak 1.0.12 released
+##### March 10th, 2015: Apache Jackrabbit Oak 1.0.12 released
Jackrabbit Oak 1.0.12 is a patch release that contains fixes and improvements over the previous 1.0.11 release.
See the downloads page for more details.
-#### March 9th, 2015: Apache Jackrabbit Oak 1.1.7 released
+##### March 9th, 2015: Apache Jackrabbit Oak 1.1.7 released
Jackrabbit Oak 1.1.7 is an unstable release cut directly from trunk, with a focus on new features and other improvements.
See the downloads page for more details.
-#### February 25th, 2015: Apache Jackrabbit FileVault 3.1.16 released
+##### February 25th, 2015: Apache Jackrabbit FileVault 3.1.16 released
Jackrabbit FileVault 3.1.16 is current stable release of the recently donated repository content synchronization tool.
See the downloads page for more details.
-#### February 9th, 2015: Apache Jackrabbit Oak 1.1.6 released
+##### February 9th, 2015: Apache Jackrabbit Oak 1.1.6 released
Jackrabbit Oak 1.1.6 is an unstable release cut directly from trunk, with a focus on new features and other improvements.
See the downloads page for more details.
-#### February 6th, 2015: Apache Jackrabbit 2.9.1 released
+##### February 6th, 2015: Apache Jackrabbit 2.9.1 released
Apache Jackrabbit 2.9.x is an unstable series of releases cut directly from Jackrabbit trunk, with a focus on new features
and other improvements. See the downloads page for more details.
-#### February 3rd, 2015: Apache Jackrabbit Oak 1.0.11 released
+##### February 3rd, 2015: Apache Jackrabbit Oak 1.0.11 released
Jackrabbit Oak 1.0.11 is a patch release that contains fixes and improvements over the previous 1.0.10 release.
-#### February 2nd, 2015: Apache Jackrabbit Oak 1.0.10 released
+##### February 2nd, 2015: Apache Jackrabbit Oak 1.0.10 released
Jackrabbit Oak 1.0.10 is a patch release that contains fixes and improvements over the previous 1.0.9 release.
-#### January 23rd, 2015: Apache Jackrabbit Oak 1.1.5 released
+##### January 23rd, 2015: Apache Jackrabbit Oak 1.1.5 released
Jackrabbit Oak 1.1.5 is an unstable release cut directly from trunk, with a focus on new features and other improvements.
See the downloads page for more details.
-#### January 13th, 2015: Apache Jackrabbit Oak 1.1.4 released
+##### January 13th, 2015: Apache Jackrabbit Oak 1.1.4 released
Jackrabbit Oak 1.1.4 is an unstable release cut directly from trunk, with a focus on new features and other improvements.
-## News in 2014
+News in 2014
+------------
-#### December 22nd, 2014: Apache Jackrabbit Oak 1.0.9 released
+##### December 22nd, 2014: Apache Jackrabbit Oak 1.0.9 released
Jackrabbit Oak 1.0.9 is a patch release that contains fixes and improvements over the previous 1.0.8 release.
-#### December 15th, 2014: Apache Jackrabbit Oak 1.1.3 released
+##### December 15th, 2014: Apache Jackrabbit Oak 1.1.3 released
Jackrabbit Oak 1.1.3 is an unstable release cut directly from trunk, with a focus on new features and other improvements.
-#### December 19th, 2014: Apache Jackrabbit FileVault 3.1.14 released
+##### December 19th, 2014: Apache Jackrabbit FileVault 3.1.14 released
Jackrabbit FileVault 3.1.14 is current stable release of the recently donated repository content synchronization tool.
See the downloads page for more details.
-#### November 10th, 2014: Apache Jackrabbit Oak 1.1.2 released
+##### November 10th, 2014: Apache Jackrabbit Oak 1.1.2 released
Jackrabbit Oak 1.1.2 is an unstable release cut directly from trunk, with a focus on new features and other improvements.
-#### November 4th, 2014: Apache Jackrabbit Oak 1.0.8 released
+##### November 4th, 2014: Apache Jackrabbit Oak 1.0.8 released
Jackrabbit Oak 1.0.8 is a patch release that contains fixes and improvements over the previous 1.0.7 release.
-#### October 27th, 2014: Apache Jackrabbit FileVault 3.1.8 released
+##### October 27th, 2014: Apache Jackrabbit FileVault 3.1.8 released
Jackrabbit FileVault 3.1.8 is current stable release of the recently donated repository content synchronization tool.
-#### October 17th, 2014: Apache Jackrabbit Oak 1.1.1 released
+##### October 17th, 2014: Apache Jackrabbit Oak 1.1.1 released
Jackrabbit Oak 1.1.1 is an unstable release cut directly from trunk, with a focus on new features and other improvements.
-#### October 14th, 2014: Apache Jackrabbit Oak 1.0.7 released
+##### October 14th, 2014: Apache Jackrabbit Oak 1.0.7 released
Jackrabbit Oak 1.0.7 is a patch release that contains fixes and improvements over the previous 1.0.6 release.
-#### October 6th, 2014: Apache Jackrabbit Oak 1.1.0 released
+##### October 6th, 2014: Apache Jackrabbit Oak 1.1.0 released
Jackrabbit Oak 1.1.0 is an unstable release cut directly from trunk, with a focus on new features and other improvements.
-#### September 25th, 2014: Apache Jackrabbit Oak 1.0.6 released
+##### September 25th, 2014: Apache Jackrabbit Oak 1.0.6 released
Jackrabbit Oak 1.0.6 is a patch release that contains fixes and improvements over the previous 1.0.5 release.
-#### August 29th, 2014: Apache Jackrabbit Oak 1.0.5 released
+##### August 29th, 2014: Apache Jackrabbit Oak 1.0.5 released
Jackrabbit Oak 1.0.5 is a patch release that contains fixes and improvements over the previous 1.0.4 release.
-#### August 28th, 2014: Apache Jackrabbit 2.9.0 released
+##### August 28th, 2014: Apache Jackrabbit 2.9.0 released
Apache Jackrabbit 2.9.x is an unstable series of releases cut directly from Jackrabbit trunk, with a focus on new features
and other improvements.
-#### August 4th, 2014: Apache Jackrabbit Oak 1.0.4 released
+##### August 4th, 2014: Apache Jackrabbit Oak 1.0.4 released
Jackrabbit Oak 1.0.4 is a patch release that contains fixes and improvements over the previous 1.0.3 release.
-#### July 28th, 2014: Apache Jackrabbit Oak 1.0.3 released
+##### July 28th, 2014: Apache Jackrabbit Oak 1.0.3 released
Jackrabbit Oak 1.0.3 is a patch release that contains fixes and improvements over the previous 1.0.2 release.
-#### July 22nd, 2014: Apache Jackrabbit Oak 1.0.2 released
+##### July 22nd, 2014: Apache Jackrabbit Oak 1.0.2 released
Jackrabbit Oak 1.0.2 is a patch release that contains fixes and improvements over the previous 1.0.1 release.
-#### June 26th, 2014: Apache Jackrabbit Oak 1.0.1 released
+##### June 26th, 2014: Apache Jackrabbit Oak 1.0.1 released
Jackrabbit Oak 1.0.1 is a patch release that contains fixes and improvements over the previous 1.0.0 release.
-#### May 12th, 2014: Apache Jackrabbit 2.8.0 released
+##### May 12th, 2014: Apache Jackrabbit 2.8.0 released
Apache Jackrabbit 2.8 is an incremental feature release based on and compatible with earlier stable Jackrabbit 2.x releases.
See the downloads page for more details.
-#### April 25th, 2014: Apache Jackrabbit FileVault 3.1.6 released
+##### April 25th, 2014: Apache Jackrabbit FileVault 3.1.6 released
Jackrabbit FileVault 3.1.6 is current stable release of the recently donated repository content synchronization tool.
-#### April 8th, 2014: Apache Jackrabbit Oak 0.20.0 released
+##### April 8th, 2014: Apache Jackrabbit Oak 0.20.0 released
Jackrabbit Oak 0.20.0 is to be considered alpha-level software. Use at your own risk with no stability or compatibility guarantees.
-#### April 5th, 2014: Apache Jackrabbit FileVault 3.1.2 released
+##### April 5th, 2014: Apache Jackrabbit FileVault 3.1.2 released
Jackrabbit FileVault 3.1.2 is current stable release of the recently donated repository content synchronization tool.
-#### March 31th, 2014: Apache Jackrabbit FileVault 3.1.0 released
+##### March 31th, 2014: Apache Jackrabbit FileVault 3.1.0 released
Jackrabbit FileVault 3.1.0 is the second release of the recently donated repository content synchronization tool.
-#### March 24th, 2014: Apache Jackrabbit Oak 0.19 released
+##### March 24th, 2014: Apache Jackrabbit Oak 0.19 released
Jackrabbit Oak 0.19 is to be considered alpha-level software. Use at your own risk with no stability or compatibility guarantees.
-#### March 17th, 2014: Apache Jackrabbit 2.7.5 released
+##### March 17th, 2014: Apache Jackrabbit 2.7.5 released
Apache Jackrabbit 2.7.x is an unstable series of releases cut directly from Jackrabbit trunk, with a focus on new features
and other improvements.
-#### March 11th, 2014: Apache Jackrabbit Oak 0.18 released
+##### March 11th, 2014: Apache Jackrabbit Oak 0.18 released
Jackrabbit Oak 0.18 is to be considered alpha-level software. Use at your own risk with no stability or compatibility guarantees.
-#### February 26th, 2014: Apache Jackrabbit Oak 0.17.1 released
+##### February 26th, 2014: Apache Jackrabbit Oak 0.17.1 released
Jackrabbit Oak 0.17.1 is to be considered alpha-level software. Use at your own risk with no stability or compatibility guarantees.
-#### February 11th, 2014: Apache Jackrabbit 2.7.4 released
+##### February 11th, 2014: Apache Jackrabbit 2.7.4 released
Apache Jackrabbit 2.7.x is an unstable series of releases cut directly from Jackrabbit trunk, with a focus on new features
and other improvements.
-#### February 10th, 2014: Apache Jackrabbit Oak 0.16 released
+##### February 10th, 2014: Apache Jackrabbit Oak 0.16 released
Jackrabbit Oak 0.16 is to be considered alpha-level software. Use at your own risk with no stability or compatibility guarantees.
-#### January 27th, 2014: Apache Jackrabbit Oak 0.15 released
+##### January 27th, 2014: Apache Jackrabbit Oak 0.15 released
Jackrabbit Oak 0.15 is to be considered alpha-level software. Use at your own risk with no stability or compatibility guarantees.
-#### January 13th, 2014: Apache Jackrabbit Oak 0.14 released
+##### January 13th, 2014: Apache Jackrabbit Oak 0.14 released
Jackrabbit Oak 0.14 is to be considered alpha-level software. Use at your own risk with no stability or compatibility guarantees.
-## Older News
+Older News
+----------
See the [news archive](news-archive.html) for past news.
\ No newline at end of file
Modified: jackrabbit/site/trunk/src/site/markdown/jackrabbit-history.md
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/src/site/markdown/jackrabbit-history.md?rev=1671120&r1=1671119&r2=1671120&view=diff
==============================================================================
--- jackrabbit/site/trunk/src/site/markdown/jackrabbit-history.md (original)
+++ jackrabbit/site/trunk/src/site/markdown/jackrabbit-history.md Fri Apr 3 18:23:58 2015
@@ -1,114 +1,119 @@
-Title: Jackrabbit History
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Jackrabbit History
+==================
The Apache Jackrabbit project has a long history that is recorded in the
archives various mailing lists, Apache board minutes, and of course also in
the Jackrabbit codebase. This page highlights some of the key historical
events and records from past years.
-For recent events, have a look at the [News Archive](news-archive.html)
-.
+For recent events, have a look at the [News Archive](news-archive.html).
-<a name="JackrabbitHistory-Jackrabbitin2011"></a>
-## Jackrabbit in 2011
-* December 2011: [Jackrabbit Status December 2011](jackrabbit-status-december-2011.html)
-* September 2011: [Jackrabbit Status September 2011](jackrabbit-status-september-2011.html)
-* June 2011: [Jackrabbit Status June 2011](jackrabbit-status-june-2011.html)
-* March 2011: [Jackrabbit Status March 2011](jackrabbit-status-march-2011.html)
+Jackrabbit in 2011
+------------------
+* December 2011: [Jackrabbit Status December 2011](status/jackrabbit-status-december-2011.html)
+* September 2011: [Jackrabbit Status September 2011](status/jackrabbit-status-september-2011.html)
+* June 2011: [Jackrabbit Status June 2011](status/jackrabbit-status-june-2011.html)
+* March 2011: [Jackrabbit Status March 2011](status/jackrabbit-status-march-2011.html)
-<a name="JackrabbitHistory-Jackrabbitin2010"></a>
-## Jackrabbit in 2010
-* December 2010: [Jackrabbit Status December 2010](jackrabbit-status-december-2010.html)
+Jackrabbit in 2010
+------------------
+* December 2010: [Jackrabbit Status December 2010](status/jackrabbit-status-december-2010.html)
* December 2010: Apache Jackrabbit 2.2 [released](http://markmail.org/message/2zq6unitjdyvbiar)
-* September 2010: [Jackrabbit Status September 2010](jackrabbit-status-september-2010.html)
-* June 2010: [Jackrabbit Status June 2010](jackrabbit-status-june-2010.html)
+* September 2010: [Jackrabbit Status September 2010](status/jackrabbit-status-september-2010.html)
+* June 2010: [Jackrabbit Status June 2010](status/jackrabbit-status-june-2010.html)
* April 2010: Apache Jackrabbit 2.1 [released](http://markmail.org/message/5v7aaxsctgz4vvsz)
-* March 2010: [Jackrabbit Status March 2010](jackrabbit-status-march-2010.html)
+* March 2010: [Jackrabbit Status March 2010](status/jackrabbit-status-march-2010.html)
* January 2010: Apache Jackrabbit 2.0 [released](http://markmail.org/message/oljl5ggvt725jksu)
-<a name="JackrabbitHistory-Jackrabbitin2009"></a>
-## Jackrabbit in 2009
-* December 2009: [Jackrabbit Status December 2009](jackrabbit-status-december-2009.html)
-* September 2009: [Jackrabbit Status September 2009](jackrabbit-status-september-2009.html)
+Jackrabbit in 2009
+------------------
+* December 2009: [Jackrabbit Status December 2009](status/jackrabbit-status-december-2009.html)
+* September 2009: [Jackrabbit Status September 2009](status/jackrabbit-status-september-2009.html)
* August 2009: Apache Jackrabbit 1.6 [released](http://markmail.org/message/uojg7bkwm3cfnrvt)
-* June 2009: [Jackrabbit Status June 2009](jackrabbit-status-june-2009.html)
-* March 2009: [Jackrabbit Status March 2009](jackrabbit-status-march-2009.html)
+* June 2009: [Jackrabbit Status June 2009](status/jackrabbit-status-june-2009.html)
+* March 2009: [Jackrabbit Status March 2009](status/jackrabbit-status-march-2009.html)
-<a name="JackrabbitHistory-Jackrabbitin2008"></a>
-## Jackrabbit in 2008
-* December 2008: [Jackrabbit Status December 2008](jackrabbit-status-december-2008.html)
+Jackrabbit in 2008
+------------------
+* December 2008: [Jackrabbit Status December 2008](status/jackrabbit-status-december-2008.html)
* December 2008: Apache Jackrabbit 1.5 [released](http://markmail.org/message/ui7jard4owktrxut)
-* September 2008: [Jackrabbit Status September 2008](jackrabbit-status-september-2008.html)
-* June 2008: [Jackrabbit Status June 2008](jackrabbit-status-june-2008.html)
-* March 2008: [Jackrabbit Status March 2008](jackrabbit-status-march-2008.html)
+* September 2008: [Jackrabbit Status September 2008](status/jackrabbit-status-september-2008.html)
+* June 2008: [Jackrabbit Status June 2008](status/jackrabbit-status-june-2008.html)
+* March 2008: [Jackrabbit Status March 2008](status/jackrabbit-status-march-2008.html)
* January 2008: Apache Jackrabbit 1.4 [released](http://markmail.org/message/ivkdm62rp5cksap4)
-<a name="JackrabbitHistory-Jackrabbitin2007"></a>
-## Jackrabbit in 2007
-* December 2007: [Jackrabbit Status December 2007](jackrabbit-status-december-2007.html)
-* September 2007: [Jackrabbit Status September 2007](jackrabbit-status-september-2007.html)
-* June 2007: [Jackrabbit Status June 2007](jackrabbit-status-june-2007.html)
+Jackrabbit in 2007
+------------------
+* December 2007: [Jackrabbit Status December 2007](status/jackrabbit-status-december-2007.html)
+* September 2007: [Jackrabbit Status September 2007](status/jackrabbit-status-september-2007.html)
+* June 2007: [Jackrabbit Status June 2007](status/jackrabbit-status-june-2007.html)
* April 2007: Apache Jackrabbit 1.3 [released](http://markmail.org/message/fchceeuamcg4fxyw)
-* March 2007: [Jackrabbit Status March 2007](jackrabbit-status-march-2007.html)
+* March 2007: [Jackrabbit Status March 2007](status/jackrabbit-status-march-2007.html)
* January 2007: Apache Jackrabbit 1.2 [released](http://markmail.org/message/wjopzzughkzgceqr)
-<a name="JackrabbitHistory-Jackrabbitin2006"></a>
-## Jackrabbit in 2006
-* December 2006: [Jackrabbit Status December 2006](jackrabbit-status-december-2006.html)
+Jackrabbit in 2006
+------------------
+* December 2006: [Jackrabbit Status December 2006](status/jackrabbit-status-december-2006.html)
* October 2006: Apache Jackrabbit 1.1 [released](http://markmail.org/message/3atqtbuviomoo7dj)
-* September 2006: [Jackrabbit Status September 2006](jackrabbit-status-september-2006.html)
-* August 2006: [Jackrabbit Chair 2006 Resolution](jackrabbit-chair-2006-resolution.html)
- makes Jukka Zitting the PMC chair
-* July 2006: [Jackrabbit Status July 2006](jackrabbit-status-july-2006.html)
-* May 2006: [Jackrabbit Status May 2006](jackrabbit-status-may-2006.html)
-* April 2006: [Jackrabbit Status April 2006](jackrabbit-status-april-2006.html)
+* September 2006: [Jackrabbit Status September 2006](status/jackrabbit-status-september-2006.html)
+* August 2006: [Jackrabbit Chair 2006 Resolution](jackrabbit-chair-2006-resolution.html) makes Jukka Zitting the PMC chair
+* July 2006: [Jackrabbit Status July 2006](status/jackrabbit-status-july-2006.html)
+* May 2006: [Jackrabbit Status May 2006](status/jackrabbit-status-may-2006.html)
+* April 2006: [Jackrabbit Status April 2006](status/jackrabbit-status-april-2006.html)
* April 2006: Apache Jackrabbit 1.0 [released](http://markmail.org/message/jlk4qe336lne7v4m)
-* March 2006: The [Apache Jackrabbit Resolution](apache-jackrabbit-resolution.html)
- makes Jackrabbit a TLP with Roy Fielding as the PMC chair
-* March 2006: [Jackrabbit Status March 2006](jackrabbit-status-march-2006.html)
+* March 2006: The [Apache Jackrabbit Resolution](apache-jackrabbit-resolution.html) makes Jackrabbit a TLP with Roy Fielding as the PMC chair
+* March 2006: [Jackrabbit Status March 2006](status/jackrabbit-status-march-2006.html)
* February 2006: Apache Jackrabbit 0.9 (incubating) [released](http://markmail.org/message/7q5jhiob5wurrnpn)
-* January 2006: [Jackrabbit Status January 2006](jackrabbit-status-january-2006.html)
+* January 2006: [Jackrabbit Status January 2006](status/jackrabbit-status-january-2006.html)
-<a name="JackrabbitHistory-Jackrabbitin2005"></a>
-## Jackrabbit in 2005
-* October 2005: [Jackrabbit Status October 2005](jackrabbit-status-october-2005.html)
-* July 2005: [Jackrabbit Status July 2005](jackrabbit-status-july-2005.html)
-* April 2005: [Jackrabbit Status April 2005](jackrabbit-status-april-2005.html)
+Jackrabbit in 2005
+------------------
+* October 2005: [Jackrabbit Status October 2005](status/jackrabbit-status-october-2005.html)
+* July 2005: [Jackrabbit Status July 2005](status/jackrabbit-status-july-2005.html)
+* April 2005: [Jackrabbit Status April 2005](status/jackrabbit-status-april-2005.html)
-<a name="JackrabbitHistory-Jackrabbitin2004"></a>
-## Jackrabbit in 2004
-* October 2004: [Jackrabbit Status October 2004](jackrabbit-status-october-2004.html)
+Jackrabbit in 2004
+------------------
+* October 2004: [Jackrabbit Status October 2004](status/jackrabbit-status-october-2004.html)
* September 2004: The incubating Apache Jackrabbit project is [started](http://markmail.org/message/naqqdwlvd25d7ep6)
-* September 2004: The project is [renamed](http://markmail.org/message/mypq2iozpelmuvqh)
- to "Jackrabbit"
-* August 2004: The [JCR Proposal](http://wiki.apache.org/incubator/JcrProposal)
- is [accepted|http://markmail.org/message/3le75qdgvujzhv74]
- by the Incubator PMC
-* August 2004: The idea of making the JCR RI an independent project in the
-Incubator is [discussed](http://markmail.org/message/tc3wjlmw3m6yknvx)
-* May 2004: The JCR RI [returns](http://markmail.org/message/kmhfyqm4aoc6ijxl)
- to the Slide CVS
-* February 2004: The JCR RI codebase is [removed](http://markmail.org/message/hyt3b5intr6mj53m)
- from Slide CVS for [various reasons|http://markmail.org/message/wt264hfdr34vr2ep]
-
-<a name="JackrabbitHistory-Jackrabbitin2003"></a>
-## Jackrabbit in 2003
-
-* February 2003: Initial version of the JCR RI codebase is [imported](http://markmail.org/message/mnhcaeifc5a6bgpb)
- to Slide CVS
-* February 2003: The first [proposal](http://markmail.org/message/i32zkqeijec6hw37)
- is made of making Slide the JSR 170 reference implementation
-
-<a name="JackrabbitHistory-Jackrabbitin2002"></a>
-## Jackrabbit in 2002
-
-* May 2002: Initial ideas about making Slide a JSR 170 content repository
-are [discussed](http://markmail.org/message/2gqv3a4wgjkbhieb)
-* February 2002: JSR 170 is first [mentioned](http://markmail.org/message/y2vrelkge7c3vopx)
- on the Slide development list
+* September 2004: The project is [renamed](http://markmail.org/message/mypq2iozpelmuvqh) to "Jackrabbit"
+* August 2004: The [JCR Proposal](http://wiki.apache.org/incubator/JcrProposal) is [accepted|http://markmail.org/message/3le75qdgvujzhv74] by the Incubator PMC
+* August 2004: The idea of making the JCR RI an independent project in the Incubator is [discussed](http://markmail.org/message/tc3wjlmw3m6yknvx)
+* May 2004: The JCR RI [returns](http://markmail.org/message/kmhfyqm4aoc6ijxl) to the Slide CVS
+* February 2004: The JCR RI codebase is [removed](http://markmail.org/message/hyt3b5intr6mj53m) from Slide CVS for [various reasons|http://markmail.org/message/wt264hfdr34vr2ep]
+
+
+Jackrabbit in 2003
+------------------
+* February 2003: Initial version of the JCR RI codebase is [imported](http://markmail.org/message/mnhcaeifc5a6bgpb) to Slide CVS
+* February 2003: The first [proposal](http://markmail.org/message/i32zkqeijec6hw37) is made of making Slide the JSR 170 reference implementation
+
+
+Jackrabbit in 2002
+------------------
+* May 2002: Initial ideas about making Slide a JSR 170 content repository are [discussed](http://markmail.org/message/2gqv3a4wgjkbhieb)
+* February 2002: JSR 170 is first [mentioned](http://markmail.org/message/y2vrelkge7c3vopx) on the Slide development list
Modified: jackrabbit/site/trunk/src/site/markdown/jcr--api.md
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/src/site/markdown/jcr--api.md?rev=1671120&r1=1671119&r2=1671120&view=diff
==============================================================================
--- jackrabbit/site/trunk/src/site/markdown/jcr--api.md (original)
+++ jackrabbit/site/trunk/src/site/markdown/jcr--api.md Fri Apr 3 18:23:58 2015
@@ -1,46 +1,81 @@
-Jackrabbit is a complete, and fully compliant implementation of the Content Repository API for Java Technology (JCR) and therefore its primary API is defined by JCR. For a developer this means that most operations required are defined by the JCR API. The classes and interfaces within Apache Jackrabbit are only needed when accessing functionality that is not specified in JCR.
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+JCR API
+=======
+Jackrabbit is a complete, and fully compliant implementation of the Content Repository API for Java Technology (JCR)
+and therefore its primary API is defined by JCR. For a developer this means that most operations required are defined by
+the JCR API. The classes and interfaces within Apache Jackrabbit are only needed when accessing functionality that is
+not specified in JCR.
-Beyond the JCR API Jackrabbit features numerous extensions and administrational features that are needed to run a repository but are not (yet) specified by JCR. (see [Jackrabbit Architecture])
+Beyond the JCR API Jackrabbit features numerous extensions and administrational features that are needed to run a
+repository but are not (yet) specified by JCR. (see [Jackrabbit Architecture](jackrabbit-architecture.html))
See the javadoc documentation of the JCR API and Apache Jackrabbit releases:
-* [JCR 2.0|http://www.day.com/maven/javax.jcr/javadocs/jcr-2.0/]
-* [Apache Jackrabbit 2.2|http://jackrabbit.apache.org/api/2.2/]
-* [Apache Jackrabbit 2.1|http://jackrabbit.apache.org/api/2.1/]
-* [Apache Jackrabbit 2.0|http://jackrabbit.apache.org/api/2.0/]
-
-* [JCR 1.0|http://www.day.com/maven/jsr170/javadocs/jcr-1.0/]
-* [Apache Jackrabbit 1.6|http://jackrabbit.apache.org/api/1.6/]
-* [Apache Jackrabbit 1.5|http://jackrabbit.apache.org/api/1.5/]
-* [Apache Jackrabbit 1.4|http://jackrabbit.apache.org/api/1.4/]
-* [Apache Jackrabbit 1.3|http://jackrabbit.apache.org/api/1.3/]
-* [Apache Jackrabbit 1.2|http://jackrabbit.apache.org/api/1.2.3/]
-* [Apache Jackrabbit 1.0|http://jackrabbit.apache.org/api-1/]
-
-h2. JSR-170 Levels
-
-The Content Repository API for Java Technology (JSR-170) is split into different Levels of compliancy, to allow Repository Vendors to gradually adopt JSR-170 and to avoid that the overhead is unnecessarily high for repository vendors that only want to expose portions of their repository functionality through a JSR-170 compliant Interface. JSR-170 specifies a Level 1, a Level 2 and a set of advanced repository feature blocks. Jackrabbit is fully JSR-170 compliant and therefore supports Level 1, Level 2 and all the optional blocks.
-
-h3. Level 1 : Ease of Adoption, Covering many usecases
-
-The Scope of Level 1 of JSR-170 to cover a large number of simple Applications, that need to search repositories and need to read from repositories. Level 1 specifies a read-only API that allows to introspect Node and Property-types and offers hierarchical read access to content stored in a repository.
-
-{center}!level-1.jpg!{center}
-
-Level 1 of JSR-170 is geared to allow people to write applications such as search and display Portlets, CMS-Templates, Reports, Exports or other applications that harvest, search, present or display information from one or multiple repositories.
-
-h3. Level 2 : Writeable Repository
-
-Level 2 of JSR-170 specifies all the writing capabilities need to bi-directionally interact with a content repository in a fine and coarse grained fashion.
-
-{center}!level-2.jpg!{center}
-
-Applications written against Level 2 of JSR-170 include management applications or generally speaking any application that generates data, information or content for both structured and unstructured information.
-
-h3. Advanced Options
-
-On top of Level 1 or Level 2 a number of functional block serve for more advanced repository functionality. This includes functions like: Versioning, (JTA) Transactions, Query using SQL, Explicit Locking and Content Observation.
-
-{center}!level-adv.jpg!{center}
-
-A fully JSR-170 compliant repository like Jackrabbit encompasses all the functionalities and therefore lends itself as general purpose, off-the-shelf infrastructure for Content-, Document- and Source Code Management or for just about any other application that persists content.
\ No newline at end of file
+* [JCR 2.0](http://www.day.com/maven/javax.jcr/javadocs/jcr-2.0/)
+* [Apache Jackrabbit 2.2](http://jackrabbit.apache.org/api/2.2/)
+* [Apache Jackrabbit 2.1](http://jackrabbit.apache.org/api/2.1/)
+* [Apache Jackrabbit 2.0](http://jackrabbit.apache.org/api/2.0/)
+
+
+* [JCR 1.0](http://www.day.com/maven/jsr170/javadocs/jcr-1.0/)
+* [Apache Jackrabbit 1.6](http://jackrabbit.apache.org/api/1.6/)
+* [Apache Jackrabbit 1.5](http://jackrabbit.apache.org/api/1.5/)
+* [Apache Jackrabbit 1.4](http://jackrabbit.apache.org/api/1.4/)
+* [Apache Jackrabbit 1.3](http://jackrabbit.apache.org/api/1.3/)
+* [Apache Jackrabbit 1.2](http://jackrabbit.apache.org/api/1.2.3/)
+* [Apache Jackrabbit 1.0](http://jackrabbit.apache.org/api-1/)
+
+JSR-170 Levels
+--------------
+The Content Repository API for Java Technology (JSR-170) is split into different Levels of compliancy, to allow
+Repository Vendors to gradually adopt JSR-170 and to avoid that the overhead is unnecessarily high for repository
+vendors that only want to expose portions of their repository functionality through a JSR-170 compliant Interface.
+
+JSR-170 specifies a Level 1, a Level 2 and a set of advanced repository feature blocks. Jackrabbit is fully JSR-170
+compliant and therefore supports Level 1, Level 2 and all the optional blocks.
+
+### Level 1 : Ease of Adoption, Covering many usecases
+The Scope of Level 1 of JSR-170 to cover a large number of simple Applications, that need to search repositories and
+need to read from repositories. Level 1 specifies a read-only API that allows to introspect Node and Property-types
+and offers hierarchical read access to content stored in a repository.
+
+
+
+Level 1 of JSR-170 is geared to allow people to write applications such as search and display Portlets,
+CMS-Templates, Reports, Exports or other applications that harvest, search, present or display information from one
+or multiple repositories.
+
+### Level 2 : Writeable Repository
+Level 2 of JSR-170 specifies all the writing capabilities need to bi-directionally interact with a content repository
+in a fine and coarse grained fashion.
+
+
+
+Applications written against Level 2 of JSR-170 include management applications or generally speaking any application
+that generates data, information or content for both structured and unstructured information.
+
+### Advanced Options
+On top of Level 1 or Level 2 a number of functional block serve for more advanced repository functionality. This
+includes functions like: Versioning, (JTA) Transactions, Query using SQL, Explicit Locking and Content Observation.
+
+
+
+A fully JSR-170 compliant repository like Jackrabbit encompasses all the functionality and therefore lends itself as
+general purpose, off-the-shelf infrastructure for Content-, Document- and Source Code Management or for just about any
+other application that persists content.
\ No newline at end of file