You are viewing a plain text version of this content. The canonical link for it is here.
Posted to pluto-scm@portals.apache.org by zh...@apache.org on 2006/01/16 15:05:18 UTC

svn commit: r369472 - in /portals/pluto/trunk/pluto-site/src/site: apt/ resources/css/site.css site.xml xdoc/app-servers.xml xdoc/getting-started.xml xdoc/index.xml xdoc/mirrors.xml xdoc/mission.xml xdoc/news.xml xdoc/resources.xml xdoc/subprojects.xml

Author: zheng
Date: Mon Jan 16 06:05:06 2006
New Revision: 369472

URL: http://svn.apache.org/viewcvs?rev=369472&view=rev
Log:
Moving all apt docs to xdocs

Added:
    portals/pluto/trunk/pluto-site/src/site/xdoc/app-servers.xml
    portals/pluto/trunk/pluto-site/src/site/xdoc/getting-started.xml
    portals/pluto/trunk/pluto-site/src/site/xdoc/mission.xml
    portals/pluto/trunk/pluto-site/src/site/xdoc/resources.xml
    portals/pluto/trunk/pluto-site/src/site/xdoc/subprojects.xml
Removed:
    portals/pluto/trunk/pluto-site/src/site/apt/
Modified:
    portals/pluto/trunk/pluto-site/src/site/resources/css/site.css
    portals/pluto/trunk/pluto-site/src/site/site.xml
    portals/pluto/trunk/pluto-site/src/site/xdoc/index.xml
    portals/pluto/trunk/pluto-site/src/site/xdoc/mirrors.xml
    portals/pluto/trunk/pluto-site/src/site/xdoc/news.xml

Modified: portals/pluto/trunk/pluto-site/src/site/resources/css/site.css
URL: http://svn.apache.org/viewcvs/portals/pluto/trunk/pluto-site/src/site/resources/css/site.css?rev=369472&r1=369471&r2=369472&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-site/src/site/resources/css/site.css (original)
+++ portals/pluto/trunk/pluto-site/src/site/resources/css/site.css Mon Jan 16 06:05:06 2006
@@ -113,26 +113,46 @@
     
 }
 
+/**
+ * The section title.
+ */
 .section h2 {
-    padding-left: 0.25em;
-    background-color: #8DB7DF;
-    color: #FFFFFF;
+    padding: 0em;
+    margin: 0.25em 0em 0.25em 0em;
+    background-color: #FFFFFF;
+    color: #6D97BF;
+    font-family: "Trebuchet MS", Trebuchet, Arial, Verdana, Sans-serif;
     font-weight: bold;
     white-space: nowrap;
-    border-width: 1px;
-    border-style: solid;
-    border-color: #2E6794;
+    border-width: 0px;
 }
 
+/**
+ * The subsection title.
+ */
 .section h3 {
-    padding-left: 0.25em;
-    background-color: #CCCCCC;
-    color: white;
+    padding: 0em;
+    margin: 0.25em 0em 0.25em 0em;
+    background-color: #FFFFFF;
+    color: #000000;
+    font-family: "Trebuchet MS", Trebuchet, Arial, Verdana, Sans-serif;
     font-weight: bold;
     white-space: nowrap;
-    border-width: 1px;
-    border-style: solid;
-    border-color: #2E6794;
+    border-width: 0px;
+}
+
+/**
+ * The subsection title.
+ */
+.section h4 {
+    padding: 0em;
+    margin: 0.25em 0em 0.25em 0em;
+    background-color: #FFFFFF;
+    color: #000000;
+    font-family: "Trebuchet MS", Trebuchet, Arial, Verdana, Sans-serif;
+    font-size: 120%;
+    font-weight: bold;
+    border-width: 0px;
 }
 
 #footer {

Modified: portals/pluto/trunk/pluto-site/src/site/site.xml
URL: http://svn.apache.org/viewcvs/portals/pluto/trunk/pluto-site/src/site/site.xml?rev=369472&r1=369471&r2=369472&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-site/src/site/site.xml (original)
+++ portals/pluto/trunk/pluto-site/src/site/site.xml Mon Jan 16 06:05:06 2006
@@ -1,6 +1,23 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+Copyright 2004 The Apache Software Foundation
+Licensed  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.
+-->
 
-<project name="Maven">
+<project name="Pluto">
+  
   <bannerLeft>
     <name>Pluto</name>
     <src>http://portals.apache.org/pluto/images/apache-portals.gif</src>
@@ -9,61 +26,60 @@
   <bannerRight>
     <src>http://portals.apache.org/pluto/images/banner.png</src>
   </bannerRight>
+  
   <body>
+    
     <links>
       <item name="JSR 168" href="http://jcp.org/en/jsr/detail?id=168"/>
       <item name="JSR 286" href="http://jcp.org/en/jsr/detail?id=286"/>
       <item name="Chinese Translation" href="http://people.apache.org/~zheng/pluto/chinese/"/>
     </links>
-
-	<menu name="The Pluto Project">
+    
+    <menu name="The Pluto Project">
       <item name="About Pluto" href="/index.html"/>
       <item name="Mission" href="/mission.html"/>
-	  <iten name="Download" href="http://www.apache.org/dyn/closer.cgi/portals/pluto/"/>
+      <iten name="Download" href="http://www.apache.org/dyn/closer.cgi/portals/pluto/"/>
       <item name="News" href="/news.html"/>
-	  <item name="FAQ" href="/faq.html"/>
-	  <item name="Powered By Pluto" href="/powered.html"/>
-	</menu>
-
-	<menu name="Pluto 1.0.1">
+      <item name="FAQ" href="/faq.html"/>
+      <item name="Powered By Pluto" href="/powered.html"/>
+    </menu>
+    
+    <menu name="Pluto 1.0.1">
       <item name="Getting Started" href="/v101/install.html"/>
-	  <item name="Resources" href="/v101/resources.html"/>
-	  <menu name="User Guide" href="/v101/userguide/index.html">
+      <item name="Resources" href="/v101/resources.html"/>
+      <menu name="User Guide" href="/v101/userguide/index.html">
         <item name="Portal Guide" href="/v101/userguide/portal.html"/>
         <item name="Testsuite Guide" href="/v101/userguide/testsuite.html"/>
-	  </menu>
-	  <menu name="Developer Guide" href="/v101/developer/index.html">
+      </menu>
+      <menu name="Developer Guide" href="/v101/developer/index.html">
         <item name="Architecture" href="/v101/developer/arch.html"/>
         <item name="Obtaining Source" href="/v101/developer/subversion.html"/>
         <item name="Building From Source" href="/v101/developer/build_source.html"/>
-		<item name="Integrating/Embedding" href="/v101/developer/integrate.html"/>
-	  </menu>
-	</menu>
-
+        <item name="Integrating/Embedding" href="/v101/developer/integrate.html"/>
+      </menu>
+    </menu>
+    
     <menu name="Pluto 1.1">
       <item name="Getting Started" href="/getting-started.html"/>
       <item name="App Servers" href="/app-servers.html"/>
       <item name="Resources" href="/resources.html"/>
-
       <menu name="Subprojects" href="subprojects.html" collapsed="true">
         <item name="Portlet Container" href="/pluto-container/index.html"/>
-		<item name="Portlet Tags" href="/pluto-taglib/index.html"/>
-
+        <item name="Portlet Tags" href="/pluto-taglib/index.html"/>
         <item name="Portal Driver" href="/pluto-container/index.html"/>
         <item name="Portal" href="/pluto-container/index.html"/>
-		<item name="Testsuite" href="/pluto-testsuite/index.html"/>
-
+        <item name="Testsuite" href="/pluto-testsuite/index.html"/>
         <item name="Descriptor API" href="/pluto-descriptor-api/index.html"/>
         <item name="Descriptor Impl" href="/pluto-descriptor-impl/index.html"/>
-
-		<item name="Optional Services" href="/pluto-optional-services/index.html"/>
-		<item name="Maven Plugin" href="/maven-pluto-plugin/index.html"/>
-		<item name="Ant Tasks" href="/pluto-ant-tasks/index.html"/>
+        <item name="Optional Services" href="/pluto-optional-services/index.html"/>
+        <item name="Maven Plugin" href="/maven-pluto-plugin/index.html"/>
+        <item name="Ant Tasks" href="/pluto-ant-tasks/index.html"/>
         <item name="Util" href="/pluto-container/index.html"/>
       </menu>
     </menu>
-
-
+    
     ${reports}
+    
   </body>
+  
 </project>

Added: portals/pluto/trunk/pluto-site/src/site/xdoc/app-servers.xml
URL: http://svn.apache.org/viewcvs/portals/pluto/trunk/pluto-site/src/site/xdoc/app-servers.xml?rev=369472&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-site/src/site/xdoc/app-servers.xml (added)
+++ portals/pluto/trunk/pluto-site/src/site/xdoc/app-servers.xml Mon Jan 16 06:05:06 2006
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+Copyright 2004 The Apache Software Foundation
+Licensed  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.
+-->
+
+<document>
+  
+  <properties>
+    <title>Supported Application Servers</title>
+    <author email="ddewolf@apache.org">David DeWolf</author>
+  </properties>
+  
+  <body>
+    <section name="Supported Application Servers">
+      <p>The following application servers have been tested with Pluto 1.1:</p>
+      <p>
+        <table>
+          <tr>
+            <th>App Server</th>
+            <th>Version</th>
+            <th>Status</th>
+            <th>Notes</th>
+          </tr>
+          <tr>
+            <td>Tomcat</td>
+            <td>5.5.9</td>
+            <td>WORKING</td>
+            <td>
+              Use pluto-util module to install the the container and portal
+              into tomcat.
+            </td>
+          </tr>
+          <tr>
+            <td>Tomcat</td>
+            <td>5.5.12</td>
+            <td>MANUAL</td>
+            <td>
+              Tomcat contains a bug and does not recognize the context
+              configuration.  Manual Installation and renaming will work.
+            </td>
+          </tr>
+          <tr>
+            <td>Jetty</td>
+            <td>5.1.5rc2</td>
+            <td>BEING FIXED</td>
+            <td>Deployment Descriptor Error. See Issue Log.</td>
+          </tr>
+          <tr>
+            <td>WebLogic</td>
+            <td></td>
+            <td>UNTESTED</td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>WebSphere</td>
+            <td></td>
+            <td>UNTESTED</td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>SunOne</td>
+            <td></td>
+            <td>UNTESTED</td>
+            <td></td>
+          </tr>
+        </table>
+      </p>
+    </section>
+  </body>
+  
+</document>
+

