streams-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sblack...@apache.org
Subject svn commit: r986611 [7/7] - in /websites/production/streams/content/site/0.3-incubating-SNAPSHOT/streams-master: ./ css/ fonts/ images/ images/logos/ images/profiles/ img/ js/ tutorial/
Date Mon, 25 Apr 2016 19:54:34 GMT
Added: websites/production/streams/content/site/0.3-incubating-SNAPSHOT/streams-master/tutorial/environment.html
==============================================================================
--- websites/production/streams/content/site/0.3-incubating-SNAPSHOT/streams-master/tutorial/environment.html
(added)
+++ websites/production/streams/content/site/0.3-incubating-SNAPSHOT/streams-master/tutorial/environment.html
Mon Apr 25 19:54:34 2016
@@ -0,0 +1,284 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at 2016-04-25 
+ | Rendered using Apache Maven Fluido Skin 1.4
+-->
+<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="20160425" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Apache Streams :: streams-master &#x2013; Create a folder to hold streams
configuration files</title>
+    <link rel="stylesheet" href="../css/apache-maven-fluido-1.4.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.4.min.js"></script>
+
+    
+                  </head>
+        <body class="topBarEnabled">
+          
+                        
+                    
+                
+
+    <div id="topbar" class="navbar navbar-fixed-top navbar-inverse">
+      <div class="navbar-inner">
+                                  <div class="container"><div class="nav-collapse">
+            
+                
+                                <ul class="nav">
+                                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../index.html"  title="Overview">Overview</a>
+</li>
+                  
+                      <li>      <a href="../architecture.html"  title="Architecture">Architecture</a>
+</li>
+                  
+                      <li>      <a href="../concepts.html"  title="Concepts">Concepts</a>
+</li>
+                  
+                      <li>      <a href="../downloads.html"  title="Downloads">Downloads</a>
+</li>
+                  
+                      <li>      <a href="../faq.html"  title="Frequently Asked Questions">Frequently
Asked Questions</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Details <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../license.html"  title="Project License">Project
License</a>
+</li>
+                  
+                      <li>      <a href="../mail-lists.html"  title="Mailing Lists">Mailing
Lists</a>
+</li>
+                  
+                      <li>      <a href="../team-list.html"  title="Project Team">Project
Team</a>
+</li>
+                  
+                      <li>      <a href="../integration.html"  title="Continuous
Integration">Continuous Integration</a>
+</li>
+                  
+                      <li>      <a href="../issue-tracking.html"  title="Issue Tracking">Issue
Tracking</a>
+</li>
+                  
+                      <li>      <a href="../source-repository.html"  title="Source
Repositories">Source Repositories</a>
+</li>
+                  
+                      <li>      <a href="../dependency-info.html"  title="Dependency
Info">Dependency Info</a>
+</li>
+                  
+                      <li>      <a href="../distribution-management.html"  title="Distribution
Management">Distribution Management</a>
+</li>
+                  
+                      <li>      <a href="../plugin-management.html"  title="Plugin
Management">Plugin Management</a>
+</li>
+                  
+                      <li>      <a href="../release-setup.html"  title="Release
Setup">Release Setup</a>
+</li>
+                  
+                      <li>      <a href="../release.html"  title="Release Process">Release
Process</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Projects <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../"  title="streams-master">streams-master</a>
+</li>
+                  
+                      <li>      <a href="../../streams-project"  title="streams-project">streams-project</a>
+</li>
+                  
+                      <li>      <a href="../../streams-examples/"  title="streams-examples">streams-examples</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Getting Started
<b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../../streams-project/streams-pojo/index.html"
 title="View the official Apache Streams jsonschema files">View the official Apache Streams
jsonschema files</a>
+</li>
+                  
+                      <li>      <a href="../../streams-project/streams-contrib/streams-provider-twitter/index.html"
 title="View the schemas that describe twitter data">View the schemas that describe twitter
data</a>
+</li>
+                  
+                      <li>      <a href="../../streams-project/streams-contrib/index.html"
 title="Read about twitter / streams conversion">Read about twitter / streams conversion</a>
+</li>
+                  
+                      <li>      <a href="../../streams-project/streams-components/index.html"
 title="Learn about utility streams components">Learn about utility streams components</a>
