mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-21 20:46:30 -05:00
Squashed 'docs/' changes from 6c2195936..9be494de3
9be494de3 Clean up the markup config c3e123133 Remove JustComment bc1b02bc5 Add Smart to Anchor section 49e796409 Added where .RegularPagesRecursive was added a92296e31 Fixed the new-in shortcode in pages-vs-site-pages 051e1267c Documented .RegularPagesRecursive 5bcec88a3 Fix broken link in RSS templates page 3db79d433 Correct pull request link on migrations.md 55c347168 Release 0.71.1 11a4e36c3 Merge branch 'temp711' 481fc8ed6 releaser: Add release notes to /docs for release of 0.71.1 40ba83c26 Update site.md 382632b58 Use-modules: More help how to get started importing a theme (#1107) 06751d465 Addition of hugefastsearch to search options (#1118) 8346d3b18 Add example of how to set the permalinks option for pages in "root" ebb3b4f3a Refine highlight shortcode options 1075a172a Update index.md 7cc927ea6 Fix typo in v0.71.0 release notes 4121da273 Pull in latest theme version to get link hooks 4809be651 Document render-heading feature 2078a3bd1 Release 0.71.0 c09f6899e releaser: Add release notes to /docs for release of 0.71.0 90ffe2b50 Merge commit 'c9403cbceaaeff53ff4833561f4eefe1dc1a405e' bf3dd0837 Add math.Pow git-subtree-dir: docs git-subtree-split: 9be494de3ac79081be60e0f002db110cb96ec7a3
This commit is contained in:
parent
c9403cbcea
commit
9e1dcefc5f
36 changed files with 191 additions and 87 deletions
|
@ -1,4 +1,3 @@
|
||||||
|
|
||||||
.header-link:after {
|
.header-link:after {
|
||||||
position: relative;
|
position: relative;
|
||||||
left: 0.5em;
|
left: 0.5em;
|
|
@ -2,7 +2,7 @@
|
||||||
@import '_tachyons';
|
@import '_tachyons';
|
||||||
|
|
||||||
/* purgecss start ignore */
|
/* purgecss start ignore */
|
||||||
@import '_anchorforid';
|
@import '_header-link';
|
||||||
@import '_animation';
|
@import '_animation';
|
||||||
@import '_documentation-styles';
|
@import '_documentation-styles';
|
||||||
|
|
||||||
|
|
|
@ -1,6 +1,5 @@
|
||||||
require("typeface-muli")
|
require("typeface-muli")
|
||||||
import styles from './css/main.css';
|
import styles from './css/main.css';
|
||||||
import './js/anchorforid.js'
|
|
||||||
import './js/clipboardjs.js'
|
import './js/clipboardjs.js'
|
||||||
import './js/codeblocks.js'
|
import './js/codeblocks.js'
|
||||||
import './js/docsearch.js'
|
import './js/docsearch.js'
|
||||||
|
@ -11,6 +10,3 @@ import './js/scrolldir.js'
|
||||||
import './js/smoothscroll.js'
|
import './js/smoothscroll.js'
|
||||||
import './js/tabs.js'
|
import './js/tabs.js'
|
||||||
import './js/nojs.js'
|
import './js/nojs.js'
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -1,34 +0,0 @@
|
||||||
/**
|
|
||||||
* Anchor for ID BPNY
|
|
||||||
**/
|
|
||||||
var anchorForId = function (id) {
|
|
||||||
var anchor = document.createElement("a");
|
|
||||||
anchor.className = "header-link";
|
|
||||||
anchor.href = "#" + id;
|
|
||||||
anchor.innerHTML = ' <svg class="fill-current o-60 hover-accent-color-light" height="22px" viewBox="0 0 24 24" width="22px" xmlns="http://www.w3.org/2000/svg"><path d="M0 0h24v24H0z" fill="none"/><path d="M3.9 12c0-1.71 1.39-3.1 3.1-3.1h4V7H7c-2.76 0-5 2.24-5 5s2.24 5 5 5h4v-1.9H7c-1.71 0-3.1-1.39-3.1-3.1zM8 13h8v-2H8v2zm9-6h-4v1.9h4c1.71 0 3.1 1.39 3.1 3.1s-1.39 3.1-3.1 3.1h-4V17h4c2.76 0 5-2.24 5-5s-2.24-5-5-5z"/></svg>';
|
|
||||||
return anchor;
|
|
||||||
};
|
|
||||||
|
|
||||||
var linkifyAnchors = function (level, containingElement) {
|
|
||||||
var headers = containingElement.getElementsByTagName("h" + level);
|
|
||||||
for (var h = 0; h < headers.length; h++) {
|
|
||||||
var header = headers[h];
|
|
||||||
|
|
||||||
if (typeof header.id !== "undefined" && header.id !== "") {
|
|
||||||
header.appendChild(anchorForId(header.id));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
|
|
||||||
document.onreadystatechange = function () {
|
|
||||||
if (this.readyState === "complete") {
|
|
||||||
var contentBlock = document.getElementsByClassName("prose")[0]
|
|
||||||
if (!contentBlock) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
for (var level = 2; level <= 4; level++) {
|
|
||||||
linkifyAnchors(level, contentBlock);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
};
|
|
|
@ -1,5 +1,4 @@
|
||||||
import styles from './../css/main.css';
|
import styles from './../css/main.css';
|
||||||
import './anchorforid.js'
|
|
||||||
import './clipboardjs.js'
|
import './clipboardjs.js'
|
||||||
import './codeblocks.js'
|
import './codeblocks.js'
|
||||||
import './docsearch.js'
|
import './docsearch.js'
|
||||||
|
@ -10,9 +9,7 @@ import './smoothscroll.js'
|
||||||
import './tabs.js'
|
import './tabs.js'
|
||||||
import './nojs.js'
|
import './nojs.js'
|
||||||
|
|
||||||
|
// TO use jQuery, just call the modules you want
|
||||||
|
|
||||||
// TO use Jquery, just call the modules you want
|
|
||||||
// var $ = require('jquery/src/core');
|
// var $ = require('jquery/src/core');
|
||||||
// require('jquery/src/core/init');
|
// require('jquery/src/core/init');
|
||||||
// require('jquery/src/manipulation');
|
// require('jquery/src/manipulation');
|
||||||
|
|
|
@ -5280,3 +5280,4 @@ code, .code, pre code, .highlight pre {
|
||||||
max-width:90%;
|
max-width:90%;
|
||||||
}
|
}
|
||||||
/* purgecss end ignore */
|
/* purgecss end ignore */
|
||||||
|
|
||||||
|
|
File diff suppressed because one or more lines are too long
5
_vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/_markup/render-heading.html
generated
Normal file
5
_vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/_markup/render-heading.html
generated
Normal file
|
@ -0,0 +1,5 @@
|
||||||
|
<h{{ .Level }} id="{{ .Anchor | safeURL }}">{{ .Text | safeHTML }}
|
||||||
|
{{- if and (ge .Level 2) (le .Level 4) }}{{" " -}}
|
||||||
|
<a class="header-link" href="#{{ .Anchor | safeURL }}"><svg class="fill-current o-60 hover-accent-color-light" height="22px" viewBox="0 0 24 24" width="22px" xmlns="http://www.w3.org/2000/svg"><path d="M0 0h24v24H0z" fill="none"/><path d="M3.9 12c0-1.71 1.39-3.1 3.1-3.1h4V7H7c-2.76 0-5 2.24-5 5s2.24 5 5 5h4v-1.9H7c-1.71 0-3.1-1.39-3.1-3.1zM8 13h8v-2H8v2zm9-6h-4v1.9h4c1.71 0 3.1 1.39 3.1 3.1s-1.39 3.1-3.1 3.1h-4V17h4c2.76 0 5-2.24 5-5s-2.24-5-5-5z"/></svg></a>
|
||||||
|
{{- end -}}
|
||||||
|
</h{{ .Level }}>
|
|
@ -67,7 +67,6 @@
|
||||||
|
|
||||||
{{ block "footer" . }}{{ partialCached "site-footer.html" . }}{{ end }}
|
{{ block "footer" . }}{{ partialCached "site-footer.html" . }}{{ end }}
|
||||||
|
|
||||||
|
|
||||||
</body>
|
</body>
|
||||||
|
|
||||||
</html>
|
</html>
|
|
@ -1 +1 @@
|
||||||
# github.com/gohugoio/gohugoioTheme v0.0.0-20200128164921-1d0bc5482051
|
# github.com/gohugoio/gohugoioTheme v0.0.0-20200518165806-0095b7b902a7
|
||||||
|
|
|
@ -58,14 +58,6 @@ pattern = "2006"
|
||||||
[social]
|
[social]
|
||||||
twitter = "GoHugoIO"
|
twitter = "GoHugoIO"
|
||||||
|
|
||||||
# MARKDOWN
|
|
||||||
## Configuration for BlackFriday markdown parser: https://github.com/russross/blackfriday
|
|
||||||
[blackfriday]
|
|
||||||
plainIDAnchors = true
|
|
||||||
# See https://github.com/gohugoio/hugo/issues/2424
|
|
||||||
hrefTargetBlank = false
|
|
||||||
angledQuotes = false
|
|
||||||
latexDashes = true
|
|
||||||
|
|
||||||
[imaging]
|
[imaging]
|
||||||
# See https://github.com/disintegration/imaging
|
# See https://github.com/disintegration/imaging
|
||||||
|
|
|
@ -14,12 +14,6 @@ pluralizeListTitles = false
|
||||||
# We do redirects via Netlify's _redirects file, generated by Hugo (see "outputs" below).
|
# We do redirects via Netlify's _redirects file, generated by Hugo (see "outputs" below).
|
||||||
disableAliases = true
|
disableAliases = true
|
||||||
|
|
||||||
[markup]
|
|
||||||
[markup.highlight]
|
|
||||||
style = "trac"
|
|
||||||
lineNumbersInTable = true
|
|
||||||
noClasses = false
|
|
||||||
|
|
||||||
[outputs]
|
[outputs]
|
||||||
home = [ "HTML", "RSS", "REDIR", "HEADERS" ]
|
home = [ "HTML", "RSS", "REDIR", "HEADERS" ]
|
||||||
section = [ "HTML", "RSS"]
|
section = [ "HTML", "RSS"]
|
||||||
|
|
7
config/_default/markup.toml
Normal file
7
config/_default/markup.toml
Normal file
|
@ -0,0 +1,7 @@
|
||||||
|
defaultMarkdownHandler = "goldmark"
|
||||||
|
|
||||||
|
[highlight]
|
||||||
|
style = "trac"
|
||||||
|
lineNumbersInTable = true
|
||||||
|
noClasses = false
|
||||||
|
|
|
@ -61,7 +61,7 @@ There are a few alternatives to commenting on static sites for those who do not
|
||||||
* [Utterances](https://utteranc.es/) (Open source, GitHub comments widget built on GitHub issues)
|
* [Utterances](https://utteranc.es/) (Open source, GitHub comments widget built on GitHub issues)
|
||||||
* [Remark](https://github.com/umputun/remark) (Open source, Golang, Easy to run docker)
|
* [Remark](https://github.com/umputun/remark) (Open source, Golang, Easy to run docker)
|
||||||
* [Commento](https://commento.io/) (Open Source, available as a service, local install, or docker image)
|
* [Commento](https://commento.io/) (Open Source, available as a service, local install, or docker image)
|
||||||
* [JustComments](https://just-comments.com) (Open Source, available as a service, can be self-hosted)
|
* [Hyvor Talk](https://talk.hyvor.com/) (Available as a service)
|
||||||
|
|
||||||
|
|
||||||
[configuration]: /getting-started/configuration/
|
[configuration]: /getting-started/configuration/
|
||||||
|
|
|
@ -180,7 +180,10 @@ Rotates an image by the given angle counter-clockwise. The rotation will be perf
|
||||||
### Anchor
|
### Anchor
|
||||||
|
|
||||||
Only relevant for the `Fill` method. This is useful for thumbnail generation where the main motive is located in, say, the left corner.
|
Only relevant for the `Fill` method. This is useful for thumbnail generation where the main motive is located in, say, the left corner.
|
||||||
Valid are `Center`, `TopLeft`, `Top`, `TopRight`, `Left`, `Right`, `BottomLeft`, `Bottom`, `BottomRight`.
|
|
||||||
|
Valid values are `Smart`, `Center`, `TopLeft`, `Top`, `TopRight`, `Left`, `Right`, `BottomLeft`, `Bottom`, `BottomRight`.
|
||||||
|
|
||||||
|
Default value is `Smart`, which uses [Smartcrop](https://github.com/muesli/smartcrop) to determine the best crop.
|
||||||
|
|
||||||
```go
|
```go
|
||||||
{{ $image.Fill "300x200 BottomLeft" }}
|
{{ $image.Fill "300x200 BottomLeft" }}
|
||||||
|
|
|
@ -43,10 +43,9 @@ Highlighting is carried out via the [built-in shortcode](/content-management/sho
|
||||||
|
|
||||||
Options:
|
Options:
|
||||||
|
|
||||||
* `linenos`: Valid values are `true`, `false`, `table`, `inline`. `table` will give copy-and-paste friendly code blocks) turns on line numbers.
|
* `linenos`: configure line numbers. Valid values are `true`, `false`, `table`, or `inline`. `false` will turn off line numbers if it's configured to be on in site config. {{< new-in "0.60.0" >}} `table` will give copy-and-paste friendly code blocks.
|
||||||
* Setting `linenos` to `false` will turn off linenumbers if it's configured to be on in site config.{{< new-in "0.60.0" >}}
|
* `hl_lines`: lists a set of line numbers or line number ranges to be highlighted.
|
||||||
* `hl_lines` lists a set of line numbers or line number ranges to be highlighted.
|
* `linenostart=199`: starts the line number count from 199.
|
||||||
* `linenostart=199` starts the line number count from 199.
|
|
||||||
|
|
||||||
### Example: Highlight Shortcode
|
### Example: Highlight Shortcode
|
||||||
|
|
||||||
|
|
|
@ -38,6 +38,13 @@ permalinks:
|
||||||
|
|
||||||
Only the content under `posts/` will have the new URL structure. For example, the file `content/posts/sample-entry.md` with `date: 2017-02-27T19:20:00-05:00` in its front matter will render to `public/2017/02/sample-entry/index.html` at build time and therefore be reachable at `https://example.com/2017/02/sample-entry/`.
|
Only the content under `posts/` will have the new URL structure. For example, the file `content/posts/sample-entry.md` with `date: 2017-02-27T19:20:00-05:00` in its front matter will render to `public/2017/02/sample-entry/index.html` at build time and therefore be reachable at `https://example.com/2017/02/sample-entry/`.
|
||||||
|
|
||||||
|
To configure the `permalinks` option for pages in the "root" section, use **/** as the key:
|
||||||
|
|
||||||
|
{{< code-toggle file="config" copy="false" >}}
|
||||||
|
permalinks:
|
||||||
|
/: /:year/:month/:filename/
|
||||||
|
{{< /code-toggle >}}
|
||||||
|
|
||||||
If the standard date-based permalink configuration does not meet your needs, you can also format URL segments using [Go time formatting directives](https://golang.org/pkg/time/#Time.Format). For example, a URL structure with two digit years and month and day digits without zero padding can be accomplished with:
|
If the standard date-based permalink configuration does not meet your needs, you can also format URL segments using [Go time formatting directives](https://golang.org/pkg/time/#Time.Format). For example, a URL structure with two digit years and month and day digits without zero padding can be accomplished with:
|
||||||
|
|
||||||
{{< code-toggle file="config" copy="false" >}}
|
{{< code-toggle file="config" copy="false" >}}
|
||||||
|
|
|
@ -38,4 +38,4 @@ aliases: []
|
||||||
| `math.Round` | Returns the nearest integer, rounding half away from zero. | `{{math.Round 1.5}}` → `2` |
|
| `math.Round` | Returns the nearest integer, rounding half away from zero. | `{{math.Round 1.5}}` → `2` |
|
||||||
| `math.Log` | Returns the natural logarithm of the given number. | `{{math.Log 42}}` → `3.737` |
|
| `math.Log` | Returns the natural logarithm of the given number. | `{{math.Log 42}}` → `3.737` |
|
||||||
| `math.Sqrt` | Returns the square root of the given number. | `{{math.Sqrt 81}}` → `9` |
|
| `math.Sqrt` | Returns the square root of the given number. | `{{math.Sqrt 81}}` → `9` |
|
||||||
|
| `math.Pow` | Returns the first number raised to the power of the second number. | `{{math.Pow 2 3}}` → `8` |
|
||||||
|
|
|
@ -85,9 +85,13 @@ ordered
|
||||||
|
|
||||||
Note that this is only supported with the [Goldmark](#goldmark) renderer.
|
Note that this is only supported with the [Goldmark](#goldmark) renderer.
|
||||||
|
|
||||||
These Render Hooks allow custom templates to render links and images from markdown.
|
Render Hooks allow custom templates to override markdown rendering functionality. You can do this by creating templates with base names `render-{feature}` in `layouts/_default/_markup`.
|
||||||
|
|
||||||
You can do this by creating templates with base names `render-link` and/or `render-image` inside `layouts/_default/_markup`.
|
The features currently supported are:
|
||||||
|
|
||||||
|
* `image`
|
||||||
|
* `link`
|
||||||
|
* `heading` {{< new-in "0.71.0" >}}
|
||||||
|
|
||||||
You can define [Output-Format-](/templates/output-formats) and [language-](/content-management/multilingual/)specific templates if needed.[^hooktemplate] Your `layouts` folder may look like this:
|
You can define [Output-Format-](/templates/output-formats) and [language-](/content-management/multilingual/)specific templates if needed.[^hooktemplate] Your `layouts` folder may look like this:
|
||||||
|
|
||||||
|
@ -105,10 +109,11 @@ Some use cases for the above:
|
||||||
* Resolve link references using `.GetPage`. This would make links portable as you could translate `./my-post.md` (and similar constructs that would work on GitHub) into `/blog/2019/01/01/my-post/` etc.
|
* Resolve link references using `.GetPage`. This would make links portable as you could translate `./my-post.md` (and similar constructs that would work on GitHub) into `/blog/2019/01/01/my-post/` etc.
|
||||||
* Add `target=_blank` to external links.
|
* Add `target=_blank` to external links.
|
||||||
* Resolve and [process](/content-management/image-processing/) images.
|
* Resolve and [process](/content-management/image-processing/) images.
|
||||||
|
* Add [header links](https://remysharp.com/2014/08/08/automatic-permalinks-for-blog-posts).
|
||||||
|
|
||||||
### Render Hook Templates
|
### Render Hook Templates
|
||||||
|
|
||||||
Both `render-link` and `render-image` templates will receive this context:
|
The `render-link` and `render-image` templates will receive this context:
|
||||||
|
|
||||||
Page
|
Page
|
||||||
: The [Page](/variables/page/) being rendered.
|
: The [Page](/variables/page/) being rendered.
|
||||||
|
@ -125,7 +130,24 @@ Text
|
||||||
PlainText
|
PlainText
|
||||||
: The plain variant of the above.
|
: The plain variant of the above.
|
||||||
|
|
||||||
#### Link with title Markdown example :
|
The `render-heading` template will receive this context:
|
||||||
|
|
||||||
|
Page
|
||||||
|
: The [Page](/variables/page/) being rendered.
|
||||||
|
|
||||||
|
Level
|
||||||
|
: The header level (1--6)
|
||||||
|
|
||||||
|
Anchor
|
||||||
|
: An auto-generated html id unique to the header within the page
|
||||||
|
|
||||||
|
Text
|
||||||
|
: The rendered (HTML) text.
|
||||||
|
|
||||||
|
PlainText
|
||||||
|
: The plain variant of the above.
|
||||||
|
|
||||||
|
#### Link with title Markdown example:
|
||||||
|
|
||||||
```md
|
```md
|
||||||
[Text](https://www.gohugo.io "Title")
|
[Text](https://www.gohugo.io "Title")
|
||||||
|
@ -151,5 +173,24 @@ Here is a code example for how the render-image.html template could look:
|
||||||
</p>
|
</p>
|
||||||
{{< /code >}}
|
{{< /code >}}
|
||||||
|
|
||||||
[^hooktemplate]: It's currently only possible to have one set of render hook templates, e.g. not per `Type` or `Section`. We may consider that in a future version.
|
#### Heading link example
|
||||||
|
|
||||||
|
Given this template file
|
||||||
|
|
||||||
|
{{< code file="layouts/_default/_markup/render-heading.html" >}}
|
||||||
|
<h{{ .Level }} id="{{ .Anchor | safeURL }}">{{ .Text | safeHTML }} <a href="#{{ .Anchor | safeURL }}">¶</a></h{{ .Level }}>
|
||||||
|
{{< /code >}}
|
||||||
|
|
||||||
|
And this markdown
|
||||||
|
|
||||||
|
```md
|
||||||
|
### Section A
|
||||||
|
```
|
||||||
|
|
||||||
|
The rendered html will be
|
||||||
|
|
||||||
|
```html
|
||||||
|
<h3 id="section-a">Section A <a href="#section-a">¶</a></h3>
|
||||||
|
```
|
||||||
|
|
||||||
|
[^hooktemplate]: It's currently only possible to have one set of render hook templates, e.g. not per `Type` or `Section`. We may consider that in a future version.
|
||||||
|
|
|
@ -30,9 +30,20 @@ Use `hugo mod init` to initialize a new Hugo Module. If it fails to guess the mo
|
||||||
hugo mod init github.com/gohugoio/myShortcodes
|
hugo mod init github.com/gohugoio/myShortcodes
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
Also see the [CLI Doc](/commands/hugo_mod_init/).
|
Also see the [CLI Doc](/commands/hugo_mod_init/).
|
||||||
|
|
||||||
|
## Use a Module for a Theme
|
||||||
|
The easiest way to use a for a theme is to import it in the config.
|
||||||
|
|
||||||
|
1. Initialize the hugo module system: `hugo mod init github.com/<your_user>/<your_project>`
|
||||||
|
2. Import the theme in your `config.toml`:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
[module]
|
||||||
|
[[module.imports]]
|
||||||
|
path = "github.com/spf13/hyde/"
|
||||||
|
```
|
||||||
|
|
||||||
## Update Modules
|
## Update Modules
|
||||||
|
|
||||||
Modules will be downloaded and added when you add them as imports to your configuration, see [Module Imports](/hugo-modules/configuration/#module-config-imports).
|
Modules will be downloaded and added when you add them as imports to your configuration, see [Module Imports](/hugo-modules/configuration/#module-config-imports).
|
||||||
|
|
BIN
content/en/news/0.71.0-relnotes/hugo-71-featured.png
Normal file
BIN
content/en/news/0.71.0-relnotes/hugo-71-featured.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 205 KiB |
50
content/en/news/0.71.0-relnotes/index.md
Normal file
50
content/en/news/0.71.0-relnotes/index.md
Normal file
|
@ -0,0 +1,50 @@
|
||||||
|
|
||||||
|
---
|
||||||
|
date: 2020-05-18
|
||||||
|
title: "Markdown Render Hooks for Headings"
|
||||||
|
description: "Render hooks for headings, update to Go 1.14.3, several bug fixes etc."
|
||||||
|
categories: ["Releases"]
|
||||||
|
---
|
||||||
|
|
||||||
|
Hugo 0.71 brings [Markdown render hooks for headings](https://gohugo.io/getting-started/configuration-markup#markdown-render-hooks), a set of bug fixes and more.
|
||||||
|
|
||||||
|
This release represents **12 contributions by 7 contributors** to the main Hugo code base. [@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@anthonyfok](https://github.com/anthonyfok), [@apexskier](https://github.com/apexskier), and [@johnweldon](https://github.com/johnweldon) for their ongoing contributions.
|
||||||
|
|
||||||
|
And a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) and [@onedrawingperday](https://github.com/onedrawingperday) for their relentless work on keeping the themes site in pristine condition and to [@davidsneighbour](https://github.com/davidsneighbour) and [@kaushalmodi](https://github.com/kaushalmodi) for all the great work on the documentation site.
|
||||||
|
|
||||||
|
Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
|
||||||
|
which has received **8 contributions by 7 contributors**. A special thanks to [@bep](https://github.com/bep), [@mikeee](https://github.com/mikeee), [@h-enk](https://github.com/h-enk), and [@tjamet](https://github.com/tjamet) for their work on the documentation site.
|
||||||
|
|
||||||
|
|
||||||
|
Hugo now has:
|
||||||
|
|
||||||
|
* 44043+ [stars](https://github.com/gohugoio/hugo/stargazers)
|
||||||
|
* 437+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
|
||||||
|
* 322+ [themes](http://themes.gohugo.io/)
|
||||||
|
|
||||||
|
## Enhancements
|
||||||
|
|
||||||
|
### Other
|
||||||
|
|
||||||
|
* Use WARN log level also for the early initialization [518d1496](https://github.com/gohugoio/hugo/commit/518d149646c13fb49c296a63e61a048f5e672179) [@bep](https://github.com/bep) [#7285](https://github.com/gohugoio/hugo/issues/7285)
|
||||||
|
* Update to Go 1.14.3 and Go 1.13.11 [3cc41523](https://github.com/gohugoio/hugo/commit/3cc41523bef802d1942f3d31018547a18cc55923) [@bep](https://github.com/bep)
|
||||||
|
* Improve error message when no Babel installed [2fd0a5a6](https://github.com/gohugoio/hugo/commit/2fd0a5a6781456e88745b370d12aaf5351a020ff) [@bep](https://github.com/bep)
|
||||||
|
* Add test for headings render hook [6e051c05](https://github.com/gohugoio/hugo/commit/6e051c053e2b5b8419f357ed8acd177440266d07) [@apexskier](https://github.com/apexskier)
|
||||||
|
* Add render template hooks for headings [423b8f2f](https://github.com/gohugoio/hugo/commit/423b8f2fb834139cf31514b14b1c1bf28e43b384) [@elihunter173](https://github.com/elihunter173) [#6713](https://github.com/gohugoio/hugo/issues/6713)
|
||||||
|
* Add math.Pow [99193449](https://github.com/gohugoio/hugo/commit/991934497e88dcd4134a369a213bb5072c51c139) [@jmooring](https://github.com/jmooring) [#7266](https://github.com/gohugoio/hugo/issues/7266)
|
||||||
|
* Do not suppress .well-known/ directory [558c0930](https://github.com/gohugoio/hugo/commit/558c09305e2be16953238c6c0e828f62b950e4f5) [@johnweldon](https://github.com/johnweldon) [#6691](https://github.com/gohugoio/hugo/issues/6691)
|
||||||
|
* Quote "@babel/cli" to solve build error [b69a3614](https://github.com/gohugoio/hugo/commit/b69a36140f42ec99ffa2d1e029b8b86ecf8ff929) [@anthonyfok](https://github.com/anthonyfok)
|
||||||
|
* Remove custom x-nodejs plugin [a0103864](https://github.com/gohugoio/hugo/commit/a0103864ab76c6a1462a6dee538801740acf4858) [@anthonyfok](https://github.com/anthonyfok)
|
||||||
|
* Use .Lastmod for og:updated_time [6205d56b](https://github.com/gohugoio/hugo/commit/6205d56b85fea31e008cd0fef26805bab8084786) [@dtip](https://github.com/dtip)
|
||||||
|
|
||||||
|
## Fixes
|
||||||
|
|
||||||
|
### Other
|
||||||
|
|
||||||
|
* Fix Babel on Windows [723ec555](https://github.com/gohugoio/hugo/commit/723ec555e75fbfa94d90d3ecbcd5775d6c7800e1) [@bep](https://github.com/bep) [#7251](https://github.com/gohugoio/hugo/issues/7251)
|
||||||
|
* Upgrade chroma to 0.7.3 to fix invalid css [b342e8fb](https://github.com/gohugoio/hugo/commit/b342e8fbdb23157f3979af91cb5d8d3438003707) [@apexskier](https://github.com/apexskier) [#7207](https://github.com/gohugoio/hugo/issues/7207)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
25
content/en/news/0.71.1-relnotes/index.md
Normal file
25
content/en/news/0.71.1-relnotes/index.md
Normal file
|
@ -0,0 +1,25 @@
|
||||||
|
|
||||||
|
---
|
||||||
|
date: 2020-05-25
|
||||||
|
title: "Hugo 0.71.1: A couple of Bug Fixes"
|
||||||
|
description: "This version fixes a couple of bugs."
|
||||||
|
categories: ["Releases"]
|
||||||
|
images:
|
||||||
|
- images/blog/hugo-bug-poster.png
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
This is a bug-fix release with a couple of important fixes.
|
||||||
|
|
||||||
|
* Add some more date test cases [81f56332](https://github.com/gohugoio/hugo/commit/81f5633245bf123fbe7ad78eec51ae7b4e6c177a) [@bep](https://github.com/bep) [#7310](https://github.com/gohugoio/hugo/issues/7310)
|
||||||
|
* Fix RenderString vs render hooks [9698b0da](https://github.com/gohugoio/hugo/commit/9698b0dab11f52d52145e85ff71311d2f103cb4e) [@bep](https://github.com/bep) [#7265](https://github.com/gohugoio/hugo/issues/7265)
|
||||||
|
* Prevent WARNINGs in RenderString [32344fe3](https://github.com/gohugoio/hugo/commit/32344fe3db862584e3f926d63bdf33b7fa7d22f7) [@bep](https://github.com/bep)
|
||||||
|
* Fix IsAncestor/IsDescendant for taxonomies [4d7fa9f1](https://github.com/gohugoio/hugo/commit/4d7fa9f114c62ae2ec12257203ed21b0e4d69a04) [@bep](https://github.com/bep) [#7305](https://github.com/gohugoio/hugo/issues/7305)
|
||||||
|
* Fix GetPage on section/bundle name overlaps [a985efce](https://github.com/gohugoio/hugo/commit/a985efcecf44afe1d252690ec0a00cf077974f44) [@bep](https://github.com/bep) [#7301](https://github.com/gohugoio/hugo/issues/7301)
|
||||||
|
* Fix Go template script escaping [6c3c6686](https://github.com/gohugoio/hugo/commit/6c3c6686f5d3c7155e2d455b07ac8ab70f42cb88) [@bep](https://github.com/bep) [#6695](https://github.com/gohugoio/hugo/issues/6695)
|
||||||
|
* Add a test helper [c34bf485](https://github.com/gohugoio/hugo/commit/c34bf48560c91c8a2fa106867af7b08a569609b5) [@bep](https://github.com/bep)
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -24,8 +24,12 @@ the current _list_ page:
|
||||||
|
|
||||||
`.RegularPages`
|
`.RegularPages`
|
||||||
: Collection of only _regular_ pages under the
|
: Collection of only _regular_ pages under the
|
||||||
current _list_ page.
|
current _list_ page. This **excludes** regular pages in nested sections/_list_ pages (those are subdirectories with an `_index.md` file.
|
||||||
|
|
||||||
|
`.RegularPagesRecursive`
|
||||||
|
: Collection of **all** _regular_ pages under a _list_ page. This **includes** regular pages in nested sections/_list_ pages.
|
||||||
|
|
||||||
|
This feature was added in Hugo version 0.68.0
|
||||||
|
|
||||||
Note
|
Note
|
||||||
: From the scope of _regular_ pages, `.Pages` and
|
: From the scope of _regular_ pages, `.Pages` and
|
||||||
|
|
|
@ -29,7 +29,7 @@ RSS pages are of the type `Page` and have all the [page variables](/variables/pa
|
||||||
|
|
||||||
### Section RSS
|
### Section RSS
|
||||||
|
|
||||||
A [section’s][section] RSS will be rendered at `/<SECTION>/index.xml` (e.g., https://spf13.com/project/index.xml).
|
A [section’s][section] RSS will be rendered at `/<SECTION>/index.xml` (e.g., [https://spf13.com/project/index.xml](https://spf13.com/project/index.xml)).
|
||||||
|
|
||||||
Hugo provides the ability for you to define any RSS type you wish and can have different RSS files for each section and taxonomy.
|
Hugo provides the ability for you to define any RSS type you wish and can have different RSS files for each section and taxonomy.
|
||||||
|
|
||||||
|
|
|
@ -20,7 +20,7 @@ toc: true
|
||||||
This section highlights some projects around Hugo that are independently developed. These tools try to extend the functionality of our static site generator or help you to get started.
|
This section highlights some projects around Hugo that are independently developed. These tools try to extend the functionality of our static site generator or help you to get started.
|
||||||
|
|
||||||
{{% note %}}
|
{{% note %}}
|
||||||
Do you know or maintain a similar project around Hugo? Feel free to open a [pull request](https://github.com/gohugoio/hugo/pulls) on GitHub if you think it should be added.
|
Do you know or maintain a similar project around Hugo? Feel free to open a [pull request](https://github.com/gohugoio/hugoDocs/pulls) on GitHub if you think it should be added.
|
||||||
{{% /note %}}
|
{{% /note %}}
|
||||||
|
|
||||||
Take a look at this list of migration tools if you currently use other blogging tools like Jekyll or WordPress but intend to switch to Hugo instead. They'll take care to export your content into Hugo-friendly formats.
|
Take a look at this list of migration tools if you currently use other blogging tools like Jekyll or WordPress but intend to switch to Hugo instead. They'll take care to export your content into Hugo-friendly formats.
|
||||||
|
|
|
@ -26,6 +26,7 @@ A static website with a dynamic search function? Yes, Hugo provides an alternati
|
||||||
* [hugo-lunr-zh](https://www.npmjs.com/package/hugo-lunr-zh). A bit like Hugo-lunr, but Hugo-lunr-zh can help you separate the Chinese keywords.
|
* [hugo-lunr-zh](https://www.npmjs.com/package/hugo-lunr-zh). A bit like Hugo-lunr, but Hugo-lunr-zh can help you separate the Chinese keywords.
|
||||||
* [Github Gist for Fuse.js integration](https://gist.github.com/eddiewebb/735feb48f50f0ddd65ae5606a1cb41ae). This gist demonstrates how to leverage Hugo's existing build time processing to generate a searchable JSON index used by [Fuse.js](https://fusejs.io/) on the client side. Although this gist uses Fuse.js for fuzzy matching, any client side search tool capable of reading JSON indexes will work. Does not require npm, grunt or other build-time tools except Hugo!
|
* [Github Gist for Fuse.js integration](https://gist.github.com/eddiewebb/735feb48f50f0ddd65ae5606a1cb41ae). This gist demonstrates how to leverage Hugo's existing build time processing to generate a searchable JSON index used by [Fuse.js](https://fusejs.io/) on the client side. Although this gist uses Fuse.js for fuzzy matching, any client side search tool capable of reading JSON indexes will work. Does not require npm, grunt or other build-time tools except Hugo!
|
||||||
* [hugo-search-index](https://www.npmjs.com/package/hugo-search-index). A library containing Gulp tasks and a prebuilt browser script that implements search. Gulp generates a search index from project markdown files.
|
* [hugo-search-index](https://www.npmjs.com/package/hugo-search-index). A library containing Gulp tasks and a prebuilt browser script that implements search. Gulp generates a search index from project markdown files.
|
||||||
|
* [hugofastsearch](https://gist.github.com/cmod/5410eae147e4318164258742dd053993). A usability and speed update to "Github Gist for Fuse.js integration" — global, keyboard-optimized search.
|
||||||
|
|
||||||
## Commercial Search Services
|
## Commercial Search Services
|
||||||
|
|
||||||
|
|
|
@ -20,6 +20,10 @@ toc: true
|
||||||
|
|
||||||
The following is a list of site-level (aka "global") variables. Many of these variables are defined in your site's [configuration file][config], whereas others are built into Hugo's core for convenient usage in your templates.
|
The following is a list of site-level (aka "global") variables. Many of these variables are defined in your site's [configuration file][config], whereas others are built into Hugo's core for convenient usage in your templates.
|
||||||
|
|
||||||
|
## Get the Site object from a partial
|
||||||
|
|
||||||
|
All the methods below, e.g. `.Site.RegularPages` can also be reached via the global `site` function, e.g. `site.RegularPages`, which can be handy in partials where the `Page` object isn't easily available. {{< new-in "0.53.0" >}}.
|
||||||
|
|
||||||
## Site Variables List
|
## Site Variables List
|
||||||
|
|
||||||
.Site.AllPages
|
.Site.AllPages
|
||||||
|
|
2
go.mod
2
go.mod
|
@ -2,4 +2,4 @@ module github.com/gohugoio/hugoDocs
|
||||||
|
|
||||||
go 1.12
|
go 1.12
|
||||||
|
|
||||||
require github.com/gohugoio/gohugoioTheme v0.0.0-20200328100657-2bfd5f8c6aee // indirect
|
require github.com/gohugoio/gohugoioTheme v0.0.0-20200518165806-0095b7b902a7 // indirect
|
||||||
|
|
4
go.sum
4
go.sum
|
@ -17,3 +17,7 @@ github.com/gohugoio/gohugoioTheme v0.0.0-20200327231942-7f80b3d02bfa h1:kG+O/wT9
|
||||||
github.com/gohugoio/gohugoioTheme v0.0.0-20200327231942-7f80b3d02bfa/go.mod h1:kpw3SS48xZvLQGEXKu8u5XHgXkPvL8DX3oGa07+z8Bs=
|
github.com/gohugoio/gohugoioTheme v0.0.0-20200327231942-7f80b3d02bfa/go.mod h1:kpw3SS48xZvLQGEXKu8u5XHgXkPvL8DX3oGa07+z8Bs=
|
||||||
github.com/gohugoio/gohugoioTheme v0.0.0-20200328100657-2bfd5f8c6aee h1:PJZhCwnuVLyafDWNPSHk9iJvk6gEIvPRnycy7Pq3peA=
|
github.com/gohugoio/gohugoioTheme v0.0.0-20200328100657-2bfd5f8c6aee h1:PJZhCwnuVLyafDWNPSHk9iJvk6gEIvPRnycy7Pq3peA=
|
||||||
github.com/gohugoio/gohugoioTheme v0.0.0-20200328100657-2bfd5f8c6aee/go.mod h1:kpw3SS48xZvLQGEXKu8u5XHgXkPvL8DX3oGa07+z8Bs=
|
github.com/gohugoio/gohugoioTheme v0.0.0-20200328100657-2bfd5f8c6aee/go.mod h1:kpw3SS48xZvLQGEXKu8u5XHgXkPvL8DX3oGa07+z8Bs=
|
||||||
|
github.com/gohugoio/gohugoioTheme v0.0.0-20200518164958-62cbad03c40f h1:Ge3JACszSUyJW2Az9cJzWdo4PUqdijJA1RxoQSVMBSI=
|
||||||
|
github.com/gohugoio/gohugoioTheme v0.0.0-20200518164958-62cbad03c40f/go.mod h1:kpw3SS48xZvLQGEXKu8u5XHgXkPvL8DX3oGa07+z8Bs=
|
||||||
|
github.com/gohugoio/gohugoioTheme v0.0.0-20200518165806-0095b7b902a7 h1:Sy0hlWyZmFtdSY0Cobvw1ZYm3G1aR5+4DuFNRbMkh48=
|
||||||
|
github.com/gohugoio/gohugoioTheme v0.0.0-20200518165806-0095b7b902a7/go.mod h1:kpw3SS48xZvLQGEXKu8u5XHgXkPvL8DX3oGa07+z8Bs=
|
||||||
|
|
|
@ -3,7 +3,7 @@ publish = "public"
|
||||||
command = "hugo --gc --minify"
|
command = "hugo --gc --minify"
|
||||||
|
|
||||||
[context.production.environment]
|
[context.production.environment]
|
||||||
HUGO_VERSION = "0.70.0"
|
HUGO_VERSION = "0.71.1"
|
||||||
HUGO_ENV = "production"
|
HUGO_ENV = "production"
|
||||||
HUGO_ENABLEGITINFO = "true"
|
HUGO_ENABLEGITINFO = "true"
|
||||||
|
|
||||||
|
@ -11,20 +11,20 @@ HUGO_ENABLEGITINFO = "true"
|
||||||
command = "hugo --gc --minify --enableGitInfo"
|
command = "hugo --gc --minify --enableGitInfo"
|
||||||
|
|
||||||
[context.split1.environment]
|
[context.split1.environment]
|
||||||
HUGO_VERSION = "0.70.0"
|
HUGO_VERSION = "0.71.1"
|
||||||
HUGO_ENV = "production"
|
HUGO_ENV = "production"
|
||||||
|
|
||||||
[context.deploy-preview]
|
[context.deploy-preview]
|
||||||
command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL"
|
command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL"
|
||||||
|
|
||||||
[context.deploy-preview.environment]
|
[context.deploy-preview.environment]
|
||||||
HUGO_VERSION = "0.70.0"
|
HUGO_VERSION = "0.71.1"
|
||||||
|
|
||||||
[context.branch-deploy]
|
[context.branch-deploy]
|
||||||
command = "hugo --gc --minify -b $DEPLOY_PRIME_URL"
|
command = "hugo --gc --minify -b $DEPLOY_PRIME_URL"
|
||||||
|
|
||||||
[context.branch-deploy.environment]
|
[context.branch-deploy.environment]
|
||||||
HUGO_VERSION = "0.70.0"
|
HUGO_VERSION = "0.71.1"
|
||||||
|
|
||||||
[context.next.environment]
|
[context.next.environment]
|
||||||
HUGO_ENABLEGITINFO = "true"
|
HUGO_ENABLEGITINFO = "true"
|
||||||
|
|
Binary file not shown.
After Width: | Height: | Size: 75 KiB |
Binary file not shown.
After Width: | Height: | Size: 125 KiB |
Binary file not shown.
After Width: | Height: | Size: 49 KiB |
Binary file not shown.
After Width: | Height: | Size: 29 KiB |
Binary file not shown.
After Width: | Height: | Size: 21 KiB |
Loading…
Reference in a new issue