Added: portals/pluto/trunk/pluto-site/src/site/xdoc/getting-started.xml
URL: http://svn.apache.org/viewcvs/portals/pluto/trunk/pluto-site/src/site/xdoc/getting-started.xml?rev=369472&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-site/src/site/xdoc/getting-started.xml (added)
+++ portals/pluto/trunk/pluto-site/src/site/xdoc/getting-started.xml Mon Jan 16 06:05:06 2006
@@ -0,0 +1,219 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+Copyright 2004 The Apache Software Foundation
+Licensed  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.
+-->
+
+<document>
+  
+  <properties>
+    <title>Getting Started With Pluto</title>
+    <author email="ddewolf@apache.org">David DeWolf</author>
+  </properties>
+  
+  <body>
+    
+    <section name="Installing Pluto">
+      
+      <p>
+        Maven2 is utilized as the project management and build system for
+        Pluto 1.1. Pluto currently provides Maven plugins which can be used to
+        install the Pluto Portal, assemble portlet applications, deploy
+        applications, and publish portlet applications to the to Pluto Portal.
+      </p>
+      
+      <subsection name="Installing Pluto with Maven 2">
+        <p>
+          <code>&lt;PLUTO-1.1-HOME&gt;</code> is the local directory where the
+          Pluto 1.1 source distribution is located.
+        </p>
+        <p>
+          <source><![CDATA[
+$> cd <PLUTO-1.1-HOME>
+$> mvn install
+$> mvn pluto:install -DinstallDir=path/to/appserver
+          ]]></source>
+        </p>
+        <p>
+          The <code>install</code> goal is a built in Maven 2 lifecycle
+          which builds the project artifacts and installs them into the Maven
+          repository.
+        </p>
+        <p>
+          The <code>pluto:install</code> goal will take the resulting artifacts
+          and properly deploy them within the configured tomcat installation.
+        </p>
+      </subsection>
+      
+      <subsection name="Installing Pluto Manually">
+        <p>
+          <b>Step 1:</b>
+          <source><![CDATA[
+$> cd <PLUTO-1.1-HOME>
+$> mvn install
+          ]]></source>
+        </p>
+        <p>
+          <b>Step 2:</b> Copy the following to
+          <code>&lt;TOMCAT_HOME&gt;/shared/lib</code>:
+          <ul>
+            <li>castor-0.9.6.jar</li>
+            <li>portlet-api-1.0.jar</li>
+            <li>pluto-container-1.1-SNAPSHOT.jar</li>
+            <li>pluto-descriptor-api-1.1-SNAPSHOT.jar</li>
+            <li>pluto-descriptor-impl-1.1-SNAPSHOT.jar</li>
+          </ul>
+        </p>
+        <p>
+          <b>Step 3:</b> Copy the following to
+          <code>&lt;TOMCAT_HOME&gt;/common/endorsed</code>:
+          <ul>
+            <li>xercesImpl-2.6.2.jar</li>
+            <li>xmlParserAPIs-2.6.2.jar</li>
+          </ul>
+        </p>
+        <p>
+          <b>Step 4:</b> Copy the following to
+          <code>&lt;TOMCAT_HOME&gt;/conf/Catalina/localhost</code>:
+          <ul>
+            <li>&lt;PLUTO_HOME&gt;/pluto-portal/src/main/resources/pluto.xml</li>
+            <li>&lt;PLUTO_HOME&gt;/pluto-testsuite/src/main/resources/testsuite.xml</li>
+          </ul>
+        </p>
+        <p>
+          <b>Step 5:</b> Copy the following to
+          <code>&lt;TOMCAT_HOME&gt;/webapps</code>:
+          <ul>
+            <li>pluto-portal.war</li>
+            <li>pluto-testsuite.war</li>
+          </ul>
+        </p>
+      </subsection>
+      
+      <subsection name="Installing Pluto with a Windows EXE">
+        <p>
+          The NSIS Installer is not yet complete, but we hope to have a fully
+          functional one soon.  Anyone is more than welcome to assist us in
+          this process.
+        </p>
+      </subsection>
+      
+    </section>
+    
+    <section name="Deploying the Portlet to the Portal">
+      
+      <subsection name="Portlet Assembly">
+        <p>
+          All portlet applications must be run through the pluto assembler
+          before being deployed. The assembly process injects pluto specific
+          information for deployment.  Specifically, a servlet and servlet
+          mapping are added to the deployment descriptor. This servlet will be
+          used to dispatch portlet requests to the portlet application.
+        </p>
+        <p>
+          Portlet assembly is accomplished during war creation by binding the
+          <code>pluto:assemble</code> goal to the process-resources lifecycle.
+          An example configuration follows (taken from the pluto-testsuite
+          application):
+        </p>
+        <p>
+          <source><![CDATA[
+<plugin>
+  <artifactId>maven-pluto-plugin</artifactId>
+  <version>${pom.version}</version>
+  <executions>
+    <execution>
+      <phase>generate-resources</phase>
+      <goals>
+        <goal>assemble</goal>
+      </goals>
+    </execution>
+  </executions>
+</plugin>
+          ]]></source>
+        </p>
+        <p>
+          Once configured within the portlet application's pom, the webapp and
+          war artifacts created by the project through Maven will include the
+          appropriate resources.
+        </p>
+      </subsection>
+      
+      <subsection name="Portlet Deployment">
+        <p>
+          After portlet applications are assembled properly they must be
+          deployed to the servlet engine within which the portal application
+          is running. This can be acheived by using your favorite Maven
+          appserver plugin or by invoking the following:
+        </p>
+        <p>
+          <source><![CDATA[
+$> cd <PORTLET-APP-HOME>
+$> maven pluto:deploy
+          ]]></source>
+        </p>
+        <p>
+          NOTE: The deployment plugin is currently undergoing modifications
+          and may not be 100% functional.
+        </p>
+      </subsection>
+      
+      <subsection name="Portlet Publishing">
+        <p>
+          All portlet applications that are to be used within the Pluto Portal
+          must be published to the Portal. Publishing notifies the Portal
+          Application that a portlet application is bound (deployed) to a
+          certain context within the app server.
+        </p>
+        <p>
+          Currently the only way to publish an application to the portal is to
+          manually update the Portal's pluto-portal-driver-config.xml file.
+          An automated approach is in development and should be available before
+          the ALPHA-1 release.
+        </p>
+      </subsection>
+      
+      <subsection name="Starting the Portal">
+        <p>
+          <ul>
+            <li>
+              Add a user in the 'pluto' role to conf/tomcat-users.xml in the
+              conf directory of your Tomcat installation (&lt;TOMCAT_HOME&gt;).
+              The simplest way to do this is to add the 'pluto' role to the
+              tomcat user's record.
+            </li>
+            <li>
+              Start up Tomcat as using by running startup.bat or startup.sh in
+              the bin directory of &lt;TOMCAT_HOME&gt;.
+            </li>
+            <li>
+              Browse to http://localhost:8080/pluto/portal
+            </li>
+            <li>
+              Login to Pluto using the user and password you just created in
+              tomcat-users.xml. If you added the 'pluto' role to the tomcat
+              user's record in tomcat-user.xml, you can log in as tomcat/tomcat
+              (This is required to successfully run the Security Mapping Test
+              in the testsuite portlet).
+            </li>
+          </ul>
+        </p>
+      </subsection>
+    </section>
+    
+  </body>
+  
+</document>
+