+</li>
+                  
+                      <li>      <a href="../../streams-project/streams-contrib/index.html"
 title="Learn about streams interoperability modules">Learn about streams interoperability
modules</a>
+</li>
+                  
+                      <li>      <a href="../../streams-project/streams-contrib/index.html"
 title="Browse streams providers, processors, and persisters">Browse streams providers,
processors, and persisters</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorial <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../tutorial/build.html"  title="Build streams
and streams-examples from source">Build streams and streams-examples from source</a>
+</li>
+                  
+                      <li>      <a href="../tutorial/environment.html"  title="Create
a local folder to configure streams">Create a local folder to configure streams</a>
+</li>
+                  
+                      <li>      <a href="../tutorial/docker.html"  title="Set up
a local docker environment">Set up a local docker environment</a>
+</li>
+                  
+                      <li>      <a href="../tutorial/database.html"  title="Run
a local database to store activity documents">Run a local database to store activity documents</a>
+</li>
+                  
+                      <li>      <a href="../../../0.2-incubating-SNAPSHOT/streams-examples/streams-examples-local/twitter-history-elasticsearch/index.html"
 title="Run twitter-history-elasticsearch">Run twitter-history-elasticsearch</a>
+</li>
+                  
+                      <li>      <a href="../tutorial/browse.html"  title="Browse
and search the twitter data you collected">Browse and search the twitter data you collected</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Other Resources
<b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="http://activitystrea.ms"  title="ActivityStreams
Homepage">ActivityStreams Homepage</a>
+</li>
+                  
+                      <li>      <a href="http://activitystrea.ms/specs/"  title="ActivityStreams
Specifications">ActivityStreams Specifications</a>
+</li>
+                  
+                      <li>      <a href="http://blogs.apache.org/streams/"  title="Streams
Blog">Streams Blog</a>
+</li>
+                  
+                      <li>      <a href="http://wiki.apache.org/incubator/StreamsProposal"
 title="Streams Proposal Wiki Page">Streams Proposal Wiki Page</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Foundation <b
class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="http://www.apache.org/"  title="Foundation
Info">Foundation Info</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/sponsorship.html"
 title="Sponsorship">Sponsorship</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/thanks.html"
 title="Thanks">Thanks</a>
+</li>
+                          </ul>
+      </li>
+                  </ul>
+          
+          
+                                                                            
+                   
+                      </div>
+          
+        </div>
+      </div>
+    </div>
+    
+        <div class="container">
+          <div id="banner">
+        <div class="pull-left">
+                                                  <a href="../../../.." id="bannerLeft">
+                                                                                        
       <img src="../../../../images/streams_logo.jpg"  alt="Apache Streams" width="150"
height="100"/>
+                </a>
+                      </div>
+        <div class="pull-right">                  <a href="http://incubator.apache.org"
id="bannerRight">
+                                                                                        <img
src="http://incubator.apache.org/images/egg-logo.png"  alt="Apache Incubator"/>
+                </a>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+                    
+                              <li class="">
+                    <a href="http://incubator.apache.org/" class="externalLink" title="Incubator">
+        Incubator</a>
+                    <span class="divider">/</span>
+      </li>
+            <li class="">
+                    <a href="../../../../" title="Streams">
+        Streams</a>
+                    <span class="divider">/</span>
+      </li>
+        <li class="active ">Create a folder to hold streams configuration files</li>
+        
+                
+                    
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span>
Last Published: 2016-04-25</li>
+              <li id="projectVersion" class="pull-right">
+                    Version: 0.3-incubating-SNAPSHOT
+        </li>
+            
+                            </ul>
+      </div>
+
+      
+                
+        <div id="bodyColumn" >
+                                  
+            <div class="section">
+<div class="section">
+<h3><a name="Create_a_folder_to_hold_streams_configuration_files"></a>Create
a folder to hold streams configuration files</h3>
+<p>Pick a place on your file system that&#x2019;s easy to remember and reference
with an absolution path.</p>
+<p>Create a new empty folder there and export the path to a variables.</p>
+<p><tt>mkdir ~/streams</tt>  <tt>export STREAMS=$(cd ~streams; pwd)</tt></p></div>
+<div class="section">
+<h3><a name="Create_a_configuration_file_to_hold_secrets"></a>Create a
configuration file to hold secrets</h3>
+<p><tt>cd $STREAMS</tt>  <tt>touch reference.conf</tt></p>
+<p>To get started, put the following into reference.conf</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">twitter {
+    oauth {
+        consumerKey = &quot;&quot;
+        consumerSecret = &quot;&quot;
+        accessToken = &quot;&quot;
+        accessTokenSecret = &quot;&quot;
+    }
+}
+</pre></div></div>
+<p>Visit developer.twitter.com to obtain the above fields and put them your reference.conf</p></div></div>
+                  </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container">
+                      <div class="row">
+                                      <p >Copyright &copy;                    2012&#x2013;2016
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All rights reserved.      
+                    
+      </p>
+                </div>
+
+                <p id="poweredBy" class="pull-right">
+                          <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>
+              </p>
+        
+                </div>
+    </footer>
+        </body>
+</html>
\ No newline at end of file

