Skip to content

Commit 05df869

Browse files
committed
Switch faq-link and error-link from md to html
1 parent e8d8294 commit 05df869

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

51 files changed

+140
-140
lines changed

Diff for: _error-messages/a2da.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Even if you aren't intentionally using redirects there are two common ways that
1919
If you're unsure why a redirect is occurring then the first step is to check the `Location` response header. Often the
2020
new location will only differ from the original location by a single character so you may need to check it very
2121
carefully. Safari and recent versions of Chrome don't show the preflight request separately in the *Network* tab of the
22-
developer tools, making it difficult to check the response headers. See {% include faq-link.md faq="b56b" %} for more
22+
developer tools, making it difficult to check the response headers. See {% include faq-link.html faq="b56b" %} for more
2323
information.
2424

2525
While the server should not be attempting to redirect the preflight `OPTIONS` request it is usually trivial to fix in
@@ -29,5 +29,5 @@ the client by updating the URL to avoid the redirect altogether.
2929

3030
Related:
3131

32-
* {% include faq-link.md faq="c320" %}
33-
* {% include faq-link.md faq="b56b" %}
32+
* {% include faq-link.html faq="c320" %}
33+
* {% include faq-link.html faq="b56b" %}

Diff for: _error-messages/a384.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ This message is intended to provide extra feedback to the developer but ultimate
2020
`Origin` request header will always be well-formed so if the `Access-Control-Allow-Origin` header can't be parsed it
2121
can't be a match.
2222

23-
This is very similar to {% include error-link.md message="f6e6" text="another error message" %}. That error relates to
23+
This is very similar to {% include error-link.html message="f6e6" text="another error message" %}. That error relates to
2424
the preflight `OPTIONS` request, whereas this error specifically concerns the main request.
2525

2626
If you are making the request using the `fetch` API then you'll also see the following text at the end of the error
@@ -31,5 +31,5 @@ message:
3131
mode to 'no-cors' to fetch the resource with CORS disabled.
3232
</blockquote>
3333

34-
For more information about opaque responses see {% include faq-link.md faq="dfdb" %}. Using an opaque response will
34+
For more information about opaque responses see {% include faq-link.html faq="dfdb" %}. Using an opaque response will
3535
suppress the error message but it won't allow you to access the response details.

Diff for: _error-messages/aa0c.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,11 @@ The best place to start with debugging this error is to check which status code
1313
response body that provides further information.
1414

1515
This can be tricky in browsers that don't show the preflight `OPTIONS` request separately in the developer tools. See
16-
{% include faq-link.md faq="b56b" %} for more information.
16+
{% include faq-link.html faq="b56b" %} for more information.
1717

1818
The other thing to check is the request URL. Specifically check in the developer tools rather than in your code. Make
1919
sure the URL really is what you intended. Depending on how the server is configured there are several different status
2020
codes you might receive if the URL is wrong.
2121

2222
Attempts to redirect to a different URL will typically show a different error message. See
23-
{% include error-link.md message="a2da" text="Redirect is not allowed for a preflight request" %}.
23+
{% include error-link.html message="a2da" text="Redirect is not allowed for a preflight request" %}.

Diff for: _error-messages/aa2f.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -22,5 +22,5 @@ A value of `*` can also be used as a wildcard in `Access-Control-Allow-Headers`.
2222

2323
Related:
2424

25-
* {% include faq-link.md faq="b7f6" %}
26-
* {% include faq-link.md faq="b040" %}.
25+
* {% include faq-link.html faq="b7f6" %}
26+
* {% include faq-link.html faq="b040" %}.

Diff for: _error-messages/b435.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -13,14 +13,14 @@ error:
1313

1414
For requests that use `withCredentials` the server response to the preflight `OPTIONS` request must include the header
1515
`Access-Control-Allow-Credentials` set to the value `true`. The same header must also be included for the main request,
16-
though omitting it would trigger {% include error-link.md message="bbd3" text="a different error message" %}.
16+
though omitting it would trigger {% include error-link.html message="bbd3" text="a different error message" %}.
1717

18-
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.md faq="b7f6" %}.
18+
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.html faq="b7f6" %}.
1919

2020
If the message reports a value of `''` then that usually means the header is missing altogether rather than being
2121
returned with an explicit empty value.
2222

2323
If the error message indicates that the current value is `'true, true'` then that suggests that the header is being
2424
returned twice.
2525

26-
See also {% include faq-link.md faq="fcd5" %}.
26+
See also {% include faq-link.html faq="fcd5" %}.

Diff for: _error-messages/b78f.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -6,15 +6,15 @@ message: "Response to preflight request doesn't pass access control check: No 'A
66
This error indicates that the preflight `OPTIONS` request failed because the server did not include the response header
77
`Access-Control-Allow-Origin`.
88

