Difference between revisions of "Www-mediawiki-client"

From FreekiWiki
Jump to navigation Jump to search
(describe basic usage of mvs)
(note about creating initial page, and reminder to commit after previewing)
Line 42: Line 42:
  
 
mvs up User\:USERNAME.wiki
 
mvs up User\:USERNAME.wiki
 +
 +
if you get ? User\:USERNAME.wiki, then you must create the initial page with a
 +
web browser first and then try again.
  
 
then, edit User\:USERNAME.wiki with your favorite editor.
 
then, edit User\:USERNAME.wiki with your favorite editor.
Line 55: Line 58:
 
and this will generate a preview.html file that you can view with your
 
and this will generate a preview.html file that you can view with your
 
web-browser.
 
web-browser.
 +
 +
if you like what you see, don't forget to do a "mvs com"

Revision as of 11:26, 25 July 2005

i'm not so fond of using my web browser as an editor, so i looked for tools to download wiki pages and edit them with my preferred editor, vim.

i grabbed WWW::Mediawiki::Client, and built a debian package out of it.


Installing

you can apt-get it by putting in your /etc/apt/sources.list:

deb http://sempai.fglan/~vagrant/debian unstable/

and then running:

apt-get update

apt-get install libwww-mediawiki-client-perl

from the package description:

WWW::Mediawiki::Client provides a very simple cvs-like interface for
Mediawiki driven WikiWiki websites, such as
http://www.wikitravel.org%7CWikitravel or
http://www.wikipedia.org%7CWikipedia.
.
the mvs command (formerly known as wix), mimics the two most basic
cvs commands: update and commit with similarly named methods.  Each
of these has a shorter alias, as in cvs.


Basic Usage

mkdir ~/some_wiki_dir

cd ~/some_wiki_dir

log in:

mvs login -u USERNAME -p PASSWORD -d wiki.freegeek.org -w index.php

download a page (don't forget the .wiki part!):

mvs up User\:USERNAME.wiki

if you get ? User\:USERNAME.wiki, then you must create the initial page with a web browser first and then try again.

then, edit User\:USERNAME.wiki with your favorite editor.

to commit:

mvs com -m 'some commit message about what i changed' User\:USERNAME.wiki

alternately, you can do a preview:

mvs preview -m 'some commit message about what i changed' User\:USERNAME.wiki

and this will generate a preview.html file that you can view with your web-browser.

if you like what you see, don't forget to do a "mvs com"