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 2015/12/23 17:01:05 UTC
[1/2] isis-site git commit: ISIS-1093: updating the migration guide
for the new i18n support in Wicket viewer.
Repository: isis-site
Updated Branches:
refs/heads/asf-site ba6860ceb -> 502272307
ISIS-1093: updating the migration guide for the new i18n support in Wicket viewer.
Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/57a23c4d
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/57a23c4d
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/57a23c4d
Branch: refs/heads/asf-site
Commit: 57a23c4da448640ba303c664f1c2f54f00d7815a
Parents: ba6860c
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Wed Dec 23 15:11:14 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Wed Dec 23 15:11:14 2015 +0000
----------------------------------------------------------------------
content/guides/ugbtb.html | 32 ++++++++++++++++----------------
content/migration-notes.html | 16 ++++++++++++++++
2 files changed, 32 insertions(+), 16 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis-site/blob/57a23c4d/content/guides/ugbtb.html
----------------------------------------------------------------------
diff --git a/content/guides/ugbtb.html b/content/guides/ugbtb.html
index 6dd95b8..be80e05 100644
--- a/content/guides/ugbtb.html
+++ b/content/guides/ugbtb.html
@@ -1860,7 +1860,7 @@ methods for properties (see ?).</p>
<p>Isis does not translate the values of your domain objects, though. So, if you have a domain concept such as <code>Country</code> whose name is intended to be localized according to the current user, you will need to model this yourself.</p>
</div>
<div class="sect2">
-<h3 id="_implementation_approach">4.1. Implementation Approach</h3>
+<h3 id="_ugbtb_i18n_implementation-approach">4.1. Implementation Approach</h3>
<div class="paragraph">
<p>Most Java frameworks tackle i18n by using Java’s own <code>ResourceBundle</code> API. However, there are some serious drawbacks in this approach, including:</p>
</div>
@@ -1934,7 +1934,7 @@ methods for properties (see ?).</p>
</div>
</div>
<div class="sect2">
-<h3 id="__code_translationservice_code">4.2. <code>TranslationService</code></h3>
+<h3 id="_ugbtb_i18n_translation-service">4.2. <code>TranslationService</code></h3>
<div class="paragraph">
<p>The cornerstone of Apache Isis' support for i18n is the <code>TranslationService</code> service. This is defined in the applib with the following API:</p>
</div>
@@ -2009,7 +2009,7 @@ methods for properties (see ?).</p>
</div>
</div>
<div class="sect2">
-<h3 id="_imperative_messages">4.3. Imperative messages</h3>
+<h3 id="_ugbtb_i18n_imperative-messages">4.3. Imperative messages</h3>
<div class="paragraph">
<p>The <code>TranslationService</code> is used internally by Apache Isis when building up the metamodel; the name and description of every class, property, collection, action and action parameter is automatically translated. Thus the simple act of bootstrapping Apache Isis will cause most of the messages requiring translation (that is: those for the Apache Isis metamodel) to be captured by the <code>TranslationService</code>.</p>
</div>
@@ -2163,7 +2163,7 @@ msgstr "Iche heisse {firstName} {lastName}."</code></pre>
</div>
</div>
<div class="sect2">
-<h3 id="_wicket_viewer_code_1_11_0_snapshot_code">4.4. Wicket Viewer (<code>1.11.0-SNAPSHOT</code>)</h3>
+<h3 id="_ugbtb_i18n_wicket-viewer">4.4. Wicket Viewer (<code>1.11.0-SNAPSHOT</code>)</h3>
<div class="paragraph">
<p>(As of <code>1.11.0-SNAPSHOT</code>), the <a href="ugvw.html">Wicket viewer</a> (its labels and messages) is also internationalized using
the <code>TranslationService</code>. This is done through an Isis-specific implementation of the Wicket framework’s <code>org.apache.wicket.Localizer</code> class, namely <code>LocalizerForIsis</code>.</p>
@@ -2432,7 +2432,7 @@ msgstr "Username"</code></pre>
</div>
</div>
<div class="sect2">
-<h3 id="_integration_testing">4.5. Integration Testing</h3>
+<h3 id="_ugbtb_i18n_integration-testing">4.5. Integration Testing</h3>
<div class="paragraph">
<p>So much for the API; but as noted, it is also necessary to ensure that the required translations are recorded (by the <code>TranslationService</code>) into the <code>.pot</code> file.</p>
</div>
@@ -2542,7 +2542,7 @@ msgstr "<i>Quantité</i>"</code></pre>
</div>
</div>
<div class="sect2">
-<h3 id="_configuration">4.7. Configuration</h3>
+<h3 id="_ugbtb_i18n_configuration">4.7. Configuration</h3>
<div class="paragraph">
<p>There are several different aspects of the translation service that can be configured.</p>
</div>
@@ -3347,7 +3347,7 @@ build up its metamodel.</p>
</div>
</div>
<div class="sect3">
-<h4 id="_configuration_2">7.1.2. Configuration</h4>
+<h4 id="_configuration">7.1.2. Configuration</h4>
<div class="paragraph">
<p>Once you have implemented your validator, you must register it with the framework by defining the appropriate configuration property:</p>
</div>
@@ -3560,7 +3560,7 @@ Pretty much all the other <code>FacetFactory</code>s are responsible for install
</div>
</div>
<div class="sect3">
-<h4 id="_configuration_3">7.3.2. Configuration</h4>
+<h4 id="_configuration_2">7.3.2. Configuration</h4>
<div class="paragraph">
<p>Once you have implemented your validator, you must register it with the framework by defining the appropriate configuration property:</p>
</div>
@@ -4985,27 +4985,27 @@ the default ones of <code>isis.properties</code> et al):</p>
</li>
<li><a href="#_ugbtb_i18n">4. i18n</a>
<ul class="sectlevel2">
-<li><a href="#_implementation_approach">4.1. Implementation Approach</a></li>
-<li><a href="#__code_translationservice_code">4.2. <code>TranslationService</code></a>
+<li><a href="#_ugbtb_i18n_implementation-approach">4.1. Implementation Approach</a></li>
+<li><a href="#_ugbtb_i18n_translation-service">4.2. <code>TranslationService</code></a>
<ul class="sectlevel3">
<li><a href="#__code_translationservicepo_code">4.2.1. <code>TranslationServicePo</code></a></li>
</ul>
</li>
-<li><a href="#_imperative_messages">4.3. Imperative messages</a>
+<li><a href="#_ugbtb_i18n_imperative-messages">4.3. Imperative messages</a>
<ul class="sectlevel3">
<li><a href="#__code_translatablestring_code">4.3.1. <code>TranslatableString</code></a></li>
<li><a href="#__code_translatableexception_code">4.3.2. <code>TranslatableException</code></a></li>
</ul>
</li>
-<li><a href="#_wicket_viewer_code_1_11_0_snapshot_code">4.4. Wicket Viewer (<code>1.11.0-SNAPSHOT</code>)</a>
+<li><a href="#_ugbtb_i18n_wicket-viewer">4.4. Wicket Viewer (<code>1.11.0-SNAPSHOT</code>)</a>
<ul class="sectlevel3">
<li><a href="#_commonly_used">4.4.1. Commonly used</a></li>
<li><a href="#_login_self_sign_up">4.4.2. Login/self-sign-up</a></li>
</ul>
</li>
-<li><a href="#_integration_testing">4.5. Integration Testing</a></li>
+<li><a href="#_ugbtb_i18n_integration-testing">4.5. Integration Testing</a></li>
<li><a href="#_escaped_strings">4.6. Escaped strings</a></li>
-<li><a href="#_configuration">4.7. Configuration</a>
+<li><a href="#_ugbtb_i18n_configuration">4.7. Configuration</a>
<ul class="sectlevel3">
<li><a href="#_logging">4.7.1. Logging</a></li>
<li><a href="#_location_of_the_code_po_code_files">4.7.2. Location of the <code>.po</code> files</a></li>
@@ -5059,7 +5059,7 @@ the default ones of <code>isis.properties</code> et al):</p>
<li><a href="#__code_summarizingvisitor_code"><code>SummarizingVisitor</code></a></li>
</ul>
</li>
-<li><a href="#_configuration_2">7.1.2. Configuration</a></li>
+<li><a href="#_configuration">7.1.2. Configuration</a></li>
</ul>
</li>
<li><a href="#_ugbtb_programming-model_finetuning">7.2. Finetuning</a>
@@ -5079,7 +5079,7 @@ the default ones of <code>isis.properties</code> et al):</p>
<li><a href="#_extended_api">Extended API</a></li>
</ul>
</li>
-<li><a href="#_configuration_3">7.3.2. Configuration</a></li>
+<li><a href="#_configuration_2">7.3.2. Configuration</a></li>
</ul>
</li>
</ul>
http://git-wip-us.apache.org/repos/asf/isis-site/blob/57a23c4d/content/migration-notes.html
----------------------------------------------------------------------
diff --git a/content/migration-notes.html b/content/migration-notes.html
index 4414bae..cec4efe 100644
--- a/content/migration-notes.html
+++ b/content/migration-notes.html
@@ -611,6 +611,21 @@ to be generated from the Apache Isis metamodel. These can be downloaded directl
<p>The text of the simple app’s <code>about/index.html</code> has also changed (the <code><li</code>> for the <code>/restful</code> URL has been replaced with a <code>/swagger-ui</code> URL). If you use <a href="https://github.com/apache/isis/blob/master/example/application/simpleapp/webapp/src/main/webapp/about/index.html">this file</a>, then update it.</p>
</div>
</div>
+<div class="sect2">
+<h3 id="_wicket_viewer_i18n">Wicket Viewer i18n</h3>
+<div class="paragraph">
+<p>The <a href="guides/ugvw.html">Wicket viewer</a> (its labels, buttons, messages etc) can now be internationalized using the
+<a href="guides/rgsvc.html#_rgsvc_spi_TranslationService"><code>TranslationService</code></a>.</p>
+</div>
+<div class="paragraph">
+<p>To enable this, new <code>msgId</code>s and corresponding translations must be added to the <code>translations.po</code> file. Full
+details of these <code>msgId</code>s can be found in <a href="guides/ugbtb.html#_ugbtb_i18n_wicket-viewer">i18n</a> section of the "beyond the basics" guide.</p>
+</div>
+<div class="paragraph">
+<p>If no translations are available, then the fallback is to use the previous mechanism, ie Wicket’s original resource bundles.
+This feature can therefore be considered as optional.</p>
+</div>
+</div>
</div>
</div>
<div class="sect1">
@@ -1973,6 +1988,7 @@ into the new <code>org.isisaddons.module.settings:isis-module-settings-dom</code
<ul class="sectlevel2">
<li><a href="#_jaxb_view_models">JAXB view models</a></li>
<li><a href="#_swagger_ui">Swagger UI</a></li>
+<li><a href="#_wicket_viewer_i18n">Wicket Viewer i18n</a></li>
</ul>
</li>
<li><a href="#_migration-notes_1.9.0-to-1.10.0">From v1.9.0 to 1.10.0</a>
[2/2] isis-site git commit: ISIS-1243: adding quote to website.
Posted by da...@apache.org.
ISIS-1243: adding quote to website.
Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/50227230
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/50227230
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/50227230
Branch: refs/heads/asf-site
Commit: 502272307270c3ff938a4a70267395644a45caf7
Parents: 57a23c4
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Wed Dec 23 16:00:55 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Wed Dec 23 16:00:55 2015 +0000
----------------------------------------------------------------------
content/index.html | 11 +++++++++++
1 file changed, 11 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis-site/blob/50227230/content/index.html
----------------------------------------------------------------------
diff --git a/content/index.html b/content/index.html
index b720f4f..f7b0ffb 100644
--- a/content/index.html
+++ b/content/index.html
@@ -425,6 +425,17 @@
<blockquote>
<div class="row">
<div class="large-12 medium-12">
+ <p>We'd been looking for a RAD-tool for building our app; after trying different tools, Apache Isis gave us the most confidence for getting the job done. It's really remarkable how easy it is to use, while contributors and users on the Isis' active mailing list are ready to help on more advanced topics.</p>
+ <small>Erik de Hair, pocos.nl</small>
+ </div>
+ </div>
+ </blockquote>
+ </div>
+
+ <div>
+ <blockquote>
+ <div class="row">
+ <div class="large-12 medium-12">
<p>With its automatic UI and REST web services generation, Apache Isis kept our developers amazed and happy. Having had strenuous experiences with architecture and infrastructure concerns differing from project to project, it's like having back the fun in software development</p>
<small>Willie Loyd Tandingan</small>
</div>