Skip to content
Permalink
Browse files

Update URL docs for relative URLs etc

  • Loading branch information...
bep committed Apr 18, 2019
1 parent bd58dd8 commit 9a7e192314539063fe603cc2c1e8466dd2ac07af
Showing with 20 additions and 2 deletions.
  1. +20 −2 content/en/content-management/urls.md
@@ -84,7 +84,6 @@ The following is a list of values that can be used in a `permalink` definition i

Aliases can be used to create redirects to your page from other URLs.


Aliases comes in two forms:

1. Starting with a `/` meaning they are relative to the `BaseURL`, e.g. `/posts/my-blogpost/`
@@ -130,6 +129,8 @@ aliases:
---
```

From Hugo 0.55 you can also have page-relative aliases, so ` /es/posts/my-original-post/` can be simplified to the more portable `my-original-post/`

### How Hugo Aliases Work

When aliases are specified, Hugo creates a directory to match the alias entry. Inside the directory, Hugo creates an `.html` file specifying the canonical URL for the page and the new redirect target.
@@ -257,12 +258,29 @@ Or, if you are on Windows and do not have `grep` installed:
hugo config | FINDSTR /I canon
```

## Override URLs with Front Matter
## Set URL in Front Matter

In addition to specifying permalink values in your site configuration for different content sections, Hugo provides even more granular control for individual pieces of content.

Both `slug` and `url` can be defined in individual front matter. For more information on content destinations at build time, see [Content Organization][contentorg].

From Hugo 0.55, you can use URLs relative to the current site context (the language), which makes it simpler to maintain. For a Japanese translation, both of the following examples would get the same URL:

```markdown
---
title: "Custom URL!"
url: "/jp/custom/foo"
---
```

```markdown
---
title: "Custom URL!"
url: "custom/foo"
---
```


## Relative URLs

By default, all relative URLs are left unchanged by Hugo, which can be problematic when you want to make your site browsable from a local file system.

0 comments on commit 9a7e192

Please sign in to comment.
You can’t perform that action at this time.