Hola

Hi - for the first - thank you for the plugin - it seems it is something I was looking for. Now - to some tings which could be perhaps changed. least - I had to do this tp make your plugin working on Linux (I do not have Windows box currently, so, I cannot check it there)?.Anyway:

1. The sytax of vimwiki.vim should be changed as follows: on line 19: exe 'syntax match wikiWord /".g:vimwiki_word1."/' on line 21: exe 'syntax match wikiWord /".g:vimwiki_word2."/'

2. Proposed by you entry in .vimrc:

nmap <Leader>ww :e d:/vimwiki/index.wiki<CR>

is not working. It should be something like this:

nmap <Leader>ww :e $HOME/vimwiki/index.wiki<CR>

I hope it will help you to improve the very nice tool - after making the changes I mentioned above - it works very well!

Many thanks - once again, tami

tami, I am glad that you like it. Thank you. as for issues

1. if i change line 19 and 21 the way you suggest - it doesn't work for me. And it shouldn't work for you either. May be I am wrong.
2. depends on where your wiki files located. it is an example.

Hi - just want to say big thanks for the latest version of the plugin - works very well here :)

Kind friendly regards, tami

I was looking for some tool for note taking that was cross-platform, fast, and content was not on a proprietary format. This plug in is fitting the bill. I've been using it for a couple of days and looks promising. Thanks!

Hi, I'm a lazy programmer. I don't want to take much time in write html tags to create a simple and clean doc. This plugin let me free. Thanks a lot! And, I'm a chinese. I have made two minor change in this script:

    first, support mutibyte WikiWords;
    second, support Wikiword redirect. ( for use non-multibye file name) 

But, I'm a newbie for vim script ( exactly, newbie for gVim), so, can anyone check my change? Thanks!

2bloodmud: Did you check

let g:vimwiki_upper="A-ZА-Я" 
let g:vimwiki_lower="a-zа-я"

? Try to change it to your language. It works for Russian multibyte Wikiwords. Though I'm not sure it will for Chinese.

To habamax. Thanks! You are very kind.

I am chinese, as i mentioned. How can I set g:vimwiki_upper and let g:vimwiki_lower ?

I have modified vim script myself by change the regex expression for g:vimwiki_word2 to support multibyte. and, added g:vimwiki_word3 to support redirect. and, fixed WikiStripWord? and Wiki2HTM function to fit these changes.

I have made some test. It looks good. but i can't assure these changes no harm for the whole thing. so ...

Have I made simple thing com complicated ?

Thanks.

BTW: How can i fix the comment i have posted here. ( My english is poor.)

How can I put some images links in the wiki and output the html syntax like "<img src='...'/>"?

I use vimwiki under the windows and wikiDelText,wikiSuperScript,wikiSubScript,wikiLink aren't functional now, anyone can use them?

Anyway, thanks for the amazing plugin!

2bloodmud:

Unfortunatly it is impossible to edit comment previously posted.

Could you send me changes you made?

2lxuhao:

Wiki2Html? converting for wikiDelText, wikiSuperScript, wikiSubScript are not yet implemented.

As for images -- just put the link to image like:

http://habamax.ru/blog/wp-content/uploads/2008/07/dsc01081.jpg

and it should be converted to <img src...>. Link must have one of .jpg, .png, .gif endings.

2lxuhao:

check vimwiki_0_5 as wikiDelText, wikiSuperScript and wikiSubScript are functional now.

Hey habamax, I think you have something really good here. I have some suggestions I hope you will consider for future releases.

I modified the function HTMLHeader and footer to include this line instead

let lines = readfile(g:vimwiki_tplhead)

and

let lines = readfile(g:vimwiki_tpltail)

Those variables I have defined in .vimrc as follow:

let g:vimwiki_tplhead = "/path/to/top.html" let g:vimwiki_tpltail = "/path/to/bottom.html"

in this way I can theme the wiki a little more easy. But I cant set the title of the page.

Also I would like to have a syntax for tables

Hi mortengb!

Header and footer templates -- this could be a really good point. I'll think of adding it in a future release. Maybe next one.

And what about tables? Vimwiki has quite limited table support like

||cell1||cell2||cell3||
||cell4||cell5||cell6||
||cell7||cell8||cell9||

Hi, I'm just passing by to thank you for this simple yet very useful wiki system for vim. I hope to hear more from it.

Hi habamax,

Thank you for this plugin. I've tested a lot of wiki wich can be edited with vim or any console editor, like MoinMoin? or Ikiwiki. Vimwiki is simple and can be used on a USB stick or through an ssh connection. Very usefull to me. Thanks again.

And, yes, it needs templates support :)

2noagbodjivictor: Thanks! I really appreciate you were not that lazy to drop me a line. :)

