Ⅰ. 插件描述
Insert Extended Markdown Footnotes in VimⅡ. 基本信息
|
Ⅲ. 安装方法
使用Vundle管理器安装
在你的.vimrc下添加:Plugin 'vim-pandoc/markdownfootnotes':source %
:PluginInstall对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。
使用NeoBundle管理器安装
在你的.vimrc下添加:NeoBundle 'vim-pandoc/markdownfootnotes':source %
:NeoBundleInstall使用VimPlug管理器安装
在你的.vimrc下添加:Plug 'vim-pandoc/markdownfootnotes':source %
:PlugInstall使用Pathogen管理器安装
在终端中运行以下命令:cd ~/.vim/bundle
git clone https://github.com/vim-pandoc/vim-markdownfootnotesⅣ. 文档说明
# WARNING: git repository rebased to fix fsck issue
April 16th, 2019
This repository had (for its entire lifetime, inherited from the two commits in VimFootnotes) an issue with malformed commits. If your git config had integrity checking turned on, it would only have been clonable with git clone --config transfer.fsckobjects=false --config receive.fsckobjects=false --config fetch.fsckobjects=false <url>. Per discussion in issue #5, the master branch of this repository was rebased to address this issue. This unfortunately means all forks and clones will need to be likewise rebased on the updated repository.
If you have a clone with no changes, one way to fix this is to blow it away and clone again. If you have local changes you'd like to keep, first fetch using git fetch --all then rebase using git rebase origin/master (replace origin with the upstream name if you have changed it).
VimFootnotes for Markdown
This fork is a slight tweak of the venerable [vimfootnotes][], for use
with extended markdown.
The new script inserts footnotes in the widely supported extended markdown
syntax:
Here is some text.[^1]
[^1]: Here is a note.The footnote number gets determined by an automatic counter whenever a new
footnote gets inserted. The counter works with the default arabic numerals
and all other settings provided by b:vimfootnotetype. The automatic counter
code is based on the code for the counting of HTML footnotes in [this post by
Nick Coleman][3], adjusted slightly to work with Markdown footnotes.
The script defines two mappings,
<Leader>f Insert new footnote
<Leader>r Return from footnoteTo insert a footnote, type <Leader>f. A footnote mark will be inserted
after the cursor. A matching footnote mark will be inserted at the end
of the file. A new buffer will open in a split window at the bottom of
your screen, ready to edit the new footnote. When you are done, type<Leader>r to close the split and return to the main text.
Installation
Drop markdownfootnotes.vim in your plugin directory.
Or use Pathogen.
Settings
By default, footnote ids are arabic numerals. You can change this by
setting b:vimfootnotetype:
arabic: 1, 2, 3...alpha: a, b, c, aa, bb..., zz, a...Alpha: A, B, C, AA, BB..., ZZ, A...roman: i, ii, iii... (displayed properly up to 89)Roman: I, II, III...star: *, **, ***...
You can optionally disable line breaks before each footnote by setting g:vimfootnotelinebreak = 0.
Commands
AddVimFootnote
: inserts footnotemark at cursor location, inserts footnotemark on new
line at end of file, opens a split window all ready for you to enter in
the footnote.
ReturnFromFootnote
: closes the split window and returns to the text in proper place.
These are mapped to <Leader>f and <Leader>r respectively.
FootnoteNumber
: Change the current footnote number (one obligatory argument)
:FootnoteNumber 5
FootnoteNumberRestore
: Restore old footnote number
FootnoteUndo
: Decrease footnote counter by 1
FootnoteMeta [<footnotetype>]
: Change type of the footnotes and restart counter (1, a, A, i, I, *)
The <footnotetype> argument is optional. If omitted, and your previous
footnote type was not arabic, the new type will be arabic; if it was
arabic, the new type will be alpha. If the new type is the same as the
previous type, then the counter will not be restarted.
FootnoteRestore
: Restore previous footnote type and counter.