update packages and add valign
This commit is contained in:
84
lisp/valign/README-elpa
Normal file
84
lisp/valign/README-elpa
Normal file
@@ -0,0 +1,84 @@
|
||||
━━━━━━━━━━━
|
||||
VALIGN.EL
|
||||
━━━━━━━━━━━
|
||||
|
||||
|
||||
[中文 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':
|
||||
┌────
|
||||
│ (add-hook 'org-mode-hook #'valign-mode)
|
||||
└────
|
||||
|
||||
<./default.png>
|
||||
|
||||
<./table.el.png>
|
||||
|
||||
*Known problems:*
|
||||
• Hidden links in markdown still occupy the full length of the link,
|
||||
because it uses character composition which we don’t support now.
|
||||
• Rendering large tables (≥100 lines) is laggy.
|
||||
|
||||
*Note:*
|
||||
|
||||
For table.el tables to work with valign, each cell has to have at least
|
||||
one space on the right and no space on the left. You can use
|
||||
[ftable.el] to auto-layout the table for you.
|
||||
|
||||
|
||||
[中文 README] <file:README-CN.org>
|
||||
|
||||
[ftable.el] <https://github.com/casouri/ftable>
|
||||
|
||||
|
||||
1 Install
|
||||
═════════
|
||||
|
||||
You can obtain valign.el from GNU ELPA by typing:
|
||||
┌────
|
||||
│ M-x package-install RET valign RET
|
||||
└────
|
||||
|
||||
|
||||
2 Customization
|
||||
═══════════════
|
||||
|
||||
Set `valign-fancy-bar' to `non-nil':
|
||||
|
||||
<./fancy-bar.png>
|
||||
|
||||
This only affects Org Mode and Markdown tables.
|
||||
|
||||
By default, valign doesn’t re-align the table after normal edit
|
||||
commands like `self-insert-command' and `backward-kill-word'. If you
|
||||
want valign to not re-align the table after a certain command, add
|
||||
that command to `valign-not-align-after-list'.
|
||||
|
||||
Because valign isn’t particularly efficient, it doesn’t align tables
|
||||
larger than 4000 characters in size. If you want to change that
|
||||
behavior, customize `valign-max-table-size'. Valign puts
|
||||
`valign-table-fallback' face on those large tables.
|
||||
|
||||
Other (less interesting) customization:
|
||||
• `valign-signal-parse-error': Set to non-nil to be informed of parse
|
||||
errors.
|
||||
• `valign-lighter': Lighter in mode-line.
|
||||
• `valign-box-charset-alist': Used for defining table.el tables, e.g.,
|
||||
Unicode/ASCII tables.
|
||||
|
||||
|
||||
3 If function advice makes you itch
|
||||
═══════════════════════════════════
|
||||
|
||||
`valign-mode' adds advice and doesn’t remove them even if you close
|
||||
`valign-mode' because function advice is global and `valign-mode' is
|
||||
local. If you want to remove the advice, use
|
||||
`valign-remove-advice'. If you run this while some buffer still has
|
||||
`valign-mode' on, they break.
|
||||
Reference in New Issue
Block a user