57 lines
2.2 KiB
Org Mode
57 lines
2.2 KiB
Org Mode
#+TITLE: Org mode and Outline mode syntax highlighting for Vim
|
||
|
||
Org.vim is a very minimal [[https://orgmode.org][Org mode]] and
|
||
[[https://www.gnu.org/software/emacs/manual/html_node/emacs/Outline-Mode.html][Outline mode]]
|
||
plugin for [[https://www.vim.org][Vim]] providing only syntax highlighting and
|
||
folding.
|
||
|
||
This plugin aims to replicate Vim's [[https://github.com/tpope/vim-markdown/][existing Markdown]]
|
||
editing experience on Org mode (and Outline mode) files, rather than trying to
|
||
be a full featured Org mode plugin—that is what Emacs is for.
|
||
|
||
Originally created so I would be able to quickly edit and easily read Org mode
|
||
files in Vim without any of /the bells and whistles/ of the original Emacs
|
||
implementation. It also allowed me use [[https://github.com/orgzly/orgzly-android/][Orgzly]]
|
||
(highly recommended) without worrying about Emacs lock-in.
|
||
|
||
*Note*: this project is considered /feature complete/ by the author, so the
|
||
addition of new features will be unlikely.
|
||
|
||
|
||
** Installation
|
||
|
||
Installation of Org.vim can be performed by using your preferred plugin/package
|
||
management tool(s). If you don't have a Vim package manager I recommend using
|
||
Vim 8 packages.
|
||
|
||
Just run these 2 commands from your shell.
|
||
|
||
#+BEGIN_SRC sh
|
||
git clone https://github.com/axvr/org.vim ~/.vim/pack/plugins/start/org
|
||
vim +'helptags ~/.vim/pack/plugins/start/org/doc/' +q
|
||
#+END_SRC
|
||
|
||
Once installed check out the Org.vim manual (run ~:help org.txt~ to open it) for
|
||
usage information and configuration options.
|
||
|
||
|
||
** Screenshots
|
||
|
||
Different Vim colour schemes will result in different appearances.
|
||
|
||
| [[https://github.com/romainl/Apprentice][Apprentice]] | [[https://github.com/axvr/photon.vim][Photon]] |
|
||
|--------+------------|
|
||
| [[https://raw.githubusercontent.com/axvr/org.vim/images/apprentice.png]] | [[https://raw.githubusercontent.com/axvr/org.vim/images/photon.png]] |
|
||
|
||
|
||
** Licence
|
||
|
||
Copyright © 2018–2020, Alex Vear.
|
||
|
||
Org.vim is distributed under the same terms as Vim itself.
|
||
|
||
A copy of the full licence text should have been provided with this extension
|
||
in the =LICENCE= file. The license can also be viewed on the
|
||
[[http://vimdoc.sourceforge.net/htmldoc/uganda.html#license][web]] or by invoking
|
||
~:help license~ from within Vim.
|