Hi,

I've just started an experimental listing site using github pages with 
jekyll style engine.

http://vagrant-lists.github.io/

Thanks for Javascript magics, we can now search and sort list of plugins, 
boxes and use-cases.
You can sort list with clinking title in table. Boxes list has a search 
text box.

And more it gives experimental JSON listing for machine processing.
http://vagrant-lists.github.io/api/v1/plugins.json
http://vagrant-lists.github.io/api/v1/boxes.json

One reason why I've start page is that
there are so many plugins and boxes in vagrant eco-system, and thanks 
vagrantbox.es to list many boxes.
I've been looking for a list of plugins and sample Vagrantfile recipes, and 
knows vagrant wiki page is an only simple list.
Wiki is good for collaboration but IMHO, it is difficult to maintain so 
many items listing to manage.

It was heavily inspired by Vagrantbox.es and 
https://github.com/fgrehm/vagrantboxes-gh-pages which is 
a proposal of improvement for vagrantbox.es.


How to maintain list
=============

The list page is maintained through github repository in public github 
organization.
I hope the list becomes maintained by volunteers through pull-request 
and/or join organization and commit directory.

You are welcome to fork it and add items.
https://github.com/vagrant-lists/vagrant-lists.github.io

You are also welcome to join github organization.

There is a rakefile to help maintain records. To add plugin item, just type 
ad answer some questions.

$ rake plugin
Name? vagrant-librarian-puppet
Description(eg. VirtualBox provider)?: A Vagrant plugin to install Puppet 
modules using Librarian-Puppet.
Tags?(eg. tag1,tag2)Puppet
Any note?:
plugin type?(_Provider, p_Rovisioner, _Command, _Sync) [p/r/c/s] r
link? (eg. 
https://example.com/)https://github.com/mhahn/vagrant-librarian-puppet
Creating new post: ./_posts/plugins/2014-02-22-vagrant-librarian-puppet.md

and then

$ git add ./_posts/plugins/2014-02-22-vagrant-librarian-puppet.md
$ git commit -m 'add vagrant-librarian-puppet'
$ rake plugin_version
  ... proccesing to retrieve plugin version number from rubygems...
$ git commit -am 'update version'
$ git push origin master

Now it can be used with 'plugin', 'usecase', 'box' and 'recipe'.

plugin record is located in _posts/plugins. usecase is located in 
_posts/usecases.
The page is generated by github pages engine automatically.
Each item record is a single file. This makes easy to merge requests.

Again, you are welcome to join a progress, give ideas, write codes, 
documentation and  design site!

--
Hiroshi Miura
https://github.com/miurahr

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

Reply via email to