[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/valign b6a0dcd 04/15: Add Chinese README
From: |
Stefan Monnier |
Subject: |
[elpa] externals/valign b6a0dcd 04/15: Add Chinese README |
Date: |
Tue, 16 Mar 2021 00:01:29 -0400 (EDT) |
branch: externals/valign
commit b6a0dcdb36b28c177ead30da3d391e68265edf1a
Author: EvanMeek <the_lty_mail@foxmail.com>
Commit: Yuan Fu <casouri@gmail.com>
Add Chinese README
* README-CN.org: New file.
* README.org: Add link to README-CN.org.
---
README-CN.org | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
README.org | 2 ++
2 files changed, 56 insertions(+)
diff --git a/README-CN.org b/README-CN.org
new file mode 100644
index 0000000..61046b3
--- /dev/null
+++ b/README-CN.org
@@ -0,0 +1,54 @@
+#+TITLE: Valign.el
+
+此包在GUI Emacs下,为Org Mode,
Markdown以及table.el的表格提供了对齐效果。其可以正确的对齐包含了可变字体(variable-pitch
font),中日韩(CJK)字符,以及图片的表格。同时,不影响Org Mode(或Markdown mode)的基于文本对齐的方式。
+
+为了使用此包,先加载,它其次将 ~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]]
+
+*已知的问题:*
+
+- 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
+
+*注意:*
+
+为了使得 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不是格外的强大,所以其不会对大于4k字符大小的表格对齐。如果你想要改变这个限制,可以修改 ~valign-max-table-size~
。 Valign会将 ~valign-table-fallback~ face置于大型表格上。
+
+* 如果函数advice让你感到不适
+
+~valign-mode~ 添加了advice,即使你关闭了 ~valign-mode~ 也仍然无法删除advice,因为函数advice是全局的,而
~valign-mode~ 是局部的。 如果你想要删除 advice,请使用 ~valign-remove-advice~ 。
如果你在一些缓冲区(buffer) 仍然开启 ~valign-mode~ ,那么advice仍然存在。
diff --git a/README.org b/README.org
index d1ab824..4b7319d 100644
--- a/README.org
+++ b/README.org
@@ -1,5 +1,7 @@
#+TITLE: Valign.el
+[[file:README-CN.org][中文版本README]]
+
This package provides visual alignment for Org Mode, Markdown and table.el
tables on GUI Emacs. It can properly align tables containing variable-pitch
font, CJK characters and images. Meanwhile, the text-based alignment generated
by Org mode (or Markdown mode) is left untouched.
To use this package, load it and add ~valign-mode~ to ~org-mode-hook~ or
~markdown-mode-hook~:
- [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, 2021/03/16
- [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 <=
- [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
- [elpa] externals/valign ad8419e 11/15: ; * test.org: Add a test for Unicode tables., Stefan Monnier, 2021/03/16
- [elpa] externals/valign 745889d 09/15: * valign.el (valign--at-table-p): Don't pass "" to 'char-to-string'., Stefan Monnier, 2021/03/16
- Re: [elpa] externals/valign updated (223407d -> 2035143), Yuan Fu, 2021/03/16