naviation

• home
• minibpp
• commonist
• trustvis
• rcbirds
• linky
• mwjed
• jedit
• shell
• mushell
• boo!

commonist

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

commonist-0.3.43.zip (sources included)

see changes.txt for changes in version 0.3.43.

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 commonist-0.3.43.zip and unpack it. this will create a new directory commonist-0.3.43. 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