abstract

the commonist is a simple upload clients for wikimedia commons and a number of other mediawiki sites. it is written in java and BeanShell.

this software is in beta state, so don't complain if it's broken ;)

contact

the dot gray at gmx dot net (write in english or german)

license

the commonist is released under the GPL.

requirements

download

$(project)-$(version).zip (sources included)

see changes.txt for changes in version $(version).

usage

1. click this link to start the commonist if you have webstart installed. the webstart files of the commonist are signed with a snake oil certificate, so an ugly warning will pop up.
2. alternatively, you can download $(project)-$(version).zip and unpack it. this will create a new directory $(project)-$(version). cd into this directory and start the commonist with bin/commonist (on linux or mac os x), or $ bin\commonist.bat (on windows).
   note: on windows, you may have to click away a requester at program startup with continue.

customization

license templates

this works with the webstart version and the zipfile version.

1. copy etc/licenses.txt to $HOME/.commonist/licenses.txt.
2. change $HOME/.commonist/licenses.txt as you like.
3. if $HOME/.commonist/licenses.txt exists, it overrides settings in etc/licenses.txt.

gallery templates

this works with the webstart version and the zipfile version.

1. the gallery is built from template files. the templates contain wiki markup, lines starting with a # are beanshell code toi be executed, $() encloses beanshell code to be printed.
2. etc/gallery_commons.bpp and etc/image_commons.bpp are used for commons, etc/gallery_default.bpp and etc/image_default.bpp for other wikis.
3. copy one or more of these files to $HOME/.commonist/
4. change them as you like.

adding an UI-language

this works with the zipfile version, but not with the webstart version.

1. copy etc/messages_en.properties to $HOME/.commonist/messages_xxx.properties, xxx is the user language printed out on startup.
2. translate $HOME/.commonist/messages_xxx.properties

adding a wiki

this works with the webstart version and the zipfile version.

1. unpack lib/mwapi.jar from the unpacked binary zip into a new directory
2. look for commons.family and commons.site in this directory
3. create a directory $HOME/.commonist/family
4. copy commons.family to $HOME/.commonist/family/NAME.family
5. copy commons.site to $HOME/.commonist/family/NAME.site
6. adapt these two files.

running code on startup

this works with the webstart version and the zipfile version.

you can create a file $HOME/.commonist/startup.bsh which is executed on startup. this can be used for automatic login, to provide passwords for htaccess-protected servers and to allow untrusted SSL-certificates. have a look at etc/startup.bsh for examples.

supported sites