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

JDK 1.5.0 or newerhttp://java.sun.com/javase/

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

commons-chttp://commons.wikimedia.org
meta-mhttp://meta.wikimedia.org
mediawiki-mwhttp://www.mediawiki.org
 
wikipediaarabicw:arhttp://ar.wikipedia.org
wikipediacatalanw:cahttp://ca.wikipedia.org
wikipediadanishw:dahttp://da.wikipedia.org
wikipediagermanw:dehttp://de.wikipedia.org
wikipediaenglishw:enhttp://en.wikipedia.org
wikipediaesperantow:eohttp://eo.wikipedia.org
wikipediaspanishw:eshttp://es.wikipedia.org
wikipediaestonianw:ethttp://et.wikipedia.org
wikipediafinnishw:fihttp://fi.wikipedia.org
wikipediafrenchw:frhttp://fr.wikipedia.org
wikipediahebreww:hehttp://he.wikipedia.org
wikipediacroatianw:hrhttp://hr.wikipedia.org
wikipediainterlinguaw:iahttp://ia.wikipedia.org
wikipediaitalianw:ithttp://it.wikipedia.org
wikipediajapanesew:jahttp://ja.wikipedia.org
wikipediadutchw:nlhttp://nl.wikipedia.org
wikipedianorwegianw:nohttp://no.wikipedia.org
wikipediapolishw:plhttp://pl.wikipedia.org
wikipediaportuguesew:pthttp://pt.wikipedia.org
wikipediaromanianw:rohttp://ro.wikipedia.org
wikipediaslovenianw:slhttp://sl.wikipedia.org
wikipediaswedishw:svhttp://sv.wikipedia.org
wikipediachinesew:zhhttp://zh.wikipedia.org
 
wikisourceenglishs:enhttp://en.wikisource.org
wikisourcegermans:dehttp://de.wikisource.org
wikisourcefrenchs:frhttp://fr.wikisource.org
wikisourcejapaneses:jahttp://ja.wikisource.org
wikisourcedutchs:nlhttp://nl.wikisource.org
wikisourceitalians:ithttp://it.wikisource.org
wikisourceswedishs:svhttp://sv.wikisource.org
wikisourcepolishs:plhttp://pl.wikisource.org
wikisourceportugueses:pthttp://pt.wikisource.org
wikisourcespanishs:eshttp://es.wikisource.org
 
wikibooksgermanb:dehttp://de.wikibooks.org
wikibooksenglishb:enhttp://en.wikibooks.org
wikibooksfrenchb:frhttp://fr.wikibooks.org
wikibooksjapaneseb:jahttp://ja.wikibooks.org
wikibooksdutchb:nlhttp://nl.wikibooks.org
wikibooksitalianb:ithttp://it.wikibooks.org
wikibooksswedishb:svhttp://sv.wikibooks.org
wikibookspolishs:plhttp://pl.wikibooks.org
wikibooksportugueseb:pthttp://pt.wikibooks.org
wikibooksspanishb:eshttp://es.wikibooks.org
 
wiktionarygermanwikt:dehttp://de.wiktionary.org
wiktionaryenglishwikt:enhttp://en.wiktionary.org
wiktionaryfrenchwikt:frhttp://fr.wiktionary.org
wiktionaryjapanesewikt:jahttp://ja.wiktionary.org
wiktionarydutchwikt:nlhttp://nl.wiktionary.org
wiktionaryitalianwikt:ithttp://it.wiktionary.org
wiktionaryswedishwikt:svhttp://sv.wiktionary.org
wiktionarypolishs:plhttp://pl.wiktionary.org
wiktionaryportuguesewikt:pthttp://pt.wiktionary.org
wiktionaryspanishwikt:eshttp://es.wiktionary.org
 
wikiquotegermanq:dehttp://de.wikiquote.org
wikiquoteenglishq:enhttp://en.wikiquote.org
wikiquotejapaneseq:jahttp://ja.wikiquote.org
wikiquotedutchq:nlhttp://nl.wikiquote.org
wikiquoteitalianq:ithttp://it.wikiquote.org
wikiquoteswedishq:svhttp://sv.wikiquote.org
wikiquotepolishs:plhttp://pl.wikiquote.org
wikiquoteportugueseq:pthttp://pt.wikiquote.org
wikiquotespanishq:eshttp://es.wikiquote.org
 
wikinewsgermann:dehttp://de.wikinews.org
wikinewsenglishn:enhttp://en.wikinews.org
wikinewsjapanesen:jahttp://ja.wikinews.org
wikinewsdutchn:nlhttp://nl.wikinews.org
wikinewsitaliann:ithttp://it.wikinews.org
wikinewsswedishn:svhttp://sv.wikinews.org
wikinewspolishs:plhttp://pl.wikinews.org
wikinewsportuguesen:pthttp://pt.wikinews.org
wikinewsspanishn:eshttp://es.wikinews.org
 
wikiversitygermanv:dehttp://de.wikiversity.org
wikiversityenglishv:enhttp://en.wikiversity.org
 
fotowiki-fotohttp://foto.wikia.com
kamelopedia-kamelohttp://kamelopedia.mormo.org
uncyclopedia-unchttp://uncyclopedia.org