hugo/docs/content/en/hugo-pipes/js.md
2020-07-20 22:20:33 +02:00

1.9 KiB

title description date publishdate lastmod categories keywords menu weight sections_weight draft
JavaScript Building Hugo Pipes can process JavaScript files with [ESBuild](https://github.com/evanw/esbuild). 2020-07-20 2020-07-20 2020-07-20
asset management
docs
parent weight
pipes 45
45 45 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.
{{ $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.
{{ $defines := dict "process.env.NODE_ENV" `"development"` }}

Examples

{{ $built := resources.Get "js/index.js" | js.Build "main.js" }}

Or with options:

{{ $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>