9-
This is very similar to {% include error-link.md message="e2a2" text="another error message" %}. That error relates to
9+
This is very similar to {% include error-link.html message="e2a2" text="another error message" %}. That error relates to
1010
the main request, whereas this error specifically concerns the preflight `OPTIONS` request.
1111

12-
If you're new to CORS see {% include faq-link.md faq="e9f4" %} for more information.
12+
If you're new to CORS see {% include faq-link.html faq="e9f4" %} for more information.
1313

14-
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.md faq="b7f6" %}.
14+
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.html faq="b7f6" %}.
1515

1616
If you've attempted to configure the CORS headers but you're still seeing this message then try
17-
{% include faq-link.md faq="ea74" %}.
17+
{% include faq-link.html faq="ea74" %}.
1818

1919
If you are making the request using the `fetch` API then you'll also see the following text at the end of the error
2020
message:
@@ -23,5 +23,5 @@ message:
2323
If an opaque response serves your needs, set the request's mode to 'no-cors' to fetch the resource with CORS disabled.
2424
</blockquote>
2525

26-
For more information about opaque responses see {% include faq-link.md faq="dfdb" %}. Using an opaque response will
26+
For more information about opaque responses see {% include faq-link.html faq="dfdb" %}. Using an opaque response will
2727
suppress the error message but it won't allow you to access the response details.

Diff for: _error-messages/bbd3.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -19,4 +19,4 @@ returned with an explicit empty value.
1919
If the error message indicates that the current value is `'true, true'` then that suggests that the header is being
2020
returned twice.
2121

22-
See also {% include faq-link.md faq="fcd5" %}.
22+
See also {% include faq-link.html faq="fcd5" %}.

Diff for: _error-messages/d514.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,6 @@ message: "Response to preflight request doesn't pass access control check: The '
44
---
55

66
This error specifically refers to the preflight `OPTIONS` request but is otherwise identical to
7-
{% include error-link.md message="f5ab" text="an earlier error message" %}.
7+
{% include error-link.html message="f5ab" text="an earlier error message" %}.
88

9-
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.md faq="b7f6" %}.
9+
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.html faq="b7f6" %}.

Diff for: _error-messages/d897.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -49,5 +49,5 @@ message:
4949
mode to 'no-cors' to fetch the resource with CORS disabled.
5050
</blockquote>
5151

52-
For more information about opaque responses see {% include faq-link.md faq="dfdb" %}. Using an opaque response will
52+
For more information about opaque responses see {% include faq-link.html faq="dfdb" %}. Using an opaque response will
5353
suppress the error message but it won't allow you to access the response details.

Diff for: _error-messages/da36.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,6 @@ message: "Response to preflight request doesn't pass access control check: The '
44
---
55

66
This error specifically refers to the preflight `OPTIONS` request but is otherwise identical to
7-
{% include error-link.md message="d897" text="an earlier error message" %}.
7+
{% include error-link.html message="d897" text="an earlier error message" %}.
88

9-
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.md faq="b7f6" %}.
9+
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.html faq="b7f6" %}.

Diff for: _error-messages/dab3.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -14,13 +14,13 @@ This error indicates that the `Access-Control-Allow-Origin` response header had
1414
not allowed for requests that use `withCredentials`.
1515

1616
In many cases `withCredentials` isn't required and can simply be removed. If you aren't using cookies then you probably
17-
don't need it. For more information see {% include faq-link.md faq="fcd5" %}.
17+
don't need it. For more information see {% include faq-link.html faq="fcd5" %}.
1818

1919
If you do need `withCredentials` then you'll have to change the server so that it doesn't return `*` for
2020
`Access-Control-Allow-Origin`. Instead the server should check that the `Origin` request header contains an allowed
2121
origin before echoing that origin value back in `Access-Control-Allow-Origin`.
2222

23-
If you want to understand why this restriction on using `*` exists then see {% include faq-link.md faq="ffcc" %}. By
23+
If you want to understand why this restriction on using `*` exists then see {% include faq-link.html faq="ffcc" %}. By
2424
extension it's important that the server does not simply echo back all origins: only trusted origins should be allowed.
2525

2626
There are browser extensions that automatically set the `Access-Control-Allow-Origin` header to `*`, overriding any

Diff for: _error-messages/e048.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -20,4 +20,4 @@ headers. In that case the browser will still include the `Access-Control-Request
2020
A value of `*` can also be used as a wildcard in `Access-Control-Allow-Methods`. However, this is not allowed when using
2121
`withCredentials` and will result in the same error message.
2222

23-
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.md faq="b7f6" %}.
23+
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.html faq="b7f6" %}.

Diff for: _error-messages/e2a2.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,13 @@ message: No 'Access-Control-Allow-Origin' header is present on the requested res
44

55
This error indicates that the server response did not include the header `Access-Control-Allow-Origin`.
66

7-
This is very similar to {% include error-link.md message="b78f" text="another error message" %}. That error relates to
7+
This is very similar to {% include error-link.html message="b78f" text="another error message" %}. That error relates to
88
the preflight `OPTIONS` request, whereas this error specifically concerns the main request.
99

10-
If you're new to CORS see {% include faq-link.md faq="e9f4" %} for more information.
10+
If you're new to CORS see {% include faq-link.html faq="e9f4" %} for more information.
1111

1212
If you've attempted to configure the CORS headers but you're still seeing this message then try
13-
{% include faq-link.md faq="ea74" %}.
13+
{% include faq-link.html faq="ea74" %}.
1414

1515
If you are making the request using the `fetch` API then you'll also see the following text at the end of the error
1616
message:
@@ -19,5 +19,5 @@ message:
1919
If an opaque response serves your needs, set the request's mode to 'no-cors' to fetch the resource with CORS disabled.
2020
</blockquote>
2121

22-
For more information about opaque responses see {% include faq-link.md faq="dfdb" %}. Using an opaque response will
22+
For more information about opaque responses see {% include faq-link.html faq="dfdb" %}. Using an opaque response will
2323
suppress the error message but it won't allow you to access the response details.

Diff for: _error-messages/efd0.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,6 @@ error:
1212
</blockquote>
1313

1414
This error specifically refers to the preflight `OPTIONS` request but is otherwise identical to
15-
{% include error-link.md message="dab3" text="an earlier error message" %}.
15+
{% include error-link.html message="dab3" text="an earlier error message" %}.
1616

17-
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.md faq="b7f6" %}.
17+
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.html faq="b7f6" %}.

Diff for: _error-messages/f5ab.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,5 +14,5 @@ message:
1414
mode to 'no-cors' to fetch the resource with CORS disabled.
1515
</blockquote>
1616

17-
For more information about opaque responses see {% include faq-link.md faq="dfdb" %}. Using an opaque response will
17+
For more information about opaque responses see {% include faq-link.html faq="dfdb" %}. Using an opaque response will
1818
suppress the error message but it won't allow you to access the response details.

Diff for: _error-messages/f6e6.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,6 @@ message: "Response to preflight request doesn't pass access control check: The '
44
---
55

66
This error specifically refers to the preflight `OPTIONS` request but is otherwise identical to
7-
{% include error-link.md message="a384" text="an earlier error message" %}.
7+
{% include error-link.html message="a384" text="an earlier error message" %}.
88

9-
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.md faq="b7f6" %}.
9+
If you are unclear what a preflight `OPTIONS` request is then see {% include faq-link.html faq="b7f6" %}.

Diff for: _faq/a313.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,4 @@ question: Why am I seeing an OPTIONS request instead of the GET/POST/etc. reques
44

55
That is the *preflight request*.
66

7-
See {% include faq-link.md faq="b7f6" %} for more information.
7+
See {% include faq-link.html faq="b7f6" %} for more information.

Diff for: _faq/a8d2.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -18,18 +18,18 @@ If you're seeing a CORS-related error message but you aren't sure what it means
1818
The next thing to try is the *Network* tab of the developer tools. Find the request that isn't working and
1919
check exactly what is being sent each way.
2020

21-
If you're seeing an `OPTIONS` request that you weren't expecting then see {% include faq-link.md faq="a313" %}.
21+
If you're seeing an `OPTIONS` request that you weren't expecting then see {% include faq-link.html faq="a313" %}.
2222

23-
If you're seeing the warning *'Provisional headers are shown'* then see {% include faq-link.md faq="b56b" %}.
23+
If you're seeing the warning *'Provisional headers are shown'* then see {% include faq-link.html faq="b56b" %}.
2424

2525
If you think all the headers look correct then you can check them using our [CORS header checker](/header-checker).
2626

2727
---
2828

2929
Related:
3030

31-
* {% include faq-link.md faq="ea74" %}
32-
* {% include faq-link.md faq="cdc8" %}
33-
* {% include faq-link.md faq="b1b0" %}
34-
* {% include faq-link.md faq="a313" %}
35-
* {% include faq-link.md faq="b56b" %}.
31+
* {% include faq-link.html faq="ea74" %}
32+
* {% include faq-link.html faq="cdc8" %}
33+
* {% include faq-link.html faq="b1b0" %}
34+
* {% include faq-link.html faq="a313" %}
35+
* {% include faq-link.html faq="b56b" %}.

Diff for: _faq/abe3.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,6 @@ to be part of the *origin* when the browser decides whether or not to use CORS.
1313

1414
Related:
1515

16-
* {% include faq-link.md faq="d1a6" %}
17-
* {% include faq-link.md faq="b667" %}
18-
* {% include faq-link.md faq="f173" %}
16+
* {% include faq-link.html faq="d1a6" %}
17+
* {% include faq-link.html faq="b667" %}
18+
* {% include faq-link.html faq="f173" %}

Diff for: _faq/b040.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ The headers `Access-Control-Request-Method` and `Access-Control-Request-Headers`
77
preflight in required.
88

99
This can be tricky as recent versions of Chrome don't show the preflight request in the developer tools. See
10-
{% include faq-link.md faq="b56b" %} for more information.
10+
{% include faq-link.html faq="b56b" %} for more information.
1111

1212
First check `Access-Control-Request-Method`. If it's set to `GET`, `HEAD` or `POST` then that isn't the problem. Those 3
1313
request methods are considered safe and won't trigger a preflight request. For any other values, e.g. `PUT` or `DELETE`,
@@ -37,5 +37,5 @@ breakpoint just before your request and step into the library code to see exactl
3737

3838
Related:
3939

40-
* {% include faq-link.md faq="b56b" %}
41-
* {% include faq-link.md faq="b7f6" %}
40+
* {% include faq-link.html faq="b56b" %}
41+
* {% include faq-link.html faq="b7f6" %}

Diff for: _faq/b1b0.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -24,4 +24,4 @@ for more information.
2424

2525
Related:
2626

27-
* {% include faq-link.md faq="b56b" %}
27+
* {% include faq-link.html faq="b56b" %}

Diff for: _faq/b4d0.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ One particularly noteworthy error shown in Chrome is:
1515
Interestingly, the same problem in Firefox doesn't show any error message, the request just fails without explanation.
1616

1717
The source of this problem is that the URI is missing the prefix `http://` or `https://`, so the browser interprets the
18-
`localhost:` as being the *scheme* of the URI. {% include error-link.md message="c0d3" text="More information" %}.
18+
`localhost:` as being the *scheme* of the URI. {% include error-link.html message="c0d3" text="More information" %}.
1919