2Etienne.LeBelleguy?: I am glad to hear that vimwiki is useful to you. And yes, I am planning to add header and footer templates support into vimwiki's html export.

Hi Habamax,

thanks for the tool. Just a small remark : could it be possible to line up the syntax with the one used in txt2tags? That way, the wiki could serve as a source for plenty of other documents, not only HTML. Just a thought...

Thanks again,

Jan (Belgium)

Hi Jan,

There are simple MediaWiki? and GoogleWiki? syntax markups built into vimwiki. And making your own markup is quite easy. Just take a look at syntax/vimwiki_media.vim or syntax/vimwiki_google.vim.

Hi Habamax,

This is a very useful tool for me. Thanks so much!

And one suggestion, could you add the syntax highlight feature for codes later? Like <code java> ... </code> . That will be more useful for programmers.

You may reference :TOHtml command built-in vim7. Thank you again !

jasonli2u:

Syntax highlighting for different programming languages could be quite useful, indeed. But I don't think it is possible to do in vimwiki. I mean it would take a way too much time to implement this.

I would consider using http://code.google.com/p/syntaxhighlighter/ for that purpose.

great project! thanks a lot. I needed something like a personal knowledge base, and this is really useful for this task.

Excellent work on the vimWiki part. I have one question on the toggle on or off part, ie I have tried with Ctrl+Space, it is not working. Am i missing anything ?

Toggle -- tried with Ctrl+Space ... no luck

perlpons

On and off should work for list items: Add

    * List item

Place cursor on that line, then press Ctrl-Space :

    * [ ] List item

Press again to toggle it on

    * [x] List item

And again to toggle it off

    * [ ] List item

C-Space is mapped to :VimwikiToggleListItem? command.

PS: if it didn't help you -- give me more details so I could find out what the problem is in.

Hi All,

One more question on the key bindings,

In my terminal (xterm) which is enabled with UTF-8 character encoding, the backspace is not letting me to the main wiki home .

But the same 'backspace' is working fine (ie taking me to the home wiki page) in another xterm terminal without UTF character encoding.

I'm running certain applications like finch which requires UTF-8 character encoding. So, I can't change the character encoding :-(

Could you PLS help me to address this issues.

Thanks, Pons.

2Pons

I am not sure, but the following line in your .vimrc could help:

au FileType vimwiki map <buffer><c-h> :VimwikiGoBackWord<CR> 

<BS> now should bring you to a previous wikipage.

Hi, I have a lot of articles in my wiki. Some of them I'd like to group in subdirectories (or "namespaces" in mediawiki-slang). Would it be possible to implement something like that? So I could create a link like [[mystuff/article1]] and [[myotherstuff/article1]], whereas "mystuff" and "myotherstuff" are two subdirectories. What do you think about it?

Thanks for this great plugin! Frank

Hi zottie, there is issue 19 that I am going to resolve as soon as I have free time.

Just came across vimwiki yesterday. I just love it (I think any vim junkies will love it too). Thanks habamax!

This is a fantastic plugin; exactly what I was looking for in a personal wiki. Thanks a lot!

Just got your plugin about 30 minutes ago. I don't know quite how to express my elation...fapfapfapfapfap. Yeah, so probably the coolest plugin ever.

Thank you for the excellent plugin !

one query: How to go to the next search result? eg. If i give command :Search /pattern/ and there are multiple occurrences of /pattern/ then how to navigate to those occurrences.

Thanks.

2dipakc:

I believe it is :cn

Awesome plugin!

Suggestion: I would like to see an automatically generated table of contents like mediawiki does.

2eydaimon: Table of contents would be incorporated into the next release.

The new TOC feature is really nice :)

Here's a screenshot:

Hi

How can I change the default location of the default wiki?

2maymunbeyin:

see :h g:vimwiki_list

add the following into your .vimrc:

  let g:vimwiki_list = [{'path': '~/my_new_location/'}]

Hey awesome, thank you so much.

I have one more question. Is it possible to use single square brackets rather than double brackets fro wikiwords? The reason I am asking is that I also use some other wiki applications so ti would be nice to share the same file format across those files.

thanks

Unfortunatly you can't use single square brackets for wikiwords in vimwiki.

That is fair. Thanks again

First of all: Great job! Very nice plugin! I'm making extensively use of it, but what I'm missing is the ability to use external links to link to a local file, like this: interesting paper If this is already possible: how? Best wishes

2Bernhard

It looks like I forget to add file:// protocol to vimwiki's external links. I am going to add it to the next version of vimwiki so links like [file://C:/data/book.pdf interesting book] would be fine.

Hey, I've been trying this out for a few days and it seems very promising. I never stuck with other personal wikis because any extensive typing outside my preferred editor just felt slow and awkard. Plus, I'm keeping my wiki in a remote git repo so it's automatically synced and backed up. Best solution I've found so far!

