{"id":14981429,"url":"https://github.com/jakejarvis/hugo-extended","last_synced_at":"2025-10-02T22:31:27.583Z","repository":{"id":38214989,"uuid":"237325867","full_name":"jakejarvis/hugo-extended","owner":"jakejarvis","description":"✏️ Plug-and-play Node.js wrapper for Hugo Extended, the awesomest static-site generator.","archived":false,"fork":true,"pushed_at":"2025-01-17T02:06:48.000Z","size":1945,"stargazers_count":27,"open_issues_count":12,"forks_count":6,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-01-20T00:51:37.634Z","etag":null,"topics":["bin","binary","cli","front-end","gohugoio","hugo","hugo-extended","node","npm","wrapper"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/hugo-extended","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"fenneclab/hugo-bin","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jakejarvis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-01-30T23:28:48.000Z","updated_at":"2025-01-17T02:06:17.000Z","dependencies_parsed_at":"2023-02-10T16:01:37.352Z","dependency_job_id":"f00d4362-7c22-4f2e-9cac-ed4f7558d8a2","html_url":"https://github.com/jakejarvis/hugo-extended","commit_stats":{"total_commits":451,"total_committers":12,"mean_commits":"37.583333333333336","dds":0.5565410199556541,"last_synced_commit":"89897960231ef5dd558a4f344bac88b0290da708"},"previous_names":[],"tags_count":100,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakejarvis%2Fhugo-extended","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakejarvis%2Fhugo-extended/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakejarvis%2Fhugo-extended/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakejarvis%2Fhugo-extended/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jakejarvis","download_url":"https://codeload.github.com/jakejarvis/hugo-extended/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235049009,"owners_count":18927715,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bin","binary","cli","front-end","gohugoio","hugo","hugo-extended","node","npm","wrapper"],"created_at":"2024-09-24T14:03:33.582Z","updated_at":"2025-10-02T22:31:27.256Z","avatar_url":"https://github.com/jakejarvis.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"https://raw.githubusercontent.com/gohugoio/gohugoioTheme/master/static/images/hugo-logo-wide.svg?sanitize=true\" alt=\"Hugo\" width=\"115\"\u003e via NPM [![npm](https://img.shields.io/npm/v/hugo-extended?color=blue\u0026logo=npm)](https://www.npmjs.com/package/hugo-extended) [![CI status](https://github.com/jakejarvis/hugo-extended/workflows/Run%20tests/badge.svg)](https://github.com/jakejarvis/hugo-extended/actions)\n\n\u003e Plug-and-play binary wrapper for [Hugo Extended](https://gohugo.io/), the awesomest static-site generator.\n\n## Installation\n\n```sh\nnpm install hugo-extended --save-dev\n# or...\nyarn add hugo-extended --dev\n```\n\n`hugo-extended` defaults to the [extended version](https://gohugo.io/troubleshooting/faq/#i-get--this-feature-is-not-available-in-your-current-hugo-version) of Hugo on [supported platforms](https://github.com/gohugoio/hugo/releases), and automatically falls back to vanilla Hugo if unsupported (mainly on 32-bit systems).\n\nThis package's version numbers align with Hugo's — `hugo-extended@0.64.1` installs Hugo v0.64.1, for example.\n\n_Note:_ If you'll be using the SCSS features of Hugo Extended, it's probably smart to install [`postcss`](https://www.npmjs.com/package/postcss), [`postcss-cli`](https://www.npmjs.com/package/postcss-cli), and [`autoprefixer`](https://www.npmjs.com/package/autoprefixer) as devDependencies too, since they can be conveniently called via [built-in Hugo pipes](https://gohugo.io/hugo-pipes/postcss/):\n\n```sh\nnpm install postcss postcss-cli autoprefixer --save-dev\n# or...\nyarn add postcss postcss-cli autoprefixer --dev\n```\n\n## Usage\n\nThe following examples simply refer to downloading and executing Hugo as a Node dependency. See the [official Hugo docs](https://gohugo.io/documentation/) for guidance on actual Hugo usage.\n\n### via CLI / `package.json`:\n\nThe `build:preview` script below is designed for [Netlify deploy previews](https://www.netlify.com/blog/2016/07/20/introducing-deploy-previews-in-netlify/), where [`$DEPLOY_PRIME_URL`](https://docs.netlify.com/configure-builds/environment-variables/#deploy-urls-and-metadata) is substituted for the base URL (usually ending in .netlify.app) of each pull request, branch, or commit preview.\n\n```jsonc\n// package.json:\n\n{\n  // ...\n  \"scripts\": {\n    \"build\": \"hugo\",\n    \"build:preview\": \"hugo --baseURL \\\"${DEPLOY_PRIME_URL:-/}\\\" --buildDrafts --buildFuture\",\n    \"start\": \"hugo server\"\n  },\n  \"devDependencies\": {\n    \"autoprefixer\": \"^10.3.4\",\n    \"hugo-extended\": \"^0.88.1\",\n    \"postcss\": \"^8.3.6\",\n    \"postcss-cli\": \"^8.3.1\"\n  }\n  // ...\n}\n```\n\n```bash\n$ npm run start\n\nStart building sites …\nhugo v0.88.1-5BC54738+extended darwin/amd64 BuildDate=2021-09-04T09:39:19Z VendorInfo=gohugoio\n\n                   | EN\n-------------------+------\n  Pages            |  50\n  Paginator pages  |   0\n  Non-page files   | 138\n  Static files     |  39\n  Processed images |  63\n  Aliases          |   0\n  Sitemaps         |   1\n  Cleaned          |   0\n\nBuilt in 2361 ms\nWatching for changes in {archetypes,assets,content,data,layouts,package.json,static}\nWatching for config changes in config.toml\nEnvironment: \"development\"\nServing pages from memory\nWeb Server is available at http://localhost:1313/ (bind address 127.0.0.1)\n```\n\n### via API:\n\n```js\n// version.js:\n\nimport hugo from \"hugo-extended\";\nimport { execFile } from \"child_process\";\n\n(async () =\u003e {\n  const binPath = await hugo();\n\n  execFile(binPath, [\"version\"], (error, stdout) =\u003e {\n    console.log(stdout);\n  });\n})();\n```\n\n```bash\n$ node version.js\nhugo v0.88.1-5BC54738+extended darwin/amd64 BuildDate=2021-09-04T09:39:19Z VendorInfo=gohugoio\n```\n\n## Examples\n\n- [jakejarvis/jarv.is](https://github.com/jakejarvis/jarv.is)\n\n## License\n\nThis project is distributed under the [MIT License](LICENSE.md). Hugo is distributed under the [Apache License 2.0](https://github.com/gohugoio/hugo/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakejarvis%2Fhugo-extended","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjakejarvis%2Fhugo-extended","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakejarvis%2Fhugo-extended/lists"}