You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ra...@apache.org on 2016/05/16 21:17:45 UTC
svn commit: r1744142 [1/9] - in /cordova/site/public: ./ docs/en/6.x/
docs/en/6.x/config_ref/ docs/en/6.x/cordova/events/
docs/en/6.x/cordova/storage/ docs/en/6.x/guide/platforms/win8/
docs/en/6.x/plugin_ref/ docs/en/6.x/reference/cordova-cli/ docs/en/...
Author: rakatyal
Date: Mon May 16 21:17:45 2016
New Revision: 1744142
URL: http://svn.apache.org/viewvc?rev=1744142&view=rev
Log:
Snapshotting current dev to 6.x
Added:
cordova/site/public/privacy/
cordova/site/public/privacy/index.html
cordova/site/public/static/img/guide/platforms/win8/win8_installTools.PNG (with props)
Modified:
cordova/site/public/docs/en/6.x/config_ref/images.html
cordova/site/public/docs/en/6.x/config_ref/index.html
cordova/site/public/docs/en/6.x/cordova/events/events.html
cordova/site/public/docs/en/6.x/cordova/storage/storage.html
cordova/site/public/docs/en/6.x/guide/platforms/win8/index.html
cordova/site/public/docs/en/6.x/guide/platforms/win8/plugin.html
cordova/site/public/docs/en/6.x/index.html
cordova/site/public/docs/en/6.x/plugin_ref/plugman.html
cordova/site/public/docs/en/6.x/plugin_ref/spec.html
cordova/site/public/docs/en/6.x/reference/cordova-cli/index.html
cordova/site/public/docs/en/6.x/reference/cordova-plugin-contacts/index.html
cordova/site/public/docs/en/6.x/reference/cordova-plugin-dialogs/index.html
cordova/site/public/docs/en/6.x/reference/cordova-plugin-file-transfer/index.html
cordova/site/public/docs/en/6.x/reference/cordova-plugin-file/index.html
cordova/site/public/docs/en/6.x/reference/cordova-plugin-geolocation/index.html
cordova/site/public/docs/en/6.x/reference/cordova-plugin-inappbrowser/index.html
cordova/site/public/docs/en/6.x/reference/cordova-plugin-media-capture/index.html
cordova/site/public/docs/en/6.x/reference/cordova-plugin-media/index.html
cordova/site/public/docs/en/6.x/reference/cordova-plugin-network-information/index.html
cordova/site/public/docs/en/6.x/reference/cordova-plugin-splashscreen/index.html
cordova/site/public/docs/en/dev/config_ref/images.html
cordova/site/public/docs/en/dev/config_ref/index.html
cordova/site/public/docs/en/dev/cordova/storage/storage.html
cordova/site/public/docs/en/dev/guide/platforms/win8/index.html
cordova/site/public/docs/en/dev/guide/platforms/win8/plugin.html
cordova/site/public/docs/en/dev/index.html
cordova/site/public/docs/en/dev/plugin_ref/plugman.html
cordova/site/public/docs/en/dev/reference/cordova-cli/index.html
cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html
cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html
cordova/site/public/feed.xml
cordova/site/public/sitemap.xml
Modified: cordova/site/public/docs/en/6.x/config_ref/images.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/6.x/config_ref/images.html?rev=1744142&r1=1744141&r2=1744142&view=diff
==============================================================================
--- cordova/site/public/docs/en/6.x/config_ref/images.html (original)
+++ cordova/site/public/docs/en/6.x/config_ref/images.html Mon May 16 21:17:45 2016
@@ -6,7 +6,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="format-detection" content="telephone=no">
<meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width" />
- <meta name="description" content="Learn how to customize icons for your Cordova app. ">
+ <meta name="description" content="Learn how to customize icons for your Cordova application. ">
<title>
@@ -2647,12 +2647,12 @@
<div id="page-toc-source">
<h1>Customize Icons</h1>
-<p>This section shows how to configure an app's icon for various platforms. Support for splash screen has moved to a Cordova plugin of its own. The configuration options can be found in the <a href="../reference/cordova-plugin-splashscreen/">Splashscreen plugin docs</a>.</p>
+<p>This section shows how to configure an application's icon for various platforms. Documentation about splash screen images can be found in the Cordova-Plugin-Splashscreen documentation <a href="../reference/cordova-plugin-splashscreen/">Splashscreen plugin docs</a>.</p>
<h2>Configuring Icons in the CLI</h2>
-<p>When working in the CLI you can define app icon(s) via <code><icon></code> element (<code>config.xml</code>).
-If you do not specify an icon then the Apache Cordova logo is used.</p>
+<p>When working in the CLI you can define application icon(s) via the <code><icon></code> element (<code>config.xml</code>).
+If you do not specify an icon, the Apache Cordova logo is used.</p>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/ios/icon.png"</span> <span class="na">platform=</span><span class="s">"ios"</span> <span class="na">width=</span><span class="s">"57"</span> <span class="na">height=</span><span class="s">"57"</span> <span class="na">density=</span><span class="s">"mdpi"</span> <span class="nt">/></span>
</code></pre></div>
<table><thead>
@@ -2687,11 +2687,11 @@ If you do not specify an icon then the A
</tr>
</tbody></table>
-<p>The following configuration can be used to define single default icon
+<p>The following configuration can be used to define a single default icon
which will be used for all platforms.</p>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/icon.png"</span> <span class="nt">/></span>
</code></pre></div>
-<p>For each platform you can also define a pixel-perfect icons set to fit
+<p>For each platform, you can also define a pixel-perfect icon set to fit
different screen resolutions.</p>
<h2>Android</h2>
@@ -2731,6 +2731,10 @@ different screen resolutions.</p>
<li><a href="http://developer.blackberry.com/html5/documentation/icon_element.html">BlackBerry's documentation</a> for targeting multiple sizes and locales.</li>
</ul>
+<h2>Browser</h2>
+
+<p>Icons are not applicable to the Browser platform.</p>
+
<h2>iOS</h2>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><platform</span> <span class="na">name=</span><span class="s">"ios"</span><span class="nt">></span>
<span class="c"><!-- iOS 8.0+ --></span>
@@ -2769,7 +2773,7 @@ different screen resolutions.</p>
<h2>Windows</h2>
-<p>For Windows the recommended approach to define app icons is to use <code>target</code> attribute.</p>
+<p>For Windows the recommended approach to define application icons is to use the <code>target</code> attribute.</p>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><platform</span> <span class="na">name=</span><span class="s">"windows"</span><span class="nt">></span>
<span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/windows/storelogo.png"</span> <span class="na">target=</span><span class="s">"StoreLogo"</span> <span class="nt">/></span>
<span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/windows/smalllogo.png"</span> <span class="na">target=</span><span class="s">"Square30x30Logo"</span> <span class="nt">/></span>
@@ -2781,16 +2785,18 @@ different screen resolutions.</p>
<span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/Windows/Wide310x150Logo.png"</span> <span class="na">target=</span><span class="s">"Wide310x150Logo"</span> <span class="nt">/></span>
<span class="nt"></platform></span>
</code></pre></div>
-<p>where <code>source</code> is the path to the icon which needs to be added.</p>
+<p>where <code>src</code> is the path to the icon which needs to be added.</p>
+
+<p>The Windows platform handles MRT icons automatically, so if you specify <code>src="res/windows/storelogo.png"</code> the following files will be copied into the application's <code>images</code> folder: <code>res/windows/storelogo.scale-100.png</code>, <code>res/windows/storelogo.scale-200.png</code>, etc.</p>
-<p>Please note that Windows platform handles MRT icons automatically, so if you specify <code>src="res/windows/storelogo.png"</code> the following files will be copied into app's <code>images</code> folder: <code>res/windows/storelogo.scale-100.png</code>, <code>res/windows/storelogo.scale-200.png</code>, etc.</p>
+<p>TODO Define what MRT is.</p>
-<p>The <code>target</code> attribute specifies the base name for resultant icons. For every icon file destination filename is calculated as <code>target + '.' + MRT_qualifiers + extension(src)</code>. For the icons to display properly in resultant app every <code>target</code> value should be the one of icon filenames, defined in application's <code>.appxmanifest</code> file.</p>
+<p>The <code>target</code> attribute specifies the base name for the resultant icons. For every icon file, its destination filename is calculated as <code>target + '.' + MRT_qualifiers + extension(src)</code>. For the icons to display properly in the application, every <code>target</code> value should be one of the icon filenames defined in the application's <code>.appxmanifest</code> file.</p>
-<p>Summarizing the above, using <code>target</code> attribute it is possible to:</p>
+<p>Summarizing the above... using the <code>target</code> attribute it is possible to:</p>
<ul>
-<li>define a group of icons for different device scale factors using single <code><icon ...></code> element, for example:
+<li>define a group of icons for different device scale factors using a single <code><icon ...></code> element, for example:
<code>xml
<icon src="res/Windows/AppListIcon.png" target="Square44x44Logo" />
</code>
@@ -2804,7 +2810,7 @@ which is equivalent to the following lin
<li>define icons with scale factors other than <code>scale-100</code> and <code>scale-240</code> (and any other MRT qualifiers)</li>
</ul>
-<p>Though it is not recommended but is still possible to define icons using <code>width</code> and <code>height</code> attributes:</p>
+<p>Although it is not recommended, it is also possible to define icons using the <code>width</code> and <code>height</code> attributes:</p>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><platform</span> <span class="na">name=</span><span class="s">"windows"</span><span class="nt">></span>
<span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/windows/logo.png"</span> <span class="na">width=</span><span class="s">"150"</span> <span class="na">height=</span><span class="s">"150"</span> <span class="nt">/></span>
<span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/windows/smalllogo.png"</span> <span class="na">width=</span><span class="s">"30"</span> <span class="na">height=</span><span class="s">"30"</span> <span class="nt">/></span>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org