Documentation/content/codeberg-pages/redirects.md
crapStone da1b77aa6a Add woodpecker ci & many linters (and their required fixes) (#377)
closes #238

Co-authored-by: pat-s <patrick.schratz@gmail.com>
Co-authored-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/377
Co-authored-by: crapStone <crapstone01@gmail.com>
Co-committed-by: crapStone <crapstone01@gmail.com>
2024-06-11 07:51:22 +00:00

1.1 KiB

eleventyNavigation
key title parent order
Redirects Redirects CodebergPages 102

Redirects can be created with a _redirects file with the following format:

# Comment
from  to  [status]
  • Lines starting with # are ignored
  • from - the path to redirect from (Note: repository and branch names are removed from request URLs)
  • 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

Simple redirect

Redirects a specific path.

/example  https://example.com/  301
/path /other-path 301

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

Example: /articles/2022/10/12/post-1/ -> /posts/2022/10/12/post-1/