Merge commit '5be51ac3db225d5df501ed1fa1499c41d97dbf65'

This commit is contained in:
Bjørn Erik Pedersen
2025-04-10 13:04:51 +02:00
987 changed files with 12379 additions and 14083 deletions

View File

@@ -3,17 +3,11 @@ title: js.Babel
description: Compile the given JavaScript resource with Babel.
categories: []
keywords: []
action:
aliases: [babel]
related:
- functions/js/Batch
- functions/js/Build
- functions/resources/Fingerprint
- functions/resources/Minify
returnType: resource.Resource
signatures: ['js.Babel [OPTIONS] RESOURCE']
weight: 30
toc: true
params:
functions_and_methods:
aliases: [babel]
returnType: resource.Resource
signatures: ['js.Babel [OPTIONS] RESOURCE']
---
```go-html-template
@@ -37,18 +31,21 @@ toc: true
## Setup
Step 1
: Install [Node.js](https://nodejs.org/en/download)
### Step 1
Step 2
: Install the required Node.js packages in the root of your project.
Install [Node.js](https://nodejs.org/en/download)
### Step 2
Install the required Node.js packages in the root of your project.
```sh
npm install --save-dev @babel/core @babel/cli
```
Step 3
: Add the babel executable to Hugo's `security.exec.allow` list in your site configuration:
### Step 3
Add the babel executable to Hugo's `security.exec.allow` list in your site configuration:
{{< code-toggle file=hugo >}}
[security.exec]
@@ -75,32 +72,28 @@ module.exports = {
## Options
###### compact
compact
: (`bool`) Whether to remove optional newlines and whitespace. Enabled when `minified` is `true`. Default is `false`
(`bool`) Whether to remove optional newlines and whitespace. Enabled when `minified` is `true`. Default is `false`
config
: (`string`) Path to the Babel configuration file. Hugo will, by default, look for a `babel.config.js` file in the root of your project. See&nbsp;[details](https://babeljs.io/docs/en/configuration).
###### config
minified
: (`bool`) Whether to minify the compiled code. Enables the `compact` option. Default is `false`.
(`string`) Path to the Babel configuration file. Hugo will, by default, look for a `babel.config.js` file in the root of your project. See [details](https://babeljs.io/docs/en/configuration).
noBabelrc
: (`string`) Whether to ignore `.babelrc` and `.babelignore` files. Default is `false`.
###### minified
noComments
: (`bool`) Whether to remove comments. Default is `false`.
(`bool`) Whether to minify the compiled code. Enables the `compact` option. Default is `false`.
sourceMap
: (`string`) Whether to generate source maps, one of `external`, `inline`, or `none`. Default is `none`.
###### noBabelrc
verbose
: (`bool`) Whether to enable verbose logging. Default is `false`
(`string`) Whether to ignore `.babelrc` and `.babelignore` files. Default is `false`.
###### noComments
(`bool`) Whether to remove comments. Default is `false`.
###### sourceMap
(`string`) Whether to generate source maps, one of `external`, `inline`, or `none`. Default is `none`.
<!-- In the above, technically "none" is not one of the enumerated values, but it has the same effect and is easier to document than an empty string. -->
###### verbose
(`bool`) Whether to enable verbose logging. Default is `false`
<!--
In the above, technically "none" is not one of the enumerated sourceMap
values but it has the same effect and is easier to document than an empty string.
-->