Release 2.4.0

Author: knalli

de/js/docs-setup.js

@@ -0,0 +1,14 @@
+<h1><code ng:non-bindable="">$translationCache</code>
+<div><span class="hint"></span>
+</div>
+</h1>
+<div><h2 id="description">Description</h2>
+<div class="description"><div class="-translationcache-page"><p>The first time a translation table is used, it is loaded in the translation cache for quick retrieval. You
+can load translation tables directly into the cache by consuming the
+<code>$translationCache</code> service directly.</p>
+</div></div>
+<h2 id="dependencies">Dependencies</h2>
+<ul class="dependencies"><li><code ng:non-bindable=""><a href="#/api/ng.$cacheFactory">$cacheFactory</a></code>
+</li>
+</ul>
+</div>

de/partials/api/$translationCache.html

@@ -61,6 +61,11 @@ <h4 id="usage_parameters">Parameters</h4><table class="variables-matrix table ta
 </div><h5 id="methods_ispostcompilingenabled_returns">Returns</h5><table class="variables-matrix"><tr><td><a href="" class="label type-hint type-hint-bool">bool</a></td><td><div class="pascalprecht-translate-translate-ispostcompilingenabled-page"><p>storage key</p>
 </div></td></tr></table></div>
 </li>
+<li><h3 id="methods_loadercache">loaderCache()</h3>
+<div class="loadercache"><div class="pascalprecht-translate-translate-loadercache-page"><p>Returns the defined loaderCache.</p>
+</div><h5 id="methods_loadercache_returns">Returns</h5><table class="variables-matrix"><tr><td><a href="" class="label type-hint type-hint-boolean">boolean|string|object</a></td><td><div class="pascalprecht-translate-translate-loadercache-page"><p>current value of loaderCache</p>
+</div></td></tr></table></div>
+</li>
 <li><h3 id="methods_preferredlanguage">preferredLanguage(langKey)</h3>
 <div class="preferredlanguage"><div class="pascalprecht-translate-translate-preferredlanguage-page"><p>Returns the language key for the preferred language.</p>
 </div><h5 id="methods_preferredlanguage_parameters">Parameters</h5><table class="variables-matrix table table-bordered table-striped"><thead><tr><th>Param</th><th>Type</th><th>Details</th></tr></thead><tbody><tr><td>langKey</td><td><a href="" class="label type-hint type-hint-string">string</a></td><td><div class="pascalprecht-translate-translate-preferredlanguage-page"><p>language String or Array to be used as preferredLanguage (changing at runtime)</p>
@@ -125,6 +130,11 @@ <h4 id="usage_parameters">Parameters</h4><table class="variables-matrix table ta
 get back to the whole stack</p>
 </div></td></tr></tbody></table></div>
 </li>
+<li><h3 id="methods_versioninfo">versionInfo()</h3>
+<div class="versioninfo"><div class="pascalprecht-translate-translate-versioninfo-page"><p>Returns the current version information for the angular-translate library</p>
+</div><h5 id="methods_versioninfo_returns">Returns</h5><table class="variables-matrix"><tr><td><a href="" class="label type-hint type-hint-string">string</a></td><td><div class="pascalprecht-translate-translate-versioninfo-page"><p>angular-translate version</p>
+</div></td></tr></table></div>
+</li>
 </ul>
 </div>
 </div>

de/partials/api/pascalprecht.translate.$translate.html

@@ -14,6 +14,8 @@ <h2 id="dependencies">Dependencies</h2>
 </li>
 <li><code ng:non-bindable=""><a href="#/api/ng.$rootScope">$rootScope</a></code>
 </li>
+<li><code ng:non-bindable=""><a href="#/api/ng.$translate">$translate</a></code>
+</li>
 </ul>
 <h2 id="usage">Usage</h2>
 <div class="usage"><pre class="prettyprint linenums">$translatePartialLoader(options);</pre>

de/partials/api/pascalprecht.translate.$translatePartialLoader.html

@@ -129,6 +129,15 @@ <h1><code ng:non-bindable="">$translateProvider</code>
 </div></td></tr><tr><td>options <div><em>(optional)</em></div></td><td><a href="" class="label type-hint type-hint-object">Object</a></td><td><div class="pascalprecht-translate-translateprovider-useloader-page"><p>Optional configuration object</p>
 </div></td></tr></tbody></table></div>
 </li>
+<li><h3 id="methods_useloadercache">useLoaderCache(cache)</h3>
+<div class="useloadercache"><div class="pascalprecht-translate-translateprovider-useloadercache-page"><p>Registers a cache for internal $http based loaders.
+<a href="#/api/pascalprecht.translate.$translateProvider#determinepreferredlanguage">determinePreferredLanguage</a>.
+When false the cache will be disabled (default). When true or undefined
+the cache will be a default (see $cacheFactory). When an object it will
+be treat as a cache object itself: the usage is $http({cache: cache})</p>
+</div><h5 id="methods_useloadercache_parameters">Parameters</h5><table class="variables-matrix table table-bordered table-striped"><thead><tr><th>Param</th><th>Type</th><th>Details</th></tr></thead><tbody><tr><td>cache</td><td><a href="" class="label type-hint type-hint-object">object</a></td><td><div class="pascalprecht-translate-translateprovider-useloadercache-page"><p>boolean, string or cache-object</p>
+</div></td></tr></tbody></table></div>
+</li>
 <li><h3 id="methods_uselocalstorage">useLocalStorage()</h3>
 <div class="uselocalstorage"><div class="pascalprecht-translate-translateprovider-uselocalstorage-page"><p>Tells angular-translate to use <code>$translateLocalStorage</code> service as storage layer.</p>
 </div></div>