Modified: portals/pluto/trunk/pluto-site/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewcvs/portals/pluto/trunk/pluto-site/src/site/xdoc/index.xml?rev=369472&r1=369471&r2=369472&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-site/src/site/xdoc/index.xml (original)
+++ portals/pluto/trunk/pluto-site/src/site/xdoc/index.xml Mon Jan 16 06:05:06 2006
@@ -1,4 +1,21 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+Copyright 2004 The Apache Software Foundation
+Licensed  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.
+-->
+
 <document>
   
   <properties>

Modified: portals/pluto/trunk/pluto-site/src/site/xdoc/mirrors.xml
URL: http://svn.apache.org/viewcvs/portals/pluto/trunk/pluto-site/src/site/xdoc/mirrors.xml?rev=369472&r1=369471&r2=369472&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-site/src/site/xdoc/mirrors.xml (original)
+++ portals/pluto/trunk/pluto-site/src/site/xdoc/mirrors.xml Mon Jan 16 06:05:06 2006
@@ -1,4 +1,4 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
 Copyright 2004 The Apache Software Foundation
 Licensed  under the  Apache License,  Version 2.0  (the "License");

Added: portals/pluto/trunk/pluto-site/src/site/xdoc/mission.xml
URL: http://svn.apache.org/viewcvs/portals/pluto/trunk/pluto-site/src/site/xdoc/mission.xml?rev=369472&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-site/src/site/xdoc/mission.xml (added)
+++ portals/pluto/trunk/pluto-site/src/site/xdoc/mission.xml Mon Jan 16 06:05:06 2006
@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+Copyright 2004 The Apache Software Foundation
+Licensed  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.
+-->
+
+<document>
+  
+  <properties>
+    <title>The Pluto Project Mission</title>
+  </properties>
+  
+  <body>
+    <section name="The Pluto Project Mission">
+      <p>
+        The Pluto Portlet Container is the Reference Implementation of the Java
+        Portlet Specification. As such, Pluto offers the development community
+        a reference for interpretation of the specification, portlet developers
+        a container with which compliant portlets can be tested, and portal
+        developers a compliant container with which they can integrate.
+      </p>
+      <p>
+        The following document attempts to clarify the development priorities 
+        of the Apache Pluto project.
+      </p>
+      <p>
+        The primary concern of the pluto community is to ensure that the Pluto
+        Container maintains compatibility with the most current Java Portlet
+        Specification. Enhancements and bug fixes should be completed in a
+        manner in which compatibility is maintained.
+      </p>
+      <p>
+        It is the responsibility of the pluto development team to ensure that
+        no ambiguity is introduced into the reference implementation. No
+        enhancements should be implemented which introduce questions about the
+        specification.
+      </p>
+      <p>
+        It is desirable for Pluto to become a robust and easy to use portlet
+        container. This will facilitate its wider acceptance and usage in the
+        community. In order to accomplish these goals, it is assumed that
+        enhancements which are above and beyond the specification will be
+        introduced. These enhancements may be integrated with Pluto as long as
+        they do not compromise the integrity of the reference implementation as
+        described above.
+      </p>
+      <p>
+        Furthermore, functionality which is clearly beyond the scope of the
+        specification should be documented as such and placed into a package
+        which helps to distinguish it as such. The Pluto container should
+        always remain fully specification compliant and in working state when
+        these enhancements are removed. In most cases, this removal should be
+        supported through configuration parameters.
+      </p>
+      <p>
+        Finally, while the pluto project contains several subprojects, it is
+        important to realize that the container itself is the most important
+        aspect of the project. It, in an of itself, is the Java Portlet
+        reference implementation. The portal driver (Pluto Test Portal),
+        testsuite, and deployer exist to simplfy the use and testing of the
+        container. As such, any significant enhancements to these components
+        (most especially the portal driver) should be scrutinized before
+        implementation, as most likely, it is outside the scope of the pluto
+        project and belong in a portal full implementation.
+      </p>
+    </section>
+  </body>
+  
+</document>
+

