2023-02-25 15:33:12 -05:00
|
|
|
# Features
|
|
|
|
|
|
|
|
|
|
## Custom domains
|
|
|
|
|
|
|
|
|
|
...
|
|
|
|
|
|
|
|
|
|
## Redirects
|
|
|
|
|
|
|
|
|
|
Redirects can be created with a `_redirects` file with the following format:
|
|
|
|
|
|
|
|
|
|
```
|
2023-02-25 21:45:49 -05:00
|
|
|
# Comment
|
2023-02-25 15:33:12 -05:00
|
|
|
from to [status]
|
|
|
|
|
```
|
|
|
|
|
|
2023-02-25 21:45:49 -05:00
|
|
|
* Lines starting with `#` are ignored
|
2023-02-25 15:33:12 -05:00
|
|
|
* `from` - the path to redirect from
|
|
|
|
|
* `to` - the path or URL to redirect to
|
|
|
|
|
* `status` - status code to use when redirecting (default 301)
|
|
|
|
|
|
|
|
|
|
### Status codes
|
|
|
|
|
|
|
|
|
|
* `200` - returns content from specified path (no external URLs) without changing the URL (rewrite)
|
|
|
|
|
* `301` - Moved Permanently (Permanent redirect)
|
|
|
|
|
* `302` - Found (Temporary redirect)
|
|
|
|
|
|
|
|
|
|
### Examples
|
|
|
|
|
|
|
|
|
|
#### SPA (single-page application) rewrite
|
|
|
|
|
|
|
|
|
|
Redirects all paths to `/index.html` for single-page apps.
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
/* /index.html 200
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### Splats
|
|
|
|
|
|
|
|
|
|
Redirects every path under `/articles` to `/posts` while keeping the path.
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
/articles/* /posts/:splat 302
|
|
|
|
|
```
|
|
|
|
|
|
2023-03-11 06:20:19 +01:00
|
|
|
Example: `/articles/2022/10/12/post-1/` -> `/posts/2022/10/12/post-1/`
|