de/partials/api/pascalprecht.translate.$translateProvider.html

@@ -61,6 +61,14 @@ <h3 id="$translate--service-benutzen_mehrere-translationids-auf-einmal">Mehrere
 Übersetzungen zurückgibt. Dabei spielt es keine Rolle, ob eine einzelne
 Übersetzung (oder sogar alle) nicht übersetzt werden konnten. Eine mögliche
 Fehlerbehandlung muss von Deiner Seite aus geschehen.</p>
+<h3 id="$translate--service-benutzen_angular-translate-versionsinformationen">angular-translate Versionsinformationen</h3>
+<p>Für einige Anwendungen mag es sinnvoll sein, die eingesetzte Version im &quot;Über uns&quot;-Bereich o.ä. anzuzeigen.
+Damit dieses problemlos möglich ist, beinhaltet angular-translate eine Funktion, die sehr einfach verwendet werden
+kann und die aktuelle Modulversion zurückgibt:</p>
+<pre class="prettyprint linenums">
+  $translate.versionInfo();
+  // returns e.g. "2.1.0"
+</pre>
 <h3 id="$translate--service-benutzen_dinge-die-berücksichtigt-werden-sollten">Dinge die berücksichtigt werden sollten</h3>
 <p>Bitte beachte dass <code>$translate</code> Service kein Two-Way Data-Binding unterstützt.
 <code>$translate</code> Service arbeitet asynchron, dass bedeteut aber nicht, dass er informiert

de/partials/guide/03_using-translate-service.html

@@ -189,6 +189,39 @@ <h3 id="asynchrones-laden_lazy-loading-at-runtime">Lazy loading at runtime</h3>
 Sprache zur Laufzeit mit <code>$translate.use()</code> wechselt. Für den Fall dass die Daten
 asynchron geladen werden ändert sich nichts. <code>$translate.use()</code> überprüft ob die
 angefragte Sprache vorhanden ist und wenn nicht, wird diese erst geladen.</p>
+<h3 id="asynchrones-laden_konfiguration-eines-loaders">Konfiguration eines Loaders</h3>
+<p>Jedem Loader kann eine erweiterte Konfiguration <code>options</code> angegeben werden. Dies
+gilt sowohl für den allgemeinen Konstructor <code>useLoader(name, options)</code> als auch
+die Shortcut-Konstruktoren wie <code>useStaticFilesLoader(options)</code>:</p>
+<pre class="prettyprint linenums">
+$translationProvider.useLoader('customLoader', {
+  settingA: 'foobar'
+});
+$translationProvider.useStaticFilesLoader({
+  $http: {
+    method: 'POST'
+  }
+});
+</pre>
+<p>Die Eigenschaft <code>$http</code> wird entsprechend durchgereicht. Nur das Attribut <code>cache</code> wird ggf. überschrieben
+(siehe nächstes Kapitel).</p>
+<h3 id="asynchrones-laden_benutzung-eines-caches">Benutzung eines Caches</h3>
+<p>Bei der Verwendung der Standard Loader kann man das Caching steuern. Weitere Informationen
+über Caches finden sich in der
+<a href="https://docs.angularjs.org/api/ng/type/$cacheFactory.Cache">offiziellen AngularJS Dokumentation</a>.</p>
+<p>Den Cache kann man sehr leicht mit folgender Konfiguration aktivieren:</p>
+<pre class="prettyprint linenums">
+$translationProvider.useLoaderCache(true); // default ist false, also deaktiviert
+</pre>
+<p>Falls Du bereits eine eigene Instanz konfiguriert hast, kannst Du diese auch direkt übergeben:</p>
+<pre class="prettyprint linenums">
+$translationProvider.useLoaderCache(yourSpecialCacheService);
+</pre>
+<p>Angular-Translate unterstützt auch das Lazy-Binding, so dass auch folgendes funktioniert:</p>
+<pre class="prettyprint linenums">
+$translationProvider.useLoaderCache('yourSpecialCacheService');
+</pre>
+<p>Die Instanz mit der ID <code>yourSpecialCacheService</code> wird erst bei Bedarf aus dem Kontext geladen.</p>
 <h3 id="asynchrones-laden_fouc---flash-of-untranslated-content">FOUC - Flash of untranslated content</h3>
 <p>Es gibt einen Nachteil wenn man Asynchrone Loader verwendet. Für keinen kurzen
 Moment beim Startup der App könnte es ein kleines Flackern geben, da die initiale