No project description provided
Project description
doku is a cli tool to read and manipulate documents in DokuWiki via its XMLRPC endpoint.
Install
pip install doku # or as a user pip install --user doku # upgrade pip install --upgrade doku
Configuration
Enable XML RPC on your DokuWiki instance:
Admin > Configuration Settings > Authentication
Create a new file: $HOME/.doku.ini
[connection] domain = domain.name.tld username = your-username password = your-password ssl = true path = / [settings] 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]... Options: --help Show this message and exit. Commands: cat edit list search
Diary
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 :diary:2019:02:21 :diary:2019:02:root :diary:2019:root # Will regenerate this page # if you log an entry in a year previously was not there :diary:root # 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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
doku-0.1.8.tar.gz
(17.7 kB
view hashes)
Built Distribution
doku-0.1.8-py3-none-any.whl
(19.7 kB
view hashes)