{"id":15138714,"url":"https://github.com/sudocat/nunjucks-isomorphic-loader","last_synced_at":"2025-09-29T08:31:21.281Z","repository":{"id":57148924,"uuid":"82614070","full_name":"SudoCat/Nunjucks-Isomorphic-Loader","owner":"SudoCat","description":"Nunjucks loader for webpack, supporting both javascript templating and generating static HTML files through the HtmlWebpackPlugin.","archived":true,"fork":false,"pushed_at":"2018-08-22T13:32:51.000Z","size":17,"stargazers_count":16,"open_issues_count":3,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-09-26T07:43:42.590Z","etag":null,"topics":["html-webpack-plugin","nunjucks","webpack","webpack-loader"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SudoCat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-02-20T23:39:25.000Z","updated_at":"2023-01-28T18:17:45.000Z","dependencies_parsed_at":"2022-08-31T20:10:20.222Z","dependency_job_id":null,"html_url":"https://github.com/SudoCat/Nunjucks-Isomorphic-Loader","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SudoCat%2FNunjucks-Isomorphic-Loader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SudoCat%2FNunjucks-Isomorphic-Loader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SudoCat%2FNunjucks-Isomorphic-Loader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SudoCat%2FNunjucks-Isomorphic-Loader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SudoCat","download_url":"https://codeload.github.com/SudoCat/Nunjucks-Isomorphic-Loader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219874011,"owners_count":16554535,"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":["html-webpack-plugin","nunjucks","webpack","webpack-loader"],"created_at":"2024-09-26T07:43:52.030Z","updated_at":"2025-09-29T08:31:15.990Z","avatar_url":"https://github.com/SudoCat.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nunjucks Isomorphic loader for webpack\r\n\r\nNunjucks loader for webpack, supporting both javascript templating and generating static HTML files through the HtmlWebpackPlugin.\r\n\r\nCompletely rewritten, now (mostly) error free. Supports context file (.js only) for passing data.\r\n\r\nThis loader supports the following extensions: `.njk`, `.nunjucks`, `.html`, `.tpl`, `.tmpl`\r\n\r\n## Warning: (Mostly) Unmaintained\r\n\r\nUnfortunately, I rarely get much free time to work on this package any more. While I'll always try to answer any questions anyone has, it may take some time and I might not know the correct answer. Luckily the Open Source Community is filled with lovely people who have keep this updated and documented! \r\n\r\nSpecial thanks to:\r\n- [3dos](https://github.com/3dos)\r\n- [sebbdk](https://github.com/sebbdk)\r\n\r\n## Installation\r\n\r\nThis loader need [`nunjucks`](https://www.npmjs.com/package/nunjucks) as a peer dependency. Versions \u003e= 2.5.0 \u003c= 4.0.0 are accepted. If you do not have nunjucks already installed, first run:\r\n\r\nUsing yarn:\r\n\r\n```\r\nyarn add nunjucks -D\r\n```\r\n\r\nUsing npm:\r\n\r\n```\r\nnpm install nunjucks -D\r\n```\r\n\r\nIf you have nunjucks installed, you can then install the loader.\r\n\r\nUsing yarn:\r\n\r\n```\r\nyarn add nunjucks-isomorphic-loader -D\r\n```\r\n\r\nUsing npm:\r\n\r\n```\r\nnpm install nunjucks-isomorphic-loader -D\r\n```\r\n\r\n## Usage\r\n\r\nBasic usage of this loader with `html-webpack-plugin`\r\n\r\n```\r\nmodule: {\r\n  rules: [\r\n    {\r\n      test: /\\.(njk|nunjucks|html|tpl|tmpl)$/,\r\n      use: [\r\n        {\r\n          loader: 'nunjucks-isomorphic-loader',\r\n          query: {\r\n            root: [path.resolve(__dirname, 'path/to/templates/root')]\r\n          }\r\n        }\r\n      ]\r\n    }\r\n  ]\r\n},\r\n\r\nplugins: [\r\n  new HtmlWebpackPlugin({\r\n    customData: { foo: 'bar' },\r\n    filename: 'list.html',\r\n    template: 'path/to/template.njk'\r\n  })\r\n]\r\n```\r\n\r\nAccessing data from the templates with the above config of `html-webpack-plugin`\r\n\r\n`path/to/template.njk` :\r\n\r\n```\r\n{% set vars = htmlWebpackPlugin.options.customData %}\r\n\r\n\u003c!DOCTYPE html\u003e\r\n\u003chtml\u003e\r\n  \u003chead\u003e\r\n    \u003cmeta charset=\"utf-8\"\u003e\r\n    \u003ctitle\u003e{{ vars.foo }}\u003c/title\u003e{# outputs 'bar' #}\r\n  \u003c/head\u003e\r\n  \u003cbody\u003e\r\n    \u003cheader class=\"header\"\u003e\r\n    {% block header %}\r\n      \u003ch1 class=\"header-logo\"\u003e\r\n        \u003ca href=\"#\"\u003e{{ vars.foo }}\u003c/a\u003e{# outputs 'bar' #}\r\n      \u003c/h1\u003e\r\n    {% endblock %}\r\n    \u003c/header\u003e\r\n\r\n    {% block content %}\r\n      \u003csection\u003e\r\n        \u003cp\u003eI was generated with html-webpack-plugin and nunjucks-isomorphic-loader!\u003c/p\u003e\r\n      \u003c/section\u003e\r\n    {% endblock %}\r\n  \u003c/body\u003e\r\n\u003c/html\u003e\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudocat%2Fnunjucks-isomorphic-loader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsudocat%2Fnunjucks-isomorphic-loader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsudocat%2Fnunjucks-isomorphic-loader/lists"}