github/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2024-11-07 20:30:36 -05:00
Code Issues Projects Releases Packages Wiki Activity
hugo/docs/content/extras/urls.md

63 lines
2.4 KiB
Markdown
Raw Normal View History

Add `canonifyurls` config option. Be able to inhibit AbsURL canonicalization of content, on a site configuration basis. Advantages of being able to inhibit this include making it easier to rendering on other hostnames, and being able to include resources on http or https depending on how this page was retrieved, avoiding mixed-mode client complaints without adding latency for plain http.
2014-01-03 18:36:53 -05:00
---
aliases:
Converting front matter to YAML
2014-05-29 18:42:05 -04:00
- /doc/urls/
date: 2014-01-03
Implementing new menu system in the docs site
2014-04-23 03:00:11 -04:00
menu:
main:
Converting front matter to YAML
2014-05-29 18:42:05 -04:00
parent: extras
next: /community/mailing-list
notoc: true
prev: /extras/toc
title: URLs
Documentation for `ref` and `relref`. - 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.
2014-11-25 03:07:18 -05:00
weight: 110
Add `canonifyurls` config option. Be able to inhibit AbsURL canonicalization of content, on a site configuration basis. Advantages of being able to inhibit this include making it easier to rendering on other hostnames, and being able to include resources on http or https depending on how this page was retrieved, avoiding mixed-mode client complaints without adding latency for plain http.
2014-01-03 18:36:53 -05:00
---
Adding documentation on Pretty Urls
2014-02-20 19:04:29 -05:00
Minor proofreading corrections to Hugo docs
2014-08-31 07:08:36 -04:00
## Pretty URLs
Adding documentation on Pretty Urls
2014-02-20 19:04:29 -05:00
[Docs] Document the new (temp?) default of `canonifyurls = false` Also add a **Caveat** on http://gohugo.io/tutorials/github-pages-blog/ warning the reader that a `canonifyurls = true` must be added for Spencer's old example files to work. Fixes #802
2015-01-22 20:04:07 -05:00
By default, Hugo create content with 'pretty' URLs. For example,
content created at `/content/extras/urls.md` will be rendered at
`/public/extras/urls/index.html`, thus accessible from the browser
at http://example.com/extras/urls/. No non-standard server-side
configuration is required for these pretty URLs to work.
Adding documentation on Pretty Urls
2014-02-20 19:04:29 -05:00
[Docs] Document the new (temp?) default of `canonifyurls = false` Also add a **Caveat** on http://gohugo.io/tutorials/github-pages-blog/ warning the reader that a `canonifyurls = true` must be added for Spencer's old example files to work. Fixes #802
2015-01-22 20:04:07 -05:00
If you would like to have what we call "ugly URLs",
e.g.&nbsp;http://example.com/extras/urls.html, you are in luck.
Hugo supports the ability to create your entire site with ugly URLs.
Simply add `uglyurls = true` to your site-wide `config.toml`,
or use the `--uglyUrls=true` flag on the command line.
Adding documentation on Pretty Urls
2014-02-20 19:04:29 -05:00
Minor proofreading corrections to Hugo docs
2014-08-31 07:08:36 -04:00
If you want a specific piece of content to have an exact URL, you can
[Docs] Document the new (temp?) default of `canonifyurls = false` Also add a **Caveat** on http://gohugo.io/tutorials/github-pages-blog/ warning the reader that a `canonifyurls = true` must be added for Spencer's old example files to work. Fixes #802
2015-01-22 20:04:07 -05:00
specify this in the front matter under the `url` key. See [Content
doc: Strip trailing whitespace; other revisions Make some random and non-comprehensive changes to the template functions documentation to make them more consistent.
2015-08-04 14:00:08 -04:00
Organization](/content/organization/) for more details.
Adding documentation on Pretty Urls
2014-02-20 19:04:29 -05:00
## Canonicalization
[Docs] Document the new (temp?) default of `canonifyurls = false` Also add a **Caveat** on http://gohugo.io/tutorials/github-pages-blog/ warning the reader that a `canonifyurls = true` must be added for Spencer's old example files to work. Fixes #802
2015-01-22 20:04:07 -05:00
By default, all relative URLs encountered in the input are left unmodified,
[Docs] Clarify the switch to `canonifyurls = false` as default Quote from @spf13: "I also think it's the better default and should continue to be the case going forward." Also mention the use of `hugo config` to check the current value of `canonifyurls`, thanks to suggestion by @bep. Fixes #802
2015-02-21 16:46:12 -05:00
e.g. `/css/foo.css` would stay as `/css/foo.css`,
i.e. `canonifyurls` defaults to `false`.
[Docs] Document the new (temp?) default of `canonifyurls = false` Also add a **Caveat** on http://gohugo.io/tutorials/github-pages-blog/ warning the reader that a `canonifyurls = true` must be added for Spencer's old example files to work. Fixes #802
2015-01-22 20:04:07 -05:00
By setting `canonifyurls` to `true`, all relative URLs would instead
be *canonicalized* using `baseurl`. For example, assuming you have
`baseurl = http://yoursite.example.com/` defined in the site-wide
[Docs] Clarify the switch to `canonifyurls = false` as default Quote from @spf13: "I also think it's the better default and should continue to be the case going forward." Also mention the use of `hugo config` to check the current value of `canonifyurls`, thanks to suggestion by @bep. Fixes #802
2015-02-21 16:46:12 -05:00
`config.toml`, the relative URL `/css/foo.css` would be turned into
[Docs] Document the new (temp?) default of `canonifyurls = false` Also add a **Caveat** on http://gohugo.io/tutorials/github-pages-blog/ warning the reader that a `canonifyurls = true` must be added for Spencer's old example files to work. Fixes #802
2015-01-22 20:04:07 -05:00
the absolute URL `http://yoursite.example.com/css/foo.css`.
Add `canonifyurls` config option. Be able to inhibit AbsURL canonicalization of content, on a site configuration basis. Advantages of being able to inhibit this include making it easier to rendering on other hostnames, and being able to include resources on http or https depending on how this page was retrieved, avoiding mixed-mode client complaints without adding latency for plain http.
2014-01-03 18:36:53 -05:00
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.
[Docs] Document the new (temp?) default of `canonifyurls = false` Also add a **Caveat** on http://gohugo.io/tutorials/github-pages-blog/ warning the reader that a `canonifyurls = true` must be added for Spencer's old example files to work. Fixes #802
2015-01-22 20:04:07 -05:00
[Docs] Clarify the switch to `canonifyurls = false` as default Quote from @spf13: "I also think it's the better default and should continue to be the case going forward." Also mention the use of `hugo config` to check the current value of `canonifyurls`, thanks to suggestion by @bep. Fixes #802
2015-02-21 16:46:12 -05:00
> Note: In the May 2014 release of Hugo v0.11, the default value of `canonifyurls` was switched from `true` to `false`, which we think is the better default and should continue to be the case going forward. So, please verify and adjust your website accordingly if you are upgrading from v0.10 or older versions.
[Docs] Document the new (temp?) default of `canonifyurls = false` Also add a **Caveat** on http://gohugo.io/tutorials/github-pages-blog/ warning the reader that a `canonifyurls = true` must be added for Spencer's old example files to work. Fixes #802
2015-01-22 20:04:07 -05:00
[Docs] Clarify the switch to `canonifyurls = false` as default Quote from @spf13: "I also think it's the better default and should continue to be the case going forward." Also mention the use of `hugo config` to check the current value of `canonifyurls`, thanks to suggestion by @bep. Fixes #802
2015-02-21 16:46:12 -05:00
To find out the current value of `canonifyurls` for your website, you may use the handy `hugo config` command added in v0.13:
[Docs] Document the new (temp?) default of `canonifyurls = false` Also add a **Caveat** on http://gohugo.io/tutorials/github-pages-blog/ warning the reader that a `canonifyurls = true` must be added for Spencer's old example files to work. Fixes #802
2015-01-22 20:04:07 -05:00
[Docs] Clarify the switch to `canonifyurls = false` as default Quote from @spf13: "I also think it's the better default and should continue to be the case going forward." Also mention the use of `hugo config` to check the current value of `canonifyurls`, thanks to suggestion by @bep. Fixes #802
2015-02-21 16:46:12 -05:00
hugo config | grep -i canon
[Docs] Document the new (temp?) default of `canonifyurls = false` Also add a **Caveat** on http://gohugo.io/tutorials/github-pages-blog/ warning the reader that a `canonifyurls = true` must be added for Spencer's old example files to work. Fixes #802
2015-01-22 20:04:07 -05:00
[Docs] Clarify the switch to `canonifyurls = false` as default Quote from @spf13: "I also think it's the better default and should continue to be the case going forward." Also mention the use of `hugo config` to check the current value of `canonifyurls`, thanks to suggestion by @bep. Fixes #802
2015-02-21 16:46:12 -05:00
Or, if you are on Windows and do not have `grep` installed:
[Docs] Document the new (temp?) default of `canonifyurls = false` Also add a **Caveat** on http://gohugo.io/tutorials/github-pages-blog/ warning the reader that a `canonifyurls = true` must be added for Spencer's old example files to work. Fixes #802
2015-01-22 20:04:07 -05:00
[Docs] Clarify the switch to `canonifyurls = false` as default Quote from @spf13: "I also think it's the better default and should continue to be the case going forward." Also mention the use of `hugo config` to check the current value of `canonifyurls`, thanks to suggestion by @bep. Fixes #802
2015-02-21 16:46:12 -05:00
hugo config | FINDSTR /I canon
[Docs] Document the new (temp?) default of `canonifyurls = false` Also add a **Caveat** on http://gohugo.io/tutorials/github-pages-blog/ warning the reader that a `canonifyurls = true` must be added for Spencer's old example files to work. Fixes #802
2015-01-22 20:04:07 -05:00
Reference in a new issue Copy permalink