https://github.com/fefeding/vite-nunjucks-plugin

vite构建时处理nunjucks模板指定的变量和include文件
https://github.com/fefeding/vite-nunjucks-plugin

Last synced: 2 months ago
JSON representation

vite构建时处理nunjucks模板指定的变量和include文件

• Host: GitHub
• URL: https://github.com/fefeding/vite-nunjucks-plugin
• Owner: fefeding
• Created: 2025-09-11T07:08:18.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-09-11T08:07:54.000Z (7 months ago)
• Last Synced: 2025-10-16T07:32:26.957Z (6 months ago)
• Language: TypeScript
• Size: 42 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

          
# `@fefeding/vite-nunjucks-plugin`

🔧 一个专为 Vite 设计的 **轻量级 Nunjucks 模板插件**，支持核心语法：**变量替换**、**条件判断**和**模板包含**，未传入的变量会保持原样不报错。

---

## 核心功能

🔹 **变量替换**：仅替换 `variables` 中定义的变量，其余保持不变  

🔹 **条件判断**：支持 `{% if %}...{% endif %}` 逻辑控制  

🔹 **模板包含**：支持 `{% include %}` 引入子模板  

🔹 **安全处理**：未定义变量/属性保留原模板内容  

---

## 安装

```bash

npm install @fefeding/vite-nunjucks-plugin --save-dev

# 或

yarn add @fefeding/vite-nunjucks-plugin -D

```

## 示例

```ts

// 引入插件

import ViteNunjucksPlugin from '@fefeding/vite-nunjucks-plugin';

```

```ts

defineConfig({

    plugins: [

        vue() as PluginOption, 

        vueJsx() as PluginOption,

        // 处理模板

        ViteNunjucksPlugin({

            variables: {

                prefix: '', // 构建时，去掉这种prefix前缀，vite会处理依赖关系

                viteTarget: '',// 构建之后的不加base

            }

        }),

    ]

})

```