working with dokuwiki plugins using darcs

Here are some steps for those of you who would like to use a darcs repository.

• requirements:
  • a valid shell account on your server
  • the darcs binary, check for it with
    

    which darcs

  • something where you can upload your repository and others can download it
    • supported protocols and limitations:

Hint: dokuwiki/lib/plugins/<NAME> does not need to be empty.

$> cd dokuwiki/lib/plugins/<NAME>
$> darcs initialize

$> darcs add *
$> darcs add lang/*
$> darcs add lang/de/*
$> darcs add lang/en/*

• see below

that will generate a patchset oriented on your last recorded version

$> cd dokuwiki/lib/plugins/<NAME>
$> darcs record

Comment your changes and push them via:

$> darcs push

Note: use darcs send if you're using a pull-only url

$> cd dokuwiki/lib/plugins/<NAME>
$> darcs pull

...for installing new plugins maintained by others

Hint: you can also use the darcs plugin for this job

Important: use darcs get in the parent directory and check if there isn't another directory with our plugin name

$> cd dokuwiki/lib/plugins/
$> darcs get <URL>

There are 2 URLs you've to know:

• the dokuwiki-plugin repositories: http://darcs.erazor-zone.de/php/dokuwiki/
• the darcsweb interface: http://dev.erazor-zone.de/

• darcs push with ftp is non-simple It appears to require an environment variable DARCS_APPLY_FTP to be set with appropriate commands to make it work - I haven't found anything definitive on what those commands could/should be for ftp. There is mention of darcshive and darcsmirror however they aren't in the Gentoo package library. All of which is because I am trying to setup the public component of my plugin repo on higher bandwidth webspace to which I only have ftp access, finding out how to do this would be useful. — Chris 2005-09-13

E-Razor: Indeed, using darcs push with ftp isn't that easy and i wouldn't recommend it. The only good way to use ftp would be to:

1. check for _darcs/lock
2. touch _darcs/lock
3. fetch the whole repo on the ftp-server
4. add and apply patches
5. upload the repo again

that could be done with a bash script and lftp.