https://issues.apache.org/jira/browse/OPENWIRE-2
Add initial website module Project: http://git-wip-us.apache.org/repos/asf/activemq-openwire/repo Commit: http://git-wip-us.apache.org/repos/asf/activemq-openwire/commit/429b1b4a Tree: http://git-wip-us.apache.org/repos/asf/activemq-openwire/tree/429b1b4a Diff: http://git-wip-us.apache.org/repos/asf/activemq-openwire/diff/429b1b4a Branch: refs/heads/master Commit: 429b1b4a44b6201bc1fcdbd78c6c8d3628bd807b Parents: 4db2817 Author: Timothy Bish <[email protected]> Authored: Tue Aug 12 17:10:57 2014 -0400 Committer: Timothy Bish <[email protected]> Committed: Tue Aug 12 17:10:57 2014 -0400 ---------------------------------------------------------------------- openwire-website/.gitignore | 1 + openwire-website/README.md | 14 + openwire-website/ext/ScalatePackage.scala | 29 + openwire-website/ext/Website.scala | 63 + openwire-website/ext/scalate/Boot.scala | 66 + openwire-website/pom.xml | 354 + .../src/WEB-INF/scalate/layouts/default.jade | 88 + openwire-website/src/WEB-INF/web.xml | 45 + openwire-website/src/_navigation.ssp.md | 6 + openwire-website/src/blog/index.page | 39 + openwire-website/src/blog/index.rss.feed | 5 + .../src/blog/releases/release-1.0.page | 48 + .../src/community/_creating_patches.ssp.md | 23 + openwire-website/src/community/building.page | 77 + .../src/community/contributing.page | 74 + openwire-website/src/community/developers.page | 38 + openwire-website/src/community/faq.page | 74 + openwire-website/src/community/index.page | 89 + .../src/community/release-guide.page | 55 + openwire-website/src/community/site.page | 84 + openwire-website/src/community/source.page | 101 + openwire-website/src/community/support.page | 39 + .../src/documentation/getting-started.md | 42 + openwire-website/src/documentation/index.page | 28 + .../src/documentation/module-organization.page | 45 + .../src/documentation/openwire-manual.md | 60 + openwire-website/src/download.page | 133 + .../src/images/module-deps-graph.png | Bin 0 -> 8278 bytes .../src/images/project-logo-vector.png | Bin 0 -> 58826 bytes openwire-website/src/images/project-logo.png | Bin 0 -> 3561 bytes openwire-website/src/images/rss.gif | Bin 0 -> 1166 bytes openwire-website/src/index.page | 42 + openwire-website/src/privacy-policy.page | 48 + openwire-website/src/scripts/jquery.js | 8981 ++++++++++++++++++ .../src/styles/impact/blog.template | 26 + .../src/styles/impact/css/pygmentize.css | 127 + openwire-website/src/styles/impact/css/site.css | 235 + openwire-website/src/versions/index.page | 38 + pom.xml | 11 + 39 files changed, 11228 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/.gitignore ---------------------------------------------------------------------- diff --git a/openwire-website/.gitignore b/openwire-website/.gitignore new file mode 100644 index 0000000..ea8c4bf --- /dev/null +++ b/openwire-website/.gitignore @@ -0,0 +1 @@ +/target http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/README.md ---------------------------------------------------------------------- diff --git a/openwire-website/README.md b/openwire-website/README.md new file mode 100644 index 0000000..5e9b03a --- /dev/null +++ b/openwire-website/README.md @@ -0,0 +1,14 @@ +## OpenWire Protocol Library website + +This maven project builds the OpenWire protocol library website content. Its mostly consists of markdown files you can view/edit directly or via github. + +If you want to build the HTML yourself try: + +``` +mvn jetty:run +``` + +To generate the static html try: +``` +mvn scalate:sitegen +``` http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/ext/ScalatePackage.scala ---------------------------------------------------------------------- diff --git a/openwire-website/ext/ScalatePackage.scala b/openwire-website/ext/ScalatePackage.scala new file mode 100644 index 0000000..0e73d37 --- /dev/null +++ b/openwire-website/ext/ScalatePackage.scala @@ -0,0 +1,29 @@ +/** + * 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. + */ +import org.fusesource.scalate.support.TemplatePackage +import org.fusesource.scalate.{Binding, TemplateSource} + +/** + * Defines the template package of reusable imports, attributes and methods across templates + */ +class ScalatePackage extends TemplatePackage { + def header(source: TemplateSource, bindings: List[Binding]) = + """ + // common imports go here + import _root_.Website._; + """ +} http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/ext/Website.scala ---------------------------------------------------------------------- diff --git a/openwire-website/ext/Website.scala b/openwire-website/ext/Website.scala new file mode 100644 index 0000000..176edc6 --- /dev/null +++ b/openwire-website/ext/Website.scala @@ -0,0 +1,63 @@ +/** + * 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. + */ +import org.fusesource.scalate.RenderContext + +package + +/** + * <p> + * </p> + */ +object Website { + + val project_name= "ActiveMQ OpenWire" + val project_slogan= "ActiveMQ's OpenWire Protocol library" + val project_id= "OpenWire" + val project_jira_key= "OPENWIRE" + val project_issue_url= "https://issues.apache.org/jira/browse/OPENWIRE"; + val project_forums_url= "http://activemq.2283324.n4.nabble.com/ActiveMQ-Dev-f2368404.html"; + val project_wiki_url= "https://cwiki.apache.org/confluence/display/ACTIVEMQ/Index"; + val project_logo= "/images/project-logo.png" + val project_version= "1.0" + val project_snapshot_version= "1.0-SNAPSHOT" + val project_versions = List( + project_version, + "1.0" + ) + + val project_keywords= "messaging,openwire,jms,activemq,apollo,protocol" + + // ------------------------------------------------------------------- + val github_page= "https://github.com/apache/activemq-openwire"; + val git_user_url= "git://github.com/apache/activemq-openwire" + val git_commiter_url= "https://git-wip-us.apache.org/repos/asf/activemq-openwire.git"; + val git_branch= "master" + val git_edit_page_base = github_page+"/edit/"+git_branch+"/website/src" + val disqus_shortname = project_id + + // REMOVE ME ------------------------------------------------------------------- + val project_git_url= "https://git-wip-us.apache.org/repos/asf/activemq-openwire.git"; + val project_git_trunk_url= project_git_url +"/master" + val project_git_branches_url= project_git_url + "/branches" + val project_git_tags_url= project_git_url + "/tags" + val project_git_commiter_url= project_git_trunk_url.replaceFirst("http","https") + + val project_maven_groupId= "org.apache.activemq" + val project_maven_artifactId= "openwire-protocol" + + val website_base_url= "http://activemq.apache.org/openwire"; +} \ No newline at end of file http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/ext/scalate/Boot.scala ---------------------------------------------------------------------- diff --git a/openwire-website/ext/scalate/Boot.scala b/openwire-website/ext/scalate/Boot.scala new file mode 100644 index 0000000..e90ae74 --- /dev/null +++ b/openwire-website/ext/scalate/Boot.scala @@ -0,0 +1,66 @@ +/** + * 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. + */ +package scalate + +import org.fusesource.scalate.util.Logging +import java.util.concurrent.atomic.AtomicBoolean +import _root_.Website._ +import org.fusesource.scalate._ +import org.fusesource.scalamd.{MacroDefinition, Markdown} +import java.util.regex.Matcher +import org.fusesource.scalate.wikitext.Pygmentize + +class Boot(engine: TemplateEngine) extends Logging { + + private var _initialised = new AtomicBoolean(false) + + def run: Unit = { + if (_initialised.compareAndSet(false, true)) { + def filter(m:Matcher):String = { + val filter_name = m.group(1) + val body = m.group(2) + engine.filter(filter_name) match { + case Some(filter)=> + filter.filter(RenderContext(), body) + case None=> + error("filter not found: "+filter_name) + body + } + } + + def pygmentize(m:Matcher):String = Pygmentize.pygmentize(m.group(2), m.group(1)) + + // add some macros to markdown. + Markdown.macros :::= List( + MacroDefinition("""\{filter::(.*?)\}(.*?)\{filter\}""", "s", filter, true), + MacroDefinition("""\{pygmentize::(.*?)\}(.*?)\{pygmentize\}""", "s", pygmentize, true), + MacroDefinition("""\{pygmentize\_and\_compare::(.*?)\}(.*?)\{pygmentize\_and\_compare\}""", "s", pygmentize, true), + MacroDefinition("""\$\{project_version\}""", "", _ => project_version.toString, true), + MacroDefinition("""\$\{project_name\}""", "", _ => project_name.toString, true), + MacroDefinition("""\$\{project_id\}""", "", _ => project_id.toString, true), + MacroDefinition("""\$\{project_issue_url\}""", "", _ => project_issue_url.toString, true), + MacroDefinition("""\$\{website_base_url\}""", "", _ => website_base_url.toString, true) + ) + + for( ssp <- engine.filter("ssp"); md <- engine.filter("markdown") ) { + engine.pipelines += "ssp.md"-> List(ssp, md) + engine.pipelines += "ssp.markdown"-> List(ssp, md) + } + info("Bootstrapped website gen for: %s".format(project_name)) + } + } +} \ No newline at end of file http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/pom.xml ---------------------------------------------------------------------- diff --git a/openwire-website/pom.xml b/openwire-website/pom.xml new file mode 100644 index 0000000..e414dea --- /dev/null +++ b/openwire-website/pom.xml @@ -0,0 +1,354 @@ +<?xml version="1.0"?> +<!-- + 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. +--> +<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"; xmlns="http://maven.apache.org/POM/4.0.0"; + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";> + <modelVersion>4.0.0</modelVersion> + <parent> + <groupId>org.apache.activemq</groupId> + <artifactId>openwire-protocol</artifactId> + <version>1.0-SNAPSHOT</version> + </parent> + + <artifactId>openwire-website</artifactId> + <name>openwire-website</name> + <description>Creates the static website for the OpenWire library.</description> + <packaging>pom</packaging> + + <properties> + <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> + + <jettyPort>8000</jettyPort> + + <!-- lets use the latest greatest! :) --> + <hawtio-release-version>${project.version}</hawtio-release-version> + + <scala-version>2.10.0</scala-version> + <scala-plugin-version>3.1.0</scala-plugin-version> + <scalate-version>1.6.1</scalate-version> + <scalamd-version>1.6</scalamd-version> + <jetty-plugin-version>7.0.1.v20091125</jetty-plugin-version> + + <netbeans.hint.deploy.server>Tomcat60</netbeans.hint.deploy.server> + </properties> + + <dependencies> + <dependency> + <groupId>org.fusesource.scalate</groupId> + <artifactId>scalate-wikitext_2.10</artifactId> + <version>${scalate-version}</version> + </dependency> + <dependency> + <groupId>org.fusesource.scalate</groupId> + <artifactId>scalate-page_2.10</artifactId> + <version>${scalate-version}</version> + </dependency> + <dependency> + <groupId>org.fusesource.scalamd</groupId> + <artifactId>scalamd_2.10</artifactId> + <version>${scalamd-version}</version> + </dependency> + <dependency> + <groupId>org.slf4j</groupId> + <artifactId>slf4j-log4j12</artifactId> + </dependency> + + <!-- testing --> + <dependency> + <groupId>org.fusesource.scalate</groupId> + <artifactId>scalate-test_2.10</artifactId> + <version>${scalate-version}</version> + <scope>test</scope> + </dependency> + </dependencies> + + <build> + <sourceDirectory>ext</sourceDirectory> + + <plugins> + <plugin> + <inherited>true</inherited> + <artifactId>maven-source-plugin</artifactId> + <executions> + <execution> + <id>attach-sources</id> + <goals> + <goal>jar</goal> + </goals> + </execution> + </executions> + </plugin> + + <plugin> + <groupId>net.alchim31.maven</groupId> + <artifactId>scala-maven-plugin</artifactId> + <version>${scala-plugin-version}</version> + <executions> + <execution> + <goals> + <goal>compile</goal> + <goal>testCompile</goal> + </goals> + </execution> + </executions> + <configuration> + <jvmArgs> + <jvmArg>-Xmx1024m</jvmArg> + <jvmArg>-Xss8m</jvmArg> + </jvmArgs> + <scalaVersion>${scala-version}</scalaVersion> + <target>jvm-1.6</target> + </configuration> + </plugin> + + <plugin> + <artifactId>maven-surefire-plugin</artifactId> + <configuration> + <forkMode>once</forkMode> + <!-- these settings are mandatory to avoid SureFire giving a bogus system property to the web container --> + <useSystemClassLoader>false</useSystemClassLoader> + <useManifestOnlyJar>false</useManifestOnlyJar> + <includes> + <include>**/*Test.*</include> + </includes> + <excludes> + <exclude>**/SomeFailingTest.*</exclude> + </excludes> + </configuration> + </plugin> + + <plugin> + <groupId>org.fusesource.scalate</groupId> + <artifactId>maven-scalate-plugin_2.10</artifactId> + <version>${scalate-version}</version> + + <configuration> + <webappDirectory>${basedir}/src</webappDirectory> + <remoteServerId>apache-website</remoteServerId> + <remoteServerUrl>${website-base-url}/versions/${project.version}/website/</remoteServerUrl> + </configuration> + + <executions> + <execution> + <id>sitegen</id> + <goals> + <goal>sitegen</goal> + </goals> + <phase>package</phase> + </execution> + </executions> + + </plugin> + + <plugin> + <groupId>org.mortbay.jetty</groupId> + <artifactId>jetty-maven-plugin</artifactId> + <version>${jetty-plugin-version}</version> + <configuration> + <webAppSourceDirectory>${basedir}/src</webAppSourceDirectory> + <systemProperties> + <systemProperty> + <name>scalate.editor</name> + <value>${env.SCALATE_EDITOR}</value> + </systemProperty> + <systemProperty> + <name>scalate.workdir</name> + <value>${basedir}/target/_scalate</value> + </systemProperty> + <systemProperty> + <name>scalate.mode</name> + <value>development</value> + </systemProperty> + </systemProperties> + <scanIntervalSeconds>0</scanIntervalSeconds> + </configuration> + </plugin> + + <plugin> + <artifactId>maven-antrun-plugin</artifactId> + <executions> + <execution> + <phase>process-sources</phase> + <configuration> + <tasks> + <mkdir dir="${basedir}/target/sitegen/documentation/schema" /> + </tasks> + </configuration> + <goals> + <goal>run</goal> + </goals> + </execution> + </executions> + </plugin> + </plugins> + </build> + + <reporting> + <plugins> + <plugin> + <groupId>org.fusesource.mvnplugins</groupId> + <artifactId>maven-linkchecker-plugin</artifactId> + <version>${mvnplugins-version}</version> + <configuration> + <excludedLinks> + <value>http://github.com/</value> + <value>http://git.or.cz/</value> + <value>http://localhost:8080/</value> + <value>http://repo.fusesource.com/</value> + <value>http://search.twitter.com/</value> + <value>http://www.chengin.com/</value> + </excludedLinks> + </configuration> + </plugin> + </plugins> + </reporting> + + <profiles> + + <!-- We only include the java doc when doing a release build since + that's when the javadoc actually gets generated --> + <profile> + <id>apache-release</id> + + <dependencies> + <dependency> + <groupId>org.apache.activemq</groupId> + <artifactId>openwire-core</artifactId> + <version>${project.version}</version> + <classifier>javadoc</classifier> + <scope>test</scope> + </dependency> + <dependency> + <groupId>org.apache.activemq</groupId> + <artifactId>openwire-legacy</artifactId> + <version>${project.version}</version> + <classifier>javadoc</classifier> + <scope>test</scope> + </dependency> + <dependency> + <groupId>org.apache.activemq</groupId> + <artifactId>openwire-jms</artifactId> + <version>${project.version}</version> + <classifier>javadoc</classifier> + <scope>test</scope> + </dependency> + + </dependencies> + + <build> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-dependency-plugin</artifactId> + <version>2.2</version> + <executions> + <execution> + <id>unpack</id> + <phase>package</phase> + <goals> + <goal>unpack</goal> + </goals> + <configuration> + <artifactItems> + <artifactItem> + <groupId>org.apache.activemq</groupId> + <artifactId>openwire-core</artifactId> + <classifier>javadoc</classifier> + <outputDirectory>${basedir}/target/sitegen/documentation/api/openwire-core</outputDirectory> + </artifactItem> + <artifactItem> + <groupId>org.apache.activemq</groupId> + <artifactId>openwire-legacy</artifactId> + <classifier>javadoc</classifier> + <outputDirectory>${basedir}/target/sitegen/documentation/api/openwire-legacy</outputDirectory> + </artifactItem> + <artifactItem> + <groupId>org.apache.activemq</groupId> + <artifactId>openwire-jms</artifactId> + <classifier>javadoc</classifier> + <outputDirectory>${basedir}/target/sitegen/documentation/api/openwire-jms</outputDirectory> + </artifactItem> + </artifactItems> + </configuration> + </execution> + </executions> + </plugin> + </plugins> + </build> + </profile> + + <profile> + <id>deploy-website</id> + <activation> + <property> + <name>java.vm.name</name> + </property> + </activation> + <build> + <plugins> + <plugin> + <groupId>org.fusesource.scalate</groupId> + <artifactId>maven-scalate-plugin_2.10</artifactId> + <version>${scalate-version}</version> + + <executions> + <execution> + <id>deploy</id> + <goals> + <goal>deploy</goal> + </goals> + <phase>deploy</phase> + </execution> + </executions> + </plugin> + </plugins> + </build> + </profile> + + + <profile> + <id>ibmjdk</id> + <activation> + <file> + <exists>${java.home}/../lib/tools.jar</exists> + </file> + </activation> + <build> + <pluginManagement> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-antrun-plugin</artifactId> + <dependencies> + <dependency> + <groupId>com.sun</groupId> + <artifactId>tools</artifactId> + <!--the real JDK version could be 1.5 or 1.6--> + <version>1.5.0</version> + <scope>system</scope> + <optional>true</optional> + <systemPath>${java.home}/../lib/tools.jar</systemPath> + </dependency> + </dependencies> + </plugin> + </plugins> + </pluginManagement> + </build> + </profile> + </profiles> + +</project> http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/WEB-INF/scalate/layouts/default.jade ---------------------------------------------------------------------- diff --git a/openwire-website/src/WEB-INF/scalate/layouts/default.jade b/openwire-website/src/WEB-INF/scalate/layouts/default.jade new file mode 100644 index 0000000..d0ee540 --- /dev/null +++ b/openwire-website/src/WEB-INF/scalate/layouts/default.jade @@ -0,0 +1,88 @@ +!!! Basic +:plain + <!-- + 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. + Architecture + --> +- response.setContentType("text/html") +-@ var title : String = "" +-@ var body: String = null +-@ var overview: String = null +-@ var spot: String = null +-@ var blog: String = null +-@ var head: String = null +- val include_console = engine.isDevelopmentMode && engine.resourceLoader.exists("/org/fusesource/scalate/console/console_head.scaml") +html(lang="en") + head + meta(content="text/html; charset=utf-8" http-equiv="Content-Type") + meta(content="#{project_slogan}" name="description") + meta(content="#{project_keywords}" name="keywords") + meta(content="#{project_name}" name="author") + script(src={uri("/scripts/jquery.js")}) + link(type="text/css" rel="stylesheet" href={uri("/styles/impact/css/pygmentize.css")}) + link(type="text/css" rel="stylesheet" href={uri("/styles/impact/css/site.css")}) + + - if (head!=null) + !~~ head + + -# + - if (include_console) + - include("/org/fusesource/scalate/console/console_head.scaml") + link(href={uri("/css/scalate/console.css")} rel="stylesheet" type="text/css") + + title= title + body + div#navigation + div.wrapper + - include("/_navigation.ssp.md") + + - if (overview!=null) + div#overview + div.wrapper + -if ( project_logo!=null ) + div.logo + img(src="#{uri(project_logo)}" alt="#{project_name} logo") + div.message + !~~ overview + + - if (spot!=null) + div#spot + div.wrapper + !~~ spot + + - if (body!=null) + div#content + div.wrapper + !~~ body + + - if (blog!=null) + div#blog + div.wrapper + !~~ blog + + -# + - if (include_console) + = include("/org/fusesource/scalate/console/console.scaml") + -# + :javascript + var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl."; : "http://www.";); + document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E")); + </script> + <script type="text/javascript"> + try { + var pageTracker = _gat._getTracker("UA-1347593-12"); + pageTracker._trackPageview(); + } catch(err) {} \ No newline at end of file http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/WEB-INF/web.xml ---------------------------------------------------------------------- diff --git a/openwire-website/src/WEB-INF/web.xml b/openwire-website/src/WEB-INF/web.xml new file mode 100644 index 0000000..d624411 --- /dev/null +++ b/openwire-website/src/WEB-INF/web.xml @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + + 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. + +--> + +<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"; + xmlns="http://java.sun.com/xml/ns/javaee"; xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"; + xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"; + version="2.5"> + + <display-name>Website</display-name> + + <filter> + <filter-name>TemplateEngineFilter</filter-name> + <filter-class>org.fusesource.scalate.servlet.TemplateEngineFilter</filter-class> + </filter> + <filter-mapping> + <filter-name>TemplateEngineFilter</filter-name> + <url-pattern>/*</url-pattern> + </filter-mapping> + + <welcome-file-list> + <welcome-file>index.page</welcome-file> + </welcome-file-list> + + <error-page> + <error-code>500</error-code> + <location>/WEB-INF/scalate/errors/500.scaml</location> + </error-page> +</web-app> http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/_navigation.ssp.md ---------------------------------------------------------------------- diff --git a/openwire-website/src/_navigation.ssp.md b/openwire-website/src/_navigation.ssp.md new file mode 100644 index 0000000..cf0d5ca --- /dev/null +++ b/openwire-website/src/_navigation.ssp.md @@ -0,0 +1,6 @@ + +* [${project_name} ${project_version}](${uri("/")}) +* [Developers](${uri("/community/developers.html")}) +* [Community](${uri("/community/index.html")}) +* [Download](${uri("/download.html")}) + http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/blog/index.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/blog/index.page b/openwire-website/src/blog/index.page new file mode 100644 index 0000000..5cf516c --- /dev/null +++ b/openwire-website/src/blog/index.page @@ -0,0 +1,39 @@ +--- +# 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. + +title: The ${project_name} Blog +in_menu: false +sort_info: 7 + +--- name:head pipeline:ssp +<link rel="alternate" title="${project_name} RSS" href="index.rss" type="application/rss+xml"> + +--- name:overview + +The latest and greatest news from the ${project_name} team + +--- name:blog pipeline:jade + +:ssp + <h1>${project_name} Blog <a href="index.rss"><img src="${uri("/images/rss.gif")}"/></a></h1> + +- import org.fusesource.scalate.page.BlogHelper._ +- for(post <- posts) + .post + a(href={post.link}) + h2= post.title + .details Posted by #{post.author} on #{post.createdAt} + !~~ post.render() \ No newline at end of file http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/blog/index.rss.feed ---------------------------------------------------------------------- diff --git a/openwire-website/src/blog/index.rss.feed b/openwire-website/src/blog/index.rss.feed new file mode 100644 index 0000000..f6b2a40 --- /dev/null +++ b/openwire-website/src/blog/index.rss.feed @@ -0,0 +1,5 @@ +--- +link: ${website_base_url}/blog/ +author: "${project_name} Team" +title: "The ${project_name} Blog" +description: "${project_slogan}" http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/blog/releases/release-1.0.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/blog/releases/release-1.0.page b/openwire-website/src/blog/releases/release-1.0.page new file mode 100644 index 0000000..d971680 --- /dev/null +++ b/openwire-website/src/blog/releases/release-1.0.page @@ -0,0 +1,48 @@ +--- +# 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. + +blog_post: true +title: ActiveMQ OpenWire 1.0 +author: Timothy Bish +author_url: http://activemq.apache.org +created_at: 2012-02-02 12:06:40 -0000 +--- + +The [Apache ActiveMQ Project](http://activemq.apache.org) is pleased to announce the +availability of OpenWire 1.0. ActiveMQ OpenWire is an implementation of ActiveMQ's own +native wire protocol free of any dependencies on a the message Broker. This library +can be used to implement new clients or brokers that can communicate with ActiveMQ and +its various client libraries. + +OpenWire Features: + +* Tight or Loose wire encoding based on size or speed. +* Message body compression. +* Backwards protocol compatibility. + +Further information: + +* [Download](${website_base_url}/download.html) +* [Issues Fixed](https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12315620&version=12327465) +* [Documentation](${website_base_url}/versions/1.0/website/documentation) + +[Feedback](http://activemq.apache.org/community/index.html) is always welcome! + + + + + + http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/community/_creating_patches.ssp.md ---------------------------------------------------------------------- diff --git a/openwire-website/src/community/_creating_patches.ssp.md b/openwire-website/src/community/_creating_patches.ssp.md new file mode 100644 index 0000000..e39bc93 --- /dev/null +++ b/openwire-website/src/community/_creating_patches.ssp.md @@ -0,0 +1,23 @@ +We gladly accept patches if you can find ways to improve, tune or fix +${project_name} in some way. + +Most IDEs can create nice patches now very easily. e.g. in Eclipse just +right click on a file/directory and select `Team -> Create Patch`. Then +just save the patch as a file and then submit it. (You may have to click +on `Team -> Share...` first to enable the Subversion options). +Incidentally if you are an Eclipse user you should install the +[subclipse](http://subclipse.tigris.org/) plugin. + +If you're a command line person try the following to create the patch + + diff -u Main.java.orig Main.java >> patchfile.txt + +or + svn diff Main.java >> patchfile.txt + +### Submitting patches + +The easiest way to submit a patch is to create a new issue at our [Issue +Tracker](${project_issue_url}), attach the patch, tick the Patch +Attached button on the issue then fire off an email to the mailing +lists. http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/community/building.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/community/building.page b/openwire-website/src/community/building.page new file mode 100644 index 0000000..ccbb0a8 --- /dev/null +++ b/openwire-website/src/community/building.page @@ -0,0 +1,77 @@ +--- +# 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. + +title: Building +--- name:overview + +# How to Build ${project_name} +The way most developers get started contributing to a project. + +--- name:content + +## Building with Maven + +${project_name} uses [Maven](http://maven.apache.org/) as its primary +build tool for performing releases and uses the pom.xml to describe +dependencies between modules. + +### Prequisites + +*Required:* + +* Java 1.7 +* Download and [install Maven 3](http://maven.apache.org/download.html) +* Get the latest [source](source.html) + +### A normal build + + mvn install + +### Doing a Quick Build + +The following avoids running all the unit test cases, we just skip the +test running phase and not the building part + + mvn -Dtest=false install + +### Using an IDE + +If you prefer to use an IDE then you can auto-generate the IDE's project +files using maven plugins. e.g. + + mvn eclipse:eclipse + +or + + mvn idea:idea + +### Importing into Eclipse + +If you have not already done so, you will need to make Eclipse aware of +the Maven repository so that it can build everything. In the preferences, +go to `Java -> Build Path -> Classpath` and define a new Classpath +Variable named `M2_REPO` that points to your local Maven repository. i.e. +`~/.m2/repository` on Unix and `c:\Documents and Settings\$username\.m2\repository` +on Windows). + +You can also get Maven to do this for you: + + mvn eclipse:add-maven-repo -Declipse.workspace=/path/to/the/workspace/ + +### See Also + +* [Source](source.html) +* [Developer Links](developers.html) http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/community/contributing.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/community/contributing.page b/openwire-website/src/community/contributing.page new file mode 100644 index 0000000..6529bde --- /dev/null +++ b/openwire-website/src/community/contributing.page @@ -0,0 +1,74 @@ +--- +# 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. + +title: Contributing +in_menu: false +--- name:overview + +# How to contribute to ${project_name} +We love contributions! + +--- name:content + +We really want you to get involved in the ${project_name} project, to +[join the community](index.html) and help make it a better piece of +software - please do dive in and help! + +Try surf the [documentation](../documentation/index.html) and website in +general - if something is confusing or not clear, [let us +know](index.html) or raise a [support request](support.html). + +[Download](../download.html) the code and try it out and see what you think. +Browse the [source code](source.html). Got an itch to scratch, want to +tune some operation or add some feature? + +Want to do some hacking on the ${project_name} code? Try surfing the our +[Issue Tracker](${project_issue_url}) for open issues or features. If something +tickles your fancy, take ownership of the issue and start working on it! Attach +a patch once you fix it. + +## Improving the documentation + +Documentation is massively important to help users make the most of +${project_name} and its probably the area that needs the most help! + +So if you are interested in helping the documentation effort; whether its +just to fix a page here or there, correct a link or even write a tutorial +or improve what documentation is already there please do dive in and +help\! + +All of the documentation is stored in project source repository, see [How +the Site works](site.html) + +## If you find a bug or problem + +Please raise a new issue in our [Issue Tracker](${project_issue_url}). If +you can create a JUnit test case then your issue is more likely to be +resolved quicker. Then we can add your issue to our [source control +system](source.html) and then we'll know when its really fixed and we can +ensure that the problem stays fixed in future releases. + +## Working on the code and creating patches + +We gladly accept patches if you can find ways to improve, tune or fix +${project_name} in some way. + +${include("/community/_creating_patches.ssp.md")} + +## Becoming a committer + +Once you have made some good contributions you may be invited to become a +committer by the project team. We'll chat to you offline about it. http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/community/developers.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/community/developers.page b/openwire-website/src/community/developers.page new file mode 100644 index 0000000..0042f01 --- /dev/null +++ b/openwire-website/src/community/developers.page @@ -0,0 +1,38 @@ +--- +# 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. + +title: Developers +in_menu: false +--- name:overview + +# Developers +Ready to start hacking on ${project_name}? + +--- name:content + +# Developer Links + +* [Source Code](source.html) +* [Building](building.html) +* [Contributing](contributing.html) +* [Release Guide](release-guide.html) +* [Maven Site Reports](${website_base_url}/versions/${project_version}/maven/) + +# API Reference + +* [`openwire-core` API](../documentation/api/openwire-core/index.html) + +Looking for the website documentation of a different ${project_name} [version](${website_base_url}/versions/index.html)? http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/community/faq.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/community/faq.page b/openwire-website/src/community/faq.page new file mode 100644 index 0000000..6a4ea87 --- /dev/null +++ b/openwire-website/src/community/faq.page @@ -0,0 +1,74 @@ +--- +# 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. + +title: FAQ +in_menu: false +sort_info: 41 +# FYI: +# The fragments processor allows the TOC to generated by the menu tag. +--- name:overview + +# Burning Questions? + +This page contains all the frequently asked questions about the +${project_name} project. + +--- name:content + +{:toc} + +## General Questions + +General questions on the *${project_name}* project. + +### Why the name ${project_name}? + + +### What is the license? + +The license is [Apache 2 +License](http://www.apache.org/licenses/LICENSE-2.0) + +### How do I get support? + +See the [support guide](support.html) for more details. + +### How do I build ${project_name}? + +First [get the source](source.html) then see the [building +guide](building.html) + +### How do I contribute or become a committer? + +We love [contributions](contributing.html)! More details on how to +contribute and how to become a committer are in the [contributing +guide](contributing.html). + +### How do I register for the issue tracker? + +For more detail see the [support page](support.html). If you haven't done +so already you can [register with the issue tracker +here](https://www.assembla.com/user/signup) + +### How does the website work? + +For details on how to edit the website and how it works see +[How the Site works](site.html) + +## Using ${project_name} + +### How do I get started? + http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/community/index.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/community/index.page b/openwire-website/src/community/index.page new file mode 100644 index 0000000..b52361b --- /dev/null +++ b/openwire-website/src/community/index.page @@ -0,0 +1,89 @@ +--- +# 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. + +title: Community +in_menu: true +sort_info: 50 +--- name:overview + +# Lets Talk +The ${project_name} community is here to help you + +--- name:content pipeline:jade + +.left + h1 Issue Tracker +.right + :markdown + If you have a problem you can [get help](support.html) or try surfing + our [Issue Tracker](${project_issue_url}) + +.left + h1 Mailing Lists +.right + :markdown + + We really want you to get involved in the ${project_name} and we love + [contributions](contributing.html). One of the easiest ways to get + involved is to join the community discussions. + + ### ${project_name} User List + + This mailing list is end users to ask general questions about + ${project_name} + + * [Subscribe](mailto:[email protected]) + * [Unsubscribe](mailto:[email protected]) + * [Apache Archive](http://mail-archives.apache.org/mod_mbox/activemq-users/) + * [MarkMail Archive](http://activemq.markmail.org/search/list:org.apache.activemq.users) + * [Nabble Forum](http://activemq.2283324.n4.nabble.com/ActiveMQ-User-f2341805.html) + + ### ${project_name} Developer List + + This mailing list is for contributor to discuss the bug fixes and + and new features being developed for ${project_name} + + * [Subscribe](mailto:[email protected]) + * [Unsubscribe](mailto:[email protected]) + * [Apache Archive](http://mail-archives.apache.org/mod_mbox/activemq-dev/) + * [MarkMail Archive](http://activemq.markmail.org/search/list:org.apache.activemq.dev) + * [Nabble Forum](http://activemq.2283324.n4.nabble.com/ActiveMQ-Dev-f2368404.html) + + ### ${project_name} Commits List + + This mailing list get automatically notified when when the + project source code gets updated. + + * [Subscribe](mailto:[email protected]) + * [Unsubscribe](mailto:[email protected]) + * [Apache Archive](http://mail-archives.apache.org/mod_mbox/activemq-commits/) + * [MarkMail Archive](http://activemq.markmail.org/search/list:org.apache.activemq.commits) + +.left + h1 IRC +.right + :markdown + + You can also catch us on IRC to chat via the **#activemq** channel on + the **irc.codehaus.org** server. + +.left + h1 Blog +.right + :markdown + Keep up to date on the latest and greatest releases by following the + [${project_name} Blog](../blog/index.html) + http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/community/release-guide.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/community/release-guide.page b/openwire-website/src/community/release-guide.page new file mode 100644 index 0000000..b147d0c --- /dev/null +++ b/openwire-website/src/community/release-guide.page @@ -0,0 +1,55 @@ +--- +# 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. + +title: Release Guide +in_menu: false +--- name:overview + +# Release Guide +How to create releases of ${project_name} + +--- name:content + +## Release Preparation Steps + +Various documentation changes first (which should be done before the release is cut) + +* update the **${project_id}-website/src/main/webapp/download.page** page for this release +* edit the **${project_id}-website/src/main/scala/Website.scala** file and change the **project\_version** values +* blog about the release by creating an entry in **${project_id}-website/src/blog/releases** +* update the changelog.md file, copying and pasting the section the release highlights from the above blog post +* add a link to the **${project_id}-website/src/main/webapp/versions.page** to the new version. + +## Cutting the release + +* prepare the release + +{pygmentize:: text} +mvn -P release release:prepare +{pygmentize} + +* perform the release + +{pygmentize:: text} +mvn -P release release:perform +{pygmentize} + +* open [Nexus Staging](http://repository.apache.org/index.html#staging) + and close the staged release of #{project_name} +* now start a vote on the mailing lists and if it passes +* promote the closed release in nexus +* announce the release on the [mailing list](index.html) +* drink beers! http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/community/site.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/community/site.page b/openwire-website/src/community/site.page new file mode 100644 index 0000000..453fcb1 --- /dev/null +++ b/openwire-website/src/community/site.page @@ -0,0 +1,84 @@ +--- +# 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. + +title: Building +--- name:overview + +# ${project_name} Site +How the website works + +--- name:content pipeline:jade + +.left + h1 How it works +.right + :markdown + + The *${project_name}* documentation and site is created using Scalate + and is stored in git in the same [source control system as the + code](source.html) + + **Note:** For code highlighting you will need to + [install](http://pygments.org/download/) + [http://pygments.org/](http://pygments.org). + +.left + h1 Editing the source code +.right + :markdown + + If you [grab the source code](source.html) you will find the site + source in the *${project_id}-website* directory. The website is + also built using Maven so, you would + + cd ${project_id}-website + mvn install + + If you want to edit the files in your text editor and be able to + immediately see the site re-rendered in a browser then use + + mvn jetty:run + + You can now surf the site and see changes immediately. + + If you are on OS X then we highly recommend + [TextMate](http://macromates.com/) as a great editor which supports + Textile and Markdown + +.left + h1 Deploying the site +.right + :markdown + + The site is automatically deployed by the CI builds, so you can + simply wait for the changes to be automatically pushed to the project + site. + + You can manually deploy the site using Maven: + + mvn deploy + + Since deployment to our webserver requires proper authorization, + you will need to add an entry to your ~/.m2/settings.xml file simlilar + to: + + {pygmentize:: xml} + <server> + <id>${project_id}-website</id> + <username>xxxx</username> + <password>xxxxx</password> + </server> + {pygmentize} \ No newline at end of file http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/community/source.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/community/source.page b/openwire-website/src/community/source.page new file mode 100644 index 0000000..f472124 --- /dev/null +++ b/openwire-website/src/community/source.page @@ -0,0 +1,101 @@ +--- +# 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. + +title: Source +in_menu: true +sort_info: 40 +--- name:overview +# ${project_name} + +Get the latest source code + +--- name:content pipeline:jade + + +.left + :markdown + # Git + +.right + :&markdown + + #{project_name} stores its source code in a Git repository at this location: + + * [#{project_git_url}](#{project_git_url}) + + If you are new to Git you might have a look at the + [Version Control with Git](http://git-scm.com/book/en/Getting-Started-About-Version-Control) book. + +.left + :markdown + # Browsing Source +.right + :&markdown + + You can browse the source code online by using any of the following + interfaces web interfaces: + + * [Github](#{github_page}) + +.left + h1 How to Checkout +.right + :&markdown + + You must first install a [Git client](http://subversion.apache.org/packages.html). Then + you check out the project using the following: + + git clone #{project_git_trunk_url} #{project_id} + cd #{project_id} + + Now you probably want to try [build the #{project_name} code](building.html) + +.left + :markdown + # Committer Access + +.right + :&markdown + + Committers should check out the the source code using the Apache Git url. + + * [#{project_git_commiter_url}](#{project_git_commiter_url}) + + Only project developers can commit to the Git tree via this method. + + +.left + :markdown + # Contributing patches +.right + :markdown + If you are not yet a committer but want to contribute some + patch (we love [contributions!](contributing.html)) here's + how you can submit patches + + - include("/community/_creating_patches.ssp.md") + +.left + :markdown + # Next steps +.right + :&markdown + Once you have checked out the code try following + + * [instructions to build #{project_name}](building.html) + * read the [documentation](../documentation/index.html) + * browse the [developer links and maven reports](developers.html) + http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/community/support.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/community/support.page b/openwire-website/src/community/support.page new file mode 100644 index 0000000..378f5fc --- /dev/null +++ b/openwire-website/src/community/support.page @@ -0,0 +1,39 @@ +--- +# 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. + +title: Support +in_menu: true +sort_info: 55 +--- name:overview + +# You Are Not Alone +We can help! + +--- name:content + +You may find the [Frequently Asked Questions (FAQ)](faq.html) useful. + +We love feedback of all kinds; whether it's thoughts, ideas, suggestions +or bug reports! + +To submit feedback please contact the [community](index.html), +or use the [${project_name} Issue Tracker](${project_issue_url}). + +### See Also + +* [FAQ](faq.html) +* [Community](index.html) +* [Issue Tracker](${project_issue_url}) http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/documentation/getting-started.md ---------------------------------------------------------------------- diff --git a/openwire-website/src/documentation/getting-started.md b/openwire-website/src/documentation/getting-started.md new file mode 100644 index 0000000..70096e6 --- /dev/null +++ b/openwire-website/src/documentation/getting-started.md @@ -0,0 +1,42 @@ +<!-- + 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. + Architecture +--> +# Getting Started Guide + +{:toc:2-5} + +This guide will help you get started using the OpenWire protocol library in your own applications. + +## Maven dependencies + +To use the openwire library in your maven projects you need to add a dependency to your maven POM file for the core openwire library as follows: + + <dependency> + <groupId>org.apache.activemq</groupId> + <artifactId>openwire-core</artifactId> + <version>${project_version}</version> + </dependency> + +If you need to communicate with client's or brokers using older versions of the protocol then you must also include the legacy codec module: + + <dependency> + <groupId>org.apache.activemq</groupId> + <artifactId>openwire-legacy</artifactId> + <version>${project_version}</version> + </dependency> + + http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/documentation/index.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/documentation/index.page b/openwire-website/src/documentation/index.page new file mode 100644 index 0000000..0d27da3 --- /dev/null +++ b/openwire-website/src/documentation/index.page @@ -0,0 +1,28 @@ +--- +# 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. + +title: Documentation +--- name:overview + +${project_slogan} + +--- name:content + +# Documentation + +* [Getting Started Guide](getting-started.html) +* [OpenWire Protocol Manual](openwire-manual.html) + http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/documentation/module-organization.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/documentation/module-organization.page b/openwire-website/src/documentation/module-organization.page new file mode 100644 index 0000000..97fc109 --- /dev/null +++ b/openwire-website/src/documentation/module-organization.page @@ -0,0 +1,45 @@ +--- +# 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. + +title: Module Organization +--- name:overview + +${project_slogan} + +--- name:content pipeline:markdown + +# Module Organization + +ActiveMQ OpenWire is composed of many loosely coupled jar files. This helps +maintain a clear separations of concerns between the modules and allows +end users to end up with smaller footprint configurations if they don't +need all the optional features of the project. + +## OpenWire Core + +The core library contains the OpenWire Command objects and a set marshalers that +implement the initial 1.0 OpenWire protocol as well as the two most recent version +marshalers for the protocol. This allows for a small library to be used when you +only need to talk to the most up to date Broker instances. + +## OpenWire Legacy + +The module provides all remaining protocol marshalers for versions of OpenWire that +are no longer in common use. If you need to communicate with an older broker instance +then you might need to include this library in order to communicate properly. + + + http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/documentation/openwire-manual.md ---------------------------------------------------------------------- diff --git a/openwire-website/src/documentation/openwire-manual.md b/openwire-website/src/documentation/openwire-manual.md new file mode 100644 index 0000000..6a55301 --- /dev/null +++ b/openwire-website/src/documentation/openwire-manual.md @@ -0,0 +1,60 @@ +# OpenWire Protocol Manual + +{:toc:2-5} + +## The OpenWire Protocol + +The OpenWire Protocol is the native binary wire protocol used by ActiveMQ and its various cross language clients. + +### OpenWire protocol details +This section explains a little more about what's happening on the wire. The STOMP protocol, as it was designed, +is easy to understand and monitor since it's a text-based protocol. OpenWire, however, is binary, +and understanding the interactions that happen isn't as easy. Some clues might be helpful. + +All OpenWire commands are implemented as "command" objects following the Gang of Four [Command Pattern](http://en.wikipedia.org/wiki/Command_pattern). +The structure of the objects are described [at the ActiveMQ website](http://activemq.apache.org/openwire-version-2-specification.html), but +what about the interactions? + + +Establishing a connection to the broker: +A connection is established between the client and the broker with the client creating a new ActiveMQConnection +(most likely using a connection factory of some sort). When a new "connection" is created, the underlying transport +mechanisms send a WireFormatInfo command to the broker. This command describes what version and configurations of the OpenWire protocol +the client wishes to use. For example, some of the configuration options are the ones listed above that can also be +configured on the broker. + +When the TCP connection is handled on the broker side, it sends a WireFormatInfo to the client. The purpose of exchanging +these WireFormatInfo commands is to be able to negotiate what settings to use as each the client and the server has +their own preferred settings. The lowest protocol version between the two is used. When the broker receives the client's +WireFormatInfo command, it negotiates the differences on its side and then sends a BrokerInfo command. Conversely +on the client, when it receives the broker's WireFormatInfo, it negotiates it and sends a ConnectionInfo command. When +the broker receives a ConnectionInfo command, it will either ack it with a Response command, or use security settings established globally +for the broker or for a given virtual host to determine whether connections are allowed. If a connection is not allowed +to the broker or to to virtual host, the broker will kill the connection. + +### OpenWire features to be documented + +* Flow Control +* Persistent Messaging +* Message Expiration + +### Unsupported OpenWire features: + +You will get bad/undefined behaviour if you try to use any of the following OpenWire features: + +* XA transactions +* [Message Groups using JMSXGroupID](http://activemq.apache.org/message-groups.html) +* [Subscription recovery/retroactive consumer](http://activemq.apache.org/retroactive-consumer.html) +* [Exclusive Consumer with Priority](http://activemq.apache.org/exclusive-consumer.html) +* [Virtual Destinations](http://activemq.apache.org/virtual-destinations.html) + +You can use Durable Subscriptions and/or [Mirrored Queues](user-manual.html#Mirrored_Queues) to get +the same/similar behaviour that [Virtual Destinations](http://activemq.apache.org/virtual-destinations.html) provide. + +<!-- The following are not really OpenWire features.. but just general brokers features. +* [Network of brokers](http://activemq.apache.org/networks-of-brokers.html) +* [Shared-state Master/Slave](http://activemq.apache.org/shared-file-system-master-slave.html) +* [Startup Destinations](http://activemq.apache.org/configure-startup-destinations.html) +* [Delete inactive dests](http://activemq.apache.org/delete-inactive-destinations.html) +* [JMX](http://activemq.apache.org/jmx.html) +--> http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/download.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/download.page b/openwire-website/src/download.page new file mode 100644 index 0000000..7da8c53 --- /dev/null +++ b/openwire-website/src/download.page @@ -0,0 +1,133 @@ +--- +# 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. + +title: Download +in_menu: true +sort_info: 5 +--- name:overview + +# ${project_name} +Download it today! +--- name:head pipeline:jade +:javascript + $(function(){ + $("body").find(".accordion").click(function() { + $(this).next().toggle("slow"); + $(this).toggleClass("accordion-opened"); + return false; + }).each(function(){ + $(this).toggleClass("accordion-opened", !$(this).next().is(":visible") && !$(this).next().is(".hide")) + }); + }); + +:css + .download { + font-size: 80%; + } + table.download { width: 100%;} + table.download tr td { + border: 1px solid #ccc; + padding: .5em; + } +--- name:content pipeline:jade + +:&markdown + ## Get the latest official version + +- for( version <- project_versions.headOption ) + :&markdown + ### #{project_name} #{version} + [Release Notes](blog/releases/release-#{version}.html) | [Installation Instructions](${website_base_url}/versions/#{version}/website/documentation/getting-started.html) | [Documentation](${website_base_url}/versions/#{version}/website/documentation/index.html) + + table.download + tr + td Binaries for Unix/Linux/OS X: + td + a(href="http://www.apache.org/dyn/closer.cgi?path=activemq/activemq-openwire/#{version}/apache-openwire-protocol-#{version}-unix-distro.tar.gz";) apache-openwire-protocol-#{version}-unix-distro.tar.gz + td + a(href="http://apache.org/dist/activemq/activemq-openwire/#{version}/apache-openwire-protocol-#{version}-unix-distro.tar.gz.asc";) GPG Signature + tr + td Binaries for Windows: + td + a(href="http://www.apache.org/dyn/closer.cgi?path=activemq/activemq-openwire/#{version}/apache-openwire-protocol-#{version}-windows-distro.zip";) apache-openwire-protocol-#{version}-windows-distro.zip + td + a(href="http://apache.org/dist/activemq/activemq-openwire/#{version}/apache-openwire-protocol-#{version}-windows-distro.zip.asc";) GPG Signature + tr + td Source Code Distribution: + td + a(href="http://www.apache.org/dyn/closer.cgi?path=activemq/activemq-openwire/#{version}/apache-openwire-protocol-#{version}-source-release.tar.gz";) apache-openwire-protocol-#{version}-source-release.tar.gz + td + a(href="http://apache.org/dist/activemq/activemq-openwire/#{version}/apache-openwire-protocol-#{version}-source-release.tar.gz.asc";) GPG Signature + + - if( !project_versions.drop(1).isEmpty ) + div.accordion(style="padding-top:1em;") + a(href="#") Show older versions... + div.hide + - for( version <- project_versions.drop(1) ) + - version + h3.accordion + a(href="#") #{project_name} #{version} + div.hide + :&markdown + [Release Notes](blog/releases/release-#{version}.html) | [Installation Instructions](${website_base_url}/versions/#{version}/website/documentation/getting-started.html) | [Documentation](${website_base_url}/versions/#{version}/website/documentation/index.html) + table.download + tr + td Binaries for Unix/Linux/OS X: + td + a(href="http://archive.apache.org/dist/activemq/activemq-openwire/#{version}/apache-openwire-protocol-#{version}-unix-distro.tar.gz";) apache-openwire-protocol-#{version}-unix-distro.tar.gz + td + a(href="http://archive.apache.org/dist/activemq/activemq-openwire/#{version}/apache-openwire-protocol-#{version}-unix-distro.tar.gz.asc";) GPG Signature + tr + td Binaries for Windows: + td + a(href="http://archive.apache.org/dist/activemq/activemq-openwire/#{version}/apache-openwire-protocol-#{version}-windows-distro.zip";) apache-openwire-protocol-#{version}-windows-distro.zip + td + a(href="http://archive.apache.org/dist/activemq/activemq-openwire/#{version}/apache-openwire-protocol-#{version}-windows-distro.zip.asc";) GPG Signature + tr + td Source Code Distribution: + td + a(href="http://archive.apache.org/dist/activemq/activemq-openwire/#{version}/apache-openwire-protocol-#{version}-source-release.tar.gz";) apache-openwire-protocol-#{version}-source-release.tar.gz + td + a(href="http://archive.apache.org/dist/activemq/activemq-openwire/#{version}/apache-openwire-protocol-#{version}-source-release.tar.gz.asc";) GPG Signature + + +:&markdown + + ## Development Snapshot + + Want to help stablize the latest and greatest nightly development + build? **Warnning**: These builds are extremely bleeding edge! + + These development builds are automatically tested and deployed by a Jenkins CI server: + + * [Checkin Build and Test Results](https://builds.apache.org/job/ActiveMQ-OpenWire/) + * [Nightly SNAPSHOT deployment Results](https://builds.apache.org/job/ActiveMQ-OpenWire-Deploy/) + + ### #{project_name} #{project_snapshot_version} + [Installation Instructions](${website_base_url}/versions/#{project_snapshot_version}/website/documentation/getting-started.html) | [Documentation](${website_base_url}/versions/#{project_snapshot_version}/website/documentation/index.html) + +table.download + tr + td Binaries for Unix/Linux/OS X: + td + a(href="http://repository.apache.org/service/local/artifact/maven/redirect?r=snapshots&g=org.apache.activemq&a=openwire-project&v=#{project_snapshot_version}&e=tar.gz&c=unix-distro";) openwire-project-#{project_snapshot_version}-unix-distro.tar.gz + tr + td Binaries for Windows: + td + a(href="https://repository.apache.org/service/local/artifact/maven/redirect?r=snapshots&g=org.apache.activemq&a=openwire-project&v=#{project_snapshot_version}&e=zip&c=windows-distro";) openwire-project-#{project_snapshot_version}-windows-distro.zip + +:&markdown + The development build source code should be directly checked out from our [source code repository](community/source.html) http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/images/module-deps-graph.png ---------------------------------------------------------------------- diff --git a/openwire-website/src/images/module-deps-graph.png b/openwire-website/src/images/module-deps-graph.png new file mode 100644 index 0000000..53bee30 Binary files /dev/null and b/openwire-website/src/images/module-deps-graph.png differ http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/images/project-logo-vector.png ---------------------------------------------------------------------- diff --git a/openwire-website/src/images/project-logo-vector.png b/openwire-website/src/images/project-logo-vector.png new file mode 100644 index 0000000..d4d78c2 Binary files /dev/null and b/openwire-website/src/images/project-logo-vector.png differ http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/images/project-logo.png ---------------------------------------------------------------------- diff --git a/openwire-website/src/images/project-logo.png b/openwire-website/src/images/project-logo.png new file mode 100644 index 0000000..ea233f3 Binary files /dev/null and b/openwire-website/src/images/project-logo.png differ http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/images/rss.gif ---------------------------------------------------------------------- diff --git a/openwire-website/src/images/rss.gif b/openwire-website/src/images/rss.gif new file mode 100644 index 0000000..2891040 Binary files /dev/null and b/openwire-website/src/images/rss.gif differ http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/index.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/index.page b/openwire-website/src/index.page new file mode 100644 index 0000000..8cf0dd0 --- /dev/null +++ b/openwire-website/src/index.page @@ -0,0 +1,42 @@ +--- +# 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. +title: OpenWire +--- name:overview pipeline:jade + +h1 OpenWire #{project_version} + +| #{project_slogan} + +--- name:content pipeline:markdown + +[ActiveMQ OpenWire](http://activemq.apache.org/openwire/) is a stand-alone +library that provides the implementation of the native wire protocol used by +[ActiveMQ](http://activemq.apache.org) and its various client libraries. + +## Features + +* Small Core module with latest codecs only +* External legacy module with support for all past OpenWire Versions. +* JMS Wrappers around the OpenWire message types +* Tight or loose encoding at the wire level for small or fast marshaling. +* Message body compression. + +## Documentation + +* [Getting Started Guide](documentation/getting-started.html) +* [OpenWire Protocol Manual](documentation/openwire-manual.html) + + http://git-wip-us.apache.org/repos/asf/activemq-openwire/blob/429b1b4a/openwire-website/src/privacy-policy.page ---------------------------------------------------------------------- diff --git a/openwire-website/src/privacy-policy.page b/openwire-website/src/privacy-policy.page new file mode 100644 index 0000000..c8088eb --- /dev/null +++ b/openwire-website/src/privacy-policy.page @@ -0,0 +1,48 @@ +--- +# 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. + +title: Privacy Policy +--- name:overview + +{project_slogan:} + +--- name:content + +Information about your use of this website is collected using server access +logs and a tracking cookie. The collected information consists of the +following: + +* The IP address from which you access the website +* The type of browser and operating system you use to access our site +* The date and time you access our site +* The pages you visit +* The addresses of pages from where you followed a link to our site + +Part of this information is gathered using a tracking cookie set by the +[Google Analytics][] service and handled by Google as described in their +[privacy policy][]. See your browser documentation for instructions on how to +disable the cookie if you prefer not to share this data with Google. + +We use the gathered information to help us make our site more useful to +visitors and to better understand how and when our site is used. We do not +track or collect personally identifiable information or associate gathered +data with any personally identifying information from other sources. + +By using this website, you consent to the collection of this data in the +manner and for the purpose described above. + +[Google Analytics]:http://www.google.com/analytics/ +[privacy policy]:http://www.google.com/privacy.html
