Difference between revisions of "Www-mediawiki-client"
(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 10: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"