table of contents
DOKUJCLIENT(1) | General Commands Manual | DOKUJCLIENT(1) |
NAME¶
dokujclient - interact (read, write, ...) with an instance of DokuwikiSYNOPSIS¶
dokujclient GENERAL_OPTIONS COMMAND COMMAND_OPTIONSDESCRIPTION¶
Dokuwiki is an open source wiki engine. It's hence meant to be mainly used through a web browser. However, it also has an xmlrpc API.Dokujclient uses this xmlrpc API, so that it's possible to interact with an instance of Dokuwiki through a console or a shell script.
GENERAL OPTIONS¶
- --url URL
- The url to the xmlrpc interface. Should look like
http[s]://server/mywiki/lib/exe/xmlrpc.php.
Obviously, the wiki should be configured to accept incoming xmlrpc queries. See Dokuwiki's remote config.
This parameter is mandatory. - -u USER, --user USER
- Specify the username USER to use to connect to the server.
Obviously, the USER should be authorized to use the xmlrpc interface. See Dokuwiki's remoteuser config. - -p PASSWORD, --password PASSWORD
- The password of the USER
- --password-interactive
- You will be prompted to enter the user's password interactively. Useful to avoid writing the password in clear text in the command line.
- --version
- Prints the version of dokujclient
- -h --help
- Prints the general help
- --debug
- Enable debug mode, which will print more information
COMMANDS¶
- help
- Prints the general help
- help COMMAND
- Prints the help and the COMMAND_OPTIONS for COMMAND
- Other commands are:
FILES¶
To avoid typing your url, user, and password each time, you may create in your home a file .dokujclientrc, and put some or all of this info in it.echo "url=http://myhost/mywiki/lib/exe/xmlrpc.php" > ~/.dokujclientrc echo "user=toto" >> ~/.dokujclientrc echo "password=myPassword" >> ~/.dokujclientrc
EXAMPLES¶
dokujclient --user myUser --password myPassword --url http://mywiki/lib/lib/exe/xmlrpc.php getTitle > myWiki titledokujclient help > [(-u|--user) <user>] --url <url> [(-p|--password) <password>] [-h|--help] [--version] [--password-interactive] command > > Available commands: > [...skipped...]
#put user, password, and url, in the config file vim ~/.dokujclientrc
#get the list of pages of all the wiki dokujclient getPagelist . > [...skipped...]
dokujclient appendPage builds:synthesis "Build launched at 12:23 took 3'24" dokujclient getPage builds:synthesis > Build launched at 11:12 took 3'19 > Build launched at 12:23 took 3'24
#help command can give information about a given command dokujclient help putAttachment > Syntax for putAttachment: [-f|--force] <attachmentId> <localFile>
dokujclient putAttachment some:file.jpg ~/results.jpg
REPORTING BUGS¶
You are welcome to report bugs to the bugtracker https://github.com/gturri/dokujclient/issuesYou may also ask questions on the mailing list dokujclient@freelists.org