You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@stanbol.apache.org by bu...@apache.org on 2012/06/06 13:04:36 UTC

svn commit: r820457 - in /websites/staging/stanbol/trunk/content: ./ stanbol/development/website.html

Author: buildbot
Date: Wed Jun  6 11:04:36 2012
New Revision: 820457

Log:
Staging update by buildbot for stanbol

Added:
    websites/staging/stanbol/trunk/content/stanbol/development/website.html
Modified:
    websites/staging/stanbol/trunk/content/   (props changed)

Propchange: websites/staging/stanbol/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Jun  6 11:04:36 2012
@@ -1 +1 @@
-1346810
+1346823

Added: websites/staging/stanbol/trunk/content/stanbol/development/website.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/development/website.html (added)
+++ websites/staging/stanbol/trunk/content/stanbol/development/website.html Wed Jun  6 11:04:36 2012
@@ -0,0 +1,140 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+    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.
+-->
+
+  <link href="/stanbol/css/stanbol.css" rel="stylesheet" type="text/css">
+  <title>Apache Stanbol - Website Development</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+  <link rel="icon" type="image/png" href="/stanbol/images/stanbol-logo/stanbol-favicon.png"/>
+  <script type="text/javascript">
+    // Google Analytics Tracking Code
+    var _gaq = _gaq || [];
+    _gaq.push(['_setAccount', 'UA-32086816-1']);
+    _gaq.push(['_trackPageview']);
+
+    (function() {
+      var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+      ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+      var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+    })();
+  </script>  
+</head>
+
+<body>
+  <div id="navigation"> 
+  <a href="/stanbol/index.html"><img alt="Apache Stanbol" width="220" height="101" border="0" src="/stanbol/images/stanbol-logo/stanbol-2010-12-14.png"/></a>
+  <h1 id="stanbol">Stanbol</h1>
+<ul>
+<li><a href="/stanbol/index.html">Home</a></li>
+<li><a href="/stanbol/docs/trunk/tutorial.html">Tutorial</a></li>
+<li><a href="/stanbol/docs/trunk/">Documentation</a><ul>
+<li><a href="/stanbol/docs/0.9.0-incubating/">0.9.0-incubating</a></li>
+</ul>
+</li>
+<li><a href="/stanbol/docs/trunk/building.html">Building</a></li>
+<li><a href="/stanbol/development/">Development</a></li>
+</ul>
+<h1 id="project">Project</h1>
+<ul>
+<li><a href="/stanbol/docs/trunk/mailinglists.html">Mailing Lists</a></li>
+<li><a href="https://issues.apache.org/jira/browse/STANBOL">Issue Tracker</a></li>
+<li><a href="/stanbol/team.html">Project Team</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0">License</a></li>
+<li><a href="/stanbol/privacy-policy.html">Privacy Policy</a></li>
+</ul>
+<h1 id="downloads">Downloads</h1>
+<ul>
+<li><a href="/stanbol/downloads/">Overview</a><ul>
+<li><a href="/stanbol/downloads/releases.html">Releases</a></li>
+<li><a href="/stanbol/downloads/launchers.html">Launchers</a></li>
+</ul>
+</li>
+</ul>
+<h1 id="the-asf">The ASF</h1>
+<ul>
+<li><a href="http://www.apache.org">Apache Software Foundation</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a></li>
+<li><a href="http://www.apache.org/security/">Security</a></li>
+</ul>
+  </div>
+  
+  <div id="content">
+    <h1 class="title">Website Development</h1>
+    <p>Apache Stanbol uses the <a href="">ASF CMS</a> to manage its website. With this approach
+the website sources are hosted in SVN along the software sources. The website
+source can be checked out from:</p>
+<div class="codehilite"><pre><span class="n">http:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/incubator/s</span><span class="n">tanbol</span><span class="sr">/site/</span><span class="n">trunk</span><span class="o">/</span>
+</pre></div>
+
+
+<p>The website content is written using the
+<a href="http://daringfireball.net/projects/markdown/syntax">Markdown syntax</a>.
+This makes it very easy to write, edit and update documentation. No need to
+write HTML.</p>
+<h2 id="how-to-contribute-to-the-website">How to contribute to the website</h2>
+<p>We are always trying to improve the available documentation and sources of
+information about Apache Stanbol. To contribute to the website is just as
+easy as to contribute a patch to the software sources.</p>
+<p>For your contribution you should first open a new
+<a href="https://issues.apache.org/jira/browse/STANBOL">Jira issue</a> describing
+your desired changes.</p>
+<p>Then you checkout the current version of the website sources from the SVN
+and make your changes. See the existing content for how to add images and
+additional files.</p>
+<p>When you have finished, you create a patch from your
+changes. Zip your patch and upload it to the issue created prior. A
+committer will catch it up and commit your changes after a short review
+to the SVN. This will trigger the publishing process.</p>
+<h2 id="publishing-process">Publishing process</h2>
+<p>Changes to the website are committed to the SVN. This trigger an automatic
+build process of the website.</p>
+<div class="codehilite"><pre><span class="n">http:</span><span class="sr">//ci</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/builders/s</span><span class="n">tanbol</span><span class="o">-</span><span class="n">site</span><span class="o">-</span><span class="n">staging</span>
+</pre></div>
+
+
+<p>The new version is then staged to the following URL.</p>
+<div class="codehilite"><pre><span class="n">http:</span><span class="sr">//s</span><span class="n">tanbol</span><span class="o">.</span><span class="n">staging</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="o">/</span>
+</pre></div>
+
+
+<p>The website is now in staging mode meaning that it can be reviewed. You
+actually see the results of your changes. If you are satisfied with the
+results you can push the changes in production, connect to</p>
+<div class="codehilite"><pre><span class="n">https:</span><span class="sr">//cms</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/stanbol/</span><span class="n">publish</span>
+</pre></div>
+
+
+<p>with your LDAP credentials (as set on people.apache.org).</p>
+  </div>
+  
+  <div id="footer">
+    <div class="copyright">
+      <p>
+        Copyright &copy; 2010 The Apache Software Foundation, Licensed under 
+        the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+        <br />
+        Apache, Stanbol and the Apache feather and Stanbol logos are trademarks of The Apache Software Foundation.
+      </p>
+    </div>
+  </div>
+  
+</body>
+</html>