Added: websites/production/streams/content/site/0.3-incubating-SNAPSHOT/streams-master/website.html
==============================================================================
--- websites/production/streams/content/site/0.3-incubating-SNAPSHOT/streams-master/website.html
(added)
+++ websites/production/streams/content/site/0.3-incubating-SNAPSHOT/streams-master/website.html
Mon Apr 25 19:54:34 2016
@@ -0,0 +1,423 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at 2016-04-25 
+ | Rendered using Apache Maven Fluido Skin 1.4
+-->
+<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="20160425" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Apache Streams :: streams-master &#x2013; Website Information</title>
+    <link rel="stylesheet" href="./css/apache-maven-fluido-1.4.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.4.min.js"></script>
+
+    
+                  </head>
+        <body class="topBarEnabled">
+          
+                        
+                    
+                
+
+    <div id="topbar" class="navbar navbar-fixed-top navbar-inverse">
+      <div class="navbar-inner">
+                                  <div class="container"><div class="nav-collapse">
+            
+                
+                                <ul class="nav">
+                                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Overview <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="index.html"  title="Overview">Overview</a>
+</li>
+                  
+                      <li>      <a href="architecture.html"  title="Architecture">Architecture</a>
+</li>
+                  
+                      <li>      <a href="concepts.html"  title="Concepts">Concepts</a>
+</li>
+                  
+                      <li>      <a href="downloads.html"  title="Downloads">Downloads</a>
+</li>
+                  
+                      <li>      <a href="faq.html"  title="Frequently Asked Questions">Frequently
Asked Questions</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Details <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="license.html"  title="Project License">Project
License</a>
+</li>
+                  
+                      <li>      <a href="mail-lists.html"  title="Mailing Lists">Mailing
Lists</a>
+</li>
+                  
+                      <li>      <a href="team-list.html"  title="Project Team">Project
Team</a>
+</li>
+                  
+                      <li>      <a href="integration.html"  title="Continuous Integration">Continuous
Integration</a>
+</li>
+                  
+                      <li>      <a href="issue-tracking.html"  title="Issue Tracking">Issue
Tracking</a>
+</li>
+                  
+                      <li>      <a href="source-repository.html"  title="Source
Repositories">Source Repositories</a>
+</li>
+                  
+                      <li>      <a href="dependency-info.html"  title="Dependency
Info">Dependency Info</a>
+</li>
+                  
+                      <li>      <a href="distribution-management.html"  title="Distribution
Management">Distribution Management</a>
+</li>
+                  
+                      <li>      <a href="plugin-management.html"  title="Plugin
Management">Plugin Management</a>
+</li>
+                  
+                      <li>      <a href="release-setup.html"  title="Release Setup">Release
Setup</a>
+</li>
+                  
+                      <li>      <a href="release.html"  title="Release Process">Release
Process</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Projects <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href=""  title="streams-master">streams-master</a>
+</li>
+                  
+                      <li>      <a href="../streams-project"  title="streams-project">streams-project</a>
+</li>
+                  
+                      <li>      <a href="../streams-examples/"  title="streams-examples">streams-examples</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Getting Started
<b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="../streams-project/streams-pojo/index.html"
 title="View the official Apache Streams jsonschema files">View the official Apache Streams
