[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/valign 49209b4 05/15: * README-CN.org: Touch up on phra
From: |
Stefan Monnier |
Subject: |
[elpa] externals/valign 49209b4 05/15: * README-CN.org: Touch up on phrasing. |
Date: |
Tue, 16 Mar 2021 00:01:29 -0400 (EDT) |
branch: externals/valign
commit 49209b42fbf3a269688fb3da1eb183f56843451c
Author: Yuan Fu <casouri@gmail.com>
Commit: Yuan Fu <casouri@gmail.com>
* README-CN.org: Touch up on phrasing.
---
README-CN.org | 37 ++++++++++++++-----------------------
1 file changed, 14 insertions(+), 23 deletions(-)
diff --git a/README-CN.org b/README-CN.org
index 61046b3..1b178e4 100644
--- a/README-CN.org
+++ b/README-CN.org
@@ -1,8 +1,8 @@
#+TITLE: Valign.el
-此包在GUI Emacs下,为Org Mode,
Markdown以及table.el的表格提供了对齐效果。其可以正确的对齐包含了可变字体(variable-pitch
font),中日韩(CJK)字符,以及图片的表格。同时,不影响Org Mode(或Markdown mode)的基于文本对齐的方式。
+这个包能对齐 Org Mode、Markdown和table.el 的表格。它能对齐包含不等宽字体、中日韩字符、图片的表格。valign 不会影响 Org
Mode(或 Markdown mode)基于等宽字符的对齐。
-为了使用此包,先加载,它其次将 ~valign-mode~ 添加到 ~org-mode-hook~ 或 ~markdown-mode-hook~ 钩子中。
+想要用 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
@@ -11,44 +11,35 @@
[[./table.el.png]]
-*已知的问题:*
-
-- Hidden links in markdown still occupy the full length of the link, because
it uses character composition which we don’t support now.
- #+begin_quote
- Markdown的隐藏链接仍然占据了整个链接,因为其使用了我们目前无法支持的字符构成。
- #+end_quote
-- Rendering large tables (≥100 lines) is laggy.
- #+begin_quote
- 渲染大型表格(≥100b行)速度较慢。
- #+end_quote
-- ~org-indent-mode~ plus ~display-line-numbers-mode~ causes alignment problems.
- #+begin_quote
- 同时开启 org-indent-mode 和 display-line-numbers-mode 会导致对齐问题。.
- #+end_quote
+*已知问题:*
+
+- Markdown Mode 里的隐藏链接依然会占用整个链接的宽度,因为隐藏链接用了 valign 还不支持的 character composition。
+- 渲染大型表格(≥100行)速度较慢。
+- 同时开启 ~org-indent-mode~ 和 ~display-line-numbers-mode~ 会导致对齐问题。
*注意:*
-为了使得 valign 能作用于 table.el 的表格,每个单元格的右侧必须有一个空格且左侧必须没有空格。你可以使用
[[https://github.com/casouri/ftable][ftable.el]] 来为表格自动布局。
+如果想要 valign 对齐 table.el 表格,表格里每个单元格的左侧不能有空格,右侧至少要有一个空格。可以用
[[https://github.com/casouri/ftable][ftable.el]] 自动布局表格成这样。
* 安装
-你可以键入如下内容从 GNU ELPA中获取 valign.el:
+键入如下内容,从 GNU ELPA 获取 valign.el:
#+begin_src
M-x package-install RET valign RET
#+end_src
* 自定义
-设置 ~valign-fancy-bar~ 为 非空(non-nil),效果如下:
+设置 ~valign-fancy-bar~ 为 ~non-nil~ 的效果如下:
[[./fancy-bar.png]]
仅影响 Org Mode和Markdown 的表格。
-默认情况下,valign不会在普通编辑命令,例如 ~self-insert-command~ 和 ~backward-kill-word~
执行后对表格重新对其。如果你想让某些命令执行后不要重新对其表格可以将其加入 ~valign-not-align-after-list~ 中。
+默认情况下,valign 不会在普通编辑命令之后对齐表格,例如 ~self-insert-command~ 和
~backward-kill-word~。如果你不想在某些命令后对齐表格,可以把命令加入 ~valign-not-align-after-list~ 中。
-由于目前valign不是格外的强大,所以其不会对大于4k字符大小的表格对齐。如果你想要改变这个限制,可以修改 ~valign-max-table-size~
。 Valign会将 ~valign-table-fallback~ face置于大型表格上。
+因为 valign 性能一般,所以我们不会对齐大于四千个字的表格。你可以修改 ~valign-max-table-size~ 改变这个限制。valign
会把 ~valign-table-fallback~ face 置于这些没有对齐的表格上。
-* 如果函数advice让你感到不适
+* 如果函数 advice 让你浑身发痒
-~valign-mode~ 添加了advice,即使你关闭了 ~valign-mode~ 也仍然无法删除advice,因为函数advice是全局的,而
~valign-mode~ 是局部的。 如果你想要删除 advice,请使用 ~valign-remove-advice~ 。
如果你在一些缓冲区(buffer) 仍然开启 ~valign-mode~ ,那么advice仍然存在。
+~valign-mode~ 会加一些 advice,即使你关闭了 ~valign-mode~,这些 advice 也不会消失
,因为函数advice是全局起效,而 ~valign-mode~ 是局部起效。 如果你想删掉这些 advice,请用
~valign-remove-advice~ 。 这时候如果有 buffer 里还开着 ~valign-mode~,这些 buffer 里的 valign
将无法正常工作。
- [elpa] externals/valign updated (223407d -> 2035143), Stefan Monnier, 2021/03/16
- [elpa] externals/valign b000cca 02/15: Fix alignment for table.el tables, Stefan Monnier, 2021/03/16
- [elpa] externals/valign 6b0345e 03/15: Make at-table-p testing stricter, Stefan Monnier, 2021/03/16
- [elpa] externals/valign 49209b4 05/15: * README-CN.org: Touch up on phrasing.,
Stefan Monnier <=
- [elpa] externals/valign 2035143 15/15: * README-CN.org (自定义): Add descriptions for some variables., Stefan Monnier, 2021/03/16
- [elpa] externals/valign acdb551 01/15: Really really fix org-indent and line-number problem, Stefan Monnier, 2021/03/16
- [elpa] externals/valign b6a0dcd 04/15: Add Chinese README, Stefan Monnier, 2021/03/16
- [elpa] externals/valign e8a5ce1 07/15: Remove note about org-indent-mode + line-numbers-mode, Stefan Monnier, 2021/03/16
- [elpa] externals/valign f5db1ef 06/15: ; * README.org: Change link to Chinese README., Stefan Monnier, 2021/03/16
- [elpa] externals/valign db5145a 14/15: * README.org (Customization): Add description for some variables., Stefan Monnier, 2021/03/16
- [elpa] externals/valign ccbcc1c 10/15: Fix alignment for Unicode tables, Stefan Monnier, 2021/03/16
- [elpa] externals/valign 16ff947 08/15: Patch an outline bug., Stefan Monnier, 2021/03/16
- [elpa] externals/valign bcfb414 13/15: Improve parse error report, Stefan Monnier, 2021/03/16
- [elpa] externals/valign 3fcb173 12/15: Fix 'valign--separator-line-p', Stefan Monnier, 2021/03/16