Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/marlonluan/hugo-bin-extended
Binary Hugo extended via npm
https://github.com/marlonluan/hugo-bin-extended
hugo npm
Last synced: 28 days ago
JSON representation
Binary Hugo extended via npm
- Host: GitHub
- URL: https://github.com/marlonluan/hugo-bin-extended
- Owner: MarlonLuan
- License: mit
- Created: 2020-07-14T10:06:49.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-29T00:14:17.000Z (about 1 month ago)
- Last Synced: 2024-10-11T22:22:55.106Z (28 days ago)
- Topics: hugo, npm
- Language: JavaScript
- Homepage:
- Size: 2.42 MB
- Stars: 6
- Watchers: 4
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# hugo-bin-extended [](https://www.npmjs.com/package/hugo-bin-extended) [](https://github.com/MarlonLuan/hugo-bin-extended/actions?query=workflow%3ACI+branch%3Amain)
> Binary wrapper for [Hugo](https://github.com/gohugoio/hugo)
- hugo-bin-extended supports the [Extended Hugo version](https://github.com/gohugoio/hugo/releases/tag/v0.43)
- For usage within corporate networks or behind corporate proxies, the download repository can be overwritten
See [Installation options](#installation-options) for more details.
## Install
```sh
npm install hugo-bin-extended --save-dev
```
## Usage
### API
```js
import { execFile } from 'node:child_process';
import hugoPath from 'hugo-bin-extended';
execFile(hugoPath, ['version'], (error, stdout) => {
if (error) {
throw error;
}
console.log(stdout);
});
```
### CLI
#### Unix
```sh
npm exec hugo help
npm run create -- post/my-new-post.md # see below 'npm run-script'
```
#### Windows
```bat
npm exec hugo help
rem see below 'npm run-script'
npm run create -- post/my-new-post.md
```
### npm run-script
```json
{
"scripts": {
"build": "hugo",
"create": "hugo new",
"serve": "hugo server"
}
}
```
See the [Hugo Documentation](https://gohugo.io/) for more information.
## Installation options
> [!NOTE]
> You have to run `npm install hugo-bin-extended` to reinstall `hugo-bin-extended` itself if you change any of these options.
hugo-bin-extended supports options to change the variation of Hugo binaries, to overwrite the download repository and the Hugo version.
Each option can be configured in one of the following ways:
### The `hugo-bin-extended` section of your `package.json`
```json
{
"name": "your-package",
"version": "0.0.1",
"hugo-bin-extended": {
"downloadRepo": "https://some.example.com/artifactory/github-releases",
"version": "0.124.1"
}
}
```
### As local or global [.npmrc](https://docs.npmjs.com/files/npmrc) configuration file
```ini
hugo_bin_download_repo = "https://some.example.com/artifactory/github-releases"
hugo_bin_hugo_version = "0.124.1"
```
### As environment variables
On Linux/macOS:
```sh
export HUGO_BIN_DOWNLOAD_REPO="https://some.example.com/artifactory/github-releases"
export HUGO_BIN_HUGO_VERSION="0.124.1"
```
On Windows:
```bat
set HUGO_BIN_DOWNLOAD_REPO=https://some.example.com/artifactory/github-releases
set HUGO_BIN_HUGO_VERSION=0.124.1
```
### Options
#### buildTags
- Type: `string`
- Default: `""`
Set `buildTags` to `extended` to download the [extended version](https://github.com/gohugoio/hugo/releases/tag/v0.43) binary.
If this is set to `extended` but it's not available for the user's platform, then the normal version will be downloaded instead.
#### downloadRepo
- Type: `string`
- Default: `"https://github.com"`
Set it to your proxy URL to download the hugo binary from a different download repository.
#### hugoVersion
- Type: `string`
- Default: the version specified in [package.json](package.json)
You can override the Hugo version here. Please note that if any of the URLs have changed upstream, you might not be able to use
any version and you will probably need to update to a newer hugo-bin-extended version which takes into consideration the new URLs.
## Super Inspired By
- [mastilver/apex-bin](https://github.com/mastilver/apex-bin)
- [imagemin/jpegtran-bin](https://github.com/imagemin/jpegtran-bin)
- [fenneclab/hugo-bin](https://github.com/fenneclab/hugo-bin)
## License
[MIT](LICENSE) © [Marlon Luan](https://www.MarlonLuan.com/)