Nunjucks

用于 Nunjucks 模板引擎的 Sublime Text 软件包。

特性

• 增强的语法高亮
• 内置标签、过滤器、函数的自动完成
• 额外代码段
• 额外快捷键
• 智能缩进

安装

通过软件包控制（推荐）

• 打开命令面板
• 选择 Package Control: Install Packages
• 搜索 Nunjucks

通过 GitHub 仓库

• 打开命令面板
• 选择 Package Control: Add Repository
• 将 https://github.com/alsolovyev/Nunjucks 粘贴到打开的域并按回车
• 打开命令面板
• 选择 Package Control: Install Packages
• 搜索 Nunjucks

要更新软件包，选择 Package Control: Upgrade Package，再选择 Nunjucks

手动下载 sublime-package 文件

• 下载 sublime-package 文件：Nunjucks.sublime-package
• 将其移动到您 Sublime Text 的 已安装包 目录中
  • Windows: %APPDATA%\Sublime Text 3\Installed Packages
  • OS X: ~/Library/Application\ Support/Sublime\ Text\ 3/Installed\ Packages
  • Linux: ~/.config/sublime-text-3/Installed Packages

手动下载仓库

• 克隆 仓库
• 将其提取到您 Sublime Text 的 包 目录中
  • Windows: %APPDATA%\Sublime Text 3\Packages
  • OS X: ~/Library/Application\ Support/Sublime\ Text\ 3/Packages
  • Linux: ~/.config/sublime-text-3/Packages

文档

语法

• Nunjucks - HTML 基础
• Nunjucks PHP - 支持PHP语法

过滤器

您可以 创建 自定义过滤器或使用 内置 过滤器之一

• abs - 返回参数的绝对值
• batch - 返回一个包含指定项目数量的列表列表
• capitalize - 将第一个字母转换为大写
• center - 在指定宽度的字段中居中值
• default - 如果值未定义则返回默认值
• dictsort - 对dict进行排序并生成（键，值）对
• dump - 在对象上调用JSON.stringify并将结果输出到模板
• escape - 将字符串中的字符 &，<，>，‘，和 ” 转换为HTML安全序列
• first - 获取数组中的第一个元素或如果是字符串则获取第一个字母
• float - 将值转换为浮点数
• forceescape - 强制HTML转义
• groupby - 根据共同属性对对象序列进行分组
• indent - 使用空格缩进字符串
• int - 将值转换为整数
• join - 返回一个字符串，它是序列中字符串的连接
• last - 获取数组中的最后一个元素或如果是字符串则获取最后一个字母
• length - 返回数组或字符串的长度，或对象的键数
• list - 将值转换为列表
• lower - 将字符串转换成全小写
• nl2br - 将换行符替换为<br /> HTML元素
• random - 从数组中随机选择一个值
• reject - 通过对每个对象应用测试来过滤对象序列，并拒绝测试成功的对象
• rejectattr - 通过将测试应用到每个对象的指定属性上来过滤对象序列，并拒绝测试成功的对象
• replace - 替换一个项目为另一个项目
• reverse - 反转一个字符串
• round - 四舍五入一个数字
• safe - 将值标记为安全
• select - 通过对每个对象应用测试来过滤对象序列，并仅选择测试成功的对象
• selectattr - 通过将测试应用到每个对象的指定属性上来过滤对象序列，并仅选择测试成功的对象
• slice - 切分迭代器并返回包含那些项的列表列表
• sort - 使用JavaScript的arr.sort函数对arr进行排序
• string - 将对象转换为字符串
• striptags - 删除SGML/XML标签并用一个空格替换相邻的空白
• sum - 输出数组项的总和
• title - 将字符串的首字母大写
• trim - 去除字符串前后空白
• truncate - 返回字符串的截断副本
• upper - 将字符串转换为大写
• urlencode - 使用UTF-8编码对字符串进行URL转义
• urlize - 将纯文本中的URL转换为可点击链接
• wordcount - 统计并输出字符串中的单词数

全局函数

• range - 遍历一组指定的数字
• cycler - 在多个值之间旋转
• joiner - 结合多个项目，除了第一次

片段

• { - 用于变量的花括号
• % - 用于代码的花括号
• bl - 在模板中定义一个区域
• cb - BEGIN-END 注释块
• cl - 使用标签内的所有文本调用宏
• co - 用于注释的花括号
• ext - “扩展”另一个模板
• fl - 自定义过滤器模板
• for - For循环
• fr - 从模板中导入特定的值
• fras - 从模板中导入特定的值并将其绑定到变量
• if - If语句
• ife - If…Else语句
• iif - 行内If语句
• im - 导入模板
• imas - 导入模板并将其绑定到变量
• inc - 包含模板
• mc - 定义可重用的内容块（宏）
• raw - 将标签内的代码以纯文本形式输出
• set - 创建/修改变量
• setb - 创建/修改变量（块）

自动补全

当前可用于 Nunjucks 模板引擎所有支持的关键词、标签、内置函数和过滤器的自动补全。访问官方文档了解详细信息。

如果由于某些原因自动补全弹出窗口没有出现，您需要将text.html.njk添加到自动补全选择器

• 打开命令面板
• 选择首选项: 设置
• 查找 auto_complete_selector
• 添加 text.html.njk

快捷键组合

• 连续按两次 shift + { 将变为 {{ | }}
• 在 {} 内按 shift + % 将变为 {% | %}
• 在 {} 内按 shift + # 将变为 {# | #}

备注

本软件包是基于我对 Nunjucks 模板引擎的个人经验而创建的。由于我在编写过程中可能遗漏了一些东西，请您告知我任何不准确之处或希望看到的额外片段。

感谢您下载这个软件包，希望您会喜欢它。

链接

• Nunjucks 模板引擎
• Sublime Text 社区 文档
• .sublime-syntax 文件的 文档
• 缩进设置 的 文档
• 菜单 的 文档
• Oniguruma 正则表达式引擎 的 文档
• 推荐的 作用域名称
• 命名约定

许可证

本项目遵循 MIT 许可证。