You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2017/03/31 07:10:52 UTC
[16/51] [partial] isis git commit: ISIS-1521: reorganizes asciidoc
documentation, moves into subdirs (both guides and other pages)
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvro_architecture.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvro_architecture.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvro_architecture.adoc
deleted file mode 100644
index 4a91045..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvro_architecture.adoc
+++ /dev/null
@@ -1,56 +0,0 @@
-[[_ugvro_architecture]]
-= Architecture
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-The xref:ugvro.adoc#[RestfulObjects viewer] implements the http://restfulobjects.org[Restful Object spec], meaning
-that it defines a well-defined set of endpoint URLs as resources, and generates a well-defined set of (JSON)
-representations when these resources are accessed.
-
-By default, the Restful Objects viewer will automatically handle requests and return representations according to the
-RO spec. However, its internal architecture provides several hooks for content negotiation, thereby allowing the
-generated representation to be influenced using the standard HTTP `Accept` header. In response, the server uses
-the `Content-Type` header which the client can use to know how to process the returned representation.
-
-
-* `RepresentationService` +
-+
-The xref:rgfis.adoc#_rgfis_spi_RepresentationService[`RepresentationService`] is an SPI domain service (plugin-point)
-that allows an arbitrary representation to be generated for any of the resources defined in the RO spec. +
-+
-Normally this SPI service need not be replaced, because the default implementation
-(`RepresentationServiceContentNegotiator`) simply uses the HTTP `Accept` header and delegates onto another service, the
-(slightly misnamed) `ContentNegotiationService`, to actually generate the representation. There can be multiple
-implementations of the `ContentNegotiationService` and the content negotiator will delegate to each in turn until one
-is able to handle the request (per the chain of responsibliity pattern).
-
-* `ContentNegotiationService` +
-+
-As noted above, there can be multiple implementations of the
-xref:rgfis.adoc#_rgfis_spi_ContentNegotiationService[`ContentNegotiationService`], each one handling a particular
-HTTP `Accept` header. If the implementation does not recognize the value of the header, if can simply return `null`. +
-+
-The framework provides a number of implementations; an implementation that handles the
-xref:ugvro.adoc#_ugvro_simplified-representations[simplified representation] of the Apache Isis profile; an implementation that provides support for the `x-ro-domain-type` parameter, and a
-default/fallback implementation that returns the representations defined by the RO spec.
-
-* `ContentMappingService` +
-+
-The xref:rgsvc.adoc#_rgsvc_spi_ContentMappingService[`ContentMappingService`] is used by the implementation of
-`ContentNegotationService` that recognizes the `x-ro-domain-type`, its role being to transform a domain object
-(usually an entity) into some other form (usually a DTO), as specified by the `x-ro-domain-type` parameter. There
-can be many such implementations, each handling a different target domain type.
-
-
-This diagram shows how these services collaborate:
-
-image::{_imagesdir}reference-services-spi/RepresentationService/service-collaborations.png[width="800px",link="{_imagesdir}reference-services-spi/RepresentationService/service-collaborations.png"]
-
-
-Taken together these domain services offer a lot of flexibility in terms of the representations that can be generated
-from the RestfulObjects viewer.
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvro_configuration-properties.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvro_configuration-properties.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvro_configuration-properties.adoc
deleted file mode 100644
index 7e0d157..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvro_configuration-properties.adoc
+++ /dev/null
@@ -1,177 +0,0 @@
-[[_ugvro_configuration-properties]]
-= Configuration Properties
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-The Restful Objects viewer provides a couple of configuration option that extend/simplify/alter the representations
-generated from the Restful Objects specification.
-
-These configuration properties are typically stored in `WEB-INF/viewer_restfulobjects.properties`. However, you can
-place all configuration properties into `WEB-INF/isis.properties` if you wish (the configuration properties from all
-config files are merged together).
-
-
-[[__ugvro_configuration-properties_standard]]
-== Standard
-
-The following configuration properties are supported:
-
-.Restful Objects Viewer Configuration Properties
-[cols="2a,1,3", options="header"]
-|===
-|Property
-|Value +
-(_default value_)
-|Description
-
-|`isis.viewer.restfulobjects.` +
-`honorUiHints`
-| `true`,`false` (`_false_`)
-|A mechanism for reducing the number of round-trips by eagerly rendering collections; discussed xref:ugvro.adoc#___ugvro_ro-spec_extensions_minimizing-round-trips_honor-ui-hints[here].
-
-|`isis.viewer.restfulobjects.` +
-`strictAcceptChecking`
-| `true`,`false` (`_false_`)
-|Whether to strictly enforce the `Accept` header checking for the default RO-spec representations (by the
-`ContentNegotiationServiceForRestfulObjectsV1_0` service). Will otherwise accept anything. +
-
-This is convenient because it allows the `Accept` header to be set to that of the
-xref:ugvro.adoc#_ugvro_simplified-representations[Apache Isis profile] for all resources, rather than simply the
-handful of resources that supported that profile.
-
-|===
-
-
-[[__ugvro_configuration-properties_deprecated]]
-== Deprecated
-
-There are also a number of configuration properties that can be used to suppress or simplify the default RO-spec
-representations.
-
-These configuration properties pre-date the support, introduced in `1.11.0`, for the Apache Isis profile, and
-are limited by the fact that they are global configuration settings, so cannot be influenced on a request-by-request
-basis (as is the case with the `Accept` header used for the Apache Isis profile). They have therefore been
-deprecated, and may be removed in the future.
-
-Nevertheless, those configuration properties are:
-
-.Deprecated Configuration Properties
-[cols="2a,1,3", options="header"]
-|===
-|Property
-|Value +
-(_default value_)
-|Description
-
-|`isis.viewer.restfulobjects.` +
-`suppressDescribedByLinks`
-| `true`,`false` (`_false_`)
-|Suppresses the "describedby" links (on all representations)
-
-|`isis.viewer.restfulobjects.` +
-`suppressUpdateLink`
-| `true`,`false` (`_false_`)
-|suppresses the "update" link (on object representation)
-
-|`isis.viewer.restfulobjects.` +
-`suppressMemberId`
-| `true`,`false` (`_false_`)
-|suppresses the "id" json-prop for object members (on object representation and member detail representations)
-
-|`isis.viewer.restfulobjects.` +
-`suppressMemberLinks`
-| `true`,`false` (`_false_`)
-|suppresses the "links" json-prop for object members (on the object representation and member detail representations)
-
-|`isis.viewer.restfulobjects.` +
-`suppressMemberExtensions`
-| `true`,`false` (`_false_`)
-|suppresses the "extensions" json-prop for object members (on the object representation and member detail representations)
-
-|`isis.viewer.restfulobjects.` +
-`suppressMemberDisabledReason`
-| `true`,`false` (`_false_`)
-|suppresses the "disabledReason" json-prop for object members (on the object representation and member detail representations)
-
-|`isis.viewer.restfulobjects.` +
-`objectPropertyValuesOnly`
-| `true`,`false` (`_false_`)
-| See xref:ugvro.adoc#__ugvro_simplified-representations_configuration-properties_object-property-values-only[discussion] below.
-|
-
-|===
-
-
-For example, these configuration properties could all be added in the `WEB-INF/viewer_restfulobjects.properties`):
-
-[source,ini]
-----
-isis.viewer.restfulobjects.suppressDescribedByLinks=true
-isis.viewer.restfulobjects.suppressUpdateLink=true
-isis.viewer.restfulobjects.suppressMemberId=true
-isis.viewer.restfulobjects.suppressMemberLinks=true
-isis.viewer.restfulobjects.suppressMemberExtensions=true
-isis.viewer.restfulobjects.suppressMemberDisabledReason=true
-----
-
-
-[NOTE]
-====
-If these configuration settings are set in conjunction with using the
-xref:ugvro.adoc#__ugvro_simplified-representations_apache-isis-profile[Apache Isis profile], then the special `$$ro`
-property in the representations with reflect these settings.
-====
-
-
-
-If the `objectPropertyValuesOnly` configuration property is set:
-
-[source,ini]
-----
-isis.viewer.restfulobjects.objectPropertyValuesOnly=true
-----
-
-then this generates a representation such as:
-
-[source,javascript]
-----
-{
- "title" : "Buy milk due by 2014-10-27",
- "domainType" : "TODO",
- "instanceId" : "0",
- "members" : {
- "description" : "Buy milk",
- "category" : "Domestic",
- "subcategory" : "Shopping",
- "complete" : false,
- "versionSequence" : 1,
- "relativePriority" : 2,
- "dueBy" : "2014-10-27",
- "cost" : "0.75",
- "notes" : null,
- "attachment" : null,
- "doc" : null
- },
- "links" : [
- {
- "rel" : "self",
- "href" : "http://localhost:8080/restful/objects/TODO/0",
- "method" : "GET",
- "type" : "application/json;profile=\"urn:org.restfulobjects:repr-types/object\"",
- "title" : "Buy milk due by 2014-10-27"
- },
- {
- "rel" : "describedby",
- "href" : "http://localhost:8080/restful/domain-types/TODO",
- "method" : "GET",
- "type" : "application/json;profile=\"urn:org.restfulobjects:repr-types/domain-type\""
- }
- ],
- "extensions" : {
- "oid" : "TODO:0"
- },
-}
-----
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvro_hints-and-tips.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvro_hints-and-tips.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvro_hints-and-tips.adoc
deleted file mode 100644
index 4436e52..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvro_hints-and-tips.adoc
+++ /dev/null
@@ -1,96 +0,0 @@
-[[_ugvro_hints-and-tips]]
-= Hints and Tips
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-Since the Restful Objects viewer is designed for computer programs to interact with (rather than human beings), it can be a little difficult to explore and generally "grok" how it works.
-
-This section provides a few hints-and-tips to help you on your way.
-
-
-
-
-== Using Chrome Tools
-
-This link:https://www.youtube.com/watch?v=_-TOvVYWCHc[screencast] shows how to explore the Restful API using Chrome plugins/extensions, and how we use them to write end-2-end (TCK) tests for the Restful Objects viewer.
-
-
-
-
-
-== AngularJS Tips
-
-The hypermedia API exposed by Apache Isis' Restful Objects viewer is intended be support both bespoke custom-written viewers as well as generic viewers. Indeed, we expect most clients consuming the API will be bespoke, not generic.
-
-This page captures one or two tips on using AngularJS to write such a bespoke client.
-
-
-=== Invoking a GET link (eg invoking a query action)
-
-Suppose you have a `CustomerService` providing a `findCustomer` action:
-
-[source,java]
-----
-public class CustomerService {
- public String id() { return "customers"; }
- @Action(semantics=SemanticsOf.SAFE)
- public Customer findCustomer(
- @ParameterLayout(named="customerName")
- final String customerName) {
- ...
- }
-}
-----
-
-Restful Objects will expose this as action with the following link that looks something like:
-
-[source,javascript]
-----
-{
- "rel" : "urn:org.restfulobjects:rels/invoke",
- "href" : "http://localhost:8080/restful/services/customers/actions/findCustomer/invoke",
- "method" : "GET",
- "type" : "application/json;profile=\"urn:org.restfulobjects:repr-types/action-result\"",
- "arguments" : {
- "customerName" : {
- "value" : null
- }
- }
-}
-----
-
-You can then invoke this using AngularJs' `$resource` service as follows.
-
-[source,javascript]
-----
-var findCustomer = $resource("http://localhost:8080/restful/services/customers/actions/findCustomer/invoke?:queryString");
-var findCustomerArgs = {
- "customerName": {
- "value": "Fred"
- }
-};
-findCustomer.get({queryString: JSON.stringify(findCustomerArgs)}, function(data) { ... } )
-----
-
-Here the `:queryString` placeholder in the initial `$resource` constructor is expanded with a stringified version of the JSON object representing the args. Note how the `findCustomerArgs` is the same as the `"arguments"` attribute in the original link (with a value provided instead of `null`).
-
-
-=== Invoking a PUT or POST link
-
-If the method is a PUT or a POST, then no `:queryString` placeholder is required in the URL, and the args are instead part of the body.
-
-Use `$resource.put(...)` or `$resource.post(...)` instead.
-
-
-
-== Pretty printing
-
-The JSON representations generated by the Restful Objects viewer are in compact form if the xref:rgcfg.adoc#_rgcfg_deployment-types[deployment type] is SERVER (ie production), but will automatically be "pretty printed" (in other words indented) if the deployment type is PROTOTYPE.
-
-
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvro_ro-spec.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvro_ro-spec.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvro_ro-spec.adoc
deleted file mode 100644
index 3d3289d..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvro_ro-spec.adoc
+++ /dev/null
@@ -1,200 +0,0 @@
-[[_ugvro_ro-spec]]
-= RO Specification
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-The Restful Objects v1.0 specification defines a comprehensive hypermedia API, consisting of HTTP resources and
-corresponding JSON representations, for accessing and manipulating a domain object model.
-
-The Restful Objects spec can be downloaded from link:http://restfulobjects.org[here] as either a PDF or Word doc.
-
-
-
-[[__ugvro_ro-spec_goals]]
-== Goals of the Spec
-
-The goal of Restful Objects is to allow domain models to be accessed through HTTP resources, returning a set of JSON
-representations. These representations can then be consumed by any client (e.g. Javascript, Java, .NET, Ruby, Python).
-
-Both the resources and representations are generalized so that they can be applied to any domain model, and by default
-all representations have media types designed to allow a completely generic client to be written, capable of working,
-unmodified, with any domain model that has a Restful Objects interface.
-
-Alternatively, the developer may write a custom client that has some shared knowledge of the domain being exposed, and
-render the information in a more specific fashion.
-
-Restful Objects also defines that representations are served up with parameterized media types. This allows clients to
-use content negotiation to ensure that representations do not change in a breaking fashion, enabling server and client
-to evolve independently.
-
-The Restful Objects specification is at a higher-level of abstraction than, say, the JAX-RS specifications for Java
-platform, or the WCF specifications on .NET. Specifically, the domain classes that it exposes are represented in a very
-general form. They consist of:
-
-* properties (fields), each holding either a scalar value or reference to another object;
-* collections, each holding a vector reference to other entities;
-* actions (operations/methods), whereby the object can execute business logic.
-
-Beyond this, though, Restful Objects makes very few assumptions. In particular, Restful Objects does not prescribe the
-nature of the domain model.
-
-The Restful Objects spec may be downloaded directly from github as either a PDF or as a Word doc.
-
-
-== Resources and Representations
-
-The diagram below - taken from the Restful Objects spec - shows the various resources (URLs) and representations (JSON)
-that are defined:
-
-image::{_imagesdir}restfulobjects/ro-spec-resources-and-representations.png[width="800px",link="{_imagesdir}restfulobjects/ro-spec-resources-and-representations.png"]
-
-The resource URLs are always well-defined, but Apache Isis' implementation allows for different representations to
-be returned, using content negotiation. This is discussed further below.
-
-[NOTE]
-====
-In fact, there's nothing in Apache Isis to prevent you from defining your own REST controllers to provide custom
-resource URLs. One use case might be to support user registration/authentication, a topic out-of-scope of the RO spec
-itself.
-====
-
-
-[[__ugvro_ro-spec_apache-isis-implementation]]
-== Apache Isis' implementation
-
-The Restful Objects viewer is Apache Isis' implementation of the Restful Objects spec. It implements all the mandatory
-features of the specification. It also implements some of the optional capabilities (as defined in section 3 of the
-RO spec, and as represented in the version resource, section 8.1):
-
-[cols="1a,1a,1a", options="header"]
-|===
-
-| Capability
-| Support
-| Notes
-
-
-| blobsClobs
-| yes
-|
-
-| deleteObjects
-| yes
-|
-
-| domainModel
-| formal
-| The 'simple' scheme is _not_ supported
-
-| validateOnly
-| yes
-|
-
-
-|protoPersistentObjects
-|yes
-|
-
-|===
-
-
-
-
-[[__ugvro_ro-spec_extensions]]
-== Extensions
-
-The Restful Objects viewer also implements some of the "future ideas" that are out of scope for the RO spec v1.0, but
-described in section 34, "ideas for future extensions".
-
-
-
-[[___ugvro_ro-spec_extensions_content-negotiation]]
-=== Content Negotiation (34.1)
-
-Apache Isis provides two levels of support for content negotiation.
-
-[[___ugvro_ro-spec_extensions_content-negotiation_x-ro-domain-type]]
-==== `x-ro-domain-type`
-
-The first level is very similar to the "Domain Model Agnostic" approach sketched out in the RO spec. The client
-can send an `x-ro-domain-type` parameter for either domain object representations (section 14 of the spec) or
-action invocation results (section 19 of the spec). This can be combined with either `application/json` or
-`application/xml`.
-
-For example, the client could use an `Accept` header such as:
-
-[source]
-----
-Accept: application/xml;x-ro-domain-type="com.mycompany.viewmodels.v2.CustomerViewModel"
-----
-
-The server will use the xref:rgsvc.adoc#_rgsvc_spi_ContentMappingService[`ContentMappingService`] to attempt to
-transform the domain object into the requested `x-ro-domain-type`. The whole process is discussed in more detail in
-the xref:ugvro.adoc#_ugvro_architecture[architecture] chapter.
-
-
-[[___ugvro_ro-spec_extensions_content-negotiation_apache-isis-profile]]
-==== Apache Isis profile
-
-The representations defined by the RO spec are very rich and enable complex client-side applications to be built.
-However, their sophistication can be an impediment to their use if one wishes to write a simple app using third-party
-components that expect to consume much simpler representations. Examples of such tools are
-link:http://angular-ui.github.io/bootstrap/[Angular Bootstrap],
-link:http://vitalets.github.io/angular-xeditable/[Angular XEditable],
-link:https://github.com/mgcrea/angular-strap[Angular Strap].
-
-This support is discussed further in the xref:ugvro.adoc#_ugvro_simplified-representations[simplified representations]
-chapter.
-
-
-[[___ugvro_ro-spec_extensions_minimizing-round-trips]]
-=== Minimizing Round-trips (34.4)
-
-The Restful Objects viewer supports the `x-ro-follow-links` query parameter in a way very similar to that suggested
-in the RO spec, the main point being to avoid the "N+1" problem of too many (slow) network calls. For example, using
-this feature one can load a grid of data in a single call. (That said, the xref:ugvro.adoc#_ugvro_simplified-representations[simplified representations]
-supported by Restful Objects viewer also support this use case, albeit in way that deviates from the RO spec).
-
-This link:https://www.youtube.com/watch?v=hSKnqqBQ7Zo[screencast] demonstrates the Restful Object viewer's support for `x-ro-follow-links` parameter, using the
-(non-ASF) http://github.com/isisaddons/isis-app-kitchensink[Isis addons' kitchensink] app as the example,
-This app contains three entities, `Grandparent`, `Parent` and `Child` that define a hierarchy of 1:m relationships.
-
-
-The queries that are shown in the screencast include:
-
-* show parent and its children (titles) +
-+
-pass:[<pre>http://localhost:8080/restful/objects/PARENT/0?x-ro-follow-links=members[children\].value]
-
-* show parent and its children (full details) +
-+
-pass:[<pre>http://localhost:8080/restful/objects/PARENT/0?x-ro-follow-links=members[children\].value.href]
-
-* child's parent (title) +
-+
-pass:[<pre>http://localhost:8080/restful/objects/CHILD/0?x-ro-follow-links=members[parent\].value]
-
-* child's siblings (up to its parent, down to children) +
-+
-pass:[<pre>http://localhost:8080/restful/objects/CHILD/0?x-ro-follow-links=members[parent\].value.members[children\].value]
-
-
-
-[[___ugvro_ro-spec_extensions_minimizing-round-trips_honor-ui-hints]]
-==== Honor UI hints
-
-By default the representations generated by Restful Objects ignore any Apache Isis metamodel hints referring to the UI.
-In particular, if a collection is annotated then `Render(EAGERLY)` then the contents of the collection are _not_
-eagerly embedded in the object representation.
-
-However, this behaviour can be overridden globally using following property (typically added to `WEB-INF/viewer_restfulobjects.properties`):
-
-[source,ini]
-----
-isis.viewer.restfulobjects.honorUiHints=true
-----
-
-This means that standard Apache Isis annotations can be used as a simple way to obtain follow-links (driven from the
-server model, though, rather than the requesting client).
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc
deleted file mode 100644
index 6eb39c4..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc
+++ /dev/null
@@ -1,376 +0,0 @@
-[[_ugvro_simplified-representations]]
-= Simplified Representations
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-The representations defined by the RO spec are very rich and enable complex client-side applications to be built.
-However, their sophistication can be an impediment to their use if one wishes to write a simple app using third-party
-components that expect to consume much simpler representations. Examples of such tools are
-link:http://angular-ui.github.io/bootstrap/[Angular Bootstrap],
-link:http://vitalets.github.io/angular-xeditable/[Angular XEditable],
-link:https://github.com/mgcrea/angular-strap[Angular Strap].
-
-
-As of `1.11.0`, Apache Isis provides support for its own simplified representation for the most commonly-used
-representations. This is implemented using the `ContentNegotiationService` described in the
-xref:ugvro.adoc#_ugvro_architecture[architecture] chapter.
-
-
-
-[[__ugvro_simplified-representations_apache-isis-profile]]
-== The Apache Isis "Profile"
-
-The RO spec uses the standard `Accept` header for content negotiation, and defines its own "profile" for the standard
-representations; these take the form:
-
-[source]
-----
-Accept: application/json;profile="urn:org.restfulobjects:repr-types/xxx"
-----
-
-where "xxx" varies by resource. The detail can be found in section 2.4.1 of the RO spec.
-
-The Apache Isis viewer also defines its own "Isis" profile which enables the client to request simplified
-representations for the most frequently accessed resources. This is done by specifying an `Accept` header of:
-
-[source]
-----
-Accept: application/json;profile="urn:org.apache.isis/v1"
-----
-
-Not every resource supports this header, but the most commonly accessed ones do. In each case the server will set the
-`Content-Type` header so that the client knows how to process the representation.
-
-The link:https://www.youtube.com/watch?v=HMSqapQDY_4[screencast] demonstrates the feature.
-
-
-
-The sections below explain in a little more detail what is returned when this profile is activated.
-
-
-[[__ugvro_simplified-representations_domain-object]]
-== Domain Object
-
-If a domain object resource (section 14) is accessed with the Apache Isis profile, the resultant representation is a
-JSON object with simple key/value pairs for each property.
-
-The contents of any collections are also eagerly returned, consisting of an array of elements of each referenced
-object. Each such element contains key/value pairs of each property (in other words, a grid of data is returned).
-Each element also has a special `$$href` property (so that the client can easily navigate to a resource for that
-object) and a `$$title` property (to use as a label, eg the hyperlink text).
-
-In addition, the representation defined by the RO spec is also included, under a special `$$ro` property.
-
-For example, using the (non-ASF) http://github.com/isisaddons/isis-app-todoapp[Isis addons' todoapp], accessing
-this resource:
-
-[source]
-----
-http://localhost:8080/restful/objects/TODO/45
-----
-
-with an `Accept` request header of:
-
-[source]
-----
-Accept: application/json;profile="urn:org.apache.isis/v1"
-----
-
-returns the following representation:
-
-[source]
-----
-{
- "$$href" : "http://localhost:8080/restful/objects/TODO/45", // <1>
- "$$instanceId" : "45", // <2>
- "$$title" : "Buy bread due by 2015-12-04", // <3>
- "description" : "Buy bread", // <4>
- "category" : "Domestic",
- "subcategory" : "Shopping",
- "complete" : false,
- "atPath" : "/users/sven",
- ...
- "similarTo" : [ { // <5>
- "$$href" : "http://localhost:8080/restful/objects/TODO/46",
- "$$instanceId" : "46",
- "$$title" : "Buy milk due by 2015-12-04",
- "description" : "Buy milk",
- "category" : "Domestic",
- ...
- }, {
- "$$href" : "http://localhost:8080/restful/objects/TODO/47",
- "$$instanceId" : "47",
- "$$title" : "Buy stamps due by 2015-12-04",
- "description" : "Buy stamps",
- "category" : "Domestic",
- ...
- },
- ...
- } ],
- "dependencies" : [ ],
- "$$ro" : { // <6>
- "links" : [ ... ],
- "extensions" : { ... },
- "title" : "Buy bread due by 2015-12-04",
- "domainType" : "TODO",
- "instanceId" : "45",
- "members" : { ... }
- }
-}
-----
-<1> hyperlink to the representation
-<2> instance id of the domain object (unique within its type)
-<3> title of the domain object
-<4> all the properties of the domain object (to which the caller has access), as key/value pairs
-<5> contents of each collection
-<6> special `$$ro` json-prop, being the normal RO Spec representation for this object
-
-with a `Content-Type` header:
-
-[source]
-----
-Content-Type: application/json;
- profile="urn:org.apache.isis/v1";repr-type="object"
-----
-
-
-[[__ugvro_simplified-representations_object-collection]]
-== Domain Object Collection
-
-If a domain object collection (section 17) is accessed with this profile, then the resultant representation is as
-an array of elements of key/value for each referenced object, and again each element the containing the key/value
-pairs of the properties of that object (a grid, again). +
-
-In addition, the representation defined by the RO spec is also included, as a special object with a single `$$ro`
-property.
-
-For example, using the (non-ASF) http://github.com/isisaddons/isis-app-todoapp[Isis addons' todoapp], accessing
-this resource:
-
-[source]
-----
-http://localhost:8080/restful/objects/TODO/45/collections/similarTo
-----
-
-with an `Accept` request header of:
-
-[source]
-----
-Accept: application/json;profile="urn:org.apache.isis/v1"
-----
-
-returns the following representation:
-
-[source]
-----
-[ // <1>
-{
- "$$href" : "http://localhost:8080/restful/objects/TODO/46", // <2>
- "$$instanceId" : "46", // <3>
- "$$title" : "Buy milk due by 2015-12-04", // <4>
- "description" : "Buy milk", // <5>
- "category" : "Domestic",
- ...
-}, {
- "$$href" : "http://localhost:8080/restful/objects/TODO/47",
- "$$title" : "Buy stamps due by 2015-12-04",
- "description" : "Buy stamps",
- "category" : "Domestic",
- ...
-}, {
- "$$href" : "http://localhost:8080/restful/objects/TODO/48",
- "$$title" : "Mow lawn due by 2015-12-10",
- "description" : "Mow lawn",
- "category" : "Domestic",
- ...
-},
-...
-, {
- "$$ro" : { // <6>
- "id" : "similarTo",
- "memberType" : "collection",
- "links" : [ ... ],
- "extensions" : { ... },
- "value" : [ ... ]
- }
-}
-]
-----
-<1> returns a JSON array, not a JSON object
-<2> hyperlink to the representation
-<3> instance id of the domain object (unique within its type)
-<4> title of the domain object
-<5> all the properties of the domain object (to which the caller has access), as key/value pairs
-<6> last element is a special object with a single `$$ro` json-prop, being the normal RO Spec representation for this object
-
-with a `Content-Type` header:
-
-[source]
-----
-Content-Type: application/json;profile="urn:org.apache.isis/v1";repr-type="object-collection"
-----
-
-
-[[__ugvro_simplified-representations_action-invocation]]
-== Action Invocation
-
-When an action is invoked, it can return a domain object, a list, a scalar, or return nothing.
-
-=== Returning an Object
-
-If the action returned an object, then the domain object representation described
-xref:ugvro.adoc#__ugvro_simplified-representations_domain-object[above] is returned.
-
-For example, using the (non-ASF) http://github.com/isisaddons/isis-app-todoapp[Isis addons' todoapp], accessing
-this resource:
-
-[source]
-----
-http://localhost:8080/restful/objects/TODO/45/actions/updateCost/invoke
-----
-
-with an `Accept` request header of:
-
-[source]
-----
-Accept: application/json;profile="urn:org.apache.isis/v1"
-----
-
-returns the following representation:
-
-[source]
-----
-
-{
- "$$href" : "http://localhost:8080/restful/objects/TODO/45",
- "$$instanceId" : "45",
- "$$title" : "Buy bread due by 2015-12-04",
- "description" : "Buy bread",
- "category" : "Domestic",
- "subcategory" : "Shopping",
- "complete" : false,
- ...
- "similarTo" : [ ... ]
- ...
- "$$ro" : { ... }
-}
-----
-
-with a `Content-Type` of:
-
-[source]
-----
-Content-Type: application/json;profile="urn:org.apache.isis/v1";repr-type="object"
-----
-
-\... in other words no different to a representation obtained of the returned domain object directly.
-
-
-=== Returning a List
-
-On the other hand if the action returned a list (a "standalone" collection, then an array representation is returned.
-This is very similar to that returned by a
-xref:ugvro.adoc#__ugvro_simplified-representations_object-collection[(parented) object collection], though with a
-slightly different `Content-Type` to distinguish.
-
-For example, using the (non-ASF) http://github.com/isisaddons/isis-app-todoapp[Isis addons' todoapp], accessing
-this resource:
-
-[source]
-----
-http://localhost:8080/restful/services/ToDoItems/actions/notYetComplete/invoke
-----
-
-with an `Accept` request header of:
-
-[source]
-----
-Accept: application/json;profile="urn:org.apache.isis/v1"
-----
-
-returns the following representation:
-
-[source]
-----
-[ {
- "$$href" : "http://localhost:8080/restful/objects/TODO/45",
- "$$instanceId" : "45",
- "$$title" : "Buy bread due by 2015-12-04",
- "description" : "Buy bread",
- "category" : "Domestic",
- ...
-}, {
- "$$href" : "http://localhost:8080/restful/objects/TODO/46",
- "$$instanceId" : "46",
- "$$title" : "Buy milk due by 2015-12-04",
- "description" : "Buy milk",
- "category" : "Domestic",
- ...
-},
-...
-, {
- "$$ro" : {
- "links" : [ ... ]
- "resulttype" : "list",
- "result" : { ... }
- "value" : [ ... ],
- "links" : [ ... ],
- "extensions" : { }
- }
- }
-} ]
-----
-
-with a `Content-Type` header:
-
-[source]
-----
-Content-Type: application/json;profile="urn:org.apache.isis/v1";repr-type="list"
-----
-
-=== Returning Scalar/Nothing
-
-Note that actions returning scalar values or nothing (which includes `void` actions) are not supported; for these the
-regular RO spec representation will be returned.
-
-
-[[__ugvro_simplified-representations_other-representations]]
-== Supporting other Representations
-
-Sometimes though you may want to extend or change the representations generated. This might be because you want to
-write a RESTful client that uses a particular library (say a Javascript library or web components) that can only handle representations in a certain form.
-
-Or, you might want to have Apache Isis generate representations according to some other "standard", of which there are
-many:
-
-* Mike Kelly's http://stateless.co/hal_specification.html[HAL] specification
-* Mike Amundsen's http://amundsen.com/media-types/collection/[Collection+JSON] specification
-* Kevin Swiber's https://github.com/kevinswiber/siren[Siren] specification
-* Steve Klabnik's http://jsonapi.org/[JSON API] specification
-* Gregg Cainus' https://github.com/cainus/hyper-json-spec[Hyper+JSON] specification
-* the W3C's https://www.w3.org/TR/json-ld/[JSON-LD] specification
-* Markus Lanthaler's http://www.markus-lanthaler.com/hydra/[Hydra] specification.
-
-A good discussion about the relative merits of several of these different hypermedia formats can be found https://groups.google.com/forum/#!msg/api-craft/NgjzQYVOE4s/EAB2jxtU_TMJ[here].
-
-Or, of course, you may have your own internal specification that you wish to use.
-
-Supporting any of these alternative representations can be achieved by providing a suitable implementation of
-`ContentNegotiationService`. The existing implementations (eg `ContentNegotiationServiceSimplified`) can be used as a
-starting point.
-
-[NOTE]
-====
-These will, admittedly, need to access the internal APIs for the Apache Isis metamodel, and you should be aware that
-these are not formal API; they may change over time. That said, they are very stable and have not changed
-significantly over the last few years.
-====
-
-
-
-include::__ugvro_simplified-representations_configuration-properties.adoc[leveloffset=+1]
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations_configuration-properties.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations_configuration-properties.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations_configuration-properties.adoc
deleted file mode 100644
index 55a003b..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations_configuration-properties.adoc
+++ /dev/null
@@ -1,18 +0,0 @@
-[[__ugvro_simplified-representations_configuration-properties]]
-= Global Config Props (Deprecated)
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-If all that is required is a very simple representations (of objects), you can configure the Restful Objects viewer
-to provide a simplified output, then this can be done with a number of (global) configuration properties.
-
-These configuration properties pre-date the support, introduced in `1.11.0`, for the Apache Isis profile, and
-are limited by the fact that they are global configuration settings, so cannot be influenced on a request-by-request
-basis (as is the case with the `Accept` header used for the Apache Isis profile). They have therefore been
-deprecated, and may be removed in the future.
-
-Details can be found in xref:ugvro.adoc#__ugvro_configuration-properties_deprecated[here].
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties.adoc
deleted file mode 100644
index b3f1331..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties.adoc
+++ /dev/null
@@ -1,254 +0,0 @@
-[[_ugvw_configuration-properties]]
-= Configuration Properties
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-Wicket configuration properties alter the way in which Apache Isis' Wicket viewer renders domain objects. They are typically stored in `WEB-INF/viewer_wicket.properties`.
-
-[NOTE]
-====
-To tell Apache Isis that the Wicket viewer is in use (and should therefore search for the `viewer_wicket.properties` file), add the following to `WEB-INF/web.xml`:
-
-[source, xml]
-----
-<context-param>
- <param-name>isis.viewers</param-name>
- <param-value>wicket</param-value>
-</context-param>
-----
-
-====
-
-If you prefer you can place all configuration properties into `WEB-INF/isis.properties` (the configuration properties from all config files are merged together).
-
-
-.Wicket Viewer Configuration Properties
-[cols="2a,1,3", options="header"]
-|===
-|Property
-|Value +
-(_default value_)
-|Description
-
-|`isis.viewer.wicket.` +
-`ajaxDebugMode`
-| `true`,`false` +
-(`_false_`)
-| whether the Wicket debug mode should be enabled.
-
-|`isis.viewer.wicket.` +
-`bookmarkedPages`
-| +ve int +
-(`_15_`)
-| number of pages to bookmark
-
-|`isis.viewer.wicket.` +
-`breadcrumbs.showChooser`
-| `true`,`false` +
-(`_true_`)
-| Whether to show chooser for Breadcrumbs
-
-|`isis.viewer.wicket.` +
-`datePattern`
-| date format +
-(`dd-MM-yyyy`)
-|The `SimpleDateFormat` used to render dates. For the date picker (which uses `moment.js` library), this is converted
-dynamically into the corresponding `moment.js` format.
-
-|`isis.viewer.wicket.` +
-`dateTimePattern`
-| date/time format +
-(`dd-MM-yyyy HH:mm`)
-|The `SimpleDateFormat` used to render date/times. For the date picker (which uses `moment.js` library), this is
-converted dynamically into the corresponding `moment.js` format.
-
-|`isis.viewer.wicket.` +
-`datePicker.maxDate`
-| ISO format date +
-(`2100-01-01T00:00:00.000Z`)
-|Specifies a maximum date after which dates may not be specified.
-
-See link:http://eonasdan.github.io/bootstrap-datetimepicker/Options/#maxdate[datetimepicker reference docs] for
-further details. The string must be in ISO date format (see link:https://github.com/moment/moment/issues/1407[here]
-for further details).
-
-|`isis.viewer.wicket.` +
-`datePicker.minDate`
-| ISO format date +
-(`1900-01-01T00:00:00.000Z`)
-|Specifies a minimum date before which dates may not be specified.
-
-See link:http://eonasdan.github.io/bootstrap-datetimepicker/Options/#mindate[datetimepicker reference docs] for
-further details. The string must be in ISO date format (see link:https://github.com/moment/moment/issues/1407[here]
-for further details).
-
-|`isis.viewer.wicket.` +
-`disableDependentChoiceAutoSelection`
-| `true`,`false` +
-(`_false_`)
-| For dependent choices, whether to automatically select the first dependent (eg subcategory) when the parameter on which it depends (category) changes.
-
-|`isis.viewer.wicket.` +
-`disableModalDialogs`
-| `true`,`false` +
-(`_false_`)
-|No longer supported.
-
-|`isis.viewer.wicket.` +
-`liveReloadUrl`
-| URL
-|Specifies the URL if xref:dg.adoc#__dg_ide_intellij_advanced_gradle-liveReload[live reload] is set up, eg: +
-
-`http://localhost:35729/livereload.js?snipver=1`
-
-
-|`isis.viewer.wicket.` +
-`maxTitleLengthInParentedTables`
-| +ve integer +
-(`_12_`)
-| See discussion xref:ugvw.adoc#_ugvw_configuration-properties_abbreviating-titles[below].
-
-|`isis.viewer.wicket.` +
-`maxTitleLengthInStandaloneTables`
-| +ve integer, +
-(`_12_`)
-| See discussion xref:ugvw.adoc#_ugvw_configuration-properties_abbreviating-titles[below].
-
-|`isis.viewer.wicket.` +
-`maxTitleLengthInTables`
-| +ve integer, +
-(`_12_`)
-| See discussion xref:ugvw.adoc#_ugvw_configuration-properties_abbreviating-titles[below].
-
-|`isis.viewer.wicket.` +
-`preventDoubleClickForFormSubmit`
-| `true`,`false` +
-(`_true_`)
-| Whether to disable a form submit button after it has been clicked, to prevent users causing an error if they do a double click.
-
-|`isis.viewer.wicket.` +
-`preventDoubleClickForNoArgAction`
-| `true`,`false` +
-(`_true_`)
-| Whether to disable a no-arg action button after it has been clicked, to prevent users causing an error if they do a double click.
-
-|`isis.viewer.wicket.` +
-`regularCase`
-| `true`,`false` +
-(`_false_`)
-| Ignored for 1.8.0+; in earlier versions forced regular case rather than title case in the UI
-
-|`isis.viewer.wicket.` +
-`replaceDisabledTagWithReadonlyTag`
-| `true`,`false` +
-(`_true_`)
-| Whether to replace 'disabled' tag with 'readonly' (for link:https://www.w3.org/TR/2014/REC-html5-20141028/forms.html#the-readonly-attribute[w3 spec]-compliant browsers such as for Firefox and Chrome 54+) which prevent copy from 'disabled' fields.
-
-|`isis.viewer.wicket.` +
-`rememberMe.cookieKey`
-| ascii chars +
-(`_isisWicketRememberMe_`)
-|Cookie key holding the (encrypted) 'rememberMe' user/password. There is generally no need to
-change this. +
-
-Valid values as per link:http://stackoverflow.com/a/1969339/56880[this StackOverflow answer].
-
-|`isis.viewer.wicket.` +
-`rememberMe.encryptionKey`
-| any string +
-(in prod, a random UUID each time)
-|Encryption key is used to encrypt the rememberMe user/password. +
-
-Apache Isis leverages link:http://wicket.apache.org[Apache Wicket]'s rememberMe support which holds remembered
-user/passwords in an encrypted cookie.
-
-If a hard-coded and publicly known value were to be used (as was the case prior to `1.13.0`), then it would be possible for rememberMe user/password to be intercepted and decrypted, possibly compromising access.
-This configuration property therefore allows a private key to be specified, baked into the application.
-
-If no value is set then, in production, a random UUID will be used as the encryption key.
-The net effect of this fallback behaviour is that 'rememberMe' will work, but only until the webapp is restarted (after which the end-user will have to log in again.
-In prototype mode, though, a fixed key will still be used; this saves the developer having to login each time.
-
-|`isis.viewer.wicket.` +
-`rememberMe.suppress`
-| `true`,`false` +
-(`_false_`)
-|Whether to suppress "remember me" checkbox on the login page.
-
-
-|`isis.viewer.wicket.` +
-`stripWicketTags`
-| `true`,`false` +
-(`_true_`)
-| Whether to force Wicket tags to be stripped in prototype/development mode. See discussion xref:ugvw.adoc#_ugvw_configuration-properties_stripped-wicket-tags[below].
-
-|`isis.viewer.wicket.` +
-`suppressPasswordReset`
-| `true`,`false` +
-(`_false_`)
-|If user registration is enabled, whether to suppress the "password reset" link on the login page. See discussion xref:ugvw.adoc#_ugvw_configuration-properties_suppressing-password-reset[below].
-
-|`isis.viewer.wicket.` +
-`suppressRememberMe`
-| `true`,`false` +
-(`_false_`)
-|(Deprecated in `1.13.0`, replaced by `rememberMe.suppress`). Whether to suppress "remember me" checkbox on the login page.
-
-|`isis.viewer.wicket.` +
-`suppressSignUp`
-| `true`,`false` +
-(`_false_`)
-|If user registration is enabled, whether to suppress the "sign up" link on the login page. See discussion xref:ugvw.adoc#_ugvw_configuration-properties_suppressing-sign-up[below].
-
-|`isis.viewer.wicket.` +
-`timestampPattern`
-| date/time format +
-(`yyyy-MM-dd HH:mm:ss.SSS`)
-|The `SimpleDateFormat` used to render timestamps.
-
-
-|`isis.viewer.wicket.` +
-`themes.enabled`
-| comma separated list ...
-| ... of bootswatch themes. Only applies if `themes.showChooser`==`true`. See discussion xref:ugvw.adoc#_ugvw_configuration-properties_showing-theme-chooser[below].
-
-|`isis.viewer.wicket.` +
-`themes.showChooser`
-| `true`,`false` +
-(`_false_`)
-| Whether to show chooser for Bootstrap themes. See discussion xref:ugvw.adoc#_ugvw_configuration-properties_showing-theme-chooser[below]
-
-|`isis.viewer.wicket.` +
-`useIndicatorForFormSubmit`
-| `true`,`false` +
-(`_true_`)
-| Whether to show an indicator for a form submit button that it has been clicked.
-
-|`isis.viewer.wicket.` +
-`useIndicatorForNoArgAction`
-| `true`,`false` +
-(`_true_`)
-| Whether to show an indicator for a no-arg action button that it has been clicked.
-
-|`isis.viewer.wicket.` +
-`wicketSourcePlugin`
-| `true`,`false` +
-(`_false_`)
-| Whether the WicketSource plugin should be enabled; by default it is not enabled.
-
-Prior to `1.12.0` this was enabled by default for prototyping (not production).
-However it can significantly slow down rendering, hence the introduction of this configuration setting.
-
-|===
-
-
-
-include::_ugvw_configuration-properties_abbreviating-titles.adoc[leveloffset=+1]
-include::_ugvw_configuration-properties_suppressing-remember-me.adoc[leveloffset=+1]
-include::_ugvw_configuration-properties_suppressing-sign-up.adoc[leveloffset=+1]
-include::_ugvw_configuration-properties_suppressing-password-reset.adoc[leveloffset=+1]
-include::_ugvw_configuration-properties_stripped-wicket-tags.adoc[leveloffset=+1]
-include::_ugvw_configuration-properties_showing-theme-chooser.adoc[leveloffset=+1]
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_abbreviating-titles.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_abbreviating-titles.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_abbreviating-titles.adoc
deleted file mode 100644
index d5108d7..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_abbreviating-titles.adoc
+++ /dev/null
@@ -1,33 +0,0 @@
-[[_ugvw_configuration-properties_abbreviating-titles]]
-= Abbreviating/suppressing titles in tables
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-Objects whose title is overly long can be cumbersome in titles. The Wicket viewer has a xref:ugvw.adoc#_ugvw_features_titles-in-tables[mechanism to automatically shorten] the titles of objects specified using `@Title`. As an alternative/in addition, the viewer can also be configured to simply truncate titles longer than a certain length.
-
-The properties themselves are:
-
-[source,ini]
-----
-isis.viewer.wicket.maxTitleLengthInStandaloneTables=20
-isis.viewer.wicket.maxTitleLengthInParentedTables=8
-----
-
-If you wish to use the same value in both cases, you can also specify just:
-
-[source,ini]
-----
-isis.viewer.wicket.maxTitleLengthInTables=15
-----
-
-This is used as a fallback if the more specific properties are not provided.
-
-If no properties are provided, then the Wicket viewer defaults to abbreviating titles to a length of `12`.
-
-
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_showing-theme-chooser.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_showing-theme-chooser.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_showing-theme-chooser.adoc
deleted file mode 100644
index b110af8..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_showing-theme-chooser.adoc
+++ /dev/null
@@ -1,43 +0,0 @@
-[[_ugvw_configuration-properties_showing-theme-chooser]]
-= Showing a theme chooser
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-The Wicket viewer uses http://getbootstrap.com/[Bootstrap] styles and components (courtesy of the https://github.com/l0rdn1kk0n/wicket-bootstrap[Wicket Bootstrap] integration).
-
-Unless a xref:ugvw.adoc#_ugvw_customisation_default-theme[default theme has been specified], the viewer uses the default bootstrap theme. However,
-the viewer can also be configured to allow the end-user to switch theme to another theme, in particular one of those provided by http://bootswatch.com[bootswatch.com].
-
-This is done using the following configuration property (in `WEB-INF/viewer_wicket.properties`):
-
-[source,ini]
-----
-isis.viewer.wicket.themes.showChooser=true
-----
-
-.Example 1
-image::{_imagesdir}wicket-viewer/theme-chooser/example-1.png[width="720px",link="{_imagesdir}wicket-viewer/theme-chooser/example-1.png"]
-
-
-.Example 2:
-image::{_imagesdir}wicket-viewer/theme-chooser/example-2.png[width="720px",link="{_imagesdir}wicket-viewer/theme-chooser/example-2.png"]
-
-It is also possible to restrict the themes shown to some subset of those in bootswatch. This is done using a further
-property:
-
-[source,ini]
-----
-isis.viewer.wicket.themes.enabled=bootstrap-theme,Cosmo,Flatly,Darkly,Sandstone,United
-----
-
-where the value is the list of themes (from http://bootswatch.com[bootswatch.com]) to be made available.
-
-[TIP]
-====
-You can also develop and install a custom themes (eg to fit your company's look-n-feel/interface guidelines); see the xref:ugvw.adoc#_ugvw_extending_custom-bootstrap-theme[Extending] chapter for further details.
-====
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_stripped-wicket-tags.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_stripped-wicket-tags.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_stripped-wicket-tags.adoc
deleted file mode 100644
index d8211e3..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_stripped-wicket-tags.adoc
+++ /dev/null
@@ -1,26 +0,0 @@
-[[_ugvw_configuration-properties_stripped-wicket-tags]]
-= Stripped Wicket tags
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-By default the Apache Isis Wicket viewer will always strip wicket tags. However, when running in prototype mode, this behaviour can be overridden using a configuration property:
-
-[source,ini]
-----
-isis.viewer.wicket.stripWicketTags=false
-----
-
-[NOTE]
-====
-In 1.7.0 and earlier, the behaviour is different; the Apache Isis Wicket viewer will preserve wicket tags when running in Apache Isis' prototype/development mode, but will still strip wicket tags in Apache Isis' server/deployment mode.
-
-We changed the behaviour in 1.8.0 because we found that Internet Explorer can be sensitive to the presence of Wicket tags.
-====
-
-
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-password-reset.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-password-reset.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-password-reset.adoc
deleted file mode 100644
index 7a7db23..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-password-reset.adoc
+++ /dev/null
@@ -1,47 +0,0 @@
-[[_ugvw_configuration-properties_suppressing-password-reset]]
-= Suppressing 'password reset'
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-If xref:_user_registration[user registration] has been configured, then the Wicket viewer allows the user to sign-up a new account and to reset their password from the login page.
-
-The 'password reset' link can be suppressed, if required, by setting a configuration flag.
-
-
-
-== Screenshots
-
-With 'password reset' not suppressed (the default):
-
-image::{_imagesdir}wicket-viewer/suppress-password-reset/login-page-default.png[width="300px",link="{_imagesdir}wicket-viewer/suppress-password-reset/login-page-default.png"]
-
-and with the link suppressed:
-
-image::{_imagesdir}wicket-viewer/suppress-password-reset/login-page-suppress-password-reset.png[width="300px",link="{_imagesdir}wicket-viewer/suppress-password-reset/login-page-suppress-password-reset.png"]
-
-
-
-== Configuration
-
-To suppress the 'password reset' link, add the following configuration flag:
-
-[source,ini]
-----
-isis.viewer.wicket.suppressPasswordReset=true
-----
-
-Typically this should be added to the `viewer_wicket.properties` file (in `WEB-INF`), though you can add to `isis.properties` if you wish.
-
-
-
-== See also
-
-The xref:ugvw.adoc#_ugvw_configuration-properties_suppressing-sign-up[sign up link] can be suppressed in a similar manner.
-
-
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-remember-me.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-remember-me.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-remember-me.adoc
deleted file mode 100644
index c6aa669..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-remember-me.adoc
+++ /dev/null
@@ -1,33 +0,0 @@
-[[_ugvw_configuration-properties_suppressing-remember-me]]
-= Suppressing 'remember me'
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-The 'remember me' checkbox on the login page can be suppressed, if required, by setting a configuration flag.
-
-
-
-== Screenshots
-
-With 'remember me' not suppressed (the default):
-
-image::{_imagesdir}wicket-viewer/suppress-remember-me/login-page-default.png[width="300px",link="{_imagesdir}wicket-viewer/suppress-remember-me/login-page-default.png"]
-
-and with the checkbox suppressed:
-
-image::{_imagesdir}wicket-viewer/suppress-remember-me/login-page-suppress-remember-me.png[width="300px",link="{_imagesdir}wicket-viewer/suppress-remember-me/login-page-suppress-remember-me.png"]
-
-
-
-== Configuration
-
-To suppress the 'remember me' checkbox, add the following configuration flag:
-
-[source,ini]
-----
-isis.viewer.wicket.rememberMe.suppress=true
-----
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-sign-up.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-sign-up.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-sign-up.adoc
deleted file mode 100644
index 498a4d7..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-sign-up.adoc
+++ /dev/null
@@ -1,49 +0,0 @@
-[[_ugvw_configuration-properties_suppressing-sign-up]]
-= Suppressing 'sign up'
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-
-
-If xref:_user_registration[user registration] has been configured, then the Wicket viewer allows the user to sign-up a new account and to reset their password from the login page.
-
-The 'sign up' link can be suppressed, if required, by setting a configuration flag.
-
-
-
-
-== Screenshots
-
-With 'sign up' not suppressed (the default):
-
-image::{_imagesdir}wicket-viewer/suppress-sign-up/login-page-default.png[width="300px",link="{_imagesdir}wicket-viewer/suppress-sign-up/login-page-default.png"]
-
-and with the link suppressed:
-
-image::{_imagesdir}wicket-viewer/suppress-sign-up/login-page-suppress-sign-up.png[width="300px",link="{_imagesdir}wicket-viewer/suppress-sign-up/login-page-suppress-sign-up.png"]
-
-
-
-
-== Configuration
-
-To suppress the 'sign up' link, add the following configuration flag:
-
-[source,ini]
-----
-isis.viewer.wicket.suppressSignUp=true
-----
-
-
-
-== See also
-
-The xref:ugvw.adoc#_ugvw_configuration-properties_suppressing-password-reset[password reset link] can be suppressed in a similar manner.
-
-
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation.adoc
deleted file mode 100644
index 331283d..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation.adoc
+++ /dev/null
@@ -1,18 +0,0 @@
-[[_ugvw_customisation]]
-= Customisation
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-include::_ugvw_customisation_brand-logo.adoc[leveloffset=+1]
-include::_ugvw_customisation_default-theme.adoc[leveloffset=+1]
-include::_ugvw_customisation_welcome-page.adoc[leveloffset=+1]
-include::_ugvw_customisation_about-page.adoc[leveloffset=+1]
-include::_ugvw_customisation_tweaking-css-classes.adoc[leveloffset=+1]
-include::_ugvw_customisation_cheap-n-cheerful-theme.adoc[leveloffset=+1]
-include::_ugvw_customisation_using-different-css-file.adoc[leveloffset=+1]
-include::_ugvw_customisation_custom-javascript.adoc[leveloffset=+1]
-include::_ugvw_customisation_auto-refresh.adoc[leveloffset=+1]
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_about-page.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_about-page.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_about-page.adoc
deleted file mode 100644
index e1f394b..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_about-page.adoc
+++ /dev/null
@@ -1,121 +0,0 @@
-[[_ugvw_customisation_about-page]]
-= About page
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-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.
-
-
-== Screenshot
-
-Here's what the About page looks like with this configuration added:
-
-image::{_imagesdir}wicket-viewer/about-page/about-page.png[width="800px",link="{_imagesdir}wicket-viewer/about-page/about-page.png"]
-
-[NOTE]
-====
-Note that this screenshot shows an earlier version of the xref:ugvw.adoc#[Wicket viewer] UI (specifically, pre 1.8.0).
-====
-
-Note that the `Build-Time` 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:
-
-* `Implementation-Version`
-* `Build-Time`
-
-If none of these are found, then no version is displayed.
-
-== Configuration
-
-[TIP]
-====
-This configuration is included within the xref:ugfun.adoc#_ugfun_getting-started_simpleapp-archetype[SimpleApp archetype].
-====
-
-=== Adding attributes to the WAR's manifest
-
-Add the following to the webapp's `pom.xml` (under `<build>/<plugins>`):
-
-[source,xml]
-----
-<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>
-----
-
-If you then build the webapp from the Maven command line (`mvn clean package`), then the WAR should contain a `META-INF/MANIFEST.MF` with those various attribute entries.
-
-=== Exporting the attributes into the app
-
-The manifest attributes are provided to the rest of the application by way of the Wicket viewer's integration with Google Guice.
-
-In your subclass of `IsisWicketApplication`, there is a method `newIsisWicketModule()`. In this method you need to bind an `InputStream` that will read the manifest attributes. This is all boilerplate so you can just copy-n-paste:
-
-[source,java]
-----
-@Override
-protected Module newIsisWicketModule() {
- ...
- final Module simpleappOverrides = new AbstractModule() {
- @Override
- protected void configure() {
- ...
- bind(InputStream.class)
- .annotatedWith(Names.named("metaInfManifest"))
- .toProvider(Providers.of(
- getServletContext().getResourceAsStream("/META-INF/MANIFEST.MF")));
- }
- };
- ...
-}
-----
-
-With that you should be good to go!
-
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_auto-refresh.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_auto-refresh.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_auto-refresh.adoc
deleted file mode 100644
index fe06109..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_auto-refresh.adoc
+++ /dev/null
@@ -1,35 +0,0 @@
-[[_ugvw_customisation_auto-refresh]]
-= Auto-refresh page
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-This requirement from the users mailing list:
-
-pass:[<div class="extended-quote-first"><p>]Suppose you want to build a monitoring application, eg for an electricity grid. Data is updated in the background (eg via the Restful Objects REST API). What is needed is the ability to show an entity that includes a http://github.com/isisaddons/isis-wicket-gmap3[map], and have it auto-refresh every 5 seconds or so.
-pass:[</p></div>]
-
-Here's one (somewhat crude, but workable) way to accomplish this.
-
-* First, update the domain object to return custom CSS: +
-+
-[source,java]
-----
-public class MyDomainObject {
- ...
- public String cssClass() {return "my-special-auto-updating-entity"; }
- ...
-}
-----
-
-* Then, use javascript in `webapp/src/main/webapp/scripts/application.js` to reload: +
-+
-[source,javascript]
-----
-$(function() {
- if ($(".my-special-auto-updating-entity").length) {
- setTimeout(function() {document.location.reload();}, 5000); // 1000 is 5 sec
- }
-});
-----
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_brand-logo.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_brand-logo.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_brand-logo.adoc
deleted file mode 100644
index 9aadf0e..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_brand-logo.adoc
+++ /dev/null
@@ -1,71 +0,0 @@
-[[_ugvw_customisation_brand-logo]]
-= Brand logo
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-By default the Wicket viewer will display the application name top-left in the header menu. This can be changed to
-display a png logo instead.
-
-== Screenshots
-
-The screenshot below shows the Isis addons example https://github.com/isisaddons/isis-app-todoapp/[todoapp] (not ASF) with a 'brand logo' image in its header:
-
-image::{_imagesdir}wicket-viewer/brand-logo/brand-logo.png[width="750px",link="{_imagesdir}wicket-viewer/brand-logo/brand-logo.png"]
-
-A custom brand logo (typically larger) can also be specified for the signin page:
-
-image::{_imagesdir}wicket-viewer/brand-logo/brand-logo-signin.png[width="750px",link="{_imagesdir}wicket-viewer/brand-logo/brand-logo-signin.png"]
-
-
-
-
-== Configuration
-
-In the application-specific subclass of `IsisWicketApplication`, bind:
-
-* a string with name "brandLogoHeader" to the URL of a header image. A size of 160x40 works well.
-* a string with name "brandLogoSignin" to the URL of a image for the sign-in page. A size of 400x100 works well.
-
-For example:
-
-[source,java]
-----
-@Override
-protected Module newIsisWicketModule() {
- final Module isisDefaults = super.newIsisWicketModule();
-
- final Module overrides = new AbstractModule() {
- @Override
- protected void configure() {
- ...
- bind(String.class).annotatedWith(Names.named("brandLogoHeader"))
- .toInstance("/images/todoapp-logo-header.png");
- bind(String.class).annotatedWith(Names.named("brandLogoSignin"))
- .toInstance("/images/todoapp-logo-signin.png");
- ...
- }
- };
-
- return Modules.override(isisDefaults).with(overrides);
-}
-----
-
-If the logo is hosted locally, add to the relevant directory (eg `src/main/webapp/images`). It is also valid for the
-URL to be absolute.
-
-You may also wish to tweak the xref:rgcfg.adoc#_rgcfg_application-specific_application-css[`application.css`]. For example, a logo with height 40px works well with the following:
-
-[source,css]
-----
-.navbar-brand img {
- margin-top: -5px;
- margin-left: 5px;
-}
-----
-
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_cheap-n-cheerful-theme.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_cheap-n-cheerful-theme.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_cheap-n-cheerful-theme.adoc
deleted file mode 100644
index 1dfbd43..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_cheap-n-cheerful-theme.adoc
+++ /dev/null
@@ -1,29 +0,0 @@
-[[_ugvw_customisation_cheap-n-cheerful-theme]]
-= Cheap-n-cheerful theme
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-
-The application name (as defined in the `IsisWicketApplication` subclass) is also used (in sanitized form) as the CSS class in a `<div>` that wraps all the rendered content of every page.
-
-For example, if the application name is "ToDo App", then the `<div>` generated is:
-
-[source,html]
-----
-<div class="todo-app">
- ...
-</div>
-----
-
-You can therefore use this CSS class as a way of building your own "theme" for the various elements of the wicket viewer pages.
-
-[TIP]
-====
-Alternatively you could "do it properly" and create your xref:ugvw.adoc#_ugvw_extending_custom-bootstrap-theme[own Bootstrap theme], as described in the xref:ugbtb.adoc#[Extending] chapter.
-====
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_custom-javascript.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_custom-javascript.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_custom-javascript.adoc
deleted file mode 100644
index d36f31d..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_custom-javascript.adoc
+++ /dev/null
@@ -1,42 +0,0 @@
-[[_ugvw_customisation_custom-javascript]]
-= Custom Javascript
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-The Wicket viewer ships with embedded JQuery, so this can be leveraged to perform arbitrary transformations of the rendered page (eg to run some arbitrary JQuery on page load).
-
-[WARNING]
-====
-Just because something is possible, it doesn't necessarily mean we encourage it. Please be aware that there is no formal API for any custom javascript that you might implement to target; future versions of Apache Isis might break your code.
-
-If possible, consider using the `ComponentFactory` API described in the xref:ugvw.adoc#_ugvw_extending[Extending] chapter.
-====
-
-To register your Javascript code, adjusting the Guice bindings (part of Apache Isis' bootstrapping) in your custom subclass of `IsisWicketApplication`:
-
- public class MyAppApplication extends IsisWicketApplication {
- @Override
- protected Module newIsisWicketModule() {
- final Module isisDefaults = super.newIsisWicketModule();
- final Module myAppOverrides = new AbstractModule() {
- @Override
- protected void configure() {
- ...
- bind(String.class)
- .annotatedWith(Names.named("applicationJs"))
- .toInstance("scripts/application.js");
- ...
- }
- };
- return Modules.override(isisDefaults).with(myAppOverrides);
- }
- }
-
-Currently only one such `.js` file can be registered.
-
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/2669a971/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_default-theme.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_default-theme.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_default-theme.adoc
deleted file mode 100644
index b5aa3b2..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_customisation_default-theme.adoc
+++ /dev/null
@@ -1,29 +0,0 @@
-[[_ugvw_customisation_default-theme]]
-= Specifying a default theme
-:Notice: 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.
-:_basedir: ../
-:_imagesdir: images/
-
-
-
-The Apache Isis Wicket viewer uses http://getbootstrap.com/[Bootstrap] styles and components (courtesy of the https://github.com/l0rdn1kk0n/wicket-bootstrap[Wicket Bootstrap] integration).
-
-Unless specified otherwise, the viewer uses the default bootstrap theme. However, this can be changed by overriding `init()` in the application's subclass of `IsisWicketApplication`. For example, to set the http://bootswatch.com/flatly/[bootswatch.com flatly] theme
- as the default, use:
-
-[source,java]
-----
-@Override
-protected void init() {
- super.init();
- IBootstrapSettings settings = Bootstrap.getSettings();
- settings.setThemeProvider(new BootswatchThemeProvider(BootswatchTheme.Flatly));
-}
-----
-
-If you have developed a custom Bootstrap theme (as described xref:ugvw.adoc#_ugvw_extending_custom-bootstrap-theme[here]) then this can also be specified using the https://github.com/l0rdn1kk0n/wicket-bootstrap/wiki/Themes[Wicket Bootstrap API].
-
-
-
-
-