pángǔ.vim

盘古插件用于自动格式化、规范化中文排版。

它会将一些不规范，或不推荐的排版方式，在保存文件时进行自动格式化、规范化。

功能

• 中英文字符间增加一个半角空白。
• 特殊的，日期可以指定不添加空白。
• 中文前后的半角标点转成全角标点。
• 全角英文、数字转成半角字符。
• 连续的句号自动转省略号。
• 感叹号、问号最多允许连续重复 3 次。
• 其他中文标点符号不允许重复出现。
• 剔除不可见空白。

- 中文和English之间要有空白.
+ 中文和 English 之间要有空白。

  let g:pangu_rule_date = 0
- 今天是 2022 年 1 月 21 日星期五。
+ 今天是2022年1月21日星期五。

  let g:pangu_rule_date = 1
- 今天是2022年1月21日星期五。
+ 今天是 2022年1月21日 星期五。

- <世界观: 现代人必须要懂的科学哲学和科学史>这本书重建了我的科学观和世界观.
+ 《世界观：现代人必须要懂的科学哲学和科学史》这本书重建了我的科学观和世界观。

- ０１２３４５６７８９
+ 0123456789

- ＡＢＣＤＥＦＧ...ＸＹＺ
+ ABCDEFG...XYZ
- ａｂｃｄｅｆｇ...ｘｙｚ
+ abcdefg...xyz

- 真是太无语了。。。
+ 真是太无语了······

- 苍天哪！！！！！这是怎么了？？？？？？
+ 苍天哪！！！这是怎么了？？？

- 不小心多打了标点，，，和符号。。
+ 不小心多打了标点，和符号。

支持的文件格式

推荐在以下文件格式中使用：

• Markdown (*.md, *.markdown)
• Text (*.text, *.txt)
• Wiki (*.wiki)
• Vim 中文文档 (*.cnx)

如果想在其他格式的文件中使用这个功能，可以执行 :[range]Pangu 命令。

同时可以在 vimrc 中开启保存文件时自动规范化功能。开启方式：

autocmd BufWritePre *.markdown,*.md,*.text,*.txt,*.wiki,*.cnx call PanGuSpacing('ALL')

注意：目前只对纯文本格式的文件支持较好。其他源代码场景，请谨慎开启。

如果有合适的文件格式推荐，请提交 Issue

安装

via vim-plug:

Plug 'hotoo/pangu.vim', { 'for': ['markdown', 'vimwiki', 'text'] }
let g:pangu_rule_date = 1

via Vundle:

Plugin "hotoo/pangu.vim"

用法

:[range]Pangu 命令

手动执行该命令，将当前缓冲区内容进行规范化。

注意：从 1.0 开始，:Pangu 命令开始支持 range 模式，不兼容地，0.x 默认 规范化所有内容，1.0 由于 range 特殊性，默认规范化选中行或当前行部分。

希望规范化所有内容时，可以使用 :PanguAll 命令。

:PanguAll

规范化当前缓冲区内所有内容。

:PanguDisable 命令

禁止自动规范化。

:PanguEnable 命令

启用自动规范化。

技巧

批量规范化多个文档。

$ vim a.md b.md c.md

:argdo PanguAll | update
:wq

持久化禁用

在编辑的文档中任何位置注明 PANGU_DISABLE，则整个文档不自动规范化。

参考

• 中文文案排版指北