Skip to content
This repository has been archived by the owner on Oct 2, 2019. It is now read-only.

Commit

Permalink
Added description of app: syntax (closes #40)
Browse files Browse the repository at this point in the history
  • Loading branch information
marcoscaceres committed May 30, 2014
1 parent fe29a8c commit 53fc68d
Showing 1 changed file with 27 additions and 3 deletions.
30 changes: 27 additions & 3 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -177,10 +177,34 @@ <h2>
app: URL
</h2>
<p>
An <dfn>app: URL</dfn> is a [[!URL]] that can be used by a packaged
application to address resources within its container (e.g., a .zip
file).
An <dfn>app: URL</dfn> is a [[!URL]] whose <a href=
"http://url.spec.whatwg.org/#concept-url-scheme">scheme</a> component
is `app` (case-insensitive) and whose <a href=
"http://url.spec.whatwg.org/#concept-host">host</a> component is an
<a>instance identifier</a>. A user agent can use app: URLs to obtain
resources from within a packaged application (e.g., a .zip file).
</p>
<div class="note">
<p>
Traditionally, the syntax of [[URI]]s were represented using [[ABNF]].
However, as few ever implemented ABNF parsers, validators, or
producers, and given how complicated [[ABNF]] is to decypher, it
turned out not to be very helpful to implemeters or readers. So,
nowawadays, we just restrict certain parts of the URL to values and
let the <a href="http://url.spec.whatwg.org/#concept-url-parser">URL
parser</a> spit out the right result.
</p>
<p>
For readers accustomed to seeing [[ABNF]] syntax representations of
[[URI]]s, the app URL would look like this:
</p>
<pre>
appurl = "app":" hier-part [ "?" query ] [ "#" fragment ]
</pre>
<p>
The [[URI]] specification defines what each component in the above [[ABNF]] means.
</p>
</div>
</section>
<section>
<h2>
Expand Down

0 comments on commit 53fc68d

Please sign in to comment.