• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    迪恩网络公众号

patrickdavey/vimwiki_markdown: A gem to use for converting vimwiki markdown file ...

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称(OpenSource Name):

patrickdavey/vimwiki_markdown

开源软件地址(OpenSource Url):

https://github.com/patrickdavey/vimwiki_markdown

开源编程语言(OpenSource Language):

Ruby 90.0%

开源软件介绍(OpenSource Introduction):

VimwikiMarkdown

Code Climate Build Status

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 ;)

Example

It turns this:

markdown

into

finished

Requirements

Ruby installed on your computer & up to date version of vimwiki

https://www.ruby-lang.org/en/installation/

Install the vimwiki_markdown gem

$ gem install vimwiki_markdown

Setup

vimwiki_markdown works best with a recent version of vimwiki. Use the dev branch for best results.

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',
          \ 'html_filename_parameterization': 1,
          \ 'template_ext': '.tpl'}]

The most important parts are the 'custom_wiki2html': 'vimwiki_markdown' and the 'html_filename_parameterization': 1. The custom_wiki2html tells vimwiki to use this gem for creating html, the html_filename_parameterization tells vimwiki to match the filenames that vimwiki_markdown produces.

Install issues.

There have been some issues with getting dependencies installed. Before opening an issue, please check if you can use rvm to install the gem, as RVM is magic and makes everything work ;)

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 tag you put %pygments%

A sample tpl file is available here https://raw.githubusercontent.com/patrickdavey/vimwiki_markdown/master/example_files/default.tpl

Optional %root_html% marker.

You can also have a %root_html% marker in your template file, thanks to this commit. It will get rewritten with the relative path to the root of the site (e.g. ./ or ../../ etc)

Optional %date% marker.

You can also have a %date% marker in your template file It will get rewritten with todays date in the format 29 March 2019

Support for tasklists

Vimwiki has support for complex todo lists which you can read about in their help.txt. We do support turning them into HTML. This is slightly different from the way that GitHub checklists are rendered, but, the syntax is a subset of GitHub lists so it should be fine. You can read about it in the issue, but basically it should work fine. You will want to add styles in for the various states that the todo lists can be in. The easiest way is to simply add the styles into your template. You can see the styles in the sample template here

Support for :local and :file links

We have partial support for the :local and :file link types for vimwiki. If you are editing foo.md (in the root dir of your wiki) and you are linking to bar.txt stored in the same directory as foo.md you can do:

  • [link text](local:bar.txt) when output to HTML becomes <a href="../bar.txt">link text</a>
  • [link text](file:bar.txt) when output to HTML becomes <a href="/absolute/path/to/file">link text</a>

Optional %nohtml

If you place the text %nohtml anywhere in a wiki page, it will not be processed into html

Contributing

Pull requests are very welcome

  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




鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap