You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ws.apache.org by ve...@apache.org on 2013/04/29 22:59:41 UTC
svn commit: r1477339 - in /webservices/website: dev.html index.html irc.html
mail-lists.html project-info.html team-list.html
Author: veithen
Date: Mon Apr 29 20:59:40 2013
New Revision: 1477339
URL: http://svn.apache.org/r1477339
Log:
Republished the root site.
Added:
webservices/website/dev.html
Modified:
webservices/website/index.html
webservices/website/irc.html
webservices/website/mail-lists.html
webservices/website/project-info.html
webservices/website/team-list.html
Added: webservices/website/dev.html
URL: http://svn.apache.org/viewvc/webservices/website/dev.html?rev=1477339&view=auto
==============================================================================
--- webservices/website/dev.html (added)
+++ webservices/website/dev.html Mon Apr 29 20:59:40 2013
@@ -0,0 +1,246 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at Apr 29, 2013
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <meta name="Date-Revision-yyyymmdd" content="20130429" />
+ <meta http-equiv="Content-Language" content="en" />
+ <title>Apache Web Services - Developer resources</title>
+ <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
+ <link rel="stylesheet" href="./css/site.css" />
+ <link rel="stylesheet" href="./css/print.css" media="print" />
+
+
+ <script type="text/javascript" src="./js/apache-maven-fluido-1.3.0.min.js"></script>
+
+
+ </head>
+ <body class="topBarDisabled">
+
+
+
+
+ <div class="container-fluid">
+ <div id="banner">
+ <div class="pull-left">
+ <div id="bannerLeft">
+ <h2>Apache Web Services</h2>
+ </div>
+ </div>
+ <div class="pull-right"> <a href="./" id="bannerRight">
+ <img src="images/project-logo.jpg" />
+ </a>
+ </div>
+ <div class="clear"><hr/></div>
+ </div>
+
+ <div id="breadcrumbs">
+ <ul class="breadcrumb">
+
+
+ <li class="">
+ <a href="http://www.apache.org/" class="externalLink" title="Apache">
+ Apache</a>
+ </li>
+ <li class="divider ">/</li>
+ <li class="">
+ <a href="./" title="Web Services">
+ Web Services</a>
+ </li>
+ <li class="divider ">/</li>
+ <li class="">Developer resources</li>
+
+
+
+ <li id="publishDate" class="pull-right">Last Published: 2013-04-29</li>
+
+ </ul>
+ </div>
+
+
+ <div class="row-fluid">
+ <div id="leftColumn" class="span3">
+ <div class="well sidebar-nav">
+
+
+ <ul class="nav nav-list">
+ <li class="nav-header">Information</li>
+
+ <li>
+
+ <a href="index.html" title="Welcome">
+ <i class="none"></i>
+ Welcome</a>
+ </li>
+
+ <li>
+
+ <a href="mail-lists.html" title="Mailing Lists">
+ <i class="none"></i>
+ Mailing Lists</a>
+ </li>
+
+ <li>
+
+ <a href="team-list.html" title="Project Members">
+ <i class="none"></i>
+ Project Members</a>
+ </li>
+ <li class="nav-header">Projects</li>
+
+ <li>
+
+ <a href="axiom/" title="Axiom">
+ <i class="none"></i>
+ Axiom</a>
+ </li>
+
+ <li>
+
+ <a href="neethi/" title="Neethi">
+ <i class="none"></i>
+ Neethi</a>
+ </li>
+
+ <li>
+
+ <a href="tcpmon/" title="TCPMon">
+ <i class="none"></i>
+ TCPMon</a>
+ </li>
+
+ <li>
+
+ <a href="woden/" title="Woden">
+ <i class="none"></i>
+ Woden</a>
+ </li>
+
+ <li>
+
+ <a href="wss4j/" title="WSS4J">
+ <i class="none"></i>
+ WSS4J</a>
+ </li>
+
+ <li>
+
+ <a href="xmlrpc/" title="XML-RPC">
+ <i class="none"></i>
+ XML-RPC</a>
+ </li>
+
+ <li>
+
+ <a href="commons/xmlschema14/" title="XmlSchema 1.4">
+ <i class="none"></i>
+ XmlSchema 1.4</a>
+ </li>
+
+ <li>
+
+ <a href="commons/xmlschema20/" title="XmlSchema 2.0">
+ <i class="none"></i>
+ XmlSchema 2.0</a>
+ </li>
+ <li class="nav-header">Resources</li>
+
+ <li>
+
+ <a href="http://wiki.apache.org/ws/" class="externalLink" title="Wiki">
+ <i class="none"></i>
+ Wiki</a>
+ </li>
+
+ <li>
+
+ <a href="irc.html" title="IRC">
+ <i class="none"></i>
+ IRC</a>
+ </li>
+
+ <li class="active">
+
+ <a href="#"><i class="none"></i>Developer Resources</a>
+ </li>
+ <li class="nav-header">Apache</li>
+
+ <li>
+
+ <a href="http://www.apache.org/licenses/LICENSE-2.0.html" class="externalLink" title="License">
+ <i class="none"></i>
+ License</a>
+ </li>
+
+ <li>
+
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">
+ <i class="none"></i>
+ Sponsorship</a>
+ </li>
+
+ <li>
+
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">
+ <i class="none"></i>
+ Thanks</a>
+ </li>
+
+ <li>
+
+ <a href="http://www.apache.org/security/" class="externalLink" title="Security">
+ <i class="none"></i>
+ Security</a>
+ </li>
+ </ul>
+
+
+ <form id="search-form" action="http://www.google.com/search" method="get" >
+
+ <input value="ws.apache.org" name="sitesearch" type="hidden"/>
+ <input class="search-query" name="q" id="query" type="text" />
+</form>
+<script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=search-form"></script>
+
+ <hr class="divider" />
+
+ <div id="poweredBy">
+ <div class="clear"></div>
+ <div class="clear"></div>
+ <div class="clear"></div>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+ </a>
+ </div>
+ </div>
+ </div>
+
+
+ <div id="bodyColumn" class="span9" >
+
+ <!-- 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. --><div class="section"><h2>How the Web site is built - overview<a name="How_the_Web_site_is_built_-_ov
erview"></a></h2><p>The Web services project uses the following approach to build a Web site with a consistent look and feel across multiple subprojects:</p><ul><li>The Web services project defines its own parent POM that extends the <tt>org.apache:apache</tt> super POM. The Maven coordinates of this parent POM are <tt>org.apache.ws:ws-parent</tt> and the sources are located here: <a class="externalLink" href="https://svn.apache.org/repos/asf/webservices/parent/">https://svn.apache.org/repos/asf/webservices/parent/</a>. This parent POM is expected to be used by all subprojects and is responsible for several things:<ul><li>It deploys a site descriptor with reasonable defaults for the site configuration. This configuration is inherited by all subprojects that use the parent POM. It ensures a minimum of consistency between projects and includes the following settings:<ul><li>A Maven skin that is graphically a bit more sophisticated than the default skin (which is really ugly).<
/li><li>A side bar menu with links required by the <a class="externalLink" href="http://www.apache.org/foundation/marks/pmcs">Apache Project Branding Requirements</a>.</li><li>Breadcrumbs that ensure consistent navigation between the root site and the sites for the subprojects.</li></ul></li><li>It contains the necessary configurations to enable usage of the <a class="externalLink" href="http://maven.apache.org/plugins/maven-scm-publish-plugin/">maven-scm-publish-plugin</a> to deploy sites directly to the svnpubsub area in SVN.</li><li>It defines defaults for certain plugins used by the site generation process (such as maven-javadoc-plugin). The goal is to reduce the number of unnecessary file changes that occur when regenerating the site. This should avoid mass changes when committing the new version of the site.</li><li>It defines default Maven metadata that applies to all subprojects, e.g. the mailing lists.</li></ul></li><li>The root site is generated using a Maven proje
ct as well. It is located here: <a class="externalLink" href="https://svn.apache.org/repos/asf/webservices/site/maven/">https://svn.apache.org/repos/asf/webservices/site/maven/</a>. The project is configured with maven-scm-publish-plugin so that the root site can be published with a few commands (more on this below).</li></ul><p>Obviously, the parent POM requires a separate release, but since it is set up as a Maven project that follows the standard Maven release procedure, that is not so much of an issue. On the other hand, republishing the root site doesn't require a release, and the project version is set to a fixed value (0).</p></div><div class="section"><h2>Requirements for subprojects<a name="Requirements_for_subprojects"></a></h2><p>The Maven setup of each subproject should meet the following minimum requirements:</p><ul><li>The project must inherit the WS parent POM (<tt>org.apache.ws:ws-parent</tt>). During the release process, the version of the parent POM should
be updated to the latest version.</li><li>The root POM of the project must have a <tt>site</tt> entry in the <tt>distributionManagement</tt> section that points to the right location in the svnpubsub area: <tt>scm:svn:https://svn.apache.org/repos/asf/webservices/website/...</tt>.</li><li>If the project folder in the svnpubsub area contains files or directories that are not generated by Maven, then the root POM must contain a configuration for the maven-scm-publish-plugin that declares them using the <tt>ignorePathsToDelete</tt> property (See the POM of the root site for an example).</li><li>The <tt>site.xml</tt> file for the project must be configured appropriately. In most cases, it should only contain <tt>menu</tt> entries and inherit everything else from the site descriptor of the WS parent POM. It may also reconfigure the left banner to replace it with the project's logo.</li></ul></div><div class="section"><h2>Republishing the site for a subproject<a name="Republishing_
the_site_for_a_subproject"></a></h2><p>To republish the Maven site of a subproject, start by executing the following commands:</p><div><pre>mvn clean site
+mvn site:stage scm-publish:publish-scm -Dscmpublish.skipCheckin=true</pre></div><p>Then go to the <tt>target/scmpublish-checkout</tt> directory and check the changes. In particular, you should check that no files or directories have been unexpectedly marked for deletion. I you are satisfied with the result, commit them using <tt>svn commit</tt>. That's it!</p><p>If you know what you are doing, you may omit the <tt>scmpublish.skipCheckin</tt> property. In this case, <tt>publish-scm</tt> will commit the changes immediately.</p><p>Note that the procedure described above is designed to work both with single module and multi-module Maven builds. Actually, for single module projects, a simpler command could be used.</p></div><div class="section"><h2>Republishing the root site<a name="Republishing_the_root_site"></a></h2><p>Republishing the root site requires the same sequence of commands as for a subproject. Note that the POM configures the <tt>ignorePathsToDelete</tt> property of
the maven-scm-publish-plugin to avoid deleting directories belonging to subprojects, as well as files such as <tt>.htaccess</tt> and <tt>robots.txt</tt> which are not managed by the Maven project. You should therefore always use <tt>scmpublish.skipCheckin=true</tt> and carefully review the changes before committing them.</p></div>
+ </div>
+ </div>
+ </div>
+
+ <hr/>
+
+ <footer>
+ <div class="container-fluid">
+ <div class="row span12">Copyright © 2013
+ <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+ All Rights Reserved.
+
+ </div>
+
+
+
+ </div>
+ </footer>
+ </body>
+</html>
\ No newline at end of file
Modified: webservices/website/index.html
URL: http://svn.apache.org/viewvc/webservices/website/index.html?rev=1477339&r1=1477338&r2=1477339&view=diff
==============================================================================
--- webservices/website/index.html (original)
+++ webservices/website/index.html Mon Apr 29 20:59:40 2013
@@ -162,6 +162,13 @@
<i class="none"></i>
IRC</a>
</li>
+
+ <li>
+
+ <a href="dev.html" title="Developer Resources">
+ <i class="none"></i>
+ Developer Resources</a>
+ </li>
<li class="nav-header">Apache</li>
<li>
Modified: webservices/website/irc.html
URL: http://svn.apache.org/viewvc/webservices/website/irc.html?rev=1477339&r1=1477338&r2=1477339&view=diff
==============================================================================
--- webservices/website/irc.html (original)
+++ webservices/website/irc.html Mon Apr 29 20:59:40 2013
@@ -160,6 +160,13 @@
<a href="#"><i class="none"></i>IRC</a>
</li>
+
+ <li>
+
+ <a href="dev.html" title="Developer Resources">
+ <i class="none"></i>
+ Developer Resources</a>
+ </li>
<li class="nav-header">Apache</li>
<li>
Modified: webservices/website/mail-lists.html
URL: http://svn.apache.org/viewvc/webservices/website/mail-lists.html?rev=1477339&r1=1477338&r2=1477339&view=diff
==============================================================================
--- webservices/website/mail-lists.html (original)
+++ webservices/website/mail-lists.html Mon Apr 29 20:59:40 2013
@@ -160,6 +160,13 @@
<i class="none"></i>
IRC</a>
</li>
+
+ <li>
+
+ <a href="dev.html" title="Developer Resources">
+ <i class="none"></i>
+ Developer Resources</a>
+ </li>
<li class="nav-header">Apache</li>
<li>
Modified: webservices/website/project-info.html
URL: http://svn.apache.org/viewvc/webservices/website/project-info.html?rev=1477339&r1=1477338&r2=1477339&view=diff
==============================================================================
--- webservices/website/project-info.html (original)
+++ webservices/website/project-info.html Mon Apr 29 20:59:40 2013
@@ -162,6 +162,13 @@
<i class="none"></i>
IRC</a>
</li>
+
+ <li>
+
+ <a href="dev.html" title="Developer Resources">
+ <i class="none"></i>
+ Developer Resources</a>
+ </li>
<li class="nav-header">Apache</li>
<li>
Modified: webservices/website/team-list.html
URL: http://svn.apache.org/viewvc/webservices/website/team-list.html?rev=1477339&r1=1477338&r2=1477339&view=diff
==============================================================================
--- webservices/website/team-list.html (original)
+++ webservices/website/team-list.html Mon Apr 29 20:59:40 2013
@@ -160,6 +160,13 @@
<i class="none"></i>
IRC</a>
</li>
+
+ <li>
+
+ <a href="dev.html" title="Developer Resources">
+ <i class="none"></i>
+ Developer Resources</a>
+ </li>
<li class="nav-header">Apache</li>
<li>