Command-line options

-f textfile, --file textfile

Point to the Ar textfile that is going to be sent to the server.

-h, --help

Show help.

-n username, --name username

Set the username to log in as.

-q, --quick

Activate the quick mode, which disables the action menu. As a result the changes will be uploaded once a comment is entered by the user.

-t target, --target target

Provide the name of the wiki page to be updated, e.g.: “/WiFi/80211ac”. A hyperlink is acceptable as well, e.g.: “https://wiki.freebsd.org/WiFi/80211ac”.

-u, --update

Download the contents of the target wiki page and put them into the

-v, --version

Show version.

selector

Run moinmoincli as preconfigured for a given selector.

Selectors are used if the select_target() function is defined in the configuration file (defaults are listed in the FILES section). A single selector is associated with a target and a textfile. As a result it is possible to use selectors to replace “moinmoincli -f ./80211ac.moin -t /WiFi/80211ac” with “moinmoincli ac” using an ac selector.

Action menu

y, k

Confirm changes. The action menu will be closed and the changes uploaded to the server.

n, a

Abort. Close moinmoincli immediately.

t

Mark changes as trivial so that subscribers to the modified wiki page are not notified.

c

Change the comment.

d

Show the diff.

s

Print the summary.

Example 1: Downloading Wiki Pages

$ moinmoincli --file ./dogs.moinmoin --target /Community/Dogs --update

Example 2: Uploading Wiki Pages

$ moinmoincli -n CharlieRoot -f ./sandbox.txt -t /WikiSandBox

Example 3: Suggested Workflow

1. Configure ~/.moinmoincli.conf so that it is not necessary to specify the username, the text file name and the target website every time. Use selectors for that.
2. Grab the latest version of the wiki page with a selector:

   $ moinmoincli -u selectorYouHaveConfigured
       

3. Edit the text file.
4. Push the changes over to the wiki server with:

   $ moinmoincli selectorYouHaveConfigured
       

Configuration File

# The username to use when logging in.
name='CharlieRoot'

# The password for the account.
password='secret'

# The default target.
# It is used unless a selector or the -t flag is used.
target='/WikiSandBox'

# The default textfile.
textfile='/tmp/wiki.moin'

# The select_target function, which defines the logic behind
# selectors.
select_target() {
    case "$1" in
        [wW]*)
            target='/WiFi'
            textfile="$HOME/wifi.moin"
            ;;
        *)
            printf '%s\n' "invalid selector '$1'" >&2
            ;;
    esac
}