NAME

       dokujclient - interact (read, write, ...) with an instance of Dokuwiki

SYNOPSIS

       dokujclient GENERAL_OPTIONS COMMAND COMMAND_OPTIONS

DESCRIPTION

       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

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 title

        dokujclient 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/issues
       You may also ask questions on the mailing list dokujclient@freelists.org

SEE ALSO

       The documentation of the server  API is available at https://www.dokuwiki.org/devel:xmlrpc

                                                                                                  DOKUJCLIENT(1)