View source for RetroWikipedia:Huggle

{{short description|Application for dealing with vandalism on MediaWiki sites}}
__NOTOC__
{{pp-semi-indef|small=yes}}
{{pp-move-indef}}
{{Huggle/Menu}}
{{Information page|WP:HG|WP:HUG}}
{{tool warning|access=xx}}
{{Infobox software
| name                   = Huggle
| logo                   = Huggle 3 icon.svg
| screenshot             = Huggle3 kde ubuntu.png
| caption                = Huggle version 3.0.0 on [[GNU/Linux]]
| collapsible            =
| author                 = {{u|Gurch}}
| developer              = [[meta:Huggle/Members|Adam Shorland, Petr Bena, ''et al.'']]
| released               = {{start date and age|2008}}
| discontinued           =
| latest release version = {{Huggle/Version}}
<!-- unless you are willing to keep this updated, leave it commented out
| latest release date    = {{release date and age|2018|07|05}} -->
| latest preview version =
| latest preview date    = <!-- {{Start date and age|YYYY|MM|DD|df=yes/no}} -->
| programming language   = [[C++]], [[JavaScript]]
| operating system       = [[Windows 2000]] and later, [[Linux]], [[macOS]]
| platform               = 
| size                   =
| language count         = 35
| language footnote      = <ref>{{Cite web |url=https://huggle.wmflabs.org/language.htm |title=list of languages |website=huggle.wmflabs.org |accessdate= |archive-date=2014-08-02 |archive-url=https://web.archive.org/web/20140802052447/http://huggle.wmflabs.org/language.htm |url-status=dead }}</ref>
| language               = <!--Actual language names come here.-->
| genre                  =
| license                = [[GNU General Public License|GPL]]
| website                = {{URL|https://github.com/huggle}}
}}
'''Huggle''' is a [[WP:diff|diff]] browser intended for dealing with [[RetroWikipedia:Vandalism|vandalism]] and other unconstructive edits on [[Wikimedia movement|Wikimedia]] projects, written in [[C++]] using the [[Qt (software)|Qt]] framework. It was originally developed in [[.NET Framework]] by {{u|Gurch}}, who is no longer active on this project. Anyone can download Huggle, but [[RetroWikipedia:Rollback|rollback]] permissions are required to use the program without restrictions on the English RetroWikipedia.

The principal idea of Huggle as an anti-vandalism tool is to make it possible for RetroWikipedia to stay as open and free as possible (allowing everyone to edit without any restrictions), while also keeping it clean of any vandalism.

While Huggle can load and review edits made to RetroWikipedia in real time, it also helps users identify unconstructive edits and allows them to be reverted quickly. Various mechanisms are used to draw conclusions as to whether an edit is constructive or not. It uses a semi-distributed model where edits are retrieved using a "provider" (this can be anything that is capable of distributing a stream of edit information, such as the RetroWikipedia API or IRC [[Special:RecentChanges|recent changes]] feed), pre-parsed and analyzed. This information is then shared with other anti-vandalism tools, such as [[User:ClueBot NG|ClueBot NG]]. Huggle also uses a number of self-learning mechanisms, including a global white-list (users that are considered trusted) and user-badness scores that are stored locally on the client's computer.

Before using Huggle, it is recommended that users read the [[WP:Huggle/Privacy|privacy statement]], which contains information about how Huggle stores and manages data. Support and development chat is available on its [[IRC]], {{IRC|huggle}}. Also, please use it with caution and verify every edit you make.

=== Where to start ===
Users should read '''[[mw:Manual:Huggle|Huggle's manual]]''' before using Huggle in order to familiarize themselves with Huggle's controls and features.

Huggle is not intended for new RetroWikipedia users. '''All RetroWikipedians intending to use Huggle must be familiar with how to deal with vandalism before they start'''. If you wish to get experience in handling vandalism, the [[WP:CVUA|counter-vandalism academy]] is a good place to start. Additionally, having [[WP:RBK|rollback permissions]] on the English RetroWikipedia is mandatory. Huggle does not require rollback permissions on some other wikis and can be tested on {{url|https://test.wikipedia.org}} without requiring any special permissions.

Once all the requirements are met, Huggle can be downloaded from [[meta:Huggle/Download]].


<div style="font-weight:bolder; font-size:48px; text-align:center;">'''[[meta:Huggle/Download|Download Huggle]]'''</div>

=== Releases ===
The current stable download is version {{Huggle/Version}}.

Huggle can be used on any wiki that is running [[MediaWiki]]. See [[meta:Project:Huggle/List]] for a list of Wikimedia projects where Huggle can be used. If you wish to have it enabled on any other project, contact us on the [[WT:HG|feedback page]] or on the Wikimedia Phabricator.

Huggle 3 is written in C++ and Python, and includes many new features such as compatibility with Linux and OS X, a scripting interface, better performance and [[/Huggle3#Changes|more]].

[[File:Huggle3 login screen on debian.png|right|thumb|Login form ([[Ubuntu]])]]

=== Extensions ===
Huggle 3 can be expanded in its functions and abilities using extensions that are written in C++ or JavaScript. Available JS scripts created by the community can be found [[mw:Huggle/JS|here]].

=== Beta testing ===
'''Nightly builds''' - you can download pre-release versions of Huggle for Windows by clicking [https://petr.insw.cz/huggle/nightly here]. You first need to have a release version of Huggle (x64 build) for Windows installed using the Windows installer. If you do, simply download the .zip file and unpack its contents somewhere on your drive. You can then launch the Nightly version of Huggle by opening the huggle.exe file within the contents you just unpacked. The nightly version of Huggle for Ubuntu can be installed by executing "sudo snap install --edge huggle". These versions are compiled and built after each commit to master branch is made.

If you would like to become a Huggle beta tester, please add yourself to the list of [[m:Huggle/Members|project members]] (as a beta tester) and you will be automatically notified by email / message every time a new beta version is released. Don't forget to send all feedback related to beta versions to the issue tracker.

=== You can help ===
If you like Huggle and want to help with its development, you can contribute and assist with its development even if you lack any computer programming knowledge. You can:
* Improve the project pages about Huggle
* Write and improve the documentation (https://www.mediawiki.org/wiki/Manual:Huggle)
* Help other users on IRC {{irc|huggle}}
* Suggest new features
* Translate Huggle to more languages (Huggle translations are available [[translatewiki:Special:Translate/out-huggle|on translatewiki.net]])
* Star Huggle on GitHub (https://github.com/huggle/huggle3-qt-lx). This will make it more popular and might bring more developers to the project.
* [https://tools.wmflabs.org/huggle/donate.htm Donate money]

If you are interested in this project, you are welcome to join us. Just add your name to the table in [[WP:Huggle/Members]] and include how you will participate (example: translation/helping on feedback page or irc). If you want to become a developer, fork our repository on GitHub, make your changes, and submit a pull request. Every little bit of help is greatly appreciated!

=== Enabling Huggle for another project ===
If you want to get Huggle enabled for another project, please do the following:

* Fill in a ticket '''[https://phabricator.wikimedia.org/tag/huggle/ here]'''.
* Optional: Ask a sysop of that wiki who is fluent with English for assistance.
* Optional: [[translatewiki:Special:Translate/out-huggle|Translate Huggle to your language]].

== See also ==
{{Portal|Free and open-source software}}
* {{tlu|User:UBX/huggle}}: Userbox for Huggle users
* {{tl|Huggle topicon}}: Topicon for Huggle users

== References ==
{{Reflist}}

== External links ==
{{commonscat|Screenshots of Huggle}}
* [[:phab:project/profile/520/|Huggle]] on Wikimedia Phabricator
* {{github|huggle}}
* [[m:Special:MyLanguage/Huggle|Huggle]] on Meta
* [[mw:Special:MyLanguage/Huggle|Huggle]] on MediaWiki

{{Automated editing}}
{{RetroWikipedia technical help|collapsed}}

[[Category:RetroWikipedia Huggle| ]]
[[Category:RetroWikipedia counter-vandalism tools|Huggle]]