You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by bu...@apache.org on 2013/03/15 10:18:35 UTC
svn commit: r854597 - in /websites/staging/isis/trunk: cgi-bin/ content/
content/components/viewers/wicket/ content/components/viewers/wicket/images/
Author: buildbot
Date: Fri Mar 15 09:18:35 2013
New Revision: 854597
Log:
Staging update by buildbot for isis
Added:
websites/staging/isis/trunk/content/components/viewers/wicket/configuring-the-about-page.html
websites/staging/isis/trunk/content/components/viewers/wicket/images/
websites/staging/isis/trunk/content/components/viewers/wicket/images/about-page.png (with props)
Modified:
websites/staging/isis/trunk/cgi-bin/ (props changed)
websites/staging/isis/trunk/content/ (props changed)
websites/staging/isis/trunk/content/components/viewers/wicket/about.html
websites/staging/isis/trunk/content/documentation.html
Propchange: websites/staging/isis/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Mar 15 09:18:35 2013
@@ -1 +1 @@
-1456720
+1456823
Propchange: websites/staging/isis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Mar 15 09:18:35 2013
@@ -1 +1 @@
-1456720
+1456823
Modified: websites/staging/isis/trunk/content/components/viewers/wicket/about.html
==============================================================================
--- websites/staging/isis/trunk/content/components/viewers/wicket/about.html (original)
+++ websites/staging/isis/trunk/content/components/viewers/wicket/about.html Fri Mar 15 09:18:35 2013
@@ -246,6 +246,7 @@
<ul>
<li><a href="customizing-the-viewer.html">Customizing the viewer</a></li>
<li><a href="abbreviating-titles-in-tables.html">Abbreviating titles in tables</a> (1.2.0-SNAPSHOT)</li>
+<li><a href="configuring-the-about-page.html">Configuring the about page</a> (1.2.0-SNAPSHOT)</li>
</ul>
<h3>Releases</h3>
Added: websites/staging/isis/trunk/content/components/viewers/wicket/configuring-the-about-page.html
==============================================================================
--- websites/staging/isis/trunk/content/components/viewers/wicket/configuring-the-about-page.html (added)
+++ websites/staging/isis/trunk/content/components/viewers/wicket/configuring-the-about-page.html Fri Mar 15 09:18:35 2013
@@ -0,0 +1,383 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+
+ <meta charset="utf-8">
+ <title>Configuring the About page (1.2.0-SNAPSHOT)</title>
+ <meta name="description" content="">
+ <meta name="author" content="">
+
+ <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+ <!--[if lt IE 9]>
+ <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+ <![endif]-->
+
+ <!-- Le styles -->
+ <link href="./../../../bootstrap.css" rel="stylesheet">
+ <link href="./../../../prettify.css" rel="stylesheet">
+ <link href="./../../../bootstrap-mods.css" rel="stylesheet">
+
+ <style type="text/css">
+ body {
+ padding-top: 60px;
+ }
+ .sprite {
+ display: inline-block;
+ height: 20px;
+ margin: 0 auto 4px;
+ outline: medium none;
+ text-indent: -999em;
+ width: 24px;
+ background-image: url('./../../../images/sprites.png');
+ background-repeat: no-repeat;
+ overflow: hidden;
+ cursor: pointer;
+ }
+ .edit-page {
+ display: inline-block;
+ height: 20px;
+ margin: 0 auto 4px;
+ outline: medium none;
+ text-indent: -999em;
+ width: 24px;
+ background-image: url('./../../../images/edit.png');
+ background-repeat: no-repeat;
+ overflow: hidden;
+ cursor: pointer;
+ }
+ .fb-share {
+ background-position: 0px -40px;
+ }
+ .gp-share {
+ background-position: 0px 0px;
+ }
+ .tw-share {
+ background-position: 0px -80px;
+ }
+ .markdown-content {
+ min-height: 500px;
+ }
+ .book-image img {
+ border: 1px;
+ border-style: solid;
+ }
+ .release-matrix .heading {
+ background-color: #eeeeee;
+ }
+ .release-matrix .new {
+ color: #dd0000;
+ font-weight: bolder;
+ }
+ .stub,.note {
+ position: relative;
+ padding: 7px 15px;
+ margin-bottom: 18px;
+ color: #404040;
+ background-color: #eedc94;
+ background-repeat: repeat-x;
+ background-image: -khtml-gradient(linear, left top, left bottom, from(#fceec1), to(#eedc94));
+ background-image: -moz-linear-gradient(top, #fceec1, #eedc94);
+ background-image: -ms-linear-gradient(top, #fceec1, #eedc94);
+ background-image: -webkit-gradient(linear, left top, left bottom, color-stop(0%, #fceec1), color-stop(100%, #eedc94));
+ background-image: -webkit-linear-gradient(top, #fceec1, #eedc94);
+ background-image: -o-linear-gradient(top, #fceec1, #eedc94);
+ background-image: linear-gradient(top, #fceec1, #eedc94);
+ filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#fceec1', endColorstr='#eedc94', GradientType=0);
+ text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25);
+ border-color: #eedc94 #eedc94 #e4c652;
+ border-color: rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25);
+ text-shadow: 0 1px 0 rgba(255, 255, 255, 0.5);
+ border-width: 1px;
+ border-style: solid;
+ -webkit-border-radius: 4px;
+ -moz-border-radius: 4px;
+ border-radius: 4px;
+ -webkit-box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.25);
+ -moz-box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.25);
+ box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.25);
+ }
+ </style>
+ <script type="text/javascript">
+ function fbshare () {
+ window.open(
+ "http://www.facebook.com/sharer/sharer.php?u="+document.URL,
+ 'Share on Facebook',
+ 'width=640,height=426');
+ };
+ function gpshare () {
+ window.open(
+ "https://plus.google.com/share?url="+document.URL,
+ 'Share on Google+',
+ 'width=584,height=385');
+ };
+ function twshare () {
+ window.open(
+ "https://twitter.com/intent/tweet?url="+document.URL+"&text=Configuring the About page (1.2.0-SNAPSHOT)",
+ 'Share on Twitter',
+ 'width=800,height=526');
+ };
+ </script>
+
+ <!-- Le fav and touch icons -->
+ <link rel="shortcut icon" href="./../../../images/favicon.ico">
+ <link rel="apple-touch-icon" href="./../../../images/apple-touch-icon.png">
+ <link rel="apple-touch-icon" sizes="72x72" href="./../../../images/apple-touch-icon-72x72.png">
+ <link rel="apple-touch-icon" sizes="114x114" href="./../../../images/apple-touch-icon-114x114.png">
+
+ <script src="./../../../javascript/prettify.js" type="text/javascript"></script>
+ <script src="./../../../javascript/jquery-latest.js"></script>
+
+
+ <script src="http://platform.twitter.com/widgets.js" type="text/javascript"></script>
+ <script src="./../../../javascript/common.js"></script>
+ <script src="./../../../javascript/prettyprint.js"></script>
+
+ <script src="./../../../javascript/bootstrap-alert.js"></script>
+ <script src="./../../../javascript/bootstrap-dropdown.js"></script>
+ <script src="./../../../javascript/bootstrap-tooltip.js"></script>
+ <script src="./../../../javascript/bootstrap-alerts.js"></script>
+ <script src="./../../../javascript/bootstrap-modal.js"></script>
+ <script src="./../../../javascript/bootstrap-transition.js"></script>
+ <script src="./../../../javascript/bootstrap-button.js"></script>
+ <script src="./../../../javascript/bootstrap-popover.js"></script>
+ <script src="./../../../javascript/bootstrap-twipsy.js"></script>
+ <script src="./../../../javascript/bootstrap-buttons.js"></script>
+ <script src="./../../../javascript/bootstrap-scrollspy.js"></script>
+ <script src="./../../../javascript/bootstrap-typeahead.js"></script>
+ <script src="./../../../javascript/bootstrap-carousel.js"></script>
+ <script src="./../../../javascript/bootstrap-tab.js"></script>
+ <script src="./../../../javascript/bootstrap-collapse.js"></script>
+ <script src="./../../../javascript/bootstrap-tabs.js"></script>
+
+
+
+
+
+ <script>
+ $(function () { prettyPrint() })
+ $().dropdown()
+ </script>
+
+ <!-- GAQ stuff removed here -->
+
+
+ </head>
+
+ <body>
+
+ <div class="topbar">
+ <div class="fill">
+ <div class="container">
+ <a class="brand" href="./../../../index.html">Apache Isis™</a>
+ <ul class="nav">
+ <li><a href="./../../../index.html">Home</a></li>
+ <li><a href="./../../../download.html">Download</a></li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Screenshots<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="./../../../getting-started/screenshots.html">Screenshots</a></li>
+ <li><a href="./../../../getting-started/screencasts.html">Screencasts</a></li>
+ <!--
+ <li><a href="#">Online Demo</a></li>
+ -->
+ </ul>
+ </li>
+ <li><a href="./../../../documentation.html">Docs</a></li>
+ <li><a href="./../../../support.html">Support</a></li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li>
+ <a href="http://www.apache.org/">Apache Homepage <i class="icon-share-alt"></i></a>
+ </li>
+ <li>
+ <a href="http://www.apache.org/licenses/">Licenses <i class="icon-share-alt"></i></a>
+ </li>
+ <li>
+ <a href="http://www.apache.org/security/">Security <i class="icon-share-alt"></i></a>
+ </li>
+ <li>
+ <a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship <i class="icon-share-alt"></i></a>
+ </li>
+ <li>
+ <a href="http://www.apache.org/foundation/thanks.html">Thanks <i class="icon-share-alt"></i></a>
+ </li>
+ </ul>
+ </li>
+
+ </ul>
+
+ <!-- Google CSE Search Box Begins -->
+ <div style="float: right; position: relative; ">
+ <form action="http://www.google.com/cse" id="cse-search-box" _lpchecked="1">
+ <div>
+ <input type="hidden" name="cx" value="001500763902520246267:purt3m54z98">
+ <input type="hidden" name="ie" value="UTF-8">
+ <input type="text" name="q" size="31" style="border: 1px solid rgb(126, 157, 185); padding: 2px; background-color: rgb(255, 255, 255); background-position: 0% 50%; background-repeat: no-repeat no-repeat;">
+ <input type="submit" name="sa" value="Search">
+ </div>
+ <input name="siteurl" type="hidden" value="incubator.apache.org/isis/">
+ <input name="ref" type="hidden" value="">
+ <input name="ss" type="hidden" value="677j458329j2">
+ </form>
+ </div>
+ <!-- Google CSE Search Box Ends -->
+ </div>
+ </div>
+ </div>
+
+ <div class="container">
+ <div class="markdown-content">
+
+
+<div class="page-header">
+<p><a href="./../../../documentation.html">Docs</a> » <a href="./../../../components/about.html">Components</a> » <a href="./../../../components/viewers/about.html">Viewers</a> » <a href="./../../../components/viewers/wicket/about.html">Wicket</a></p>
+<h1>Configuring the About page (1.2.0-SNAPSHOT)
+
+</h1>
+</div>
+
+<p>Isis' Wicket viewer has an About page that, by default, will provide a dump of the JARs that make up the webapp. This page will also show the manifest attributes of the WAR archive itself, if there are any. One of these attributes may also be used as the application version number.</p>
+
+<h3>Screenshot</h3>
+
+<p>Here's what the About page looks like with this configuration added:</p>
+
+<p><img src="images/about-page.png" alt="" /></p>
+
+<p>Note that the <code>Build-Time</code> attribute has been used as the version number. The Wicket viewer is hard-coded to search for specific attributes and use as the application version. In order, it searches for:</p>
+
+<ul>
+<li><code>Implementation-Version</code></li>
+<li><code>Build-Time</code></li>
+</ul>
+
+<p>If none of these are found, then no version is displayed.</p>
+
+<h3>Configuration</h3>
+
+<p><em>Note: the configuration described here will also be part of the quickstart_wicket_restful_jdo archetype (1.0.3+).</em></p>
+
+<h4>Adding attributes to the WAR's manifest</h4>
+
+<p>Add the following to the webapp's <code>pom.xml</code>:</p>
+
+<pre>
+<plugin>
+ <groupId>org.codehaus.mojo</groupId>
+ <artifactId>build-helper-maven-plugin</artifactId>
+ <version>1.5</version>
+ <executions>
+ <execution>
+ <phase>validate</phase>
+ <goals>
+ <goal>maven-version</goal>
+ </goals>
+ </execution>
+ </executions>
+</plugin>
+
+<plugin>
+ <artifactId>maven-war-plugin</artifactId>
+ <configuration>
+ <archive>
+ <manifest>
+ <addDefaultImplementationEntries>true</addDefaultImplementationEntries>
+ </manifest>
+ <manifestEntries>
+ <Build-Time>${maven.build.timestamp}</Build-Time>
+ <Build-Number>${buildNumber}</Build-Number>
+ <Build-Host>${agent.name}</Build-Host>
+ <Build-User>${user.name}</Build-User>
+ <Build-Maven>Maven ${maven.version}</Build-Maven>
+ <Build-Java>${java.version}</Build-Java>
+ <Build-OS>${os.name}</Build-OS>
+ <Build-Label>${project.version}</Build-Label>
+ </manifestEntries>
+ </archive>
+ </configuration>
+ <executions>
+ <execution>
+ <phase>package</phase>
+ <goals>
+ <goal>war</goal>
+ </goals>
+ <configuration>
+ <classifier>${env}</classifier>
+ </configuration>
+ </execution>
+ </executions>
+</plugin>
+</pre>
+
+<p>If you then build the webapp from the Maven command line (<code>mvn clean package</code>), then the WAR should contain a <code>META-INF/MANIFEST.MF</code> with those various attribute entries.</p>
+
+<h4>Exporting the attributes into the app</h4>
+
+<p>The manifest attributes are provided to the rest of the application by way of the Wicket viewer's integration with Google Guice.</p>
+
+<p>In your subclass of <code>IsisWicketApplication</code>, there is a method <code>newIsisWicketModule()</code>. In this method you need to bind an <code>InputStream</code> that will read the manifest attributes. This is all boilerplate so you can just copy-n-paste:</p>
+
+<pre>
+@Override
+protected Module newIsisWicketModule() {
+
+ ...
+
+ final Module quickstartOverrides = new AbstractModule() {
+ @Override
+ protected void configure() {
+ ...
+ bind(InputStream.class)
+ .annotatedWith(Names.named("metaInfManifest"))
+ .toProvider(Providers.of(
+ getServletContext().getResourceAsStream("/META-INF/MANIFEST.MF")));
+ }
+ };
+
+ ...
+</div>
+</pre>
+
+<p>And with that you should be good to go!</p>
+
+
+
+ </div>
+
+ <div id="edit" class="modal hide fade in" style="display: none; ">
+ <div class="modal-header">
+ <a class="close" data-dismiss="modal">x</a>
+
+ <h3>Thank you for contributing to the documention!</h3>
+ </div>
+ <div class="modal-body">
+ <h4>Any help with the documentation is greatly appreciated.</h4>
+ <p>All edits are reviewed before going live, so feel free to do much more than fix typos or links. If you see a page that could benefit from an entire rewrite, we'd be thrilled to review it. Don't be surprised if we like it so much we ask you for help with other pages :)</p>
+ <small>NOTICE: unless indicated otherwise on the pages in question, all editable content available from apache.org is presumed to be licensed under the Apache License (AL) version 2.0 and hence all submissions to apache.org treated as formal Contributions under the license terms.</small>
+ <!--[if gt IE 6]>
+ <h4>Internet Explorer Users</h4>
+ <p>If you are not an Apache committer, click the Yes link and enter a <i>anonymous</i> for the username and leave the password empty</p>
+ <![endif]-->
+
+ </div>
+ <div class="modal-footer">
+ Do you have an Apache ID?
+ <a href="javascript:void(location.href='https://cms.apache.org/redirect?uri='+escape(location.href))" class="btn">Yes</a>
+ <a href="javascript:void(location.href='https://anonymous:@cms.apache.org/redirect?uri='+escape(location.href))" class="btn">No</a>
+ </div>
+ </div>
+ <script src="./../../../javascript/bootstrap-modal.js"></script>
+
+ <footer>
+ <p>
+ Copyright © 2012~2013 The Apache Software Foundation, Licensed under the Apache License, Version 2.0.
+ <br/>
+ Apache Isis, Isis, Apache, the Apache feather logo, and the Apache Isis project logo are trademarks of The Apache Software Foundation.
+ </p>
+ </footer>
+
+ </div> <!-- /container -->
+
+ </body>
+</html>
Added: websites/staging/isis/trunk/content/components/viewers/wicket/images/about-page.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/isis/trunk/content/components/viewers/wicket/images/about-page.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Modified: websites/staging/isis/trunk/content/documentation.html
==============================================================================
--- websites/staging/isis/trunk/content/documentation.html (original)
+++ websites/staging/isis/trunk/content/documentation.html Fri Mar 15 09:18:35 2013
@@ -366,7 +366,8 @@
<ul>
<li><a href="components/viewers/wicket/about.html">About</a></li>
<li><a href="components/viewers/wicket/customizing-the-viewer.html">Customizing the viewer</a></li>
-<li><a href="components/viewers/wicket/abbreviating-titles-in-tables.html">Abbreviating titles in tables</a> (1.2.0-SNAPSHOT)
+<li><a href="components/viewers/wicket/abbreviating-titles-in-tables.html">Abbreviating titles in tables</a> (1.2.0-SNAPSHOT)</li>
+<li><a href="components/viewers/wicket/configuring-the-about-page.html">Configuring the about page</a> (1.2.0-SNAPSHOT)
</div>
<div class="span-one-third"></li>
</ul>