jsonschema files</a>
+</li>
+                  
+                      <li>      <a href="../streams-project/streams-contrib/streams-provider-twitter/index.html"
 title="View the schemas that describe twitter data">View the schemas that describe twitter
data</a>
+</li>
+                  
+                      <li>      <a href="../streams-project/streams-contrib/index.html"
 title="Read about twitter / streams conversion">Read about twitter / streams conversion</a>
+</li>
+                  
+                      <li>      <a href="../streams-project/streams-components/index.html"
 title="Learn about utility streams components">Learn about utility streams components</a>
+</li>
+                  
+                      <li>      <a href="../streams-project/streams-contrib/index.html"
 title="Learn about streams interoperability modules">Learn about streams interoperability
modules</a>
+</li>
+                  
+                      <li>      <a href="../streams-project/streams-contrib/index.html"
 title="Browse streams providers, processors, and persisters">Browse streams providers,
processors, and persisters</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Tutorial <b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="tutorial/build.html"  title="Build streams
and streams-examples from source">Build streams and streams-examples from source</a>
+</li>
+                  
+                      <li>      <a href="tutorial/environment.html"  title="Create
a local folder to configure streams">Create a local folder to configure streams</a>
+</li>
+                  
+                      <li>      <a href="tutorial/docker.html"  title="Set up a
local docker environment">Set up a local docker environment</a>
+</li>
+                  
+                      <li>      <a href="tutorial/database.html"  title="Run a local
database to store activity documents">Run a local database to store activity documents</a>
+</li>
+                  
+                      <li>      <a href="../../0.2-incubating-SNAPSHOT/streams-examples/streams-examples-local/twitter-history-elasticsearch/index.html"
 title="Run twitter-history-elasticsearch">Run twitter-history-elasticsearch</a>
+</li>
+                  
+                      <li>      <a href="tutorial/browse.html"  title="Browse and
search the twitter data you collected">Browse and search the twitter data you collected</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Other Resources
<b class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="http://activitystrea.ms"  title="ActivityStreams
Homepage">ActivityStreams Homepage</a>
+</li>
+                  
+                      <li>      <a href="http://activitystrea.ms/specs/"  title="ActivityStreams
Specifications">ActivityStreams Specifications</a>
+</li>
+                  
+                      <li>      <a href="http://blogs.apache.org/streams/"  title="Streams
Blog">Streams Blog</a>
+</li>
+                  
+                      <li>      <a href="http://wiki.apache.org/incubator/StreamsProposal"
 title="Streams Proposal Wiki Page">Streams Proposal Wiki Page</a>
+</li>
+                          </ul>
+      </li>
+                <li class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown">Foundation <b
class="caret"></b></a>
+        <ul class="dropdown-menu">
+        
+                      <li>      <a href="http://www.apache.org/"  title="Foundation
Info">Foundation Info</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/sponsorship.html"
 title="Sponsorship">Sponsorship</a>
+</li>
+                  
+                      <li>      <a href="http://www.apache.org/foundation/thanks.html"
 title="Thanks">Thanks</a>
+</li>
+                          </ul>
+      </li>
+                  </ul>
+          
+          
+                                                                            
+                   
+                      </div>
+          
+        </div>
+      </div>
+    </div>
+    
+        <div class="container">
+          <div id="banner">
+        <div class="pull-left">
+                                                  <a href="../../.." id="bannerLeft">
+                                                                                        
       <img src="../../../images/streams_logo.jpg"  alt="Apache Streams" width="150" height="100"/>