Like this:

 1 xxxxxxx 
 2 xxxxxxx
 2.1 xxxxxx
 2.1.1 xxxxx
 3 xxxxxx 

fos516:

Unfortunatly vimwiki can't do ordered lists like this. But you can do

* 1 xxxxxxx 
* 2 xxxxxxx
  * 2.1 xxxxxx
    * 2.1.1 xxxxx
* 3 xxxxxx 

And change css for your unordered lists to hide bullets.

thank you for answering.

re: oredered lists

Habamax:

normal wiki syntax for that would be to just replace the atrix with #

just replace ul with ol when generating the list

astrix too. grrr

2eydaimon:

Actually vimwiki has ordered list items -- try it.

But as far as I know plain html can't do ordered list items such as:

1. xxxxx 
    1.1. xxxxx 
    1.2. xxxxx 
        1.2.1. xxxxx 
    1.3. xxxxx 
2. xxxxx 
3. xxxxx 
    3.1. xxxxx

etc.

Great plugin, working well for my needs so far (cross platform personal wiki with plain text files for viewing on my iPhone via Dropbox).

Will have a look at the code tonight.

Many thanks D

Thanks for actively developing this great plugin!!

It was also great to find out that emacs org-mode is considered to be a good example, since I first wanted to use emacs org-mode, but couldn't get along with emacs itself.

One thing that org-mode has and vimwiki doesn't is the time clocking feature. Is there any plan to implement it in the future?

2harupong

Thanks! I believe org-mode is very good for those who can use emacs without RSI.

As for time clocking, I haven't planned to implement it since:

• I don't think I would use it;
• There was no one to ask about it.

If you really need it then fill in issue so we could discuss it when there is time to implement it.

>hamabax Thanx for reply!! I see, I was the first one to ask about time clocking, then.

I will fill in an issue if I DO feel the need.

Hi, I'm using vimwiki some time and I love it. Write using reST is the only thing I miss, though. I'm using a wiki configured to use .gpg extension so it interacts with the gnupg plugin, and I have an encrypted, text-only wiki! Thank you very much.

I wish I've found this plugin earlier, it could have saved me a lot of time and neves ;) Thank you very much! One question: How could i use some special tags, for css, like <kbd></kbd> etc.?

2volker.duetsch:

Unfortunatly you can not use html tags (except for <br>) at the moment. This is going to be resolved in the future versions of vimwiki.

Good to hear, that this feature will be implemented. Another point: will it be possible to use Google's Chart API (http://code.google.com/intl/de-DE/apis/charttools/). Anyway - thank you very much for this great plugin!

I am in love with vimwiki, this is the holy grail of personal organization. Thank you so much.

Wow, vimwiki opens so many new possibilities to organize my notes!

For years I've been appending my notes to an an unstructured file ~/memo which today reached 180KB. I've now renamed it to memo/index.wiki. Vimwiki nicely understands much of the wiki markup I had been using. It seems I'll have to add a new Wiki Creole syntax to ease the conversion.

Next step would be splitting this monolitic file by topic, but first I'd need a way to quickly search through the entire wiki. Beating '/' with incsearch is not easy.

Thanks for providing such a wonderful tool.

Great work! Is there a way to format e.g. LaTeX that it is not considered as a CamelCase?? I normally use CamelCase? words for the links but there are a few words like LaTeX, TexGen?, ... I don't want as a Link. Thanks!

2jakob.gager:

add an exclamation mark at the start of it: !LaTeX.

2bernie.codewiz:

Try :VimwikiSearch command. It is not as convenient as '/' but still better then nothing.

Thanks for your quick reply!

A little idea I had ... what about adding the possibility to insert a horizontal line? So far I just enter a bunch of underscores () but there might be a nicer way!

Thanks again!

2jakob.gager: 4 or more dashes (----) produce horizontal line (<hr>) in html.

I found it! The horizontal line can be inserted by adding "----". Actually quite simple! :)

Maybe this can be added to the Reference Card?

Thanks again for the very quick reply!

Originally reference card was created by J.A.J Pater. I unfortunatly am not familiar with TeX/LaTex? stuff so for me it would be quite difficult to add that info there.

If you are willing to help with it I can give you access to the repo to change tex and pdf files the way you like it.

If you have the TeX file available, I will help and add the horizontal line and the external link to a file ([[file:]]). Is there anything else missing in the sheet from your point of view? If you don't mind I would also change the description of TextText because I was not able to figure out was Limit linking means! Maybe something like: Don't treat as WikiWord?, would be better. Btw. is there a possibility to underline Words?

One more thing. Is it possible to link external files in a relative way? Its a bit tedious to enter the whole path all the time.

2Jakob:

TeX&pdf

TeX and pdf files: http://code.google.com/p/vimwiki/source/browse/#hg/misc .

You can download it, make changes and email me the results.

Or.

