HTMLBeautify v0.85

SublimeText (版本2 & 3)

• (受到John Watson的fhtml.pl的启发)
• 由Ross A. Reyman
• 2015年2月20日
• 网址：http://reyman.name/
• 电子邮件：ross[at]reyman[dot]name

---

Sublime Text的插件，用于格式化（缩进）HTML源代码。它使代码更容易阅读。

---

按键命令恢复原始设置

由于与Sublime Text中的其他快捷键冲突，我将快捷键恢复到原始设置

• Mac OS X: Command-Option-Shift-F
• Windows: Control-Alt-Shift-F
• Linux: Control-Alt-Shift-F

(要更改此设置，请参阅下面的说明…)

注意

• 此脚本假设用户已经尝试将标记扩展到不同的行。此脚本不会自动展开最小化/压缩的代码——它只会尝试“清理”需要重新缩进的代码
  • 但是，您可以使用多个光标（查找全部替换 在标签的开始处（<）将每个标记放在新行上，在应用美化之前，这将有助于此情况。

• 目前，此脚本在对内联注释处理上有些困难。

  • 例如

    <div class="something">

  • 因此，一种解决方法是将注释保留在其自己的行上

    “

    <div class="something">

    ”

  • (待修复：Fix this!)

• 此脚本使用 \t 字符创建缩进级别和间距——ST似乎会尊重用户在ST设置中首选空格还是制表符，并相应地进行调整。

• 使用 tag_pos_inline 设置来定义可能会出现在同一行的标记。

• Windows用户：您必须重新启动Sublime Text才能完成安装。

安装（包控制）

如果您已在Sublime Text中安装了Package Control

• 打开命令面板（工具 > 命令面板…）
• 搜索并选择“Package Control：安装包”（等待几秒钟以获取可用包的列表）
• 搜索“HTMLBeautify”并安装。
• Windows用户需要重启Sublime Text来完成安装。

安装（手动）

• 下载zip文件，将结果文件夹重命名为：HTMLBeautify，然后将其放入您的Sublime Text包文件夹中。

使用方法

• 打开包含HTML的文件。
• 选择您想要美化的HTML代码。（如果没有选择，插件将在整个文件上运行。）
• 使用合适的键命令运行HTMLBeautify，或者从编辑菜单使用HTMLBeautify。
• 您可以使用HTMLBeautifyTest.html测试脚本：这是一个带有奇怪缩进的HTML文件，您可以从中了解此脚本的工作方式。

设置

您可以配置哪些标签应该通过此脚本处理

• ignored_tag_opening：哪些开启标签告诉脚本忽略HTMLBeautify格式化？

• ignored_tag_closing：哪些关闭标签告诉脚本恢复HTMLBeautify格式化？

• tag_indent：如果遇到这些开启标签之一，下一行内容将缩进一级。

• tag_unindent：如果遇到这些关闭标签之一，下一行将被缩进一级。

• tag_unindent_line：如果遇到这些关闭标签之一，此行将被缩进一级。

• tag_pos_inline：这些是特殊“单行”标签，它们在同一行上打开和关闭，所以应该忽略缩进。

• remove_extraline：设置为true以删除空行。

更改键绑定

您可以在您的键图文件中创建自己的自定义键图（键命令/宏）：包夹/User/Default[OS].sublime-keymap

{
    "keys": ["super+alt+shift+f"], //  create your own key command combination here!
    "command": "html_beautify", // command that executes html_beautify
    "context": [{
        // these options ensure that the command is executed in the right files/context
        "key": "selector",
        "operator": "equal",
        "operand": "text.html,text.html.twig,text.twig,source.html,source.html.twig,source.twig"
    }]
}

更多详情：Sublime Text非官方文档：键绑定

免责声明

此脚本已在基本的HTML编码情况下进行了测试，但性能可能会有所不同——在生产环境中使用时请小心，并请报告错误或为此脚本提供修正！（请确保此脚本按照预期工作！作者不对您HTML中引入的任何错误负责。：）