emacs-elpa-diffs
[Top][All Lists]
Advanced

[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 
将无法正常工作。



reply via email to

[Prev in Thread] Current Thread [Next in Thread]