Make a hg clone and push the changes to the repo. (I have granted you permissions to do it.)

Changes

As for changes -- do whatever you feel would make the reference card the better one.

Underline

Unfortunatly one can not underline words in vimwiki at the moment. Add an issue about it.

Relative paths

What directory this file should be relative to? Wiki source or wiki html? Add an issue -- it is convenient way to discuss that kind of stuff.

Is it possible to link from wiki page A directly to wiki page B with a specific headline? I tried it with a link from page A [[B#toc_1.12]], but it didn't work.

2volker

Nope.

I tend to refer to stuff with different names, so I was wandering if it's possible to create redirects? I haven't found anything in the wiki or the documentation, so I'm asking here.

Similar to how wikipedia works. example: when you enter foo? you actually end up in bar?

And I must thank you for creating this great tool, I encourage continued development!

2 VQvarfordt:

I am not sure I understand. Could you pls clarify? Create 'issue' if possible.

2 habamax

This article explains what Im talking about: http://en.wikipedia.org/wiki/Wikipedia:Redirect

Im wondering if this feature exists in vimwiki, if not it would be cool if it could be implemented as I think it's a great feature that many users can benefit from. =)

2 VQvarfordt:

Nice article :).

Vimwiki has no 'redirect' feature. What is your vision on how it should look like in vimwiki? I don't get your example about entering [foo], [bar] etc.

Could you create an issue with step by step explanation of 'redirect' feature as it should be used/seen in vimwiki?. We can discuss it there.

Is it possible to batch process the :VimwikiAll2HTML command? At the moment vimwiki generates about 15 MB of ~350 HTML files from the wiki files which take up to 20 minutes. I would like to do it once a day with cron.

Anyway vim and vimwiki changed my life :)

Habamax do you have an Amazon wishlist or something like that, to say "Thank You"?

2volker.duetsch@gmx.de

Have a look into http://code.google.com/p/vimwiki/source/browse/tests/test.py, lines 124..128. I believe it is possible to do the same using pretty much any shell.

I do not have Amazon wishlist -- I didn't know of its existance until now. :)

Your "Thank You" in plain words is really enough for me.

Wholesome awesomeness!!! 2 hours into it and converted. I use emacs org-mode only for todolists now because it can sync with iPhone and have due date. One thing I couldn't figure out - when I make a wiki word from a diary entry, I want it to look for definition not inside diary folder, but at the root folder. Again, THANK YOU habamax.

2vsbabu

Vimwiki looks for link (wiki word) definitions in current folder and its subfolders. You can change your 'diary_rel_path' option to '' and all diary entries would be in the same folder as other pages.

2habamax - figured it out yesteday. Still, thanks! I've now projects and diary nicely split into folders. I love the feature where VIM shows only the Wiki word and when I put the cursor on that, it expands to show the actual path.

Is there any support for inline latex?

It's really really awesome. Only if it had LaTex? support - it would turn into an awesome tool for note keeping.

Thanks for such a great plugin of vim. It really speed up the note taking. Looking forward to the implementation of latex support (e.g. integration with mathTeX). Thanks very much!

I love this plugin. I use it every day. Would it be difficult to add a template for the diary portion of vimwiki?

karlh626:

Do you mean html template or smth else?

smilitude, MKY.CANOPUS:

I know almost nothing about latex (based on tex that is created by Knuth, used by scientits, tech students and so on).

So it would be really difficult for me to implement latex support (I wonder what it means 'latex support'? Including latex commands into vimwiki syntax? Converting vimwiki syntax to latex?)

habamax:

by latex support I suppose they mean that you should be able to enter for example an equation in latex like "$e = \lim{n\to\infty} \left( 1 + \frac{1}{n} \right)^{n$" and this will be typeset in latex, looking like http://latex.codecogs.com/gif.latex?e=\lim_{n\to\infty}\left(1+\frac{1}{n}\right)}n

wikipedia uses <math> </math> tags around the latex code instead of the latex $ $, which seems smart.

ie. the user has a latex compiler on their system, and when creating html files from the vimkwiki files, the latex expressions will be sent to the latexcompiler, which sends back the compiled latex code in gif images, which will be placed where the latexcode was in the vimwikifile.

This way we'll get pretty equations in our wikis :)

VQvarfordt

Well, it makes sense. So it is all about sending some commands to another program and include the result of its execution, link to an image for example, is it?

yeah, it seems that's all there is to it.

What I wonder though is what LaTeX/TeX distribution that will be the most suitable. For creating full LaTeX documents I (and I guess most people) use texlive, which is great and all, but its huge, its like an operating system. all thats needed for this purpose is some lightweight LaTeX distribution for math typesetting (you wont typeset anything else in vimwiki, in that case you would use a fullblown LaTeX document rather than a wiki). and it doesn't have to be able to give any other output than the desired image format perhaps gif or png.

