aries-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r1041931 - in /incubator/aries/branches/site: README trunk/content/jndiproject.mdtext trunk/content/jpaproject.mdtext trunk/content/samples.mdtext
Date Fri, 03 Dec 2010 17:51:41 GMT
Author: zoe
Date: Fri Dec  3 17:51:41 2010
New Revision: 1041931

ARIES-502 More fixed and update teh README


Modified: incubator/aries/branches/site/README
--- 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:
+, look under adption constraints.
-2) Extracted the cwiki contenet using the tool.
+2) Extracted the cwiki content using the 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:
+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 and can be found here:
+3) To build the site using the build tools.
 First check the cms build tools out of SVN.
-To run the script I had to:
+To run the script I had to remove a library:
+rm lib/Dotiac/DTL/Addon/ 
-rm lib/Dotiac/DTL/Addon/ 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 --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
+<VirtualHost *:80>
+    ServerAdmin
+    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
+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
--- 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
 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
--- 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](
  to be used in an OSGi environment and will provide container managed

Modified: incubator/aries/branches/site/trunk/content/samples.mdtext
--- 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](
  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

View raw message