You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/10/31 22:38:07 UTC
svn commit: r1537692 [2/2] - in /cordova/site/public/docs/en: 3.0.0/ 3.1.0/
edge/
Modified: cordova/site/public/docs/en/edge/cordova_notification_notification.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/cordova_notification_notification.md.html?rev=1537692&r1=1537691&r2=1537692&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/cordova_notification_notification.md.html (original)
+++ cordova/site/public/docs/en/edge/cordova_notification_notification.md.html Thu Oct 31 21:38:06 2013
@@ -132,7 +132,7 @@
<option value="notification.vibrate_quick_example">Â Â Â Â Â Â - Quick Example</option>
<option value="notification.vibrate_full_example">Â Â Â Â Â Â - Full Example</option>
<option value="notification.vibrate_ios_quirks">Â Â Â Â Â Â - iOS Quirks</option>
-<option value="notification.vibrate_bb10_quirks">Â Â Â Â Â Â - BB10 Quirks</option></select></small>
+<option value="notification.vibrate_blackberry_10_quirks">Â Â Â Â Â Â - BlackBerry 10 Quirks</option></select></small>
</div>
<div id="sidebar">
@@ -277,7 +277,7 @@ typically less customizable.</p>
<ul>
<li>Android</li>
-<li>BlackBerry WebWorks (OS 5.0 and higher)</li>
+<li>BlackBerry WebWorks 5.0+</li>
<li>iOS</li>
<li>Tizen</li>
<li>Windows Phone 7 and 8</li>
@@ -286,7 +286,7 @@ typically less customizable.</p>
<h2><a name="notification.alert_quick_example">Quick Example</a></h2>
-<pre class="prettyprint"><code>// Android / BlackBerry WebWorks (OS 5.0 and higher) / iOS / Tizen
+<pre class="prettyprint"><code>// Android / BlackBerry WebWorks 5.0+ / iOS / Tizen
//
function alertDismissed() {
// do something
@@ -390,7 +390,7 @@ indexing, so the value is <code>1</code>
<ul>
<li>Android</li>
-<li>BlackBerry WebWorks (OS 5.0 and higher)</li>
+<li>BlackBerry WebWorks 5.0+</li>
<li>iOS</li>
<li>Tizen</li>
<li>Windows Phone 7 and 8</li>
@@ -603,7 +603,7 @@ function showPrompt() {
<ul>
<li>Android</li>
-<li>BlackBerry WebWorks (OS 5.0 and higher)</li>
+<li>BlackBerry WebWorks 5.0+</li>
<li>iOS</li>
<li>Tizen</li>
<li>Windows Phone 7 and 8</li>
@@ -705,7 +705,7 @@ navigator.<a href="cordova_notification_
<ul>
<li>Android</li>
-<li>BlackBerry WebWorks (OS 5.0 and higher)</li>
+<li>BlackBerry WebWorks 5.0+</li>
<li>iOS</li>
<li>Windows Phone 7 and 8</li>
</ul>
@@ -781,7 +781,7 @@ navigator.<a href="cordova_notification_
</li>
</ul>
-<h2><a name="notification.vibrate_bb10_quirks">BB10 Quirks</a></h2>
+<h2><a name="notification.vibrate_blackberry_10_quirks">BlackBerry 10 Quirks</a></h2>
<p>vibrate function owned by navigator object</p>
Modified: cordova/site/public/docs/en/edge/guide_cli_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_cli_index.md.html?rev=1537692&r1=1537691&r2=1537692&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_cli_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_cli_index.md.html Thu Oct 31 21:38:06 2013
@@ -106,10 +106,9 @@
</option>
<option value="The%20Command-line%20Interface_add_plugin_features">Â Â Â Â Â Â - Add Plugin Features</option>
<option value="The%20Command-line%20Interface_advanced_plugin_options">Â Â Â Â Â Â - Advanced Plugin Options</option>
-<option value="The%20Command-line%20Interface_customize_each_platform">Â Â Â Â Â Â - Customize Each Platform</option>
+<option value="The%20Command-line%20Interface_using_merges_to_customize_each_platform">Â Â Â Â Â Â - Using merges to Customize Each Platform</option>
<option value="The%20Command-line%20Interface_help_commands">Â Â Â Â Â Â - Help Commands</option>
-<option value="The%20Command-line%20Interface_updating_the_app">Â Â Â Â Â Â - Updating the App</option>
-<option value="The%20Command-line%20Interface_updating_cordova">Â Â Â Â Â Â - Updating Cordova</option></select></small>
+<option value="The%20Command-line%20Interface_updating_cordova_and_your_project">Â Â Â Â Â Â - Updating Cordova and Your Project</option></select></small>
</div>
<div id="sidebar">
@@ -551,7 +550,7 @@ contains the <code>plugin.xml</code> fil
<pre class="prettyprint"><code> $ cordova plugin add ../my_plugin_dir
</code></pre>
-<h2><a name="The%20Command-line%20Interface_customize_each_platform">Customize Each Platform</a></h2>
+<h2><a name="The%20Command-line%20Interface_using_merges_to_customize_each_platform">Using merges to Customize Each Platform</a></h2>
<p>While Cordova allows you to easily deploy an app for many different
platforms, sometimes you need to add customizations. In that case,
@@ -599,36 +598,31 @@ button.</p>
<h2><a name="The%20Command-line%20Interface_help_commands">Help Commands</a></h2>
-<p>If at any point you get stuck, Cordova has a couple global "help" commands.</p>
-
-<p>The first, <code>help</code> will print out a list of all available actions that Cordova can do</p>
+<p>Cordova features a couple of global commands, which may help you if
+you get stuck or experience a problem. The <code>help</code> command displays
+all available Cordova commands and their syntax:</p>
<pre class="prettyprint"><code>$ cordova help
+$ cordova # same
</code></pre>
-<p>The second, <code>info</code> will print out useful information, such as installed platforms, node.js version, etc.., that are helpful for submitting bug reports and getting help. It will also create an info.txt file at the base of your project. <strong>Note: Currently iOS and Android platforms are output</strong></p>
+<p>The <code>info</code> command produces a listing of potentially useful details,
+such as currently installed platforms and plugins, SDK versions for
+each platform, and versions of the CLI and <code>node.js</code>:</p>
<pre class="prettyprint"><code>$ cordova info
</code></pre>
-<h2><a name="The%20Command-line%20Interface_updating_the_app">Updating the App</a></h2>
-
-<p>When a new version of Cordova is released, you should update your
-<code>cordova</code> utility by following the Updating Cordova section below.
-Once you have updated Cordova, you can update the Cordova resources that
-your project uses by typing:</p>
-
-<pre class="prettyprint"><code> $ cordova platform update <PLATFORM>
-</code></pre>
+<p>It both presents the information to screen and captures the output in
+a local <code>info.txt</code> file.</p>
-<p>This will replace the old cordova resources with new ones for the
-specified PLATFORM. You should do this for every platform that you
-are developing for. </p>
+<p><strong>NOTE:</strong> Currently, only details on iOS and Android platforms are
+available.</p>
-<h2><a name="The%20Command-line%20Interface_updating_cordova">Updating Cordova</a></h2>
+<h2><a name="The%20Command-line%20Interface_updating_cordova_and_your_project">Updating Cordova and Your Project</a></h2>
-<p>After installing the <code>cordova</code> utility, you can always
-update it to the latest version by running the following command:</p>
+<p>After installing the <code>cordova</code> utility, you can always update it to
+the latest version by running the following command:</p>
<pre class="prettyprint"><code> $ sudo npm update -g cordova
</code></pre>
@@ -638,7 +632,7 @@ update it to the latest version by runni
<pre class="prettyprint"><code> $ sudo npm install -g cordova@3.1.0
</code></pre>
-<p>Run <code>cordova -v</code> to see the currently running version. Run the <code>npm
+<p>Run <code>cordova -v</code> to see which version is currently running. Run the <code>npm
info</code> command for a longer listing that includes the current version
along with other available version numbers:</p>
@@ -654,6 +648,18 @@ in the <a href="guide_platforms_index.md
command-line interface and use <code>npm update</code> to stay current, the more
time-consuming procedures described there are no longer relevant.</p>
+<p>Cordova 3.0+ may still require various changes to
+project-level directory structures and other dependencies. After you
+run the <code>npm</code> command above to update Cordova itself, you may need to
+ensure your project's resources conform to the latest version's
+requirements. Run a command such as the following for each platform
+you're building:</p>
+
+<pre class="prettyprint"><code> $ cordova platform update android
+ $ cordova platform update ios
+ ...etc.
+</code></pre>
+
</div>
</div>
Modified: cordova/site/public/docs/en/edge/guide_platforms_android_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_android_index.md.html?rev=1537692&r1=1537691&r2=1537692&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_android_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_android_index.md.html Thu Oct 31 21:38:06 2013
@@ -212,7 +212,7 @@ this to make them available in the curre
<li><p>Click on the <strong>Start</strong> menu in the lower-left corner of the desktop,
right-click on <strong>Computer</strong>, then click <strong>Properties</strong>.</p></li>
<li><p>Click <strong>Advanced System Settings</strong> in the column on the left.</p></li>
-<li><p>In the resulting dialog box, press <strong>Environment <a href="plugin_ref_spec.md.html#Variables">Variables</a></strong>.</p></li>
+<li><p>In the resulting dialog box, press <strong>Environment Variables</strong>.</p></li>
<li><p>Select the <strong>PATH</strong> variable and press <strong>Edit</strong>.</p></li>
<li>
<p>Append the following to the PATH based on where you installed the
Modified: cordova/site/public/docs/en/edge/guide_platforms_blackberry10_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_blackberry10_index.md.html?rev=1537692&r1=1537691&r2=1537692&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_blackberry10_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_blackberry10_index.md.html Thu Oct 31 21:38:06 2013
@@ -174,7 +174,7 @@ system path.</p>
<p>On Windows:</p>
<ul>
-<li><p>Go to <strong>My Computer â Properties â Advanced â Environment <a href="plugin_ref_spec.md.html#Variables">Variables</a></strong>.</p></li>
+<li><p>Go to <strong>My Computer â Properties â Advanced â Environment Variables</strong>.</p></li>
<li>
<p>Append the Native SDK's install directory to the PATH, for example:</p>
Modified: cordova/site/public/docs/en/edge/guide_platforms_win8_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_win8_index.md.html?rev=1537692&r1=1537691&r2=1537692&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_win8_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_win8_index.md.html Thu Oct 31 21:38:06 2013
@@ -98,11 +98,10 @@
<div id="subheader">
<h1>Windows 8 Platform Guide</h1>
<small><select><option value="Windows%25208%2520Platform%2520Guide">Windows 8 Platform Guide</option>
-<option value="Windows%208%20Platform%20Guide_1_requirements">Â Â Â Â Â Â - 1. Requirements</option>
-<option value="Windows%208%20Platform%20Guide_2_install_sdk_cordova">Â Â Â Â Â Â - 2. Install SDK + Cordova</option>
-<option value="Windows%208%20Platform%20Guide_3_set_up_new_project">Â Â Â Â Â Â - 3. Set up New Project</option>
-<option value="Windows%208%20Platform%20Guide_5_test_the_project">Â Â Â Â Â Â - 5. Test the Project</option>
-<option value="Windows%208%20Platform%20Guide_done">Â Â Â Â Â Â - Done!</option></select></small>
+<option value="Windows%208%20Platform%20Guide_requirements">Â Â Â Â Â Â - Requirements</option>
+<option value="Windows%208%20Platform%20Guide_install_sdk_and_cordova">Â Â Â Â Â Â - Install SDK and Cordova</option>
+<option value="Windows%208%20Platform%20Guide_set_up_a_new_project">Â Â Â Â Â Â - Set up a New Project</option>
+<option value="Windows%208%20Platform%20Guide_test_the_project">Â Â Â Â Â Â - Test the Project</option></select></small>
</div>
<div id="sidebar">
@@ -164,23 +163,30 @@ Windows RT. MSDN now refers to this type
app, and this guide follows that convention. Also, in this guide
<em>Windows 8</em> signifies both Windows 8 and Windows RT.</p>
-<h2><a name="Windows%208%20Platform%20Guide_1_requirements">1. Requirements</a></h2>
+<h2><a name="Windows%208%20Platform%20Guide_requirements">Requirements</a></h2>
<ul>
<li><p>Windows 8</p></li>
<li><p>Visual Studio 2012 Professional or better, or Visual Studio 2012 Express for Windows 8</p></li>
</ul>
-<p>Follow the instructions <a class="external" href="http://www.windowsstore.com/">here</a> to submit your apps Windows Store.</p>
+<p>Follow the instructions at
+<a class="external" href="http://www.windowsstore.com/">windowsstore.com</a>
+to submit your app to Windows Store.</p>
+
+<h2><a name="Windows%208%20Platform%20Guide_install_sdk_and_cordova">Install SDK and Cordova</a></h2>
+
+<p>Set up your preferred variant of Visual Studio 2012. All of the
+product's paid versions (Professional, etc.) let you build Windows
+Store apps. You need <strong>Express for Windows 8</strong> to build Windows Store
+apps using the
+<a class="external" href="http://www.microsoft.com/visualstudio/eng/products/visual-studio-express-products">Express editions</a>.</p>
+
+<p>Download and extract the latest copy of
+<a class="external" href="http://phonegap.com/download">Cordova</a>.
+These instuctions apply to the <code>lib\windows-8</code> subdirectory.</p>
-<h2><a name="Windows%208%20Platform%20Guide_2_install_sdk_cordova">2. Install SDK + Cordova</a></h2>
-
-<ul>
-<li><p>Set up your preferred variant of Visual Studio 2012. All of the product's paid versions (Professional, etc.) let you build Windows Store apps. You need <strong>Express for Windows 8</strong> to build Windows Store apps using the <a class="external" href="http://www.microsoft.com/visualstudio/eng/products/visual-studio-express-products">Express editions</a>.</p></li>
-<li><p>Download and extract the latest copy of <a class="external" href="http://phonegap.com/download">Cordova</a>. You will be working in the <code>lib\windows-8</code> subdirectory.</p></li>
-</ul>
-
-<h2><a name="Windows%208%20Platform%20Guide_3_set_up_new_project">3. Set up New Project</a></h2>
+<h2><a name="Windows%208%20Platform%20Guide_set_up_a_new_project">Set up a New Project</a></h2>
<p>You can already build Windows 8 apps using the <em>HTML/JavaScript track</em>
available in Windows Store apps. Use Cordova in Windows Store apps to
@@ -189,70 +195,74 @@ expose the same APIs as on other Cordova
<ul>
<li><p>Open Visual Studio 2012 and choose <strong>New Project</strong>.</p></li>
<li>
-<p>Select <strong>Installed â Template â Other Languages â JavaScript â Windows Store</strong> from the tree, and then <strong>Blank App</strong> from the projects list. Enter whatever project name you like, such as <code>CordovaWin8Foo</code> as in this example.</p>
+<p>Select <strong>Installed â Template â Other Languages â
+JavaScript â Windows Store</strong> from the tree, and then <strong>Blank
+App</strong> from the projects list. Enter whatever project name you like,
+such as <code>CordovaWin8Foo</code> as in this example:</p>
<p><img src="img/guide/platforms/win8/wsnewproject.png" alt="" title=""></p>
</li>
<li>
-<p>Microsoft continues to use <code>default.html</code> as the default home page, but most web developers use <code>index.html</code>. (Plus it's likely that in the other platform variants of your project you are using <code>index.html</code> as the name of your default page.) To fix this, in Solution Explorer rename the <code>default.html</code> file to <code>index.html</code>. Then double-click the <code>package.appxmanifest</code> file and change the <strong>Start page</strong> value to <code>index.html</code>.</p>
+<p>Microsoft continues to use <code>default.html</code> as the default home page,
+but most web developers use <code>index.html</code>. It's a good idea to do so,
+at least to match other platforms you're likely working on. To fix
+this, in <strong>Solution Explorer</strong> rename the <code>default.html</code> file to
+<code>index.html</code>. Then double-click the <code>package.appxmanifest</code> file and
+change the <strong>Start page</strong> value to <code>index.html</code>:</p>
-<p><img src="img/guide/platforms/win8/wschangemanifest.png" alt="" title=""></p>
+<pre class="prettyprint"><code>
+</code></pre>
</li>
-<li><p>To include <code>cordova.js</code> in your project, right-click on the <code>js</code> directory in Solution Explorer and select <strong>Add â New Item</strong>. Locate the <code>cordova.js</code> file in the <code>lib\windows-8</code> directory noted above.</p></li>
-<li><p>Edit the code for <code>index.html</code>. Add a reference to <code>cordova.js</code>. You can do this manually, or by dragging the file from Solution Explorer.</p></li>
-</ul>
-
-<h3>Adding the reference...</h3>
+<li><p>To include <code>cordova.js</code> in your project, right-click on the <code>js</code>
+directory in <strong>Solution Explorer</strong> and select <strong>Add â New
+Item</strong>. Locate the <code>cordova.js</code> file in the <code>lib\windows-8</code>
+directory.</p></li>
+<li>
+<p>Edit the code for <code>index.html</code>. Add a reference to <code>cordova.js</code>. You
+can do this manually, or by dragging the file from <strong>Solution
+Explorer</strong>. Add the following other dependencies to the app's home page:</p>
<pre class="prettyprint"><code> <!-- WinJS references -->
<link href="//Microsoft.WinJS.1.0/css/ui-dark.css" rel="stylesheet" />
<script src="//Microsoft.WinJS.1.0/js/base.js"></script>
<script src="//Microsoft.WinJS.1.0/js/ui.js"></script>
- <!-- Cordova -->
- <script src="/js/cordova.js"></script>
- <!-- CordovaWin8Foo references -->
- <link href="/css/default.css" rel="stylesheet" />
- <script src="/js/default.js"></script>
-</code></pre>
+<pre class="prettyprint"><code>&lt;!-- Cordova --&gt;
+&lt;script src="/js/cordova.js"&gt;&lt;/script&gt;
-<ul>
-<li>Next, add some code that demonstrates Cordova is working.</li>
-</ul>
-<h3>Adding a '<a href="cordova_events_events.md.html#deviceready">deviceready</a>' handler...</h3>
+&lt;!-- CordovaWin8Foo references --&gt;
+&lt;link href="/css/default.css" rel="stylesheet" /&gt;
+&lt;script src="/js/default.js"&gt;&lt;/script&gt;
+</code></pre>
+
+</code></pre>
+</li>
+<li>
+<p>Add a <code><a href="cordova_events_events.md.html#deviceready">deviceready</a></code> handler to demonstrate Cordova is working:</p>
<pre class="prettyprint"><code><body>
<p>Content goes here</p>
-
<script type="text/javascript">
-
console.log("Subscribing...");
document.<a href="cordova_inappbrowser_inappbrowser.md.html#addEventListener">addEventListener</a>("<a href="cordova_events_events.md.html#deviceready">deviceready</a>", function () {
-
navigator.<a href="cordova_notification_notification.md.html#notification.alert">notification.alert</a>("The device is ready!");
-
});
-
</script>
-
</body>
</code></pre>
+</li>
+</ul>
-<h2><a name="Windows%208%20Platform%20Guide_5_test_the_project">5. Test the Project</a></h2>
+<h2><a name="Windows%208%20Platform%20Guide_test_the_project">Test the Project</a></h2>
-<ul>
-<li>
<p>Run the project from Visual Studio. You'll see the message box appear:</p>
-<p><img src="img/guide/platforms/win8/wsalert.png" alt="" title=""></p>
-</li>
-</ul>
-
-<h2><a name="Windows%208%20Platform%20Guide_done">Done!</a></h2>
+<pre class="prettyprint"><code> 
+</code></pre>
-<p>That's it! You're now ready to build Windows Store apps with Cordova.</p>
+<p>That's it. You're now ready to build Windows Store apps with Cordova.</p>
</div>
</div>
Modified: cordova/site/public/docs/en/edge/guide_platforms_wp7_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_wp7_index.md.html?rev=1537692&r1=1537691&r2=1537692&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_wp7_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_wp7_index.md.html Thu Oct 31 21:38:06 2013
@@ -98,13 +98,13 @@
<div id="subheader">
<h1>Windows Phone 7 Platform Guide</h1>
<small><select><option value="Windows%2520Phone%25207%2520Platform%2520Guide">Windows Phone 7 Platform Guide</option>
-<option value="Windows%20Phone%207%20Platform%20Guide_1_system_requirements">Â Â Â Â Â Â - 1. System Requirements</option>
-<option value="Windows%20Phone%207%20Platform%20Guide_2_install_sdk_cordova">Â Â Â Â Â Â - 2. Install SDK + Cordova</option>
-<option value="Windows%20Phone%207%20Platform%20Guide_2_1_building_the_template">Â Â Â Â Â Â - 2.1. Building the template</option>
-<option value="Windows%20Phone%207%20Platform%20Guide_3_set_up_new_project">Â Â Â Â Â Â - 3. Set up New Project</option>
-<option value="Windows%20Phone%207%20Platform%20Guide_4_review_the_project_structure">Â Â Â Â Â Â - 4. Review the project structure</option>
-<option value="Windows%20Phone%207%20Platform%20Guide_6_build_your_project_for_the_device">Â Â Â Â Â Â - 6. Build your project for the device</option>
-<option value="Windows%20Phone%207%20Platform%20Guide_done">Â Â Â Â Â Â - Done!</option></select></small>
+<option value="Windows%20Phone%207%20Platform%20Guide_system_requirements">Â Â Â Â Â Â - System Requirements</option>
+<option value="Windows%20Phone%207%20Platform%20Guide_install_sdk_and_cordova">Â Â Â Â Â Â - Install SDK and Cordova</option>
+<option value="Windows%20Phone%207%20Platform%20Guide_building_the_template">Â Â Â Â Â Â - Building the Template</option>
+<option value="Windows%20Phone%207%20Platform%20Guide_set_up_a_new_project">Â Â Â Â Â Â - Set up a New Project</option>
+<option value="Windows%20Phone%207%20Platform%20Guide_review_the_project_structure">Â Â Â Â Â Â - Review the Project Structure</option>
+<option value="Windows%20Phone%207%20Platform%20Guide_build_the_project_for_the_device">Â Â Â Â Â Â - Build the Project for the Device
+</option></select></small>
</div>
<div id="sidebar">
@@ -167,84 +167,101 @@ applies to both versions:</p>
See <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a> for information about the
current interface.</p>
-<h2><a name="Windows%20Phone%207%20Platform%20Guide_1_system_requirements">1. System Requirements</a></h2>
+<h2><a name="Windows%20Phone%207%20Platform%20Guide_system_requirements">System Requirements</a></h2>
-<ul>
-<li>
-<p>Operating System:</p>
+<p>Use Windows 7 or Windows 8 (Pro) or Windows Vista with SP2. The
+64-bit version (x64) of Windows is required for the SDK. The Pro
+version is recommended for running a device emulator.</p>
-<ul>
-<li>Windows 7 or Windows 8 (Pro) or Windows Vista with SP2
-<ul>
-<li>The 64-bit version (x64) of Windows is required for the SDK.</li>
-<li>The Pro version is recommended for running a device emulator.</li>
-</ul>
-</li>
-</ul>
-</li>
-<li><p>Register and pay for a <a class="external" href="http://dev.windowsphone.com/en-us/publish">Windows Phone Dev Center</a> account if you want to install your app on a real device or submit it to Market Place.</p></li>
-</ul>
+<p>Register and pay for a <a class="external" href="http://dev.windowsphone.com/en-us/publish">Windows Phone Dev
+Center</a> account if you want
+to install an app on a real device or submit it to Market Place.</p>
-<p><strong>NOTE:</strong> Running the SDK in Virtual Machine might present some challenges. You can read this blog post that gives insight on the solutions to develop for <a class="external" href="http://aka.ms/BuildaWP8apponaMac">Windows Phone on a Mac</a>.</p>
+<p><strong>NOTE:</strong> Running the SDK in Virtual Machine may present challenges.
+Read <a class="external" href="http://aka.ms/BuildaWP8apponaMac">Windows Phone on a Mac</a> for
+insights on developing solutions.</p>
-<h2><a name="Windows%20Phone%207%20Platform%20Guide_2_install_sdk_cordova">2. Install SDK + Cordova</a></h2>
+<h2><a name="Windows%20Phone%207%20Platform%20Guide_install_sdk_and_cordova">Install SDK and Cordova</a></h2>
-<ul>
-<li><p>Download and install the <a class="external" href="http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=27570/">Windows Phone SDK</a></p></li>
-<li><p>Download and extract the latest copy of <a class="external" href="http://phonegap.com/download">Cordova</a>. You will be working in the <code>lib\windows-phone-8\wp7</code> subdirectory, <code>lib\windows-phone-8\wp8</code> contains the Windwos Phone 8 version of Cordova.</p></li>
-<li><p>Copy the <code>CordovaWP7_x_x_x.zip</code> file to the <code>\My Documents\Visual Studio 2012\Templates\ProjectTemplates\</code> directory.</p></li>
-</ul>
+<p>Download and install the <a class="external" href="http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=27570/">Windows Phone
+SDK</a>.</p>
-<h2><a name="Windows%20Phone%207%20Platform%20Guide_2_1_building_the_template">2.1. Building the template</a></h2>
+<p>Download and extract the latest copy of
+<a class="external" href="http://phonegap.com/download">Cordova</a>. You will be working in the
+<code>lib\windows-phone-8\wp7</code> subdirectory, <code>lib\windows-phone-8\wp8</code>
+contains the Windwos Phone 8 version of Cordova.</p>
-<p><strong>NOTE:</strong> this step may not be required. If the lib\windows-phone directory already contains a file CordovaWP7<em>x</em>x_x.zip then you may skip this step.</p>
+<p>Copy the <code>CordovaWP7_x_x_x.zip</code> file to the <code>\My Documents\Visual
+Studio 2012\Templates\ProjectTemplates\</code> directory.</p>
-<p>In order to simplify the development process, Cordova comes with a script to build Visual Studio templates. This allows for rapid creation of Cordova applications inside Visual Studio. This template can be modified if needed and the below steps indicate how to proceed if you want to generate the template.</p>
+<h2><a name="Windows%20Phone%207%20Platform%20Guide_building_the_template">Building the Template</a></h2>
-<h3>Run the batch file to create and install the templates.</h3>
+<p><strong>NOTE:</strong> Skip this step if the <code>lib\windows-phone</code> directory already
+contains a <code>CordovaWP7_x_x_x.zip</code> file.</p>
-<ul>
-<li><p>The root of the repo contains a file createTemplates.bat. Double clicking this file will generate 2 .zip files. (CordovaWP7<em>x</em>x<em>x.zip + CordovaWP8</em>x<em>x</em>x.zip where x.x.x is the current version number) To easily use these files in Visual Studio, copy them to
-"My Documents\Visual Studio 2012\Templates\ProjectTemplates\" You will then be able to create new Apache Cordova Windows Phone apps from the Visual Studio <a href="cordova_file_file.md.html#File">File</a>->New Project menu.</p></li>
-<li><p>If you run the batch file from the command line, you can also call with a parameter to install automatically</p></li>
-</ul>
+<p>To simplify development, Cordova bundles a script to build Visual
+Studio templates. These allow you to rapidly generate Cordova apps,
+and you can modify them if necessary. The steps below <a href="cordova_inappbrowser_inappbrowser.md.html#show">show</a> how to
+generate it.</p>
+
+<h3>Run the Batch <a href="cordova_file_file.md.html#File">File</a> to Create and Install the Templates</h3>
+
+<p>The root of the repo contains a <code>createTemplates.bat</code> file.
+Double-clicking this file generates two <code>.zip</code> files:
+<code>CordovaWP7_x_x_x.zip</code> and <code>CordovaWP8_x_x_x.zip</code>, where <em>x.x.x</em> is
+the current version number. To use these files easily in Visual
+Studio, copy them to the <code>My Documents\Visual Studio
+2012\Templates\ProjectTemplates\</code> subdirectory. You are then able to
+create new <strong>Apache Cordova Windows Phone_ apps from Visual Studio's
+__File â New Project</strong> menu.</p>
-<p>Run the script :</p>
+<p>If you run the batch file from the command line, you can also call
+with a parameter to install automatically:</p>
-<pre class="prettyprint"><code>>createTemplates.bat -install
+<pre class="prettyprint"><code> >createTemplates.bat -install
</code></pre>
-<h2><a name="Windows%20Phone%207%20Platform%20Guide_3_set_up_new_project">3. Set up New Project</a></h2>
+<h2><a name="Windows%20Phone%207%20Platform%20Guide_set_up_a_new_project">Set up a New Project</a></h2>
<ul>
-<li><p>Open Visual Studio Express for Windows Phone and choose <strong>New Project</strong>.</p></li>
-<li><p>Select <strong>CordovaWP7</strong>. (The version number is displayed in the template description.)</p></li>
+<li><p>Open Visual Studio Express for Windows Phone and choose <strong>New
+Project</strong>.</p></li>
+<li><p>Select <strong>CordovaWP7</strong>. The version number displays in the template
+description.</p></li>
<li><p>Give the project a name, and select <strong>OK</strong>.</p></li>
</ul>
-<h2><a name="Windows%20Phone%207%20Platform%20Guide_4_review_the_project_structure">4. Review the project structure</a></h2>
+<h2><a name="Windows%20Phone%207%20Platform%20Guide_review_the_project_structure">Review the Project Structure</a></h2>
-<ul>
-<li><p>The <code>www</code> directory contains your Cordova <code>html/js/css</code> and any other resources included in your app.</p></li>
-<li><p>Any content that you add here needs to be a part of the Visual Studio project, and it must be set as content.</p></li>
-<li><p>Note: This screen capture was from the wp8 cordova-2.3.0 download, your listing will vary based on the actual version installed.</p></li>
-</ul>
+<p>The <code>www</code> directory features <code>html</code>, <code>js</code>, and <code>css</code> subdirectories
+and any other resources your app requires.
+Any additional content needs to be a part of the Visual Studio
+project, and it must be set as content.</p>
+
+<p>The following sample structure represents a 2.3.0 project, but may
+vary depending on installed version:</p>
<p><img src="img/guide/platforms/wp8/projectStructure.png" alt="" title=""></p>
-<h2><a name="Windows%20Phone%207%20Platform%20Guide_6_build_your_project_for_the_device">6. Build your project for the device</a></h2>
+<h2><a name="Windows%20Phone%207%20Platform%20Guide_build_the_project_for_the_device">Build the Project for the Device
+</a></h2>
-<p>In order to test your application on a device, the device must be registered. Click <a class="external" href="http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx">here</a> to read documentation on deploying and testing on your Windows Phone 7.</p>
+<p>Before testing your application on a device, the device must be
+registered. Consult
+[Microsoft's documentation][http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx]
+for details on how to deploy and test on Windows Phone 7. These are
+the basic steps:</p>
<ul>
<li><p>Make sure your phone is connected, and the screen is unlocked.</p></li>
-<li><p>In Visual Studio, select '<a href="cordova_device_device.md.html#Device">Device</a>' from the top drop-down menu.</p></li>
-<li><p>Press the green <strong>play</strong> button next to the main drop-down menu to start debugging, or type <strong>F5</strong>.</p></li>
+<li><p>In Visual Studio, select <strong><a href="cordova_device_device.md.html#Device">Device</a></strong> from the drop-down menu at the top.</p></li>
+<li><p>Press the green <strong>play</strong> button next to the main drop-down menu to
+start debugging, or else type <strong>F5</strong>.</p></li>
</ul>
<p><img src="img/guide/platforms/wp7/wpd.png" alt="" title=""></p>
-<h2><a name="Windows%20Phone%207%20Platform%20Guide_done">Done!</a></h2>
+<p>At this point, you're done.</p>
</div>
</div>
Modified: cordova/site/public/docs/en/edge/guide_platforms_wp8_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_wp8_index.md.html?rev=1537692&r1=1537691&r2=1537692&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_wp8_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_wp8_index.md.html Thu Oct 31 21:38:06 2013
@@ -98,14 +98,14 @@
<div id="subheader">
<h1>Windows Phone 8 Platform Guide</h1>
<small><select><option value="Windows%2520Phone%25208%2520Platform%2520Guide">Windows Phone 8 Platform Guide</option>
-<option value="Windows%20Phone%208%20Platform%20Guide_1_system_requirements">Â Â Â Â Â Â - 1. System Requirements</option>
-<option value="Windows%20Phone%208%20Platform%20Guide_2_install_sdk_cordova">Â Â Â Â Â Â - 2. Install SDK + Cordova</option>
-<option value="Windows%20Phone%208%20Platform%20Guide_2_1_building_the_template">Â Â Â Â Â Â - 2.1. Building the template</option>
-<option value="Windows%20Phone%208%20Platform%20Guide_3_set_up_new_project">Â Â Â Â Â Â - 3. Set up New Project</option>
-<option value="Windows%20Phone%208%20Platform%20Guide_4_review_the_project_structure">Â Â Â Â Â Â - 4. Review the project structure</option>
-<option value="Windows%20Phone%208%20Platform%20Guide_5_build_and_deploy_to_emulator">Â Â Â Â Â Â - 5. Build and Deploy to Emulator</option>
-<option value="Windows%20Phone%208%20Platform%20Guide_6_build_your_project_for_the_device">Â Â Â Â Â Â - 6. Build your project for the device</option>
-<option value="Windows%20Phone%208%20Platform%20Guide_done">Â Â Â Â Â Â - Done!</option>
+<option value="Windows%20Phone%208%20Platform%20Guide_system_requirements">Â Â Â Â Â Â - System Requirements</option>
+<option value="Windows%20Phone%208%20Platform%20Guide_install_sdk_and_cordova">Â Â Â Â Â Â - Install SDK and Cordova</option>
+<option value="Windows%20Phone%208%20Platform%20Guide_building_the_template">Â Â Â Â Â Â - Building the Template</option>
+<option value="Windows%20Phone%208%20Platform%20Guide_set_up_a_new_project">Â Â Â Â Â Â - Set up a New Project</option>
+<option value="Windows%20Phone%208%20Platform%20Guide_review_the_project_structure">Â Â Â Â Â Â - Review the Project Structure</option>
+<option value="Windows%20Phone%208%20Platform%20Guide_build_and_deploy_to_emulator">Â Â Â Â Â Â - Build and Deploy to Emulator</option>
+<option value="Windows%20Phone%208%20Platform%20Guide_build_the_project_for_the_device">Â Â Â Â Â Â - Build the Project for the Device
+</option>
<option value="Windows%20Phone%208%20Platform%20Guide_further_reading">Â Â Â Â Â Â - Further Reading</option></select></small>
</div>
@@ -152,11 +152,11 @@
<p>This guide shows how to set up your SDK development environment to
deploy Cordova apps for Windows Phone 8 devices. If you want to target
-both 7.5 and 8 devices, develope for Windows Phone 7 instead as
+both 7.5 and 8 devices, develop for Windows Phone 7 instead as
detailed in the <a href="guide_platforms_wp7_index.md.html#Windows%20Phone%207%20Platform%20Guide">Windows Phone 7 Platform Guide</a>. Version 7 does not
-have all the advanced features included in IE10, but implements the
-same set of APIs. Windows Phone 8 apps do <em>not</em> run on Windows Phone 7
-devices.</p>
+have all the advanced features included in Internet Explorer 10, but
+implements the same set of APIs. Windows Phone 8 apps do <em>not</em> run on
+Windows Phone 7 devices.</p>
<p>See the following for more detailed platform-specific information that
applies to both versions:</p>
@@ -171,7 +171,7 @@ applies to both versions:</p>
See <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a> for information about the
current interface.</p>
-<h2><a name="Windows%20Phone%208%20Platform%20Guide_1_system_requirements">1. System Requirements</a></h2>
+<h2><a name="Windows%20Phone%208%20Platform%20Guide_system_requirements">System Requirements</a></h2>
<ul>
<li>
@@ -211,7 +211,7 @@ current interface.</p>
</ul>
</li>
<li>
-<p>SDK + IDE (Visual Studio)</p>
+<p>SDK and IDE (Visual Studio)</p>
<ul>
<li>Visual Studio 2012 Professional, Premium, or Ultimate. Note that Visual Studio Express for Windows Phone (included in the SDK) is not recommended because you can not build the template (see below) with VS Express, as it does not have the <strong>Export Template</strong> functionality, which is only in VS Pro or higher.</li>
@@ -222,79 +222,103 @@ current interface.</p>
<p><strong>NOTE:</strong> Running the SDK in Virtual Machine might present some challenges. You can read this blog post that gives insight on the solutions to develop for <a class="external" href="http://aka.ms/BuildaWP8apponaMac">Windows Phone on a Mac</a>.</p>
-<h2><a name="Windows%20Phone%208%20Platform%20Guide_2_install_sdk_cordova">2. Install SDK + Cordova</a></h2>
+<h2><a name="Windows%20Phone%208%20Platform%20Guide_install_sdk_and_cordova">Install SDK and Cordova</a></h2>
-<ul>
-<li><p>Download and install <a class="external" href="http://www.microsoft.com/en-us/download/details.aspx?id=35471">Windows Phone SDK</a></p></li>
-<li><p>Download and extract the latest copy of <a class="external" href="http://phonegap.com/download">Cordova</a>. You will be working in the <code>lib\windows-phone-8\wp8</code> subdirectory, <code>lib\windows-phone-8\wp7</code> contains the Windwos Phone 7 version of Cordova.</p></li>
-<li><p>Copy the <code>CordovaWP8_x_x_x.zip</code> file to the <code>\My Documents\Visual Studio 2012\Templates\ProjectTemplates\</code> directory.</p></li>
-</ul>
+<p>Download and install <a class="external" href="http://www.microsoft.com/en-us/download/details.aspx?id=35471">Windows Phone
+SDK</a>.</p>
-<h2><a name="Windows%20Phone%208%20Platform%20Guide_2_1_building_the_template">2.1. Building the template</a></h2>
+<p>Download and extract the latest copy of
+<a class="external" href="http://phonegap.com/download">Cordova</a>. The <code>lib\windows-phone-8\wp8</code>
+subdirectory is where you will do your work.</p>
-<p><strong>NOTE:</strong> this step may not be required. If the lib\windows-phone directory already contains a file CordovaWP8<em>x</em>x_x.zip then you may skip this step.</p>
+<p>Copy the <code>CordovaWP8_x_x_x.zip</code> file to the <code>\My Documents\Visual
+Studio 2012\Templates\ProjectTemplates\</code> directory.</p>
-<p>In order to simplify the development process, Cordova comes with a script to build Visual Studio templates. This allows for rapid creation of Cordova applications inside Visual Studio. This template can be modified if needed and the below steps indicate how to proceed if you want to generate the template.</p>
+<h2><a name="Windows%20Phone%208%20Platform%20Guide_building_the_template">Building the Template</a></h2>
-<h3>Run the batch file to create and install the templates.</h3>
+<p><strong>NOTE:</strong> Skip this step if the <code>lib\windows-phone</code> directory already
+contains a <code>CordovaWP8_x_x_x.zip</code> file.</p>
-<ul>
-<li><p>The root of the repo contains a file createTemplates.bat. Double clicking this file will generate 2 .zip files. (CordovaWP7<em>x</em>x<em>x.zip + CordovaWP8</em>x<em>x</em>x.zip where x.x.x is the current version number) To easily use these files in Visual Studio, copy them to
-"My Documents\Visual Studio 2012\Templates\ProjectTemplates\" You will then be able to create new Apache Cordova Windows Phone apps from the Visual Studio <a href="cordova_file_file.md.html#File">File</a>->New Project menu.</p></li>
-<li><p>If you run the batch file from the command line, you can also call with a parameter to install automatically</p></li>
-</ul>
+<p>To simplify development, Cordova bundles a script to build Visual
+Studio templates. These allow you to rapidly generate Cordova apps,
+and you can modify them if necessary. The steps below <a href="cordova_inappbrowser_inappbrowser.md.html#show">show</a> how to
+generate it.</p>
-<p>Run the script :</p>
+<h3>Run the Batch <a href="cordova_file_file.md.html#File">File</a> to Create and Install the Templates</h3>
-<pre class="prettyprint"><code>>createTemplates.bat -install
+<p>The repo's root directory contains a <code>createTemplates.bat</code> file.
+Double-click this to generate two <code>.zip</code> files: <code>CordovaWP7_x_x_x.zip</code>
+and <code>CordovaWP8_x_x_x.zip</code>, where <em>x.x.x</em> is the current version
+number. To use these files easily in Visual Studio, copy them to <code>My
+Documents\Visual Studio 2012\Templates\ProjectTemplates\</code>. You are
+then able to create new Apache Cordova Windows Phone apps from the
+<strong>Visual Studio <a href="cordova_file_file.md.html#File">File</a> â New Project</strong> menu.</p>
+
+<p>If you run the batch file from the command line, you can also call it
+with a parameter to install automatically:</p>
+
+<pre class="prettyprint"><code> >createTemplates.bat -install
</code></pre>
-<h2><a name="Windows%20Phone%208%20Platform%20Guide_3_set_up_new_project">3. Set up New Project</a></h2>
+<h2><a name="Windows%20Phone%208%20Platform%20Guide_set_up_a_new_project">Set up a New Project</a></h2>
-<ul>
-<li><p>Open Visual Studio Express for Windows Phone and choose <strong>New Project</strong>.</p></li>
-<li><p>Select <strong>CordovaWP8</strong>. (The version number is displayed in the template description.)</p></li>
-<li><p>Give the project a name, and select <strong>OK</strong>.</p></li>
-</ul>
+<p>Open Visual Studio Express for Windows Phone and choose <strong>New
+Project</strong>.</p>
+
+<p>Select <strong>CordovaWP8</strong>. The version number is displayed in the
+template description.</p>
+
+<p>Give the project a name, and select <strong>OK</strong>.</p>
<p><img src="img/guide/platforms/wp8/StandAloneTemplate.png" alt="" title=""></p>
-<h2><a name="Windows%20Phone%208%20Platform%20Guide_4_review_the_project_structure">4. Review the project structure</a></h2>
+<h2><a name="Windows%20Phone%208%20Platform%20Guide_review_the_project_structure">Review the Project Structure</a></h2>
-<ul>
-<li><p>The <code>www</code> directory contains your Cordova <code>html/js/css</code> and any other resources included in your app.</p></li>
-<li><p>Any content that you add here needs to be a part of the Visual Studio project, and it must be set as content.</p></li>
-<li><p>Note: This screen capture was from the cordova-2.3.0 download, your listing will vary based on the actual version installed.</p></li>
-</ul>
+<p>The <code>www</code> directory features <code>html</code>, <code>js</code>, and <code>css</code> subdirectories
+and any other resources your app requires.
+Any additional content needs to be a part of the Visual Studio
+project, and it must be set as content.</p>
+
+<p>The following sample structure represents a 2.3.0 project, but may
+vary depending on the installed version:</p>
<p><img src="img/guide/platforms/wp8/projectStructure.png" alt="" title=""></p>
-<h2><a name="Windows%20Phone%208%20Platform%20Guide_5_build_and_deploy_to_emulator">5. Build and Deploy to Emulator</a></h2>
+<h2><a name="Windows%20Phone%208%20Platform%20Guide_build_and_deploy_to_emulator">Build and Deploy to Emulator</a></h2>
-<ul>
-<li><p>Make sure <strong>Windows Phone Emulator</strong> is selected in the main drop-down menu.</p></li>
-<li><p>Press the green <strong>play</strong> button next to the drop-down menu to start debugging, or type <strong>F5</strong>.</p></li>
-</ul>
+<p>Make sure <strong>Windows Phone Emulator</strong> is selected in the main drop-down menu.</p>
+
+<p>Then press the green <strong>play</strong> button next to the drop-down menu to
+start debugging, or type <strong>F5</strong>.</p>
<p><img src="img/guide/platforms/wp8/BuildEmulator.png" alt="" title=""></p>
-<h2><a name="Windows%20Phone%208%20Platform%20Guide_6_build_your_project_for_the_device">6. Build your project for the device</a></h2>
+<h2><a name="Windows%20Phone%208%20Platform%20Guide_build_the_project_for_the_device">Build the Project for the Device
+</a></h2>
-<p>In order to test your application on a device, the device must be registered. Click <a class="external" href="http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx">here</a> to read documentation on deploying and testing on your Windows Phone 8.</p>
+<p>Before testing your application on a device, the device must be
+registered. Consult
+[Microsoft's documentation][http://msdn.microsoft.com/en-us/library/windowsphone/develop/ff402565(v=vs.105).aspx]
+for details on how to deploy and test on Windows Phone 8. These are
+the basic steps:</p>
<ul>
<li><p>Make sure your phone is connected, and the screen is unlocked.</p></li>
-<li><p>In Visual Studio, select '<a href="cordova_device_device.md.html#Device">Device</a>' from the top drop-down menu.</p></li>
-<li><p>Press the green <strong>play</strong> button next to the main drop-down menu to start debugging, or type <strong>F5</strong>.</p></li>
+<li><p>In Visual Studio, select <strong><a href="cordova_device_device.md.html#Device">Device</a></strong> from the drop-down menu at the top.</p></li>
+<li><p>Press the green <strong>play</strong> button next to the main drop-down menu to
+start debugging, or else type <strong>F5</strong>.</p></li>
</ul>
<p><img src="img/guide/platforms/wp7/wpd.png" alt="" title=""></p>
-<h2><a name="Windows%20Phone%208%20Platform%20Guide_done">Done!</a></h2>
+<p>At this point, you're done.</p>
<h2><a name="Windows%20Phone%208%20Platform%20Guide_further_reading">Further Reading</a></h2>
-<p>For more details on the specific differences between IE10 and WebKit browsers, and how to support both MS has a helpful <a class="external" href="http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx">guide here</a></p>
+<p>The Windows Phone Developer Blog provides
+<a class="external" href="http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx">helpful details</a>
+on differences between IE10 and WebKit browsers, and how to support
+both.</p>
</div>
</div>
Modified: cordova/site/public/docs/en/edge/plugin_ref_spec.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/plugin_ref_spec.md.html?rev=1537692&r1=1537691&r2=1537692&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/plugin_ref_spec.md.html (original)
+++ cordova/site/public/docs/en/edge/plugin_ref_spec.md.html Thu Oct 31 21:38:06 2013
@@ -99,36 +99,43 @@
<h1>Plugin Specification</h1>
<small><select><option value="Plugin%2520Specification">Plugin Specification</option>
<option value="Plugin%20Specification_plugin_element">Â Â Â Â Â Â -
-<plugin> element</option>
+plugin Element</option>
<option value="Plugin%20Specification_engines_and_engine_elements">Â Â Â Â Â Â -
-<engines> and <engine> elements</option>
+engines and engine Elements</option>
<option value="Plugin%20Specification_name_element">Â Â Â Â Â Â -
-<name> element</option>
+name Element</option>
<option value="Plugin%20Specification_description_element">Â Â Â Â Â Â -
-<description> element</option>
+description Element</option>
<option value="Plugin%20Specification_author_element">Â Â Â Â Â Â -
-<author> element</option>
+author Element</option>
<option value="Plugin%20Specification_keywords_element">Â Â Â Â Â Â -
-<keywords> element</option>
+keywords Element</option>
<option value="Plugin%20Specification_license_element">Â Â Â Â Â Â -
-<license> element</option>
+license Element</option>
<option value="Plugin%20Specification_asset_element">Â Â Â Â Â Â -
-<asset> element</option>
+asset Element</option>
<option value="Plugin%20Specification_js_module_element">Â Â Â Â Â Â -
-<js-module> element</option>
-<option value="Plugin%20Specification_dependency">Â Â Â Â Â Â - <dependency></option>
-<option value="Plugin%20Specification_platform">Â Â Â Â Â Â - <platform></option>
-<option value="Plugin%20Specification_source_file">Â Â Â Â Â Â - <source-file></option>
-<option value="Plugin%20Specification_config_file">Â Â Â Â Â Â - <config-file></option>
-<option value="Plugin%20Specification_plugins_plist">Â Â Â Â Â Â - <plugins-plist></option>
-<option value="Plugin%20Specification_resource_file_and_header_file">Â Â Â Â Â Â -
-<resource-file> and <header-file>
-</option>
-<option value="Plugin%20Specification_lib_file">Â Â Â Â Â Â - <lib-file></option>
-<option value="Plugin%20Specification_framework">Â Â Â Â Â Â - <framework></option>
-<option value="Plugin%20Specification_info">Â Â Â Â Â Â - <info></option>
-<option value="Variables">Variables</option>
-<option value="Variables_package_name">Â Â Â Â Â Â - $PACKAGE_NAME</option></select></small>
+js-module Element</option>
+<option value="Plugin%20Specification_dependency_element">Â Â Â Â Â Â -
+dependency element</option>
+<option value="Plugin%20Specification_platform_element">Â Â Â Â Â Â -
+platform Element</option>
+<option value="Plugin%20Specification_source_file_element">Â Â Â Â Â Â -
+source-file Element</option>
+<option value="Plugin%20Specification_config_file_element">Â Â Â Â Â Â -
+config-file Element</option>
+<option value="Plugin%20Specification_plugins_plist_element">Â Â Â Â Â Â -
+plugins-plist Element</option>
+<option value="Plugin%20Specification_resource_file_and_header_file_elements">Â Â Â Â Â Â -
+resource-file and header-file Elements</option>
+<option value="Plugin%20Specification_lib_file_element">Â Â Â Â Â Â -
+lib-file Element</option>
+<option value="Plugin%20Specification_framework_element">Â Â Â Â Â Â -
+framework Element</option>
+<option value="Plugin%20Specification_info_element">Â Â Â Â Â Â -
+info Element</option>
+<option value="Plugin%20Specification_variables">Â Â Â Â Â Â - Variables</option>
+<option value="Plugin%20Specification_package_name">Â Â Â Â Â Â - $PACKAGE_NAME</option></select></small>
</div>
<div id="sidebar">
@@ -187,7 +194,7 @@ structure of the plugin.</p>
</code></pre>
<h2><a name="Plugin%20Specification_plugin_element">
-<plugin> element</a></h2>
+plugin Element</a></h2>
<p>The <code>plugin</code> element is the plugin manifest's top-level element. It
features the following attributes:</p>
@@ -212,7 +219,7 @@ major-minor-patch style regular expressi
</ul>
<h2><a name="Plugin%20Specification_engines_and_engine_elements">
-<engines> and <engine> elements</a></h2>
+engines and engine Elements</a></h2>
<p>The child elements of the <code><engines></code> element specify versions of
Apache Cordova-based frameworks that this plugin supports. An example:</p>
@@ -242,10 +249,10 @@ example:</p>
</engines>
</code></pre>
-<p>The '<engine>' tags also has default support for all of the main platforms Cordova exists on.
-Specifying the 'cordova' engine tag means that all versions of Cordova on any platform must
+<p>The <code><engine></code> tags also has default support for all of the main platforms Cordova exists on.
+Specifying the <code>cordova</code> engine tag means that all versions of Cordova on any platform must
satisfy the engine version attribute. You may also list specific platforms and their versions
-in order to override the catch-all 'cordova' engine:</engine></p>
+in order to override the catch-all <code>cordova</code> engine:</p>
<pre class="prettyprint"><code><engines>
<engine name="cordova" version=">=1.7.0" />
@@ -254,20 +261,22 @@ in order to override the catch-all 'cord
</engines>
</code></pre>
-<p>Here's a list of the default engines that the '<engine>' tag supports:
-* 'cordova'
-* 'cordova-plugman'
-* 'cordova-android'
-* 'cordova-ios'
-* 'cordova-blackberry10'
-* 'cordova-wp7'
-* 'cordova-wp8'
-* 'cordova-windows8' <br>
-* 'android-sdk' // returns the highest Android api level installed
-* 'apple-xcode' // returns the xcode version
-* 'apple-ios' // returns the highest iOS version installed
-* 'apple-osx' // returns the OSX version
-* 'blackberry-ndk' // returns the native blackberry SDK version</engine></p>
+<p>Here's a list of the default engines that the <code><engine></code> tag supports:
+* <code>cordova</code>
+* <code>cordova-plugman</code>
+* <code>cordova-android</code>
+* <code>cordova-ios</code>
+* <code>cordova-blackberry10</code>
+* <code>cordova-wp7</code>
+* <code>cordova-wp8</code>
+* <code>cordova-windows8</code> <br>
+* <code>android-sdk</code> // returns the highest Android api level installed
+* <code>apple-xcode</code> // returns the xcode version
+* <code>apple-ios</code> // returns the highest iOS version installed
+* <code>apple-osx</code> // returns the OSX version
+* <code>blackberry-ndk</code> // returns the native blackberry SDK version
+* <code>windows-os</code> // returns the Windows OS version
+* <code>windows-sdk</code> // returns the MSBuild version</p>
<p>Specifying custom Apache Cordova-based frameworks should be listed under the engine tag like so:</p>
@@ -279,16 +288,16 @@ in order to override the catch-all 'cord
</code></pre>
<p>A custom Apache Cordova-based framework requires that an engine element includes the following attributes:
-'name', 'version', 'scriptSrc', and 'platform'. </p>
+<code>name</code>, <code>version</code>, <code>scriptSrc</code>, and <code>platform</code>. </p>
<ul>
<li><p><code>name</code> (required): A human-readable name for your custom framework. </p></li>
<li><p><code>version</code> (required): The version that your framework must have in order to install.</p></li>
<li><p><code>scriptSrc</code> (required): The script file that tells plugman what version of the custom framework is.
Ideally, this file should be within the top level directory of your plugin directory.</p></li>
-<li><p><code>platform</code> (required): Which platforms that your framework supports. You may use the wildcard '*'
-to say supported for all platforms, specify multiple with a pipe character like 'android|ios|blackberry10'
-or just a single platform like 'android'.</p></li>
+<li><p><code>platform</code> (required): Which platforms that your framework supports. You may use the wildcard <code>*</code>
+to say supported for all platforms, specify multiple with a pipe character like <code>android|ios|blackberry10</code>
+or just a single platform like <code>android</code>.</p></li>
</ul>
<p>plugman aborts with a non-zero code for any plugin whose target
@@ -298,7 +307,7 @@ project does not meet the engine's const
the specified cordova project directory blindly.</p>
<h2><a name="Plugin%20Specification_name_element">
-<name> element</a></h2>
+name Element</a></h2>
<p>A human-readable name for the plugin, whose text content contains the
name of the plugin. For example:</p>
@@ -309,7 +318,7 @@ name of the plugin. For example:</p>
<p>This element does not (yet) handle localization.</p>
<h2><a name="Plugin%20Specification_description_element">
-<description> element</a></h2>
+description Element</a></h2>
<p>A human-readable description for the plugin. The text content of the element contains
the description of the plugin. An example:</p>
@@ -320,7 +329,7 @@ the description of the plugin. An exampl
<p>This element does not (yet) handle localization.</p>
<h2><a name="Plugin%20Specification_author_element">
-<author> element</a></h2>
+author Element</a></h2>
<p>Plugin author name. The text content of the element contains
the name of the plugin author. An example:</p>
@@ -329,7 +338,7 @@ the name of the plugin author. An exampl
</code></pre>
<h2><a name="Plugin%20Specification_keywords_element">
-<keywords> element</a></h2>
+keywords Element</a></h2>
<p>Plugin keywords. The text content of the element contains comma separated keywords to describe the plugin. An example:</p>
@@ -337,7 +346,7 @@ the name of the plugin author. An exampl
</code></pre>
<h2><a name="Plugin%20Specification_license_element">
-<license> element</a></h2>
+license Element</a></h2>
<p>Plugin license. The text content of the element contains the plugin license. An example:</p>
@@ -345,7 +354,7 @@ the name of the plugin author. An exampl
</code></pre>
<h2><a name="Plugin%20Specification_asset_element">
-<asset> element</a></h2>
+asset Element</a></h2>
<p>One or more elements listing the files or directories to be copied
into a Cordova app's <code>www</code> directory. Examples:</p>
@@ -387,7 +396,7 @@ code.</p>
</ul>
<h2><a name="Plugin%20Specification_js_module_element">
-<js-module> element</a></h2>
+js-module Element</a></h2>
<p>Most plugins include one or more JavaScript files. Each <code><js-module></code>
tag corresponds to a JavaScript file, and prevents the plugin's users
@@ -455,7 +464,8 @@ exits with a non-zero code.</p>
<p>Nesting <code><js-module></code> elements within <code><platform></code> declares
platform-specific JavaScript module bindings.</p>
-<h2><a name="Plugin%20Specification_dependency"><dependency></a></h2>
+<h2><a name="Plugin%20Specification_dependency_element">
+dependency element</a></h2>
<p>The <code><dependency></code> tag allows you specify other plugins on which the
current plugin depends. While future versions will access them from
@@ -497,7 +507,8 @@ installed the plugin with a local path d
the root of the git repository and then finds the other plugin from
there.</p>
-<h2><a name="Plugin%20Specification_platform"><platform></a></h2>
+<h2><a name="Plugin%20Specification_platform_element">
+platform Element</a></h2>
<p>The <code><platform></code> tag identifies platforms that have associated native
code or require modifications to their configuration files. Tools
@@ -531,7 +542,8 @@ chosen, are listed:</p>
<li>wp8</li>
</ul>
-<h2><a name="Plugin%20Specification_source_file"><source-file></a></h2>
+<h2><a name="Plugin%20Specification_source_file_element">
+source-file Element</a></h2>
<p>The <code><source-file></code> element identifies executable source code that
should be installed into a project. Examples:</p>
@@ -574,7 +586,8 @@ If set, assigns the specified compiler f
source file.</p></li>
</ul>
-<h2><a name="Plugin%20Specification_config_file"><config-file></a></h2>
+<h2><a name="Plugin%20Specification_config_file_element">
+config-file Element</a></h2>
<p>Identifies an XML-based configuration file to be modified, where in
that document the modification should take place, and what should be
@@ -644,7 +657,8 @@ issues a warning, and exits with a non-z
</li>
</ul>
-<h2><a name="Plugin%20Specification_plugins_plist"><plugins-plist></a></h2>
+<h2><a name="Plugin%20Specification_plugins_plist_element">
+plugins-plist Element</a></h2>
<p>This is <em>outdated</em> as it only applies to cordova-ios 2.2.0 and
below. Use the <code><config-file></code> tag for newer versions of Cordova.</p>
@@ -664,9 +678,8 @@ file in an iOS Cordova project. For exam
<pre class="prettyprint"><code><plugins-plist key="Foo" string="CDVFoo" />
</code></pre>
-<h2><a name="Plugin%20Specification_resource_file_and_header_file">
-<resource-file> and <header-file>
-</a></h2>
+<h2><a name="Plugin%20Specification_resource_file_and_header_file_elements">
+resource-file and header-file Elements</a></h2>
<p>Like source files, but specifically for platforms such as iOS that
distinguish between source files, headers, and resources. Examples:</p>
@@ -676,7 +689,8 @@ distinguish between source files, header
<header-file src="CDVFoo.h" />
</code></pre>
-<h2><a name="Plugin%20Specification_lib_file"><lib-file></a></h2>
+<h2><a name="Plugin%20Specification_lib_file_element">
+lib-file Element</a></h2>
<p>Like source, resource, and header files, but specifically for
platforms such as BlackBerry 10 that use user-generated libraries.
@@ -698,7 +712,8 @@ non-zero code.</p></li>
either <code>device</code> or <code>simulator</code>.</p></li>
</ul>
-<h2><a name="Plugin%20Specification_framework"><framework></a></h2>
+<h2><a name="Plugin%20Specification_framework_element">
+framework Element</a></h2>
<p>Identifies a framework (usually part of the OS/platform) on which the plugin depends.</p>
@@ -715,7 +730,8 @@ platform.</p>
<p>The optional <code>weak</code> attribute is a boolean indicating whether the
framework should be weakly linked. The default is <code>false</code>.</p>
-<h2><a name="Plugin%20Specification_info"><info></a></h2>
+<h2><a name="Plugin%20Specification_info_element">
+info Element</a></h2>
<p>Additional information provided to users. This is useful when you
require extra steps that can't be easily automated or are beyond
@@ -730,7 +746,7 @@ android.library.reference.1=PATH_TO_ANDR
</info>
</code></pre>
-<h1><a name="Variables">Variables</a></h1>
+<h2><a name="Plugin%20Specification_variables">Variables</a></h2>
<p>In certain cases, a plugin may need to make configuration changes
dependent on the target application. For example, to register for C2DM
@@ -775,7 +791,7 @@ non-zero code.</p>
<p>Certain variable names should be reserved, as listed below.</p>
-<h2><a name="Variables_package_name">$PACKAGE_NAME</a></h2>
+<h2><a name="Plugin%20Specification_package_name">$PACKAGE_NAME</a></h2>
<p>The reverse-domain style unique identifier for the package,
corresponding to the <code>CFBundleIdentifier</code> on iOS or the <code>package</code>