50 lines
2.3 KiB
Org Mode
50 lines
2.3 KiB
Org Mode
#+TITLE: Valign.el
|
||
|
||
这个包能对齐 Org Mode、Markdown和table.el 的表格。它能对齐包含不等宽字体、中日韩字符、图片的表格。valign 不会影响 Org Mode（或 Markdown mode）基于等宽字符的对齐。
|
||
|
||
想要用 valign.el 的话，先加载 valign.el，然后把 ~valign-mode~ 加到 ~org-mode-hook~ 或 ~markdown-mode-hook~ 里即可。
|
||
#+begin_src emacs-lisp
|
||
(add-hook 'org-mode-hook #'valign-mode)
|
||
#+end_src
|
||
|
||
[[./default.png]]
|
||
|
||
[[./table.el.png]]
|
||
|
||
*已知问题:*
|
||
|
||
- Markdown Mode 里的隐藏链接依然会占用整个链接的宽度，因为隐藏链接用了 valign 还不支持的 character composition。
|
||
- 渲染大型表格（≥100行）速度较慢。
|
||
|
||
*注意:*
|
||
|
||
如果想要 valign 对齐 table.el 表格，表格里每个单元格的左侧不能有空格，右侧至少要有一个空格。可以用 [[https://github.com/casouri/ftable][ftable.el]] 自动布局表格成这样。
|
||
|
||
* 安装
|
||
|
||
键入如下内容，从 GNU ELPA 获取 valign.el:
|
||
#+begin_src
|
||
M-x package-install RET valign RET
|
||
#+end_src
|
||
|
||
* 自定义
|
||
|
||
设置 ~valign-fancy-bar~ 为 ~non-nil~ 的效果如下:
|
||
|
||
[[./fancy-bar.png]]
|
||
|
||
仅影响 Org Mode和Markdown 的表格。
|
||
|
||
默认情况下，valign 不会在普通编辑命令之后对齐表格，例如 ~self-insert-command~ 和 ~backward-kill-word~。如果你不想在某些命令后对齐表格，可以把命令加入 ~valign-not-align-after-list~ 中。
|
||
|
||
因为 valign 性能一般，所以我们不会对齐大于四千个字的表格。你可以修改 ~valign-max-table-size~ 改变这个限制。valign 会把 ~valign-table-fallback~ face 置于这些没有对齐的表格上。
|
||
|
||
其他自定义选项：
|
||
- ~valign-signal-parse-error~: 设为 non-nil，valign 遇到语法分析错误（parse error）时会报错提示。
|
||
- ~valign-lighter~: mode-line 里显示的标识。
|
||
- ~valign-box-charset-alist~: 用来定义 table.el 表格，比如 Unicode/ASCII 表格.
|
||
|
||
* 如果函数 advice 让你浑身发痒
|
||
|
||
~valign-mode~ 会加一些 advice，即使你关闭了 ~valign-mode~，这些 advice 也不会消失 ，因为函数advice是全局起效，而 ~valign-mode~ 是局部起效。 如果你想删掉这些 advice，请用 ~valign-remove-advice~ 。 这时候如果有 buffer 里还开着 ~valign-mode~，这些 buffer 里的 valign 将无法正常工作。
|