But im no expert in LaTeX distributions and how they produce their output. So Im leaving this question to someone who knows more.

and I, as many others, really wish to see LaTeX integrated in vimwiki. both are great tools, using them together would be great. Hopefully it's not that cumbersome, just sending some commands and receiving the output. :)

Almost a month of using this, now can't live without vimwiki. How I wish if I could've a quick converter to convert vimwiki format back and forth between WikiCreole? - my organization uses intranet wikis, and I am just pinching myself each time I've to edit the pages in a browser text box.

Great work guys. I use it along with Dropbox and suits my needs perfectly.

One suggestion for improvement, pertaining to tables. If I need to add a column, it is fairly easy, since I can add an extra one at the end and then re-arrange the columns using Alt-Left/Right. Adding an extra row at the end is easy, but it would be nice to have an option to insert a row in the middle or as in the case of the columns have an easy way to re-arrange rows. I currently use dd [j/k] p but it would be good to have the option.

2hsundar:

Thanks!

Actually, columns were too hard to rearrange using just vim commands that's why Alt-Left/Rights appeared. On the other hand it is very easy to rearrange rows using standard dd and p commands...

Could you pls add an issue to Issues page?

2vsbabu:

Create WikiCreole syntax for vimwiki...

Hi

First of all, thank you very, very much for vimwiki! I have been using it for nearly a month now and I love it! I would recommend it to all my friends who are Vim aficionados.

I am also excited by the potential for vimwiki and where it will go from here onwards. I have a couple of suggestions for improvements. Shall I add them to the Issues page where I would give a more in depth description of each one?

• Generate different IDs or classes for each type of link (internal, external, etc.) in the HTML. This would allow people writing their own CSS files to style external links differently from the internal links (for example), like Wikipedia does.
• The ability to add footnotes. The actual footnotes can be a placeholder div.
• People have been going on and on about LaTeX. I love LaTeX myself, but appreciate that it is difficult to implement. What I would like to see before LaTeX even, is the ability to use BibTeX files. The syntax could look similar to that of footnotes, or even different. I would offer to help with this feature, but unfortunately I am going to be insanely busy until at least March. :-(
• This is a long-term request, but are there plans to generate HTML5 wikis rather than HTML4 at some point? Perhaps make it a user option? I am not too impatient to see this happen, but I would like to see HTML5 start to dominate the web. :-)

Thank you again very much and keep up the good work! It really is appreciated!

Thanks!

As for suggestions, It would be really nice if you add them as issues.

Will do.

As for LaTeX support, I really only see three options:

1. Write your own LaTeX compiler (insanely inpractical: I don't think a reasonable person would wish something like that on their worst enemy).
2. Make use of the user's local LaTeX compiler (maybe using latexmk or tex2im or something like that), if the user has it. My guess is that the type of person who uses vimwiki is enough of a superuser to have their own LaTeX installation. If no local LaTeX compiler can be found, then the output should just be printed as plain text (the LaTeX formula "source").
3. Make use of http://mathurl.com/. It generates LaTeX online and then provides you a link to to the formula. You could then have the formula converted to an image which hotlinks the one hosted on that website. A lot of people probably won't be happy with this solution, but it is the cleanest one that I have been able to find.

One possibility for adding math equations support with latex syntax is to use mathjax http://www.mathjax.org/ This does not give full power of latex; however, you may use it for math equations and might not be too hard to implement. It works well with dokuwiki. This plugin http://www.dokuwiki.org/plugin:jsmath adds support for mathjax in dokuwiki.

Keep up the good work! I really like vimwiki.

With a bit of hacking, MathJax can be used with VimWiki.

Hacks: You handle MathJax like syntax highlighting. Here's a sample footer.tpl:

</body>

<script src="mathjax/MathJax.js">
  MathJax.Hub.Config({
    extensions: ["tex2jax.js"],
    jax: ["input/TeX","output/HTML-CSS"],
    tex2jax: {inlineMath: [["$","$"],["\\(","\\)"]]}
  });
</script>

</html>

You need a line something like this in your .vimrc:

let g:vimwiki_list = [{'path': '~/Dropbox/vimwiki', 'auto_export': 1, 'html_footer': '~/Dropbox/vimwiki_html/footer.tpl'}]

Edit the file ~/.vim/autoload/vimwiki_html.vim. You need to comment out the s:tag_super function code. (Lines 364-366; line 595 on my machine.) This function inserts HTML on detecting a "^" (caret) in a VimWiki file. This kills the !LaTeX markup.

Do not use the

/[ and /] 

tags in you !TeX. They cause problems.

Watch out for block quotes! Anything indented 4 characters with put blockquote code in the html, killing the !LaTeX markup.

I love VimWiki? but I really wish there was a nicer TODO-list option. I often have tasks

[ ] do something

scattered over different .wiki and always lose the overview. Is there a way to improve this? Perhaps a best practice?

stefan.otte:

Best practice? Propose one.

I tried to put all tasks in one .wiki. But that .wiki gets to big.

I used grep to get all tasks that were scattered. But that war rather tedious.

If there was a quickfix window (or something similar) that would show all tasks in all .wiki files. Perhaps a shortcut to add a tag like TODAY to the tasks. And then another quickfix window just for the TODAY tasks. That would be ideal.

What do you think?

Back then I didn't use grep in vim, I used it externally. If you do a

:vimgrep /* \[ \] \| - \[ \] /gj vimwiki/*.wiki

you get all open tasks in a quickfix window. With :cn you can jump to the next task. I'll try to redefine it a bit and make it more comfortable.

thanks for vimwiki - great tool; using it now for ~2 years- I found some remarks on creole syntax here: does anybody already created a syntax file?- I just had a look inside the vimwiki_default|google|media: it's easy to add/replace stuff like //italics// or bullet subitem: but how to override e.g. external link definition (creole: [[URL|link name]])?

really great handy tool. (-8. Q: is support of HTML entity planned? e.g. <p>&reg;</p> (or some other syntax) generates ® in the html file.

OR: is there already a workaround? (my initial guess is with g:vimwiki_valid_html_tags)

@jeff: wikis are usually made so as to reduce the need for mechanisms such as entities: simply work in an encoding that supports the characters you need (UTF-8 should be the preferred one anyway) and think of which input method would be the most convenient in your case. The entities in HTML are really just a workaround...

Assuming you prefer typing rather than pasting from some other window, vim has several ways that you could employ, for instance in your .vimrc (if you do not mind that the setup will also apply to other types than just .wiki):

• :imap mappings
• :dig digraphs
• :ia abbreviations
• keymap (option) mbyte-keymap

Unicode has over 100 000 codepoints for which there is no built-in setup in Vim or Vimwiki, which is quite understandable. Depending on your needs, you may need to do some customization once in a while...

This topic deserves to be better documented. A lot of people may need to insert something missing on their keyboard (in the worst case, even some of the characters used in wiki markup). I had put some more detail on CharacterInput wiki page.

Just started using it - it's really handy!

I'd love for it to Automatically put the page name at the top of newly created wiki pages, though.

{feature request}: a stop/ignore word list.

is it possible to add a stop word list, for vimwiki to ignore certain words (not parsing as wiki word), and simply treat as a common word?

one example is "JavaScript?"; it would be handy if such feature exists.

Thank you very very much. The product is great! I have one wish/request for the future changes please keep it simple and resist all those "must have" feature demands :)

-andrey

Very very nice plugin. Just what i was looking for. Thank You!

@jeff: You can prepend a "wiki word" which you do not want highlighted or changed into a link with an exclamation mark. For example, "JavaScript" will not be highlighted or turned into a link.

why my template couldn't works? I try to define two vimwiki projects,which had its own header and footer template.as follow,but when i vimwikitohtml,the two projects used the first template,but why?thanks for your replies. "vimwiki

let wiki = {}

let wiki.vimwiki_CJK_length=1

let wiki.index='index'

let wiki.path='/home/topwin/vimwiki/'

let wiki.path_html='/home/topwin/vimwiki/html/'

let wiki.html_header= '/home/topwin/vimwiki/template/header.tpl'

let wiki.html_footer= '/home/topwin/vimwiki/template/footer.tpl'

let wiki.css_name= '/home/bigzhu/Dropbox/bigzhuWiki/css/style.css'

let wiki.nested_syntaxes={'python': 'python', 'c++': 'cpp'}

let wiki2={}

let wiki2.vimwiki_CJK_length=wiki.vimwiki_CJK_length

let wiki2.index='index'

let wiki2.path='/home/topwin/vimwiki/program/'

let wiki2.path_html='/home/topwin/vimwiki/html/program/'

let wiki2.html_header='/home/topwin/vimwiki/program/template/header.tpl'

let wiki2.html_footer='/home/topwin/vimwiki/program/template/footer.tpl'

let wiki2.nested_syntaxes=wiki.nested_syntaxes

let g:vimwiki_list=[wiki,wiki2]

There are several problems with your options (maybe the first one is due to formatting that ate the brackets in your comment?).

1. The biggest one is that g:vimwiki_list has to be a List, so the last line should be

   let g:vimwiki_list=[wiki,wiki2]

2. Smaller problem: vimwiki_CJK_length is a global option (it cannot be specified for each wiki separately), so take it out of your dictionaries and put on a separate line in your .vimrc

   let g:vimwiki_CJK_length=1

3. Not an actual problem, but you seem to be setting the index option to the default value. It would be just as well if you leave it alone --- there is no need for those lines "let wiki.index = ..."

OKAY,thanks very much for your reply.I'm sorry for my paste promble.the let g:vimwiki_list=wiki,wiki2? is let g:vimwiki_list=[wiki,wiki2] in my vimrc.it's the paste problem. this is the my all of my .vimrc code. http://paste.ubuntu.org.cn/85098 i have try sevaral ways.but it couldn't work. when i use :echo VimwikiGet?("html_header") to get the value,all the vimwiki project return "~/vimwiki/template/header.tpl". I wait for your help.Thanks very much.

I am assuming you are using the last official version (1.1.1). In the development version, the html_header and html_footer options are no longer used (or are not supposed to be used).

The configuration from your .vimrc (lines 104-111) looks much better and I do not see any problem with that --- I suggest you take it as the starting point, and perhaps try to simplify it even more (by removing unnecessary/unimportant items: for instance the path for the main wiki seems to be the default value). If you cannot make it work, report the problem in the Issues, so that we are not wasting a lot of space here in the forum.

Sometimes, it makes a difference whether in a path you have a trailing / or not, but I doubt this is the source of the problem in this case.

Calling :echo VimwikiGet('html_header') is a very good idea, it will save you a lot of time compared to generating HTML and checking the output. But use the second argument too: :echo VimwikiGet('html_header',0) for the main (the first) wiki, and :echo VimwikiGet('html_header',1) for the second wiki.

Hi, first of all let me congratulate you for this great plugin. I've missed a small feature from it. I can't write '|' to tables. (Perhaps it's my mistake.) I made a small change to vimwiki_html.vim -> safe_html function, after let line = substitute(a:line, '&', '\&amp;', 'g') I put let line = substitute(a:line, '&amp;\(\w\+;\|#\d\+;\)', '\&\1', 'g') which allow to write special HTML characters, like &#124;

Is it possible in any other way, or could you merge it to the code, or do you have any disadvantage?

Thanks, Frod

Hi, at the begging I have to mention that your plug-in is great! I started using it few weeks ago and I can't imagine what was my life before ;-) To the point - among other, I use VimWiki? as my GTD system. Works quite well. However, it would be nice to have some additional highlighting:

• priorities, e.g.: (A), (B), (C) etc.
• contexts, e.g.: @home, @work, @phone, @net etc.
• dim of done items

Here my dirty hacks (I am vim noob, basically I'm programming noob...) in vimwiki.vim file:

• priorities - I'm not sure but it works out of the box (can't remember if I changed anything), I suppose thanks to emoticons syntax;
• contexts:

      syn match  VimwikiContext  "@[A-Za-z0-9_]\+"   
      hi def link VimwikiContext       Identifier

works quite well;

• dims:

        hi def link VimwikiDone     Done
        syn match VimwikiDone "\s*.\s*.*\[X\]*.*$"

doesn't work right :-( Dims only when "X" is in the body of list (after bullets). Have no clue how to get it work.

Miscellaneous wishes (already brought up by others) :

• when item is marked as done "X" it would be useful to automatically append log date to EOL, e.g.: {2011-06-09} or (2011-06-09) or DONE:2011-06-09 (format doesn't matter). BTW I've just seen your gtimelog idea - it's great! Everybody should be satisfied :-)
• time and date stamp would be nice. E.g. <leader>tt: 13:12, <leader>td: 2011-06-09.

That's all :-) Thank you again for great work.

2fro...@gmail.com

| is used for table cells so you cannot use it in tables.

As for special html chars, could you open an issue in the issue tracker?

2looka...@gmail.com

Could you add your thougts as issues? With usage examples. For priorities and contexts I can see you want only highlighting, is this correct?

For 'dim of done items' check :h g:vimwiki_hl_cb_checked.

@habamax

Yes, of course, I will submit it to issues site.

You're correct. For me, right now highlighting is all what I need. I have a bunch of grep/sort/cut scripts which generate desired lists for me. Of course grep & sort function (of contexts, priorities) inside Vim would be nice, but I guess that it requires much more work. And to be honest I have no idea how it should work (maybe taglist would be helpful). Moreover your GTD proposal at wiki seems to be much more better. But as I said, right now, highlighting is enough. I am waiting patiently for your full gtd implementation.

Dim of done items - ...that's a shame on me that haven't RTFM :-( Thank you for tip and prompt answer. Worked smoothly :-)

Thought I'd mention that I'm presently productively using vimwiki in conjunction with Trunk Notes wiki for the iPad. I synchronize via dropbox. See http://www.appsonthemove.com/forum/viewtopic.php?f=12&t=773.

For over a year now, I have been using vimwiki everyday for all of my notes, documentation, and even as a simple website authoring system. It has considerably boosted my productivity compared to previous systems (latest one before vimwiki was zim, which has lots of shortcomings).

vimwiki really is an excellent piece of software : functional, not bloated, integrated into one of the best editors around, and very flexible and efficient. Truly excellent stuff !!

Hey, I just wanted to say thanks for making this great piece of software. Its so simple and clean, I'm really looking forward to what your going to do with it next.

Hello,

I just wanted join the others in saying thank you. VimWiki? is excellent.

Lately I have become engrossed in taking in the landscape of the VimWiki? environment. Understanding how you did some of the really interesting and cool things VimWiki? does is on my todo list :-). I have not yet popped the hood on this beauty.

I really want to use some of the things you do in this project for making 9p file system interaction feel the same way. Its hard for me to describe what I mean. Your navigation stuff is just plain spot on for me.

Just moved from Viki, which I'd been using for half a year or so, and I'm finding VimWiki? amazing! So thanks a lot for bringing this to us :-)

How can I create a tags file with ctags to navigate e.g. by headlines a large vimwiki-file? I like the idea to use the tagbar plugin side-by-side with the vimwiki plugin in a splitted window.

volker.d...@gmx.de

Cool idea - combining ctags and the tagbar plugin would be very helpful! And it looks like it might not be that difficult. Check the instructions for adding new definitions in the Tagbar docs, under the heading: "Adding a definition for a new language/file type". I would appreciate hearing about it, if you have a chance to try this.

To navigate the wiki file with ctags and the tagbar plugin - all the necessary steps can be found under http://stackoverflow.com/questions/7037055/ctags-vimwiki-vim-and-tagbar-plugin

volker.d...@gmx.de:

Thanks for this! - S.

Besides %title% and %root_path%, what are other variables one can insert into template. I want to put a unique disqus identifier for each page, %title% doesn't seem to be enough.

I love VimWiki?!!!! Thank you so much, habamax.

I most abuse the Diary feature, which has little to do with Wiki-ing but nonetheless has made VimWiki? my most-used daily tool.

Besides that, the documentation encouraged me to learn more about the innards of Vim w/r/t changing my <Leader> key to comma, and mapping shortcuts to <Plug> functions.

So thanks again (= I appreciate the hard work. This is beautiful software. I have no feature requests, but I hope this project stays alive and active for a long long long time.

Oh, and w/r/t org-mode... if people think they're not "getting it", it's because there's not much to get. It's just a really good way to manage lists and outlines for people who love emacs; there's not much more to it than that.

I love Vimwiki! I hope the table function will be better, like the function to delete a colomn

Thanks for your great job. It helps me a lot to write my own blog. However I find some problem during the process. 1. I can't create link for my local image, it always explain image link to <img> label 2. [| BBB?] like labels is incompatible with table label | 3. the diary.wiki only display the date, that makes me hard to know what I write a few days before. Create the diary like :

1. [link?date?] : title

will be much better

Hope this will be a good suggestion for your work.

I love vimwiki!

I had a thought though: At my work they use Microsoft word 2007 for documents. I am much better organised using vimwiki. What would be the best way to export word files?

I could write a script in python/php using a docx library, however, I was thinking that I could use and XSLT style sheet to convert the html exported by vimwiki. Which would be the best approach do you think?

2qdxzzz: use dac command to delete a column.

2hang.xiao.hh:

1. create an issue about image links.

2. that kind of links are incompatible with tables. use another ones.

3. diary.wiki can display first level one header with the date as a link.

4. I am not sure I get it - I didn't test mathjax myself. Create an issue.

2theshadowhost:

This is up to you, really. :)

@theshadowhost

Considerations for a python/php script: - you will have the freedom to choose any of the vimwiki supported syntaxes (markdown, media), and not just the default which is the only syntax that is currently converted to html by vimwiki - recently, a hook was provided to call a custom converter - see version 1.3 dev - you will have complete ownership of the conversion - furthermore, there may already be a converter for one of the existing popular syntaxes

Considerations for an xslt stylesheet: - might be simpler to write !?

Please write back about your experience. I'm sure others would like to hear.

HTH, - Stu

I love it so far, great for note taking. But I'm playing with html generation and I can't figure out what %toc is supposed to be for. I just get a single header with a link to the current page, is there more to it? What is the use case?

Also, does anyone have nice .css templates they have written up for vimwiki output?

@rateldajer

Create more headers with different levels.

thanks @habamax, not sure why I didn't try that before.

Another question: when using bulleted lists or enumerated lists I would love to be able to edit long blocks of text under a bullet that keep wrapping. I find only the second line wraps and then after that they all left align to the margin. Does anyone know a way to make it so that they keep the hanging indent without doing gqq and breaking the fact that its all a single line?

Mark

Just loaded vimwiki. Looks very good so far. Looking forward to using it with Python. Thanks Max.

Jerol

I've been using vimwiki for years now and it's changed the way I store information. I love it! You've changed my life.