Saturday, May 4, 2013

Its about you - what about a github based wiki ? - demo ready

The future is agile - things change faster than ever.

That's why I want to introduce a 'manually managed' wiki
you can contribute to the way you love most: by using Vim.
(Yes - that's my personal preference - maybe you share it)

You can check it out:
https://github.com/MarcWeber/vim-git-wiki/

You can read more about it:
https://github.com/MarcWeber/vim-git-wiki/tree/master/vim-online-wiki-source/this-wiki

And of course there is a sample html representation
http://mawercer.de/wiki/index.html

Why yet another syntax? See http://mawercer.de/wiki/this-wiki/syntax.html
its easy to learn.

http://mawercer.de/wiki/this-wiki/design-goals.html explains why I chose
to use custom syntax - because its most simple - and very editable by
Vim.

This is an alternative solution to wikia, which we all have loved for
ages. But *I*'d like to use Vim for editing - and grep.
Eg gf follows a link - what else do you need to be productive.

A special feature is the "feature comparison matrix" as shown here:
http://mawercer.de/wiki/topic/vim%20plugin%20managment.html
-> "VAM, Pathogen, Vundle comparison"
source: https://github.com/MarcWeber/vim-git-wiki/blob/master/vim-online-wiki-source/topic/vim%20plugin%20managment#L38

I'd like to create such overviews for different topics. Also for
snippet engines etc - so that you can decide upon testing something new
easily.

Yes - some styling is still missing.

One big difference will be that people contributing occasionally only
will sent pull requests - which are likely to be reviewed.

even though the repository is hosted on my github account (at the
moment), I'd like to grant push access to many others if so desired.

The big question is: How do you feel about using git/Vim to provide
value to each other by documenting which workflows, tools, setups you
like most?

Yes - this is my preference. So if you think differently, also consider
replying.

I feel sorry that I don't have time to write up the perfec solution -
what this could be - I tried documenting here:
http://mawercer.de/wiki/this-wiki/alternatives.html

I'd like to spent my free time on making Vim read plugin/*.py
plugin/*.rb files natively - thus making alternative scripting languages
first class citizens ..

Thanks for replying - yes - you all know that I've been trying to find
the perfect solution for too long. Its time to change something.

What about windows users & git? Well - AFAIK github supports a SVN
bridge, I never tried it though.

If you don't want to checkout and patch - you can just file a bug report
and make the supporters do the change for you.

Sincerly
Marc Weber

--
--
You received this message from the "vim_use" maillist.
Do not top-post! Type your reply below the text you are replying to.
For more information, visit http://www.vim.org/maillist.php

---
You received this message because you are subscribed to the Google Groups "vim_use" group.
To unsubscribe from this group and stop receiving emails from it, send an email to vim_use+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

No comments: