Huggle is an anti-vandalism tool for use on MediaWiki based projects
Permalink
Failed to load latest commit information.
MacOS
documentation fixed version info Nov 2, 2018
snap snap: Fix FTBFS Nov 3, 2018
src Localisation updates from https://translatewiki.net. Nov 19, 2018
travis
windows
windows64 version Jul 5, 2018
.gitignore new layout of source folders and files (#281) Apr 23, 2018
.gitmodules new layout of source folders and files (#281) Apr 23, 2018
.travis.yml Drop/qt4 (#279) Apr 11, 2018
CODE_OF_CONDUCT.md
CONTRIBUTING.md Create CONTRIBUTING.md Oct 16, 2017
LICENSE Create LICENSE Jul 18, 2017
README.md fixed wrong path in README from previous commit May 25, 2018
configure implemented --enable-profiler May 25, 2018
huggle new layout of source folders and files (#281) Apr 23, 2018

README.md

huggle3-qt-lx

Huggle 3 is an anti-vandalism tool for use on Wikipedia and other MediaWiki sites, written in C++ (QT framework). It is officially supported for Windows (2000 or newer), MacOS and Linux (debian/ubuntu).

Build Status Build status Snap Status

Building

IMPORTANT: Since 3.1.19 you must download submodules in folder libs using git:

git submodule init
git submodule update

If you did not download this repository using git, there should be a guide on where you can download the libraries from in the respective folders.

Libraries and tools you need to have to build:

  • C++11 compiler
  • CMake 2.8.9 or higher is required
  • QT5 sdk (recommended 5.7 or newer, with WebEngine and QJSEngine)

[NEW] It is now possible to use a VirtualBox VM as a portable development environment for Huggle. » Wiki page

Windows

» Wiki page

Linux

  • checkout this repository
  • enter the repository folder, then execute:
# IMPORTANT
# The --extension option works only if you cloned this repository using git
# if you downloaded a gzip file, you can only use it after downloading them
# by hand into 'huggle/extension_list' folder
./configure --extension --web-engine
cd release
make
sudo make install
sudo ldconfig

MacOS

» Wiki page

WebKit vs Chromium

Qt5.0 - Qt5.4 supports WebKit, which is a default backend for Huggle. Newer Qt support only Chromium backend (code named WebEngine)

If you want to build Huggle with Qt newer than 5.4 you will have to enable it like this:

./configure --web-engine

Or alternatively if you are starting cmake by hand, just pass it -DWEB_ENGINE=true parameter

Documentation

For developers: source code documentation and the repo's Wiki are available.

For users: on metawiki and mediawiki.

Getting help

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

Contributing

Everyone is allowed to send their 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 the 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 which doesn't require sanity check, like documentation or comments, please append [ci skip] to your message.

Reporting bugs

Please use Wikimedia's tracking platform, phabricator.

Support us

Your donations are welcome and help us focus on the development even more:

PayPal (preferred), or :

LTC:  LfMDMWKqhiT45q4h1uduiDfjUZfiwGiCes
Doge: DMhK9EarJQaZrAHYinGReESL3CPvoMYcKK
BTC:  18YTu4mPqzaaRv5QarvMGRuPiH3ntk5ir2

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.