Modified: portals/pluto/trunk/pluto-site/src/site/xdoc/news.xml
URL: http://svn.apache.org/viewcvs/portals/pluto/trunk/pluto-site/src/site/xdoc/news.xml?rev=369472&r1=369471&r2=369472&view=diff
==============================================================================
--- portals/pluto/trunk/pluto-site/src/site/xdoc/news.xml (original)
+++ portals/pluto/trunk/pluto-site/src/site/xdoc/news.xml Mon Jan 16 06:05:06 2006
@@ -1,4 +1,4 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
 Copyright 2004 The Apache Software Foundation
 Licensed  under the  Apache License,  Version 2.0  (the "License");
@@ -15,181 +15,147 @@
 See the License for the specific language governing permissions and
 limitations under the License.
 -->
+
 <document>
+  
   <properties>
-    <author email="ddewolf.aT.apache.D0t.org">David H. DeWolf</author>
-    <author email="cdoremus.aT.hannaford.D0t.com">Craig Doremus</author>
     <title>Pluto Project News and Status</title>
+    <author email="ddewolf.aT.apache.D0T.org">David H. DeWolf</author>
+    <author email="cdoremus.aT.hannaford.D0T.com">Craig Doremus</author>
+    <author email="zheng.aT.apache.D0T.org">ZHENG Zhong</author>
   </properties>
-
-<body>
-  <section name="News">
-    <h5>18 September 2005 - Portals Pluto 1.0.1 General Availability Released</h5>
-    <p>
-      The Apache Pluto Community is proud to announce the
-	  General Availablility release of Pluto 1.0.1, the reference
-	  implementation of the Java Portlet Specification (JSR-168).
-	</p>  
-    <p>
-    	Nearly all the outstanding bugs have been fixed in this release.
-    	In addition, the Admin Portlet Application now supports
-    	hot deployment of custom portlets.
-    </p>
-	
-    <h5>24 July 2005 - Portals Pluto 1.0.1-rc4 Released</h5>
-
-	
-    <h5>11 July 2005 - Portals Pluto 1.0.1-rc3 Released</h5>
-     <p>
-      The Apache Pluto Community is proud to announce the release
-      of Apache Pluto 1.0.1-rc-2: the third binary release of the
-      reference implementation of the Java Portlet Specification.
-     </p>
-	 <p>
-      The third release candidate contains several bug fixes and 
-	  will be followed by a general availability of Pluto 1.0.1.
-	  In addition to bug fixes, the release contains a new administrative
-	  portlet which can be used to deploy portlets.
-     </p>
-    
-    <h5>22 December 2004 - Portals Pluto 1.0.1-rc2 Released</h5>
-     <p>
-      The Apache Pluto Community is proud to announce the release
-      of Apache Pluto 1.0.1-rc-2: the second binary release of the
-      reference implementation of the Java Portlet Specification.
-     </p>
-     <p>
-      Community feedback will decide if a further release candidate
-      is required before a final release.
-     </p>
-     <p>
-      The Java Portlet Specification defines a Portlet API
-      very similar to the Servlet API. The API provides a means
-      for aggregating disperate content sources.  The specification
-      addresses security and personalization considerations and
-      defines a standard with which these sources, or portlets
-      can be deployed.
-     </p>
-     <p>
-      Pluto is an embedable portlet container which will typically
-      be bundled within a fully functional Portal.  The Pluto
-      community has developed a simple portal driver implementation
-      which allows for the testing and development of portlets with
-      the container.  The Pluto testsuite is an implementation
-      agnostic portlet application which tests several basic
-      operations of the container in which it is deployed.
-     </p>
-     <p>
-      The distribution is organized into four releases:
-      <ul>
-       <li>
-        1. A binary distribution bundled with Tomcat. This distribution is the easiest to install.
-       </li>
-       <li>
-        2. A source distribution.
-       </li>
-       <li>
-        3. A binary distribution containing the container library.
-       </li>
-       <li>
-        4. A binary tools distribution with the portal driver and
-           testsuite.
-       </li>
-      </ul>
-     </p>
-    
-    <h5>8 October 2004 - Portals Pluto 1.0.1-rc1 Released</h5>
-     <p>
-      The Apache Pluto Community is proud to announce the release
-      of Apache Pluto 1.0.1-rc-1: the first binary release of the
-      reference implementation of the Java Portlet Specification.
-     </p>
-     <p>
-      Pluto 1.0.1-rc-1 is considered a release candidate.  The
-      promotion of this release candidate to general availability
-      is expected within the few weeks, pending feedback from
-      the community.
-     </p>
-     <p>
-      The Java Portlet Specification defines a Portlet API
-      very similar to the Servlet API. The API provides a means
-      for aggregating disperate content sources.  The specification
-      addresses security and personalization considerations and
-      defines a standard with which these sources, or portlets
-      can be deployed.
-     </p>
-     <p>
-      Pluto is an embedable portlet container which will typically
-      be bundled within a fully functional Portal.  The Pluto
-      community has developed a simple portal driver implementation
-      which allows for the testing and development of portlets with
-      the container.  The Pluto testsuite is an implementation
-      agnostic portlet application which tests several basic
-      operations of the container in which it is deployed.
-     </p>
-     <p>
-      The distribution is organized into four releases:
-      <ul>
-       <li>
-        1. A binary distribution bundled with Tomcat. This distribution is the easiest to install.
-       </li>
-       <li>
-        2. A source distribution.
-       </li>
-       <li>
-        3. A binary distribution containing the container library.
-       </li>
-       <li>
-        4. A binary tools distribution with the portal driver and
-           testsuite.
-       </li>
-      </ul>
-     </p>
+  
+  <body>
     
