Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

No project description provided

Project description

doku is a cli tool to read and manipulate documents in DokuWiki via its XMLRPC endpoint.


pip install doku

# or as a user
pip install --user doku

# upgrade
pip install --upgrade doku


Enable XML RPC on your DokuWiki instance: Admin > Configuration Settings > Authentication

Create a new file: $HOME/.doku.ini

domain =
username = your-username
password = your-password
ssl = true
path = /

indexpage = root
diaryroot = diary

Example usage:

❯ doku list
[2019-01-06 09:29:03] playground:playground
[2019-01-06 09:18:47] wiki:dokuwiki
[2019-01-06 09:18:47] wiki:syntax
[2019-01-06 09:18:47] wiki:welcome

doku list --namespace :playground
[2019-01-06 09:29:03] playground:playground

❯ doku edit wiki:welcome
# this will open your $EDITOR
# with the full content of the wiki page
Document saved.

❯ doku cat playground:playground
====== PlayGround ======

❯ doku --help
Usage: doku [OPTIONS] COMMAND [ARGS]...

  --help  Show this message and exit.



With diary commands, you can use your wiki as a diary (surprise).

The show command will show you all your logs (today).

The log command will open up your $EDITOR and after save+quit, it will append it for your diary page (today).

When you call log, doku will check all the path back and generates content for the tree.

For example:

# Today is 2019-02-21 and your index is configured to be 'root'
doku diary log

# This will create the following pages if it's not exist

# Will regenerate this page
# if you log an entry in a year previously was not there

# from stdin (pipe)
echo 'message' | doku diary log --pipe

# decorate with <code>...</code>
# automatically activated the --pipe flag
ls -la | doku diary log --code

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for doku, version 0.1.8
Filename, size File type Python version Upload date Hashes
Filename, size doku-0.1.8-py3-none-any.whl (19.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size doku-0.1.8.tar.gz (17.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page