Difference between revisions of "Www-mediawiki-client"
Jump to navigation
Jump to search
m (Category:Help) |
(formating and link) |
||
Line 1: | Line 1: | ||
− | + | 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, [http://www.vim.org vim]. I grabbed [http://search.cpan.org/~markj/WWW-Mediawiki-Client/ WWW::Mediawiki::Client], and built a debian package out of it. | |
− | download wiki pages and edit them with my preferred editor, [http://vim.org vim]. | ||
− | + | ==Installing== | |
+ | You can apt-get it by putting in your /etc/apt/sources.list: | ||
− | + | <nowiki>deb http://llama.freegeek.org/~vagrant/debian unstable/</nowiki> | |
− | + | then runn: | |
− | + | apt-get update | |
− | + | apt-get install libwww-mediawiki-client-perl | |
− | |||
− | |||
− | apt-get update | ||
− | |||
− | apt-get install libwww-mediawiki-client-perl | ||
from the package description: | from the package description: | ||
+ | <pre> | ||
+ | WWW::Mediawiki::Client provides a very simple cvs-like interface for | ||
+ | Mediawiki driven WikiWiki websites, such as | ||
+ | http://www.wikitravel.org|Wikitravel or | ||
+ | http://www.wikipedia.org|Wikipedia. | ||
+ | . | ||
+ | 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. | ||
+ | </pre> | ||
− | + | == Usage == | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
Basic Usage | 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. | web browser first and then try again. | ||
− | + | Then, edit User\:USERNAME.wiki with your favorite editor. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | mvs | + | 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" | |
[[Category:Help]] | [[Category:Help]] |
Revision as of 18:36, 6 November 2006
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://llama.freegeek.org/~vagrant/debian unstable/
then runn:
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|Wikitravel or http://www.wikipedia.org|Wikipedia. . 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.
Usage
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"