2020
However, assuming you aren't seeing that particular error...
2121

@@ -24,7 +24,7 @@ In most browsers the developer tools must be open before you make the request, o
2424
Check you don't have any filters turned on which could be hiding your request.
2525

2626
In Safari and recent versions of Chrome you won't be able to see the preflight `OPTIONS` request as a separate request.
27-
See {% include faq-link.md faq="b56b" %} for more information.
27+
See {% include faq-link.html faq="b56b" %} for more information.
2828

2929
Preflight `OPTIONS` requests can also be cached, so it's possible you may not see the request you're expecting because a
3030
cached response has been used instead. If you have access to the server logs you may be able to confirm what requests
@@ -37,4 +37,4 @@ caching problems that might be interfering with your requests.
3737

3838
Related:
3939

40-
* {% include faq-link.md faq="b56b" %}
40+
* {% include faq-link.html faq="b56b" %}

Diff for: _faq/b56b.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -38,5 +38,5 @@ Hopefully Chrome will fix the developer tools soon so that this is no longer a p
3838

3939
Related:
4040

41-
* {% include faq-link.md faq="b4d0" %}
42-
* {% include faq-link.md faq="b1b0" %}
41+
* {% include faq-link.html faq="b4d0" %}
42+
* {% include faq-link.html faq="b1b0" %}

Diff for: _faq/b667.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -28,4 +28,4 @@ In JavaScript you can access the current page's origin using `location.origin`.
2828

2929
Related:
3030

31-
* {% include faq-link.md faq="fe2a" %}
31+
* {% include faq-link.html faq="fe2a" %}

Diff for: _faq/b6b0.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ To make the copied request useful you will also need to add the `-I` option. Thi
99
output.
1010

1111
In theory you can do the same thing in Chrome but recent versions have made it more difficult to access the `OPTIONS`
12-
request in the developer tools. See {% include faq-link.md faq="b56b" %} for more information.
12+
request in the developer tools. See {% include faq-link.html faq="b56b" %} for more information.
1313

1414
Most of the request headers included by a browser aren't necessary from a CORS perspective. Servers will usually ignore
1515
those other headers when responding to a preflight request. Generally a much simpler cURL request will suffice:
@@ -40,7 +40,7 @@ Breaking this down:
4040

4141
Related:
4242

43-
* {% include faq-link.md faq="b7f6" %}
44-
* {% include faq-link.md faq="d1a6" %}
45-
* {% include faq-link.md faq="c7f6" %}
46-
* {% include faq-link.md faq="b56b" %}
43+
* {% include faq-link.html faq="b7f6" %}
44+
* {% include faq-link.html faq="d1a6" %}
45+
* {% include faq-link.html faq="c7f6" %}
46+
* {% include faq-link.html faq="b56b" %}

0 commit comments

Comments
 (0)