+                </a>
+                      </div>
+        <div class="pull-right">                  <a href="http://incubator.apache.org"
id="bannerRight">
+                                                                                        <img
src="http://incubator.apache.org/images/egg-logo.png"  alt="Apache Incubator"/>
+                </a>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+                
+                    
+                              <li class="">
+                    <a href="http://incubator.apache.org/" class="externalLink" title="Incubator">
+        Incubator</a>
+                    <span class="divider">/</span>
+      </li>
+            <li class="">
+                    <a href="../../../" title="Streams">
+        Streams</a>
+                    <span class="divider">/</span>
+      </li>
+        <li class="active ">Website Information</li>
+        
+                
+                    
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span>
Last Published: 2016-04-25</li>
+              <li id="projectVersion" class="pull-right">
+                    Version: 0.3-incubating-SNAPSHOT
+        </li>
+            
+                            </ul>
+      </div>
+
+      
+                
+        <div id="bodyColumn" >
+                                  
+            <div class="section">
+<div class="section">
+<h3><a name="Website_Information"></a>Website Information</h3>
+<p><a class="externalLink" href="http://streams.incubator.apache.org">http://streams.incubator.apache.org</a>
is a set of interconnected websites generated by the maven site plugin. The front page, this
page, and most pages linked in the top nav of the site are part of incubator-streams-master.</p>
+<div class="section">
+<h4><a name="Website_Content"></a>Website Content</h4>
+<p>Pages, diagrams, and other hard-linkable resources are stored throughout the source
tree.</p></div>
+<div class="section">
+<h4><a name="Markdown"></a>Markdown</h4>
+
+<ul>
+  
+<li>src/site/markdown</li>
+</ul>
+<p>Most HTML pages are generated from markdown. The maven-site-plugin does this during
the site build process.</p></div>
+<div class="section">
+<h4><a name="Schemas"></a>Schemas</h4>
+
+<ul>
+  
+<li>src/main/jsonschema</li>
+  
+<li>src/main/xmlschema</li>
+</ul>
+<p>JSON and XML Schemas through-out the project are copied to the web page of their
respective modules so they can be linked to in other projects.</p>
+<p>This allows users to extend the canonical streams schemas incrementally and/or re-use
specific fields as they see fit.</p></div>
+<div class="section">
+<h4><a name="Resources"></a>Resources</h4>
+
+<ul>
+  
+<li>src/main/resources</li>
+  
+<li>src/test/resources</li>
+</ul>
+<p>Other resources including .conf and .properties files are copied to the web page
of their respective modules so they can be linked to across projects and in external projects.</p>
+<p>This allows users to import HOCON from modules outside their sphere of control and
adapt to changes upstream.</p></div></div>
+<div class="section">
+<h3><a name="Website_Changes"></a>Website Changes</h3>
+<p>The project website(s) are hosted by the Apache foundation and updated via SVN.</p>
+<p>Currently pushing website changes is a manual process performed by whomever is making
the change.</p>
+<p>This typically requires checking out the current website from SVN.</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">`svn co https://svn.apache.org/repos/infra/websites/production/streams/content`
+`cd content`
+</pre></div></div>
+<div class="section">
+<h4><a name="Preparing_to_publishing_a_new_website_version"></a>Preparing
to publishing a new website version</h4>
+<p>The instructions below presume:</p>
+
+<ul>
+  
+<li>you have a shell open in the SVN content directory</li>
+  
+<li>you know the artifactId and version of the repository you want to publish.</li>
+</ul>
+<p>If this is a brand new snapshot or release version, you first need to create a directory
corresponding to the new version.</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">`content$ mkdir site/${project.version}`
+`content$ svn add site/${project.version}`
+`content$ svn commit -m &quot;svn add site/${project.version}&quot;`
+</pre></div></div>
+<p>The first time a specific site is being published for this version, you must create
the directory where it will be published.</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">`content$ mkdir site/${project.version}/${project.artifactId}`
+`content$ svn add site/${project.version}/${project.artifactId}`
+`content$ svn commit -m &quot;svn add site/${project.version}/${project.artifactId}&quot;`
+</pre></div></div>
+<p>The folder must exist and be empty for the publish steps to succeed.</p>
+<p>Repositories should always be built and published in the following order:</p>
+
+<ul>
+  
+<li>streams-master</li>
+  
+<li>streams-project</li>
+  
+<li>streams-examples</li>
+</ul></div>
+<div class="section">
+<h4><a name="Generating_and_publishing_a_new_website_version"></a>Generating
and publishing a new website version</h4>
+<p>The instructions below presume:</p>
+
+<ul>
+  
+<li>you have a shell open in the root of a project repository</li>
+  
+<li>you know the artifactId and version of the repository you want to publish.</li>
+</ul>
+<p>First, ensure that you have local credentials capable of publishing the site.</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">&lt;server&gt;
+  &lt;id&gt;site.streams.{master|project|examples}&lt;/id&gt;
+  &lt;username&gt;{your apache ID}&lt;/username&gt;
+  &lt;privateKey&gt;{absolute path to your private key&lt;/privateKey&gt;
+  &lt;passphrase&gt;{your private key passphrase}&lt;/passphrase&gt;
+  &lt;filePermissions&gt;664&lt;/filePermissions&gt;
+  &lt;directoryPermissions&gt;775&lt;/directoryPermissions&gt;
+  &lt;configuration&gt;&lt;/configuration&gt;
+&lt;/server&gt;
+</pre></div></div>
+<p>Next, generate SVG resources for all DOT diagrams in the source tree</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">`$ for dot in $(find . -name *.dot);
do dot -Tsvg $dot -o $dot.svg; done`
+</pre></div></div>
+<p>Then, generate the site that will be published</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">`$ mvn clean site:site site:stage`
+</pre></div></div>
+<p>At this point you can open target/staging/index.html and do a sanity check on the
site you intend to publish.</p>
+<p>Finally, publish the site.</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">`$ scm-publish:publish-scm -Dscmpublish.pubScmUrl=scm:svn:https://svn.apache.org/repos/infra/websites/production/streams/content/site/${project.version}/${project.artifactId}`
+</pre></div></div>
+<p>You should now be able to access the published site(s) via an absolute URL.</p>
+
+<div class="source">
+<div class="source"><pre class="prettyprint">http://streams.incubator.apache.org/site/${project.version}/${project.artifactId}
+</pre></div></div>
+<p>For example, website documentation from a recent release:</p>
+
+<ul>
+  
+<li><a class="externalLink" href="http://streams.incubator.apache.org/site/0.2-incubating/streams-project/index.html">http://streams.incubator.apache.org/site/0.2-incubating/streams-project/index.html</a></li>
+</ul>
+<p>Some recent snapshots:</p>
+
+<ul>
+  
+<li><a class="externalLink" href="http://streams.incubator.apache.org/site/0.3-incubating-SNAPSHOT/streams-master/index.html">http://streams.incubator.apache.org/site/0.3-incubating-SNAPSHOT/streams-master/index.html</a></li>
+  
+<li><a class="externalLink" href="http://streams.incubator.apache.org/site/0.3-incubating-SNAPSHOT/streams-project/index.html">http://streams.incubator.apache.org/site/0.3-incubating-SNAPSHOT/streams-project/index.html</a></li>
+  
+<li><a class="externalLink" href="http://streams.incubator.apache.org/site/0.2-incubating-SNAPSHOT/streams-examples/index.html">http://streams.incubator.apache.org/site/0.2-incubating-SNAPSHOT/streams-examples/index.html</a></li>
+</ul></div>
+<div class="section">
+<h4><a name="Promoting_a_new_website_version"></a>Promoting a new website
version</h4>
+<p>New release or snapshots are immediately published, but visitors to the website
won&#x2019;t arrive there from standard links and navigation until it has been fully promoted.</p>
+<p>The instructions below presume:</p>
+
+<ul>
+  
+<li>you have a shell open in the SVN content directory</li>
+  
+<li>you know the artifactId and version of the repository you want to publish.</li>
+</ul>
+<p>The convention in place exposes the latest specific site version(s) using redirects
maintained in the .htaccess file of project website SVN.</p>
+<p>This file can be edited from <a class="externalLink" href="https://cms.apache.org/streams/">https://cms.apache.org/streams/</a></p>
+<p>First, click &#x2018;Get streams Working Copy&#x2019;</p>
+<p>Next, open .htaccess</p>
+<p>Alter the Redirect lines from the</p>
+<p>Commit your changes.</p>
+<p>Wait a few seconds and click Follow Staging Build.</p>
+<p>You should see a new build with a &#x2018;Build Successful&#x2019; message</p></div></div></div>
+                  </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container">
+                      <div class="row">
+                                      <p >Copyright &copy;                    2012&#x2013;2016
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
+            All rights reserved.      
+                    
+      </p>
+                </div>
+
+                <p id="poweredBy" class="pull-right">
+                          <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>
+              </p>
+        
+                </div>
+    </footer>
+        </body>
+</html>
\ No newline at end of file



Mime
View raw message