-    <h5>September 2004 - Releasing Pluto</h5>
-      <p>The Pluto Team is currently working on the first public release
-        which is expected by the end of September.
+    <section name="News and Status">
+      
+      <h4>18 September 2005 - Portals Pluto 1.0.1 General Availability Released</h4>
+      <p>
+        The Apache Pluto Community is proud to announce the General
+        Availablility release of Pluto 1.0.1, the reference implementation of
+        the Java Portlet Specification (JSR-168).
       </p>
-    
-    <h5>July/August 2004 - Pluto moved out of the Incubator</h5>
-      <p>The Pluto Project is now a sub project under the portals PMC and
-       has moved out of the incubator. This move comes with some changes
-       regarding mailing addresses etc. In addition Pluto now uses Subversion
-       instead of CVS.
+      <p>
+    	  Nearly all the outstanding bugs have been fixed in this release.
+        In addition, the Admin Portlet Application now supports hot deployment
+        of custom portlets.
       </p>
-    
-    <h5>May 2004 - Pluto moved issues to JIRA</h5>
-      <p>As most projects in the ASF, we are superseding Bugzilla and
-	using JIRA to manage project issues. New URL for
-	<a href="http://issues.apache.org/jira/secure/BrowseProject.jspa?id=10560">Pluto issues</a>.</p>
-    
-    <h5>21 March 2004 - Pluto Declaration of Intent Finalized</h5>
-      <p>The Pluto Community has finalized a declaration of intent which
-         clarifies the direction with which Pluto development will
-         move forward.
+      
+      <h4>24 July 2005 - Portals Pluto 1.0.1-rc4 Released</h4>
+      
+      <h4>11 July 2005 - Portals Pluto 1.0.1-rc3 Released</h4>
+      <p>
+        The Apache Pluto Community is proud to announce the release of Apache
+        Pluto 1.0.1-rc-2: the third binary release of the reference
+        implementation of the Java Portlet Specification.
+      </p>
+      <p>
+        The third release candidate contains several bug fixes and will be
+        followed by a general availability of Pluto 1.0.1. In addition to bug
+        fixes, the release contains a new administrative portlet which can be
+        used to deploy portlets.
+      </p>
+      
+      <h4>22 December 2004 - Portals Pluto 1.0.1-rc2 Released</h4>
+      <p>
+        The Apache Pluto Community is proud to announce the release of Apache
+        Pluto 1.0.1-rc-2: the second binary release of the reference
+        implementation of the Java Portlet Specification.
+      </p>
+      <p>
+        Community feedback will decide if a further release candidate is
+        required before a final release.
+      </p>
+      
+      <h4>8 October 2004 - Portals Pluto 1.0.1-rc1 Released</h4>
+      <p>
+        The Apache Pluto Community is proud to announce the release of Apache
+        Pluto 1.0.1-rc-1: the first binary release of the reference
+        implementation of the Java Portlet Specification.
+      </p>
+      <p>
+        Pluto 1.0.1-rc-1 is considered a release candidate. The promotion of
+        this release candidate to general availability is expected within the
+        few weeks, pending feedback from the community.
+      </p>
+      <p>
+        The Java Portlet Specification defines a Portlet API very similar to
+        the Servlet API. The API provides a means for aggregating disperate
+        content sources.  The specification addresses security and
+        personalization considerations and defines a standard with which these
+        sources, or portlets can be deployed.
+      </p>
+      <p>
+        Pluto is an embedable portlet container which will typically be bundled
+        within a fully functional Portal.  The Pluto community has developed a
+        simple portal driver implementation which allows for the testing and
+        development of portlets with the container. The Pluto testsuite is an
+        implementation agnostic portlet application which tests several basic
+        operations of the container in which it is deployed.
+      </p>
+      <p>
+        The distribution is organized into four releases:
+        <ul>
+          <li>A binary distribution bundled with Tomcat. This distribution is
+          the easiest to install.</li>
+          <li>A source distribution.</li>
+          <li>A binary distribution containing the container library.</li>
+          <li>A binary tools distribution with the portal driver and testsuite.</li>
+        </ul>
+      </p>
+      
+      <h4>September 2004 - Releasing Pluto</h4>
+      <p>
+        The Pluto Team is currently working on the first public release which
+        is expected by the end of September.
+      </p>
+      
+      <h4>July/August 2004 - Pluto moved out of the Incubator</h4>
+      <p>
+        The Pluto Project is now a sub project under the portals PMC and has
+        moved out of the incubator. This move comes with some changes regarding
+        mailing addresses etc. In addition Pluto now uses Subversion instead of
+        CVS.
+      </p>
+      
+      <h4>May 2004 - Pluto moved issues to JIRA</h4>
+      <p>
+        As most projects in the ASF, we are superseding Bugzilla and using JIRA
+        to manage project issues. New URL for
+        <a href="http://issues.apache.org/jira/secure/BrowseProject.jspa?id=10560">
+        Pluto issues</a>.
+      </p>
+      
+      <h4>21 March 2004 - Pluto Declaration of Intent Finalized</h4>
+      <p>
+        The Pluto Community has finalized a declaration of intent which
+        clarifies the direction with which Pluto development will move forward.
+      </p>
+      
+      <h4>27 February 2004 - Pluto SubProject Documentation Available</h4>
+      <p>
+        The maven subproject documentation is now being generated and included
+        in the Pluto documentation builds.
+      </p>
+      
+      <h4>10 November 2003 - Pluto Gets a Face Lift</h4>
+      <p>
+        Pluto is now managed by maven and it's website has subsequently recieved
+        a face lift. http://jakarta.apache.org/pluto now contains additional
+        information that should be helpfull in establishing this community.
+      </p>
+      
+      <h4>9 November 2003 - Pluto added to Bugzilla</h4>
+      <p>
+        Pluto has been added to Bugzilla
+        (<a href="http://issues.apache.org/bugzilla">http://issues.apache.org/bugzilla</a>).
+        Issues, bugs, and enhancements will now be managed through this bug
+        database.
       </p>
     
-
-    <h5>27 February 2004 - Pluto SubProject Documentation Available</h5>
-      <p>The maven subproject documentation is now being generated and included
-         in the Pluto documentation builds.</p>
+    </section>
     
-
-  <h5>10 November 2003 - Pluto Gets a Face Lift</h5>
-  <p>Pluto is now managed by maven and it's website has subsequently recieved
-     a face lift. http://jakarta.apache.org/pluto now contains additional
-     information that should be helpfull in establishing this community.
-  </p>
+  </body>
   
-  <h5>9 November 2003 - Pluto added to Bugzilla</h5>
-  <p>Pluto has been added to Bugzilla
-     <A href="http://issues.apache.org/bugzilla">(http://issues.apache.org/bugzilla)</A>.
-     Issues, bugs, and enhancements will now be managed through this
-     bug database.</p>
-  
-</section>
-
-
-</body>
 </document>
 

Added: portals/pluto/trunk/pluto-site/src/site/xdoc/resources.xml
URL: http://svn.apache.org/viewcvs/portals/pluto/trunk/pluto-site/src/site/xdoc/resources.xml?rev=369472&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-site/src/site/xdoc/resources.xml (added)
+++ portals/pluto/trunk/pluto-site/src/site/xdoc/resources.xml Mon Jan 16 06:05:06 2006
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+Copyright 2004 The Apache Software Foundation
+Licensed  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.
+-->
+
+<document>
+  
+  <properties>
+    <title>Pluto and Portlet Resources</title>
+    <author email="ddewolf@apache.org">David DeWolf</author>
+  </properties>
+  
+  <body>
+    
+    <section name="The Java Portlet Specifications">
+      <p>
+        <ul>
+          <li><a href="http://jcp.org/en/jsr/detail?id=168">JSR-168: Portlet Specification 1.0</a></li>
+          <li><a href="http://jcp.org/en/jsr/detail?id=286">JSR-286: Portlet Specification 2.0</a></li>
+        </ul>
+      </p>
+	  </section>
+    
+    <section name="Additional Pluto Documentation">
+      <p>
+        <ul>
+          <li><a href="http://wiki.apache.org/portals/Pluto">Official Pluto Wiki</a></li>
+          <li><a href="http://people.apache.org/~zheng/pluto/chinese/">Pluto Site, Chinese Translation</a></li>
+        </ul>
+      </p>
+    </section>
+    
+    <section name="Articles, Whitepapers, and Presentations">
+      <p>
+        <ul>
+          <li>
+            <a href="http://www.developer.com/java/web/article.php/3547186">Introduction to the Portlet Specification</a>
+            by David H. DeWolf, September 2005
+          </li>
+          <li>
+            <a href="http://www.developer.com/java/web/article.php/3554396">Developing Portlets with Apache Pluto 1.1</a>
+            by David H. DeWolf, October 2005
+          </li>
+          <li>
+            <a href="http://www.developer.com/java/web/article.php/3563411">Embedding Apache Pluto 1.1</a>
+            by David H. DeWolf, September 2005
+          </li>
+        </ul>
+      </p>
+    </section>
+    
+  </body>
+  
+</document>
+

Added: portals/pluto/trunk/pluto-site/src/site/xdoc/subprojects.xml
URL: http://svn.apache.org/viewcvs/portals/pluto/trunk/pluto-site/src/site/xdoc/subprojects.xml?rev=369472&view=auto
==============================================================================
--- portals/pluto/trunk/pluto-site/src/site/xdoc/subprojects.xml (added)
+++ portals/pluto/trunk/pluto-site/src/site/xdoc/subprojects.xml Mon Jan 16 06:05:06 2006
@@ -0,0 +1,136 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+Copyright 2004 The Apache Software Foundation
+Licensed  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.
+-->
+
+<document>
+  
+  <properties>
+    <title>Pluto Subprojects</title>
+    <author email="ddewolf@apache.org">David DeWolf</author>
+  </properties>
+  
+  <body>
+    <section name="Pluto Subprojects">
+      
+      <p>
+        Pluto 1.1 utilizes Maven 2 as it's project management and build
+        automation tool.  Pluto follows maven's best practices and is organized
+        into modules or subprojects.
+      </p>
+      
+      <subsection name="Container Subprojects">
+        <p>
+          <ul>
+            <li>
+              <b>Pluto Container:</b>
+              The Pluto Container is the core compontent of the Apache Pluto
+              project. All other modules either support the development. The
+              Pluto Container is the reference implementation of the Portlet
+              Specification.
+            </li>
+            <li>
+              <b>Pluto Tags:</b>
+              The Java Portlet Tag Library implementation which is provided
+              with the container.
+            </li>
+          </ul>
+        </p>
+      </subsection>
+      
+      <subsection name="Portal/Testing Subprojects">
+        <p>
+          <ul>
+            <li>
+              <b>Pluto Portal Driver:</b>
+              A driver library for the Pluto Portlet Container. Provides service
+              implementations and utilities for implementing a portal which
+              utilizes the container.
+            </li>
+            <li>
+              <b>Pluto Portal:</b>
+              The user interface components (web application) of the Pluto
+              Portal. The pluto portal is a simple portal application which
+              embeds the portal. The portal is not meant to be a full enterprise
+              portal, but instead is meant to be an example of how to embed the
+              container and a lightweight environment for developing and testing
+              portlets.
+            </li>
+            <li>
+              <b>Pluto Testsuite:</b>
+              A test portlet which can be used to exercise and test any portlet
+              container.
+            </li>
+          </ul>
+        </p>
+      </subsection>
+      
+      <subsection name="Libraries and Supporting Subprojects">
+        <p>
+          <ul>
+            <li>
+              <b>Pluto Descriptor API:</b>
+              A domain model which represents the deployment descriptors read
+              by the portlet container.  Contains service interfaces for reading
+              and writing portlet.xml and web.xml.
+            </li>
+            <li>
+              <b>Pluto Descriptor Impl:</b>
+              The default implementation of the Pluto Descriptor API Subproject.
+              The default implementation utilzes castor for reading and writing
+              portlet and web application descriptors.
+            </li>
+            <li>
+              <b>Pluto Optional Services:</b>
+              Provides optional implementations of the Pluto Container Services.
+              Includes database implementations of the PortletPreferencesService
+              and the UserAttributeService.
+            </li>
+          </ul>
+        </p>
+      </subsection>
+      
+      <subsection name="Utilities and Tools (for working with the Pluto Portal)">
+        <p>
+          <ul>
+            <li>
+              <b>Pluto Util:</b>
+              Utilities for working with the Pluto Portal. Includes libraries
+              for installing pluto, assembling portlet applications for
+              deployment in pluto, deploying to pluto, and publishing portlets
+              to pluto.
+            </li>
+            <li>
+              <b>Maven Plugin:</b>
+              Provides Maven goals for utilizing the Pluto utilities. Install
+              the portal within a servlet container, assemble portlets, deploy
+              portlets, and publish portlets to th Pluto Portal.
+            </li>
+            <li>
+              <b>Ant Tasks:</b>
+              Ant tasks which allow developers to utilize the Pluto utilities
+              within ant. Currently supports assembling wars for deployment
+              within pluto.
+            </li>
+          </ul>
+        </p>
+      </subsection>
+      
+    </section>
+  </body>
+  
+</document>
+