mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-21 20:46:30 -05:00
Squashed 'docs/' changes from c3b4f8410..a26d0e610
a26d0e610 Add documentation to js.Build (#1175) 439a22c3e Update index.md 7a779b39a Hugo 0.74.2 07cb5740c Merge branch 'temp742' abcea676c releaser: Add release notes to /docs for release of 0.74.2 e0dcdbfea Revert "Adding an issue link to the issue creation workflow (#1023)" 21c7131f1 Adding an issue link to the issue creation workflow (#1023) 922afb18b Update index.md b9512b192 Update index.md b7af5993c Update index.md 816f864b6 Release 0.74.1 1732f3461 Merge branch 'temp741' d473f21c1 releaser: Add release notes to /docs for release of 0.74.1 bb234e9cd Add release notes 0.74.0 5cb3166d4 releaser: Add release notes to /docs for release of 0.74.0 7f35a3800 Merge commit '823ce055ed3356da37e9ec4ac70446bdbbaa8de8' 4b7054be5 docs: Regenerate docs helper 1d86f0aed Merge commit '6aa5c9117fd34644459ea9bcfb1b3f5010658d5d' 068b2ab28 Update formats.md doc for new allowed extensions. d71ed99d3 Add support for inline partials efe0e549c Rework external asciidoctor integration git-subtree-dir: docs git-subtree-split: a26d0e610457c7942fd79e7abdd78021f9401796
This commit is contained in:
parent
823ce055ed
commit
28bd06265e
13 changed files with 377 additions and 35 deletions
|
@ -33,8 +33,8 @@ The current list of content formats in Hugo:
|
||||||
| Blackfriday | blackfriday |Blackfriday will eventually be deprecated.|
|
| Blackfriday | blackfriday |Blackfriday will eventually be deprecated.|
|
||||||
|MMark|mmark|Mmark is deprecated and will be removed in a future release.|
|
|MMark|mmark|Mmark is deprecated and will be removed in a future release.|
|
||||||
|Emacs Org-Mode|org|See [go-org](https://github.com/niklasfasching/go-org).|
|
|Emacs Org-Mode|org|See [go-org](https://github.com/niklasfasching/go-org).|
|
||||||
|Asciidoc|asciidoc, adoc, ad|Needs Asciidoc or [Asciidoctor][ascii] installed.|
|
|AsciiDoc|asciidoc, adoc, ad|Needs AsciiDoc or [Asciidoctor][ascii] installed.|
|
||||||
|RST|rst|Needs [RST](https://docutils.sourceforge.io/rst.html) installed.|
|
|RST|rst|Needs [RST](http://docutils.sourceforge.net/rst.html) installed.|
|
||||||
|Pandoc|pandoc, pdc|Needs [Pandoc](https://www.pandoc.org/) installed.|
|
|Pandoc|pandoc, pdc|Needs [Pandoc](https://www.pandoc.org/) installed.|
|
||||||
|HTML|html, htm|To be treated as a content file, with layout, shortcodes etc., it must have front matter. If not, it will be copied as-is.|
|
|HTML|html, htm|To be treated as a content file, with layout, shortcodes etc., it must have front matter. If not, it will be copied as-is.|
|
||||||
|
|
||||||
|
@ -43,12 +43,13 @@ The `markup identifier` is fetched from either the `markup` variable in front ma
|
||||||
|
|
||||||
## External Helpers
|
## External Helpers
|
||||||
|
|
||||||
Some of the formats in the table above needs external helpers installed on your PC. For example, for Asciidoc files, Hugo will try to call the `asciidoctor` or `asciidoc` command. This means that you will have to install the associated tool on your machine to be able to use these formats. ([See the Asciidoctor docs for installation instructions](https://asciidoctor.org/docs/install-toolchain/)).
|
Some of the formats in the table above needs external helpers installed on your PC. For example, for AsciiDoc files,
|
||||||
|
Hugo will try to call the `asciidoctor` or `asciidoc` command. This means that you will have to install the associated
|
||||||
|
tool on your machine to be able to use these formats.
|
||||||
|
|
||||||
Hugo passes reasonable default arguments to these external helpers by default:
|
Hugo passes reasonable default arguments to these external helpers by default:
|
||||||
|
|
||||||
- `asciidoc`: `--no-header-footer --safe -`
|
- `asciidoctor`: `--no-header-footer -v -`
|
||||||
- `asciidoctor`: `--no-header-footer --safe --trace -`
|
|
||||||
- `rst2html`: `--leave-comments --initial-header-level=2`
|
- `rst2html`: `--leave-comments --initial-header-level=2`
|
||||||
- `pandoc`: `--mathjax`
|
- `pandoc`: `--mathjax`
|
||||||
|
|
||||||
|
@ -56,6 +57,53 @@ Hugo passes reasonable default arguments to these external helpers by default:
|
||||||
Because additional formats are external commands generation performance will rely heavily on the performance of the external tool you are using. As this feature is still in its infancy, feedback is welcome.
|
Because additional formats are external commands generation performance will rely heavily on the performance of the external tool you are using. As this feature is still in its infancy, feedback is welcome.
|
||||||
{{% /warning %}}
|
{{% /warning %}}
|
||||||
|
|
||||||
|
### External Helper AsciiDoc
|
||||||
|
|
||||||
|
[AsciiDoc](https://github.com/asciidoc/asciidoc) implementation EOLs in Jan 2020 and is no longer supported.
|
||||||
|
AsciiDoc development is being continued under [Asciidoctor](https://github.com/asciidoctor). The format AsciiDoc
|
||||||
|
remains of course. Please continue with the implementation Asciidoctor.
|
||||||
|
|
||||||
|
### External Helper Asciidoctor
|
||||||
|
|
||||||
|
The Asciidoctor community offers a wide set of tools for the AsciiDoc format that can be installed additionally to Hugo.
|
||||||
|
[See the Asciidoctor docs for installation instructions](https://asciidoctor.org/docs/install-toolchain/). Make sure that also all
|
||||||
|
optional extensions like `asciidoctor-diagram` or `asciidoctor-html5s` are installed if required.
|
||||||
|
|
||||||
|
Asciidoctor parameters can be customized in Hugo:
|
||||||
|
|
||||||
|
Parameter | Default | Comment
|
||||||
|
--- | --- | ---
|
||||||
|
backend | `html5` | Don't change this unless you know what you are doing.
|
||||||
|
doctype | `article` | Document type (article, book or manpage).
|
||||||
|
extensions | | Possible extensions are `asciidoctor-html5s`, `asciidoctor-bibtex`, `asciidoctor-diagram`, `asciidoctor-interdoc-reftext`, `asciidoctor-katex`, `asciidoctor-latex`, `asciidoctor-mathematical`, `asciidoctor-question`, `asciidoctor-rouge`.
|
||||||
|
attributes | | Variables to be referenced in your `adoc` file. This is a list of variable name/value maps. See [Asciidoctor#attributes](https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#attributes-and-substitutions).
|
||||||
|
noheaderorfooter | true | Output an embeddable document, which excludes the header, the footer, and everything outside the body of the document. Don't change this unless you know what you are doing.
|
||||||
|
safemode | `unsafe` | Safe mode level `unsafe`, `safe`, `server` or `secure`. Don't change this unless you know what you are doing.
|
||||||
|
sectionnumbers | `false` | Auto-number section titles.
|
||||||
|
verbose | `true` | Verbosely print processing information and configuration file checks to stderr.
|
||||||
|
trace | `false` | Include backtrace information on errors.
|
||||||
|
failurelevel | `fatal` | The minimum logging level that triggers a non-zero exit code (failure).
|
||||||
|
workingfoldercurrent | `false` | Set the working folder to the rendered `adoc` file, so [include](https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#include-files) will work with relative paths. This setting uses the `asciidoctor` cli parameter `--base-dir` and attribute `outdir=`. For rendering [asciidoctor-diagram](https://asciidoctor.org/docs/asciidoctor-diagram/) `workingfoldercurrent` must be set to `true`.
|
||||||
|
|
||||||
|
```
|
||||||
|
[markup.asciidocext]
|
||||||
|
extensions = ["asciidoctor-html5s", "asciidoctor-diagram"]
|
||||||
|
workingFolderCurrent = true
|
||||||
|
trace = true
|
||||||
|
[markup.asciidocext.attributes]
|
||||||
|
my-base-url = "https://example.com/"
|
||||||
|
my-attribute-name = "my value"
|
||||||
|
```
|
||||||
|
|
||||||
|
Important: External `asciidoctor` requires Hugo rendering to _disk_ to a specific destination folder. It is required to run Hugo with the command option `--destination`!
|
||||||
|
|
||||||
|
In a complex Asciidoctor environment it is sometimes helpful to debug the exact call to your external helper with all
|
||||||
|
parameters. Run Hugo with `-v`. You will get an output like
|
||||||
|
|
||||||
|
```
|
||||||
|
INFO 2019/12/22 09:08:48 Rendering book-as-pdf.adoc with C:\Ruby26-x64\bin\asciidoctor.bat using asciidoc args [--no-header-footer -r asciidoctor-html5s -b html5s -r asciidoctor-diagram --base-dir D:\prototypes\hugo_asciidoc_ddd\docs -a outdir=D:\prototypes\hugo_asciidoc_ddd\build -] ...
|
||||||
|
```
|
||||||
|
|
||||||
## Learn Markdown
|
## Learn Markdown
|
||||||
|
|
||||||
Markdown syntax is simple enough to learn in a single sitting. The following are excellent resources to get you up and running:
|
Markdown syntax is simple enough to learn in a single sitting. The following are excellent resources to get you up and running:
|
||||||
|
|
|
@ -9,9 +9,9 @@ keywords: []
|
||||||
menu:
|
menu:
|
||||||
docs:
|
docs:
|
||||||
parent: "pipes"
|
parent: "pipes"
|
||||||
weight: 49
|
weight: 48
|
||||||
weight: 49
|
weight: 48
|
||||||
sections_weight: 49
|
sections_weight: 48
|
||||||
draft: false
|
draft: false
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
63
content/en/hugo-pipes/js.md
Normal file
63
content/en/hugo-pipes/js.md
Normal file
|
@ -0,0 +1,63 @@
|
||||||
|
---
|
||||||
|
title: JavaScript Building
|
||||||
|
description: Hugo Pipes can process JavaScript files with [ESBuild](https://github.com/evanw/esbuild).
|
||||||
|
date: 2020-07-20
|
||||||
|
publishdate: 2020-07-20
|
||||||
|
lastmod: 2020-07-20
|
||||||
|
categories: [asset management]
|
||||||
|
keywords: []
|
||||||
|
menu:
|
||||||
|
docs:
|
||||||
|
parent: "pipes"
|
||||||
|
weight: 45
|
||||||
|
weight: 45
|
||||||
|
sections_weight: 45
|
||||||
|
draft: false
|
||||||
|
---
|
||||||
|
|
||||||
|
Any JavaScript resource file can be transpiled and "tree shaken" using `js.Build` which takes for argument either a string for the filepath or a dict of options listed below.
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
targetPath [string]
|
||||||
|
: If not set, the source path will be used as the base target path.
|
||||||
|
Note that the target path's extension may change if the target MIME type is different, e.g. when the source is TypeScript.
|
||||||
|
|
||||||
|
minify [bool]
|
||||||
|
: Let `js.Build` handle the minification.
|
||||||
|
|
||||||
|
target [string]
|
||||||
|
: The language target.
|
||||||
|
One of: `es2015`, `es2016`, `es2017`, `es2018`, `es2019`, `es2020` or `esnext`.
|
||||||
|
Default is `esnext`.
|
||||||
|
|
||||||
|
externals [slice]
|
||||||
|
: External dependencies. If a dependency should not be included in the bundle (Ex. library loaded from a CDN.), it should be listed here.
|
||||||
|
|
||||||
|
```go-html-template
|
||||||
|
{{ $externals := slice "react" "react-dom" }}
|
||||||
|
```
|
||||||
|
|
||||||
|
defines [map]
|
||||||
|
: Allow to define a set of string replacement to be performed when building. Should be a map where each key is to be replaced by its value.
|
||||||
|
|
||||||
|
```go-html-template
|
||||||
|
{{ $defines := dict "process.env.NODE_ENV" `"development"` }}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
```go-html-template
|
||||||
|
{{ $built := resources.Get "js/index.js" | js.Build "main.js" }}
|
||||||
|
```
|
||||||
|
|
||||||
|
Or with options:
|
||||||
|
|
||||||
|
```go-html-template
|
||||||
|
{{ $externals := slice "react" "react-dom" }}
|
||||||
|
{{ $defines := dict "process.env.NODE_ENV" `"development"` }}
|
||||||
|
|
||||||
|
{{ $opts := dict "targetPath" "main.js" "externals" $externals "defines" $defines }}
|
||||||
|
{{ $built := resources.Get "scripts/main.js" | js.Build $opts }}
|
||||||
|
<script type="text/javascript" src="{{ $built.RelPermalink }}" defer></script>
|
||||||
|
```
|
BIN
content/en/news/0.74.0-relnotes/featured.png
Normal file
BIN
content/en/news/0.74.0-relnotes/featured.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 55 KiB |
85
content/en/news/0.74.0-relnotes/index.md
Normal file
85
content/en/news/0.74.0-relnotes/index.md
Normal file
|
@ -0,0 +1,85 @@
|
||||||
|
|
||||||
|
---
|
||||||
|
date: 2020-07-13
|
||||||
|
title: "Native JS Bundler, Open API Support, Inline Partials"
|
||||||
|
description: "Hugo 0.74.0 brings blazingly fast native JavaScript bundling, with minification, tree shaking, scope hoisting for ES6 modules, and transpilation of JSX and newer JS syntax down to ES6. And more."
|
||||||
|
categories: ["Releases"]
|
||||||
|
---
|
||||||
|
|
||||||
|
**Note:** The documentation site isn't updated with all of the main new things below. We will get to it soon. See https://github.com/gohugoio/hugoDocs/issues/1171
|
||||||
|
|
||||||
|
This release comes with native JavaScript bundling (and minifier), with [import](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import) support (from `node_modules` etc.), tree shaking, scope hoisting for ES6 modules, transpilation of JSX and newer JS syntax down to ES6, JavaScript/JSX and TypeScript/TSX support. And it's _very fast_. [Benchmarks](https://github.com/evanw/esbuild#benchmarks) rates it **at least 100x faster** than the other JavaScript bundlers included. This new feature is backed by the very impressive [ESBuild](https://github.com/evanw/esbuild) project by [@evanw](https://github.com/evanw). Many thanks to [@remko](https://github.com/remko) for the integration work.
|
||||||
|
|
||||||
|
A very simple example building a TypeScript file:
|
||||||
|
|
||||||
|
```go-html-template
|
||||||
|
{{ $js := resources.Get "js/main.ts" | js.Build }}
|
||||||
|
```
|
||||||
|
This release also comes with Open API 3-support. This makes it much easier to create "Swagger styled" API-documentation. The below will unmarshal your YAML file into [this object graph](https://godoc.org/github.com/getkin/kin-openapi/openapi3#Swagger):
|
||||||
|
|
||||||
|
```go-html-template
|
||||||
|
{{ $api := resources.Get "api/openapi.yaml" | openapi3.Unmarshal }}
|
||||||
|
```
|
||||||
|
|
||||||
|
Hugo's Asciidoc integration has also gotten a face lift. A big shoutout to [@muenchhausen](https://github.com/muenchhausen) and [@bwklein](https://github.com/bwklein) for their work on this.
|
||||||
|
|
||||||
|
And finally, [partials](https://gohugo.io/templates/partials/#inline-partials) can now be defined inline -- and that is way more useful than it sounds.
|
||||||
|
|
||||||
|
|
||||||
|
This release represents **23 contributions by 9 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 [@niklasfasching](https://github.com/niklasfasching), [@bwklein](https://github.com/bwklein), and [@muenchhausen](https://github.com/muenchhausen) for their ongoing contributions.
|
||||||
|
|
||||||
|
And a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the themes site in pristine condition and to [@davidsneighbour](https://github.com/davidsneighbour), [@coliff](https://github.com/coliff) 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 [@OmarEmaraDev](https://github.com/OmarEmaraDev), [@regisphilibert](https://github.com/regisphilibert), [@coliff](https://github.com/coliff), and [@jessicahuynh](https://github.com/jessicahuynh) for their work on the documentation site.
|
||||||
|
|
||||||
|
|
||||||
|
Hugo now has:
|
||||||
|
|
||||||
|
* 45377+ [stars](https://github.com/gohugoio/hugo/stargazers)
|
||||||
|
* 438+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
|
||||||
|
* 331+ [themes](http://themes.gohugo.io/)
|
||||||
|
|
||||||
|
## Enhancements
|
||||||
|
|
||||||
|
### Templates
|
||||||
|
|
||||||
|
* Add strings.Count [028b3567](https://github.com/gohugoio/hugo/commit/028b356787426dbc190ce9868fbc9a6400c2996e) [@bep](https://github.com/bep) [#7453](https://github.com/gohugoio/hugo/issues/7453)
|
||||||
|
* Add debug.Dump [defd7106](https://github.com/gohugoio/hugo/commit/defd7106bf79a502418ec373bdb82742b16f777f) [@bep](https://github.com/bep) [#3957](https://github.com/gohugoio/hugo/issues/3957)
|
||||||
|
|
||||||
|
### Output
|
||||||
|
|
||||||
|
* Add proper Media Type handling in js.Build [9df98ec4](https://github.com/gohugoio/hugo/commit/9df98ec49ca9fa326125ccfee626b6e46c6ab14b) [@bep](https://github.com/bep) [#732](https://github.com/gohugoio/hugo/issues/732)
|
||||||
|
|
||||||
|
### Core
|
||||||
|
|
||||||
|
* Add missing zero check on file [ccfaeb67](https://github.com/gohugoio/hugo/commit/ccfaeb678b312535928af3451324a54f2c7cb199) [@bep](https://github.com/bep)
|
||||||
|
|
||||||
|
### Other
|
||||||
|
|
||||||
|
* Regenerate docs helper [25e3da33](https://github.com/gohugoio/hugo/commit/25e3da3343b5cd4bbcd11fa76b382fb089971840) [@bep](https://github.com/bep)
|
||||||
|
* Add js.Build asset bundling [2fc33807](https://github.com/gohugoio/hugo/commit/2fc33807077cd25bf91f2298bf1a8ace126881a7) [@remko](https://github.com/remko) [#7321](https://github.com/gohugoio/hugo/issues/7321)
|
||||||
|
* Add openapi3.Unmarshal [12a65e76](https://github.com/gohugoio/hugo/commit/12a65e76df9470d9563b91a22969ddb41b7c19aa) [@bep](https://github.com/bep) [#7442](https://github.com/gohugoio/hugo/issues/7442)[#7443](https://github.com/gohugoio/hugo/issues/7443)
|
||||||
|
* Remove trailing hyphen from auto heading ID [58c0f5e6](https://github.com/gohugoio/hugo/commit/58c0f5e6171cbf8e3ed8d73ac95a7b85168c5b2f) [@jmooring](https://github.com/jmooring) [#6798](https://github.com/gohugoio/hugo/issues/6798)
|
||||||
|
* Ensure that non-trivial default flag values are passed through. [a1c3e3c1](https://github.com/gohugoio/hugo/commit/a1c3e3c1f32bcbc3b3aa6921bdee98a9f795a2da) [@vangent](https://github.com/vangent)
|
||||||
|
* Update formats.md doc for new allowed extensions. [e9f87c4e](https://github.com/gohugoio/hugo/commit/e9f87c4e3feee937d05504763935805fec26213c) [@bwklein](https://github.com/bwklein)
|
||||||
|
* Update config.go to add two Asciidoctor extensions [beb6c03b](https://github.com/gohugoio/hugo/commit/beb6c03bc8f476b753e5f3e3bc7a4a2e3f8ad355) [@bwklein](https://github.com/bwklein)
|
||||||
|
* Add support for inline partials [4a3efea7](https://github.com/gohugoio/hugo/commit/4a3efea7efe59cd3de7d0eb352836ab395a2b6b3) [@bep](https://github.com/bep) [#7444](https://github.com/gohugoio/hugo/issues/7444)
|
||||||
|
* Add support for native Org dates in frontmatter [c66dc6c7](https://github.com/gohugoio/hugo/commit/c66dc6c74fa3bbe308ccaade8c76071b49908129) [@sometimesfood](https://github.com/sometimesfood)
|
||||||
|
* Update go-org to v1.3.0 [127d5feb](https://github.com/gohugoio/hugo/commit/127d5feb32b466c4a0035e81f86684920dd88cfe) [@niklasfasching](https://github.com/niklasfasching)
|
||||||
|
* Update go-org to v1.2.0 [2d42ba91](https://github.com/gohugoio/hugo/commit/2d42ba912ba945230aa0be23c3c8256cba40ce99) [@niklasfasching](https://github.com/niklasfasching)
|
||||||
|
* Update bug_report.md [5b7b5dea](https://github.com/gohugoio/hugo/commit/5b7b5dea1fe3494995c6a9c3368087abf47cdc12) [@bep](https://github.com/bep)
|
||||||
|
* Remove some unused code [057b1377](https://github.com/gohugoio/hugo/commit/057b1377c5f4d0d80ee299293db06384a475ad19) [@bep](https://github.com/bep)
|
||||||
|
* Add an option to print memory usage at intervals [48dbb593](https://github.com/gohugoio/hugo/commit/48dbb593f7cc0dceb55d232ac198e82f3df1c964) [@bep](https://github.com/bep)
|
||||||
|
* Rework external asciidoctor integration [f0266e2e](https://github.com/gohugoio/hugo/commit/f0266e2ef3487bc57dd05402002fc816e3b40195) [@muenchhausen](https://github.com/muenchhausen)
|
||||||
|
* Enable the embedded template test when race detector is off [77aa385b](https://github.com/gohugoio/hugo/commit/77aa385b84dbc1805ff7e34dafeadb181905c689) [@bep](https://github.com/bep) [#5926](https://github.com/gohugoio/hugo/issues/5926)
|
||||||
|
* Merge branch 'release-0.73.0' [545a1c1c](https://github.com/gohugoio/hugo/commit/545a1c1cedc93d091050bae07c02fc2435ad2d20) [@bep](https://github.com/bep)
|
||||||
|
* Updated installation instruction about Sass/SCSS support [0b579db8](https://github.com/gohugoio/hugo/commit/0b579db80fba1bde7dab07ea92d622dd6214dcfb) [@mateusz-szczyrzyca](https://github.com/mateusz-szczyrzyca)
|
||||||
|
|
||||||
|
## Fixes
|
||||||
|
|
||||||
|
### Other
|
||||||
|
|
||||||
|
* Fix server reload when non-HTML shortcode changes [42e150fb](https://github.com/gohugoio/hugo/commit/42e150fbfac736bd49bc7e50cb8cdf9f81386f59) [@bep](https://github.com/bep) [#7448](https://github.com/gohugoio/hugo/issues/7448)
|
||||||
|
|
||||||
|
|
19
content/en/news/0.74.1-relnotes/index.md
Normal file
19
content/en/news/0.74.1-relnotes/index.md
Normal file
|
@ -0,0 +1,19 @@
|
||||||
|
|
||||||
|
---
|
||||||
|
date: 2020-07-13
|
||||||
|
title: "Hugo 0.74.1: A couple of Bug Fixes"
|
||||||
|
description: "This version fixes one issue introduced in 0.74.0."
|
||||||
|
categories: ["Releases"]
|
||||||
|
images:
|
||||||
|
- images/blog/hugo-bug-poster.png
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
This is a bug-fix release with one important fix.
|
||||||
|
|
||||||
|
* Fix baseof block regression [c91dbe4c](https://github.com/gohugoio/hugo/commit/c91dbe4ce9c30623ba6e686fd17efae935aa0cc5) [@bep](https://github.com/bep) [#7478](https://github.com/gohugoio/hugo/issues/7478)
|
||||||
|
|
||||||
|
|
||||||
|
|
24
content/en/news/0.74.2-relnotes/index.md
Normal file
24
content/en/news/0.74.2-relnotes/index.md
Normal file
|
@ -0,0 +1,24 @@
|
||||||
|
|
||||||
|
---
|
||||||
|
date: 2020-07-17
|
||||||
|
title: "Hugo 0.74.2: A couple of Bug Fixes"
|
||||||
|
description: "This version fixes a couple of bugs introduced in 0.74.0."
|
||||||
|
categories: ["Releases"]
|
||||||
|
images:
|
||||||
|
- images/blog/hugo-bug-poster.png
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Add .Defines to js.Build options [35011bcb](https://github.com/gohugoio/hugo/commit/35011bcb26b6fcfcbd77dc05aa8246ca45b2c2ba) [@bep](https://github.com/bep) [#7489](https://github.com/gohugoio/hugo/issues/7489)
|
||||||
|
|
||||||
|
This is needed to import `react` as a library, e.g.:
|
||||||
|
|
||||||
|
```
|
||||||
|
{{ $jsx := resources.Get "index.jsx" }}
|
||||||
|
{{ $options := dict "defines" (dict "process.env.NODE_ENV" "\"development\"") }}
|
||||||
|
{{ $js := $jsx | js.Build $options }}
|
||||||
|
```
|
||||||
|
|
||||||
|
|
|
@ -81,6 +81,21 @@ This means the partial will *only* be able to access those variables. The partia
|
||||||
|
|
||||||
In addition to outputting markup, partials can be used to return a value of any type. In order to return a value, a partial must include a lone `return` statement.
|
In addition to outputting markup, partials can be used to return a value of any type. In order to return a value, a partial must include a lone `return` statement.
|
||||||
|
|
||||||
|
## Inline partials
|
||||||
|
|
||||||
|
{{< new-in "0.74.0" >}}
|
||||||
|
|
||||||
|
You can also define partials inline in the template. But remember that template namespace is global, so you need to make sure that the names are unique to avoid conflicts.
|
||||||
|
|
||||||
|
```go-html-template
|
||||||
|
Value: {{ partial "my-inline-partial" . }}
|
||||||
|
|
||||||
|
{{ define "partials/my-inline-partial" }}
|
||||||
|
{{ $value := 32 }}
|
||||||
|
{{ return $value }}
|
||||||
|
{{ end }}
|
||||||
|
```
|
||||||
|
|
||||||
### Example GetFeatured
|
### Example GetFeatured
|
||||||
```go-html-template
|
```go-html-template
|
||||||
{{/* layouts/partials/GetFeatured.html */}}
|
{{/* layouts/partials/GetFeatured.html */}}
|
||||||
|
|
|
@ -1488,6 +1488,19 @@
|
||||||
"skipHTML": false,
|
"skipHTML": false,
|
||||||
"footnoteAnchorPrefix": "",
|
"footnoteAnchorPrefix": "",
|
||||||
"footnoteReturnLinkContents": ""
|
"footnoteReturnLinkContents": ""
|
||||||
|
},
|
||||||
|
"asciidocExt": {
|
||||||
|
"backend": "html5",
|
||||||
|
"docType": "article",
|
||||||
|
"extensions": [],
|
||||||
|
"attributes": {},
|
||||||
|
"noHeaderOrFooter": true,
|
||||||
|
"safeMode": "unsafe",
|
||||||
|
"sectionNumbers": false,
|
||||||
|
"verbose": true,
|
||||||
|
"trace": false,
|
||||||
|
"failureLevel": "fatal",
|
||||||
|
"workingFolderCurrent": false
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"minify": {
|
"minify": {
|
||||||
|
@ -1572,6 +1585,16 @@
|
||||||
"toml"
|
"toml"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"type": "application/typescript",
|
||||||
|
"string": "application/typescript",
|
||||||
|
"mainType": "application",
|
||||||
|
"subType": "typescript",
|
||||||
|
"delimiter": ".",
|
||||||
|
"suffixes": [
|
||||||
|
"ts"
|
||||||
|
]
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"type": "application/xml",
|
"type": "application/xml",
|
||||||
"string": "application/xml",
|
"string": "application/xml",
|
||||||
|
@ -1664,6 +1687,16 @@
|
||||||
"html"
|
"html"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"type": "text/jsx",
|
||||||
|
"string": "text/jsx",
|
||||||
|
"mainType": "text",
|
||||||
|
"subType": "jsx",
|
||||||
|
"delimiter": ".",
|
||||||
|
"suffixes": [
|
||||||
|
"jsx"
|
||||||
|
]
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"type": "text/plain",
|
"type": "text/plain",
|
||||||
"string": "text/plain",
|
"string": "text/plain",
|
||||||
|
@ -1674,6 +1707,16 @@
|
||||||
"txt"
|
"txt"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"type": "text/tsx",
|
||||||
|
"string": "text/tsx",
|
||||||
|
"mainType": "text",
|
||||||
|
"subType": "tsx",
|
||||||
|
"delimiter": ".",
|
||||||
|
"suffixes": [
|
||||||
|
"tsx"
|
||||||
|
]
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"type": "text/x-sass",
|
"type": "text/x-sass",
|
||||||
"string": "text/x-sass",
|
"string": "text/x-sass",
|
||||||
|
@ -3189,6 +3232,21 @@
|
||||||
"Examples": []
|
"Examples": []
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
"debug": {
|
||||||
|
"Dump": {
|
||||||
|
"Description": "Dump returns a object dump of val as a string.\nNote that not every value passed to Dump will print so nicely, but\nwe'll improve on that. We recommend using the \"go\" Chroma lexer to format the output\nnicely.\nAlso note that the output from Dump may change from Hugo version to the next,\nso don't depend on a specific output.",
|
||||||
|
"Args": [
|
||||||
|
"val"
|
||||||
|
],
|
||||||
|
"Aliases": null,
|
||||||
|
"Examples": [
|
||||||
|
[
|
||||||
|
"{{- $m := newScratch -}}\n{{- $m.Set \"Hugo\" \"Rocks!\" -}}\n{{- $m.Values | debug.Dump | safeHTML -}}",
|
||||||
|
"map[string]interface {}{\n \"Hugo\": \"Rocks!\",\n}"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
"encoding": {
|
"encoding": {
|
||||||
"Base64Decode": {
|
"Base64Decode": {
|
||||||
"Description": "Base64Decode returns the base64 decoding of the given content.",
|
"Description": "Base64Decode returns the base64 decoding of the given content.",
|
||||||
|
@ -3505,6 +3563,14 @@
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
"js": {
|
||||||
|
"Build": {
|
||||||
|
"Description": "",
|
||||||
|
"Args": null,
|
||||||
|
"Aliases": null,
|
||||||
|
"Examples": null
|
||||||
|
}
|
||||||
|
},
|
||||||
"lang": {
|
"lang": {
|
||||||
"Merge": {
|
"Merge": {
|
||||||
"Description": "",
|
"Description": "",
|
||||||
|
@ -3735,6 +3801,14 @@
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
"openapi3": {
|
||||||
|
"Unmarshal": {
|
||||||
|
"Description": "",
|
||||||
|
"Args": null,
|
||||||
|
"Aliases": null,
|
||||||
|
"Examples": []
|
||||||
|
}
|
||||||
|
},
|
||||||
"os": {
|
"os": {
|
||||||
"FileExists": {
|
"FileExists": {
|
||||||
"Description": "FileExists checks whether a file exists under the given path.",
|
"Description": "FileExists checks whether a file exists under the given path.",
|
||||||
|
@ -4229,6 +4303,20 @@
|
||||||
"Aliases": null,
|
"Aliases": null,
|
||||||
"Examples": null
|
"Examples": null
|
||||||
},
|
},
|
||||||
|
"Count": {
|
||||||
|
"Description": "Count counts the number of non-overlapping instances of substr in s.\nIf substr is an empty string, Count returns 1 + the number of Unicode code points in s.",
|
||||||
|
"Args": [
|
||||||
|
"substr",
|
||||||
|
"s"
|
||||||
|
],
|
||||||
|
"Aliases": null,
|
||||||
|
"Examples": [
|
||||||
|
[
|
||||||
|
"{{\"aabab\" | strings.Count \"a\" }}",
|
||||||
|
"3"
|
||||||
|
]
|
||||||
|
]
|
||||||
|
},
|
||||||
"CountRunes": {
|
"CountRunes": {
|
||||||
"Description": "CountRunes returns the number of runes in s, excluding whitepace.",
|
"Description": "CountRunes returns the number of runes in s, excluding whitepace.",
|
||||||
"Args": [
|
"Args": [
|
||||||
|
@ -4767,7 +4855,7 @@
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
"Unmarshal": {
|
"Unmarshal": {
|
||||||
"Description": "Unmarshal unmarshals the data given, which can be either a string\nor a Resource. Supported formats are JSON, TOML, YAML, and CSV.\nYou can optionally provide an options map as the first argument.",
|
"Description": "Unmarshal unmarshals the data given, which can be either a string, json.RawMessage\nor a Resource. Supported formats are JSON, TOML, YAML, and CSV.\nYou can optionally provide an options map as the first argument.",
|
||||||
"Args": [
|
"Args": [
|
||||||
"args"
|
"args"
|
||||||
],
|
],
|
||||||
|
|
|
@ -3,7 +3,7 @@ publish = "public"
|
||||||
command = "hugo --gc --minify"
|
command = "hugo --gc --minify"
|
||||||
|
|
||||||
[context.production.environment]
|
[context.production.environment]
|
||||||
HUGO_VERSION = "0.73.0"
|
HUGO_VERSION = "0.74.2"
|
||||||
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.73.0"
|
HUGO_VERSION = "0.74.2"
|
||||||
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.73.0"
|
HUGO_VERSION = "0.74.2"
|
||||||
|
|
||||||
[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.73.0"
|
HUGO_VERSION = "0.74.2"
|
||||||
|
|
||||||
[context.next.environment]
|
[context.next.environment]
|
||||||
HUGO_ENABLEGITINFO = "true"
|
HUGO_ENABLEGITINFO = "true"
|
||||||
|
|
Binary file not shown.
After Width: | Height: | Size: 27 KiB |
Binary file not shown.
After Width: | Height: | Size: 42 KiB |
Loading…
Reference in a new issue