aries-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From z..@apache.org
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

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.



Mime
View raw message