Skip to content
A Vim Plugin for Blogging in Wordpress (incl. wordpress.com)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
plugin
syntax
README.md

README.md

About

This is a fork of the VimBlog project, located at: https://github.com/danielmiessler/VimBlog

And VimBlog was a fork of the VimRepress project, located at: https://github.com/vim-scripts/VimRepress

VimWordpress is a Python 3 plugin for Vim to manage Wordpress (incl. wordpress.com) blogs. As of 2016, other vim plugins lack the support of Python 3, which motivates the development of the VimWordpress plugin.

Requirements

  • Vim 7.3+ with Python 3 support (Python 2 support is dropped)
  • Python 3 Environment matched wtih Vim's support ("has(python3)" return 1 in vim)
  • python-markdown/python-markdown2 installed (execute "pip install markdown2" in shell)
  • Wordpress 3.0.0 +

Installation

  1. Use Vundle to add mrpeterlee/VimWordpress to the Plugin source. Plugin 'mrpeterlee/VimWordpress'
  2. Create a ~/.vimpressrc file, and put the following in it
[Blog0]
blog_url = https://yoursite.com/ 
username = your_user_name
password = your_password

Command Examples

Some commands list above contain special usage, example below may clearify them for you.

:BlogList             -  List 30 recent posts. 
:BlogList page        -  List 30 recent pages. 
:BlogList post 100    -  List 100 recent posts. 

:BlogNew post         -  Write an new post. 
:BlogNew page         -  Write an new page. 

:BlogSave             -  Save (defautely published.) 
:BlogSave draft       -  Save as draft. 

:BlogPreview local    -  Preview page/post locally in your browser. 
:BlogPreview publish  -  Same as `:BlogSave publish' with brower opened. 

:BlogOpen 679 
:BlogOpen http://your-first-blog.com/archives/679 
:BlogOpen http://your-second-blog.com/?p=679 
:BlogOpen http://your-third-blog.com/with-your-custom-permalink 

Commands

A few shortcuts was recommended in VimBlog for day-to-day blogging:

Starting workflow

From the shell I launch these two character shortcuts to begin blogging immediately.

alias nb="vim +BlogNew"
alias eb="vim +BlogList"

Inside Vim

Once inside Vim I can run these.

nnoremap <leader>b :BlogSave publish<CR>
nnoremap <leader>h :set ft=HTML<CR><CR>

Default to publish as "private"

Wordpress defines three types of posting: "draft", "private", "public", and VimWordpress defaults to "private" after ":BlogSave".

Credits

All credit to Pentie for creating VimRepress, which this is based on.

You can’t perform that action at this time.