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 2016/03/08 00:39:02 UTC
isis-site git commit: ISIS-993: more docs
Repository: isis-site
Updated Branches:
refs/heads/asf-site e106aba4d -> 6216734fe
ISIS-993: more docs
Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/6216734f
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/6216734f
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/6216734f
Branch: refs/heads/asf-site
Commit: 6216734feae0363ca25b738f23485b7867d16bae
Parents: e106aba
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Mon Mar 7 23:38:34 2016 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Mon Mar 7 23:38:34 2016 +0000
----------------------------------------------------------------------
content/guides/ugbtb.html | 18 ++++++++++++++++++
content/guides/ugfun.html | 9 ++++-----
2 files changed, 22 insertions(+), 5 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis-site/blob/6216734f/content/guides/ugbtb.html
----------------------------------------------------------------------
diff --git a/content/guides/ugbtb.html b/content/guides/ugbtb.html
index 6ccf5b7..7ffb17a 100644
--- a/content/guides/ugbtb.html
+++ b/content/guides/ugbtb.html
@@ -3484,6 +3484,24 @@ Pretty much all the other <code>FacetFactory</code>s are responsible for install
<div class="paragraph">
<p>You can also implement your own metadata readers and plug them into Apache Isis. These could read from a different file format, or they could, even, read data dynamically from a URL or database. (Indeed, one could imagine an implementation whereby users could share layouts, all stored in some central repository).</p>
</div>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p>(As of <code>1.12.0-SNAPSHOT</code>), the use of dynamic layouts through the <code>.layout.json</code> - and therefore also the <code>LayoutMetadataReader</code> - is DEPRECATED. Instead, the <a href="ugfun.html#_ugfun_object-layout_dynamic_xml">dynamic XML layouts</a> using <code>.layout.xml</code> enables much more sophisticated custom layouts than those afforded by <code>.layout.json</code>.</p>
+</div>
+<div class="paragraph">
+<p>By default, custom XML layouts are read from the classpath. This behaviour can be customized by providing an
+alternative implementation of the <a href="rgsvc.html#_rgsvc_spi_GridLoaderService"><code>GridLoaderService</code></a>.</p>
+</div>
+</td>
+</tr>
+</table>
+</div>
<div class="sect3">
<h4 id="_api_and_implementation_2">7.3.1. API and Implementation</h4>
<div class="paragraph">
http://git-wip-us.apache.org/repos/asf/isis-site/blob/6216734f/content/guides/ugfun.html
----------------------------------------------------------------------
diff --git a/content/guides/ugfun.html b/content/guides/ugfun.html
index 62ca70b..3256578 100644
--- a/content/guides/ugfun.html
+++ b/content/guides/ugfun.html
@@ -5883,13 +5883,12 @@ below summarises the choices:</p>
</td>
<td class="content">
<div class="paragraph">
-<p>(As of <code>1.12.0-SNAPSHOT</code>), the use of dynamic layouts through the <code>.layout.json</code> is DEPRECATED.</p>
+<p>(As of <code>1.12.0-SNAPSHOT</code>), the use of dynamic layouts through the <code>.layout.json</code> is DEPRECATED. Instead, use the
+<code>.layout.xml</code> file, which enables much more sophisticated custom layouts than those provided by <code>.layout.json</code>.</p>
</div>
<div class="paragraph">
-<p>The <code>.layout.json</code> file will be ignored if a <code>.layout.xml</code> file is present. It is possible to download initial <code>.layout.xml</code> files - which will capture all the metadata originally in the <code>.layout.json</code> file - using the <a href="rgsvc.html#_rgsvc_api_MetamodelService"><code>MetamodelService</code></a> (exposed on the prototyping menu).</p>
-</div>
-<div class="paragraph">
-<p>The <code>.layout.xml</code> file also allows enables much more sophisticated custom layouts than those afforded by <code>.layout.json</code>, and the layout files are easier to write due to the presence of an XSD schema file which ensures that the file is syntactically correct.</p>
+<p>It is possible to download initial <code>.layout.xml</code> files - which will capture all the metadata originally in the <code>.layout.json</code> file - using the <a href="rgsvc.html#_rgsvc_api_LayoutService"><code>LayoutService</code></a> (exposed as an action on the prototyping menu).
+The <code>.layout.json</code> file will be ignored once a <code>.layout.xml</code> file is present.</p>
</div>
</td>
</tr>