README.md in vimwiki_markdown-0.0.2 vs README.md in vimwiki_markdown-0.0.3
- old
+ new
@@ -3,26 +3,55 @@
This gem allows vimwiki pages written in (github enhanced) markdown
to be converted to HTML.
It is currently a work in progress (but working for me ;)
-## Installation
+## Requirements
-Add this line to your application's Gemfile:
+Ruby installed on your computer
- gem 'vimwiki_markdown'
+ https://www.ruby-lang.org/en/installation/
-And then execute:
+Install the vimwiki_markdown gem
- $ bundle
+ $ gem install vimwiki_markdown
-Or install it yourself as:
+Note, the current version of vimwiki does not allow binaries to be called
+for the generation of html. This was added on the master branch in [this commit](https://github.com/vimwiki/vimwiki/commit/c1a5bb51adc8cacaa70e2804106817b68295f932)
- $ gem install vimwiki_markdown
+Currently you will need to make sure you are running the dev branch of vimwiki, or add that commit in yourself
+## Setup
+
+Ensure that your vimiwiki directive in your .vimrc is setup for markdown. For
+this we use the custom_wiki2html parameter. My .vimrc looks like this:
+
+ let g:vimwiki_list = [{'path': '~/vimwiki', 'template_path': '~/vimwiki/templates/',
+ \ 'template_default': 'default', 'syntax': 'markdown', 'ext': '.md',
+ \ 'path_html': '~/vimwiki/site_html/', 'custom_wiki2html': 'vimwiki_markdown',
+ \ 'template_ext': '.tpl'}]
+
+The most important part is the *'custom_wiki2html': 'vimwiki_markdown'*
+
+### VimWiki Template
+
+It is a requirement that your template file contain a placeholder
+for the syntax highlighting code to be placed. In order to do this,
+open up your default.tpl (or whatever your template file is called)
+and ensure that before the closing </head> tag you put
+`%pygments%`
+
+A sample tpl file is available here https://raw.githubusercontent.com/patrickdavey/vimwiki_markdown/master/example_files/default.tpl
+
+
## Contributing
1. Fork it ( https://github.com/patrickdavey/vimwiki_markdown/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request
+
+
+## License
+
+[MIT License](http://opensource.org/licenses/mit-license.php)