|
161 | 161 | application is launched.
|
162 | 162 | </p>
|
163 | 163 | <p>
|
164 |
| - A manifest has an associated <dfn>manifest URL</dfn>, which is the |
165 |
| - [[URL]] from which the <a>manifest</a> was fetched. |
| 164 | + A manifest has an associated <dfn class="export">manifest URL</dfn>, |
| 165 | + which is the [[URL]] from which the <a>manifest</a> was fetched. |
166 | 166 | </p>
|
167 | 167 | <p>
|
168 | 168 | A [=manifest=] can have any of the following members at its root, all
|
|
607 | 607 | <aside class="note" title="Default scope">
|
608 | 608 | <p>
|
609 | 609 | The "default scope" (when [=manifest/scope=] member is missing,
|
610 |
| - empty, or failure) is the start URL, but with its filename, query, |
611 |
| - and fragment removed. |
| 610 | + empty, or failure) is the [=start URL=], but with its filename, |
| 611 | + query, and fragment removed. |
612 | 612 | </p>
|
613 | 613 | </aside>
|
614 | 614 | <p>
|
@@ -759,10 +759,11 @@ <h3>
|
759 | 759 | <p>
|
760 | 760 | The [=manifest's=] <code><dfn data-export="" data-dfn-for=
|
761 | 761 | "manifest">start_url</dfn></code> member is a <a>string</a> that
|
762 |
| - represents the <dfn>start URL</dfn> , which is <a>URL</a> that the |
763 |
| - developer would prefer the user agent load when the user launches the |
764 |
| - web application (e.g., when the user clicks on the icon of the web |
765 |
| - application from a device's application menu or homescreen). |
| 762 | + represents the <dfn class="export">start URL</dfn> , which is |
| 763 | + <a>URL</a> that the developer would prefer the user agent load when |
| 764 | + the user launches the web application (e.g., when the user clicks on |
| 765 | + the icon of the web application from a device's application menu or |
| 766 | + homescreen). |
766 | 767 | </p>
|
767 | 768 | <p>
|
768 | 769 | The [=manifest/start_url=] member is purely advisory, and a user
|
@@ -822,12 +823,12 @@ <h3>
|
822 | 823 | <p>
|
823 | 824 | Given the above, it is RECOMMENDED that, upon installation, or any
|
824 | 825 | time thereafter, a user agent allows the user to inspect and, if
|
825 |
| - necessary, modify the <a>start URL</a> of an application. |
| 826 | + necessary, modify the [=start URL=] of an application. |
826 | 827 | </p>
|
827 | 828 | <p>
|
828 |
| - Additionally, developers MUST NOT use the <a>start URL</a> to |
829 |
| - include information that uniquely identifies a user (e.g., |
830 |
| - "?user=123" or "/user/123/", or "https://user123.foo.bar"). |
| 829 | + Additionally, developers MUST NOT use the [=manifest/start URL=] to include |
| 830 | + information that uniquely identifies a user (e.g., "?user=123" or |
| 831 | + "/user/123/", or "https://user123.foo.bar"). |
831 | 832 | </p>
|
832 | 833 | </section>
|
833 | 834 | </section>
|
|
839 | 840 | The [=manifest's=] <code><dfn data-export="" data-dfn-for=
|
840 | 841 | "manifest">id</dfn></code> member is a <a>string</a> that represents
|
841 | 842 | the <dfn>identity</dfn> for the application. The [=identity=] takes
|
842 |
| - the form of a URL, which is same origin as the start URL. |
| 843 | + the form of a URL, which is same origin as the [=start URL=]. |
843 | 844 | </p>
|
844 | 845 | <p>
|
845 | 846 | The [=identity=] is used by user agents to uniquely identify the
|
|
890 | 891 | </ol>
|
891 | 892 | <aside class="example" title="Resulting ids">
|
892 | 893 | <p>
|
893 |
| - The table below shows some example `id`s resulting from the [=process |
894 |
| - the `id` member=] steps. |
| 894 | + The table below shows some example `id`s resulting from the |
| 895 | + [=process the `id` member=] steps. |
895 | 896 | </p>
|
896 | 897 | <table class="data">
|
897 | 898 | <tr>
|
@@ -1008,10 +1009,10 @@ <h3>
|
1008 | 1009 | <p>
|
1009 | 1010 | Since [=manifest/id=] is resolved against [=manifest/start_url=]'s
|
1010 | 1011 | [=URL/origin=], providing "../foo", "foo", "/foo", "./foo" all
|
1011 |
| - resolves to the same [=identifier=]. As such, best practice |
1012 |
| - is to use a leading "/" to be explicit that the id is a |
1013 |
| - root-relative URL path. Also, standard encoding/decoding rules |
1014 |
| - apply to the id processing algorithm, as per the [[[URL]]]. |
| 1012 | + resolves to the same [=identifier=]. As such, best practice is to |
| 1013 | + use a leading "/" to be explicit that the id is a root-relative URL |
| 1014 | + path. Also, standard encoding/decoding rules apply to the id |
| 1015 | + processing algorithm, as per the [[[URL]]]. |
1015 | 1016 | </p>
|
1016 | 1017 | </aside>
|
1017 | 1018 | </section>
|
|
0 commit comments