[[PageOutline]]

= WebKitGTK+ =

The GTK+ port of WebKit is intended to provide a browser component for the portable [http://www.gtk.org/ GTK+] UI toolkit. WebKitGTK+ is developed within the official WebKit SVN, so the codebase is unrelated to the classic [http://gtk-webcore.sourceforge.net/ GTK+ WebCore], but WebKitGTK+ has superseded Gtk+ WebCore. The [http://build.webkit.org/ WebKit Buildbot] provides continuous build and layout tests.

A [wiki:WebKitGTK/StableReleaseTracker semi-stable] branch exists to evaluate how to handle issues such as stability and security support.

Developers interested in using or contributing to the GTK+ port should be willing to get their hands dirty at this stage. Patches are welcome on the [http://bugs.webkit.org/ bug tracker] and help is readily available at #webkit-gtk on irc.freenode.net and the [http://lists.webkit.org/mailman/listinfo.cgi/webkit-gtk mailing list] for developers who want to learn the ropes.

== Building ==

See the [https://trac.webkit.org/wiki/BuildingGtk build instructions].

== Getting Involved ==

=== Reporting Bugs ===

You can file a bug against WebKitGTK+ by using [https://bugs.webkit.org/enter_bug.cgi?assigned_to=webkit-unassigned%40lists.webkit.org&attachurl=&blocked=&bug_file_loc=http://&bug_severity=Normal&bug_status=NEW&comment=&component=WebKit%20Gtk&contenttypeentry=&contenttypemethod=autodetect&contenttypeselection=text/plain&data=&dependson=&description=&flag_type-1=X&flag_type-3=X&flag_type-4=X&form_name=enter_bug&keywords=GTK&maketemplate=Remember%20values%20as%20bookmarkable%20template&op_sys=Linux&priority=P3&product=WebKit&rep_platform=PC&short_desc=%5BGTK%5D%20 this template]. Remember to include the version of WebKitGTK+ or revision number / commit hash that you are using in the bug summary. It's very important to include a minimal, reproducible test case, whether it be a snippet of HTML or a bit of C code. The QtWebKit port has provided some excellent [QtWebKitBugs tips] for good bug reports.

=== Running Tests ===

See the [https://trac.webkit.org/wiki/WebKitGtkLayoutTests instructions] for running tests.

== Distributions ==

The WebKit/GTK+ API follows a stable additions-only policy. The core engine is continually being stabilised and is suitable for most embedding tasks. Distributors should get in touch with the upstream maintainers to be sure they're packaging the correct version.

We have posted some detailed information about [https://trac.webkit.org/wiki/WebKitGTKStableReleases WebKitGTK+ Stable Releases].

=== Debian ===

Debian Unstable provides experimental WebKit/GTK+ packages by Mike Hommey.

 Debian has organised a packaging team for WebKit:

 * [http://lists.alioth.debian.org/mailman/listinfo/pkg-webkit-maintainers pkg-webkit-maintainers]: General WebKit packaging discussion
 * [http://lists.alioth.debian.org/mailman/listinfo/pkg-webkit-commits pkg-webkit-commits]: Commits list

=== Gentoo ===

Ebuilds supporting both Gtk+-3.0 Gtk+-2.0 (webkit-gtk:2) are available in portage and are parallel-installable:
{{{
# emerge -v1a webkit-gtk webkit-gtk:2
}}}

Ebuilds for unstable branch of WebKitGTK+ are available from gnome-overlay.

=== Lunar-Linux ===

Lunar provides an experimental/development module for WebKit/GTK+.  It can be found in the moonbase in the experimental (zbeta) section under the name 'WebKit.'

= Further links =

 * [ApplicationsGtk Applications using this Gtk port]
 * [wiki:"HackingGtk" the hacker's guide to WebKit/GTK+].
 * [wiki:"WebKitGTK/KeepingTheTreeGreen" help keep the buildbots happy. and green].
 * [wiki:"WebKitGTK/StableReleaseTracker" Preparing for the WebKitGTK+ stable release]
 * [wiki:"WebKitGTK/Releasing" Making a release of WebKit/GTK+]