mirror of
https://github.com/jakejarvis/hugo-extended.git
synced 2025-04-26 10:05:23 -04:00
115 lines
2.7 KiB
Markdown
115 lines
2.7 KiB
Markdown
# hugo-bin [](https://travis-ci.org/fenneclab/hugo-bin) [](https://david-dm.org/fenneclab/hugo-bin) [](https://david-dm.org/fenneclab/hugo-bin?type=dev)
|
|
|
|
> Binary wrapper for [Hugo](https://gohugo.io/)
|
|
|
|
## Install
|
|
|
|
```sh
|
|
npm install hugo-bin --save-dev
|
|
```
|
|
|
|
hugo-bin now supports the [Extended Hugo version](https://github.com/gohugoio/hugo/releases/tag/v0.43). See [Installation options](#installation-options) for more details.
|
|
|
|
## Usage
|
|
|
|
### API
|
|
|
|
```js
|
|
const { execFile } = require('child_process');
|
|
const hugo = require('hugo-bin');
|
|
|
|
execFile(hugo, ['version'], (error, stdout) => {
|
|
if (error) {
|
|
throw error;
|
|
}
|
|
|
|
console.log(stdout);
|
|
});
|
|
```
|
|
|
|
### CLI
|
|
|
|
```sh
|
|
$(npm bin)/hugo --help
|
|
npm run create -- post/my-new-post.md # see below 'npm run-script'
|
|
```
|
|
|
|
or on Windows:
|
|
|
|
```bat
|
|
for /f "delims=" %F in ('npm bin') do call "%F\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
|
|
|
|
hugo-bin supports options to change the variation of Hugo binaries.
|
|
|
|
Each option can be configured in the `hugo-bin` section of your `package.json`:
|
|
|
|
```json
|
|
{
|
|
"name": "your-package",
|
|
"version": "0.0.1",
|
|
"hugo-bin": {
|
|
"buildTags": "extended"
|
|
}
|
|
}
|
|
```
|
|
|
|
Also as local or global [.npmrc](https://docs.npmjs.com/files/npmrc) configuration file:
|
|
|
|
```ini
|
|
hugo_bin_build_tags = "extended"
|
|
```
|
|
|
|
Also as an environment variable:
|
|
|
|
```sh
|
|
export HUGO_BIN_BUILD_TAGS="extended"
|
|
```
|
|
|
|
**Note that you have to run `npm install hugo-bin` to re-install hugo-bin itself, if you change any of these options.**
|
|
|
|
### Options
|
|
|
|
#### buildTags
|
|
|
|
Default: `""`
|
|
|
|
Set it 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.
|
|
|
|
## Supported versions
|
|
|
|
See [the package.json commit history](https://github.com/fenneclab/hugo-bin/commits/master/package.json).
|
|
|
|
## Full example
|
|
|
|
- [fenneclab/blog.fenneclab.com](https://github.com/fenneclab/blog.fenneclab.com)
|
|
|
|
## Super Inspired By
|
|
|
|
- [mastilver/apex-bin](https://github.com/mastilver/apex-bin)
|
|
- [imagemin/jpegtran-bin](https://github.com/imagemin/jpegtran-bin)
|
|
|
|
## License
|
|
|
|
MIT © [Shun Sato](http://blog.fenneclab.com/)
|