mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-30 11:39:15 -05:00
fd33e5d202
- Rejigged the weight of the extras/ content for the new crossreferences
page.
- Used the new {{</*…*/>}} format for documenting highlighting and to
prevent a warning about the missing `fig` shortcode.
45 lines
1.4 KiB
Markdown
45 lines
1.4 KiB
Markdown
---
|
|
aliases:
|
|
- /doc/urls/
|
|
date: 2014-01-03
|
|
menu:
|
|
main:
|
|
parent: extras
|
|
next: /community/mailing-list
|
|
notoc: true
|
|
prev: /extras/toc
|
|
title: URLs
|
|
weight: 110
|
|
---
|
|
|
|
## Pretty URLs
|
|
|
|
By default Hugo will create content with 'pretty' URLs. For example
|
|
content created at /content/extras/urls.md will be rendered at
|
|
/content/extras/urls/index.html and accessible at /content/extras/urls. No
|
|
no standard server side configuration is required for these pretty urls to
|
|
work.
|
|
|
|
If you would like to have ugly URLs, you are in luck. Hugo supports the
|
|
ability to create your entire site with ugly URLs. Simply use the
|
|
`--uglyUrls=true` flag on the command line.
|
|
|
|
If you want a specific piece of content to have an exact URL, you can
|
|
specify this in the front matter under the url key. See [Content
|
|
Organization](/content/organization/) for more details.
|
|
|
|
## Canonicalization
|
|
|
|
By default, all relative URLs encountered in the input will be canonicalized
|
|
using `baseurl`, so that a link `/css/foo.css` becomes
|
|
`http://yoursite.example.com/css/foo.css`.
|
|
|
|
Setting `canonifyurls` to `false` will prevent this canonicalization.
|
|
|
|
Benefits of canonicalization include fixing all URLs to be absolute, which may
|
|
aid with some parsing tasks. Note though that all real browsers handle this
|
|
client-side without issues.
|
|
|
|
Benefits of non-canonicalization include being able to have resource inclusion
|
|
be scheme-relative, so that http vs https can be decided based on how this
|
|
page was retrieved.
|