Skip to content

Latest commit

 

History

History
110 lines (83 loc) · 3.36 KB

README.md

File metadata and controls

110 lines (83 loc) · 3.36 KB
Raw

huggle3-qt-lx

Huggle 3 QT-LX is an anti-vandalism tool for use on Wikipedia and other Wikimedia projects, written in C++ (QT framework). It is officialy supported for Windows (2000 or newer) and Linux (debian/ubuntu), but it may work on other distributions as well as MacOS.

Build Status

Building

Libraries and tools you need to have to build:

  • GCC (gcc g++ make)
  • CMake 2.8.9 or higher is required
  • QT4 sdk (libqt4-dev libqt4-webkit libqt4-network qt4-qmake libqtwebkit-dev libqt4-dev-bin qt4-dev-tools)
  • (optional) QT5 sdk (libqt5webkit5-dev qt5-default qtquick1-5-dev qtlocation5-dev qtsensors5-dev qtdeclarative5-dev)
  • (optional) Python (libpython-dev)

Windows

Note in case you don't have power shell you need to do these 2 steps before you can build huggle:

  • Create empty version.txt in folder huggle
  • Copy definitions_prod.hpp to definitions.hpp

Linux

  • checkout this repository
  • cd REPO/huggle, execute
./configure --qt4 #you can use --qt5 in case you have it
cd huggle_release
make
sudo make install

MacOS

brew install qt
./configure
cd huggle_release
make
open huggle.app

Python

To enable python engine you need to:

On linux / mac: run ./configure with --python option, for example

./configure --qt5 --python

On windows:

  • open huggle.pro and uncomment / add python library
  • open definitions.hpp and uncomment #define PYTHONENGINE

now rebuild huggle and pray

If you manage to compile it, you can insert your .py extensions to HUGGLEROOT/extensions, for more information ask for help on our irc channel.

Documentation

Developers: http://tools.wmflabs.org/huggle/docs/head

This is a documentation for users: https://meta.wikimedia.org/wiki/Huggle

Getting help

We have a channel irc://chat.freenode.org/#huggle so if you need any kind of help please go there

Contributing

Everyone is allowed to send the pull requests to this repository, and all regular contributors get a developer access to directly push if they need it. If you want to join a huggle developer team, please see https://meta.wikimedia.org/wiki/Huggle/Members and insert yourself

This repository is running CI using travis, if you want to change anything what doesn't require sanity check, like documentation or comments, please append [ci skip] to your message

Reporting bugs

Please use https://bugzilla.wikimedia.org/enter_bug.cgi?product=Huggle

License

Huggle 3 is licensed under GPL v3+, some contents of this repository may be licensed under different license. See the local README or file headers for more information.