You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@aries.apache.org by zo...@apache.org on 2010/12/03 18:51:41 UTC
svn commit: r1041931 - in /incubator/aries/branches/site: README
trunk/content/jndiproject.mdtext trunk/content/jpaproject.mdtext
trunk/content/samples.mdtext
Author: zoe
Date: Fri Dec 3 17:51:41 2010
New Revision: 1041931
URL: http://svn.apache.org/viewvc?rev=1041931&view=rev
Log:
ARIES-502 More fixed and update teh README
Modified:
incubator/aries/branches/site/README
incubator/aries/branches/site/trunk/content/jndiproject.mdtext
incubator/aries/branches/site/trunk/content/jpaproject.mdtext
incubator/aries/branches/site/trunk/content/samples.mdtext
Modified: incubator/aries/branches/site/README
URL: http://svn.apache.org/viewvc/incubator/aries/branches/site/README?rev=1041931&r1=1041930&r2=1041931&view=diff
==============================================================================
--- incubator/aries/branches/site/README (original)
+++ incubator/aries/branches/site/README Fri Dec 3 17:51:41 2010
@@ -1,11 +1,13 @@
This is the new Apache Aries site content
==========================================
-Here is what I did to create it.
+Here is what I did to create it. Steps 1 and 2 should never need to br repeated so they are just here for reference.
+Go straight to step 3 if you want to build the site and test it.
-1) Branched the old site and created the new site structure as specififed
+1) Branched the old site and created the new site structure as specififed on the cms pages:
+http://www.apache.org/dev/cms.html, look under adption constraints.
-2) Extracted the cwiki contenet using the export-site.pl tool.
+2) Extracted the cwiki content using the export-site.pl tool.
To run this I had to install some extra perl modules:
sudo port install p5-crypt-ssleay
@@ -14,25 +16,58 @@ Here is what I did to create it.
These are Mac specific Darwin ports commands, could also have installed from CPAN.
-This generates the site content as *.mdtext files - but also leaves the cwiki files for reference
+This generates the site content as *.mdtext files - but also leaves the cwiki files for reference.
+The results of all of this are currently checked in here:
+https://svn.apache.org/repos/asf/incubator/aries/branches/site/.
+
+After the initial creation I had to:
+(a) Create a site template
+(b) Workout how to fix teh navigation panes (look at the templates directory)
+(c) Fix a lot of places where the wiki conversion had't worked right
+(d) In particular the downloads page - which we used to handle with a confluenece Macro
-3) Next step is to build the site using the build tools.
+There is still more fixing up to be done!
+
+At this point anyone should be able to check out, build and test the site. The tool used to build the site is
+build_site.pl and can be found here: https://svn.apache.org/repos/infra/websites/cms/build/
+
+3) To build the site using the build tools.
First check the cms build tools out of SVN.
-To run the build_site.pl script I had to:
+To run the build_site.pl script I had to remove a library:
+
+rm lib/Dotiac/DTL/Addon/markup.pl
-rm lib/Dotiac/DTL/Addon/markup.pl from teh build tools directory, then install:
+from the build tools directory.
+Install two other libraries:
sudo perl -MCPAN -e "install Dotiac::DTL"
sudo cpan Dotiac::DTL::Addon::markup
-Also need to take a guess at what the site template shoudl be like. I copied comdev's.
+Then to build the site:
+
+perl build_site.pl --source-base /path/to/newsite/trunk/ --target-base /path/to/output/
4) Check the site on a local server.
-The template needed a lot of fixing.
-The navigation needed some very specific fixing of the mdtext file.
-The site (mainly links) also still need a lot of fixing.
+I have a vhost to check the site. On a Mac this means that I add teh following stanza to /etc/apache2/extra/httpd-vhosts.conf
+
+<VirtualHost *:80>
+ ServerAdmin zoe.slattery@googlemail.com
+ DocumentRoot "/Users/zoe/Sites/zaries/www"
+ ServerName zaries
+ ErrorLog "/Users/zoe/Sites/zaries/error.log"
+ CustomLog "/Users/zoe/Sites/zaries/access.log" custom
+
+ LogLevel debug
+</VirtualHost>
+
+So to test the site I move it, like this:
+
+mv /path/to/output/content /Users/zoe/Sites/zaries/www
+
+Then navigate to http://zaries in a browser.
+
Modified: incubator/aries/branches/site/trunk/content/jndiproject.mdtext
URL: http://svn.apache.org/viewvc/incubator/aries/branches/site/trunk/content/jndiproject.mdtext?rev=1041931&r1=1041930&r2=1041931&view=diff
==============================================================================
--- incubator/aries/branches/site/trunk/content/jndiproject.mdtext (original)
+++ incubator/aries/branches/site/trunk/content/jndiproject.mdtext Fri Dec 3 17:51:41 2010
@@ -1,6 +1,6 @@
Title: JNDIProject
<a name="JNDIProject-Overview"></a>
-##### Overview
+# JNDI
The Aries JNDI project aims to provide a fully compliant implementation of
the OSGi Alliance JNDI Service Specification. This specification details
@@ -9,7 +9,7 @@ environment. It also defines how to obta
registry via JNDI.
<a name="JNDIProject-ServiceRegistryaccessfromJNDI"></a>
-##### Service Registry access from JNDI
+## Service Registry access from JNDI
The OSGi service registry provides a centralised register/query capability
for OSGi services. A common pattern outside of OSGi is to make use of the
@@ -19,7 +19,7 @@ project provides two URL lookup mechanis
access the service registry.
<a name="JNDIProject-osgi:service"></a>
-###### osgi:service
+## osgi:service
The osgi:service lookup scheme is defined by the JNDI Service Specification
and follows the scheme:
@@ -77,14 +77,14 @@ such alternative exists then an org.osgi
type of ServiceException.UNREGISTERED.
<a name="JNDIProject-osgi:servicelist"></a>
-###### osgi:servicelist
+## osgi:servicelist
It is possible that there are multiple services in the registry that match.
In this case the osgi:servicelist lookup scheme can be used. It has the
same format as osgi:service, but it is designed to return multiple.
<a name="JNDIProject-aries:services"></a>
-###### aries:services
+## aries:services
The aries:services scheme works in the same way as the osgi:service scheme,
but does not perform proxying. You get the actual object back. Care must be
@@ -97,7 +97,7 @@ up cannot occur.
<a name="JNDIProject-MoreInformation"></a>
-##### More Information
+## More Information
Modified: incubator/aries/branches/site/trunk/content/jpaproject.mdtext
URL: http://svn.apache.org/viewvc/incubator/aries/branches/site/trunk/content/jpaproject.mdtext?rev=1041931&r1=1041930&r2=1041931&view=diff
==============================================================================
--- incubator/aries/branches/site/trunk/content/jpaproject.mdtext (original)
+++ incubator/aries/branches/site/trunk/content/jpaproject.mdtext Fri Dec 3 17:51:41 2010
@@ -1,4 +1,5 @@
Title: JPAProject
+# JPA
The Aries JPA project will make it easy for JPA persistence providers such
as [Apache OpenJPA](http://openjpa.apache.org/)
to be used in an OSGi environment and will provide container managed
Modified: incubator/aries/branches/site/trunk/content/samples.mdtext
URL: http://svn.apache.org/viewvc/incubator/aries/branches/site/trunk/content/samples.mdtext?rev=1041931&r1=1041930&r2=1041931&view=diff
==============================================================================
--- incubator/aries/branches/site/trunk/content/samples.mdtext (original)
+++ incubator/aries/branches/site/trunk/content/samples.mdtext Fri Dec 3 17:51:41 2010
@@ -2,43 +2,19 @@ Title: Samples
<a name="Samples-Samples"></a>
# Samples
-<a name="Samples-[BlogSample](blogsample.html)"></a>
-### [Blog Sample|Blog Sample]
+### [BlogSample](blogsample.html)
Includes Blueprint, WAB and JPA concepts delivered in a EBA.
-<a name="Samples-[AriesTraderSample](ariestrader.html)"></a>
-### [AriesTrader Sample|AriesTrader]
+### [AriesTraderSample](ariestrader.html)
Includes Blueprint, WAB and JPA concepts delivered in a EBA.
You may also know this as the [Apache Geronimo Daytrader](https://cwiki.apache.org/GMOxDOC22/daytrader-a-more-complex-application.html)
application, which has been migrated from a pure Java EE environment to a
OSGi Blueprint model.
-<a name="Samples-[GOATSample](goatsample.html)"></a>
-### [GOAT Sample|GOATSample]
+### [GOATSample](goatsample.html)
A graphical tool for displaying the status of, and relationships between,
OSGi bundles running in an OSGi framework.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<a name="Samples-[ArchivedSampleInstructions](archiveinstructions.html)"></a>
-#### [Archived Sample Instructions|ArchiveInstructions]
+### [ArchivedSampleInstructions](archiveinstructions.html)
Archived versions of Sample instructions from earlier Apache Aries
releases.