<commit_before>[![Build Status](https://buildhive.cloudbees.com/job/gwtbootstrap3/job/gwtbootstrap3/badge/icon)](https://buildhive.cloudbees.com/job/gwtbootstrap3/job/gwtbootstrap3/)

GwtBootstrap3 is a GWT wrapper for the Bootstrap front-end framework version 3
containing design templates, styles and beautiful widgets.

Have a look at the [demo](http://gwtbootstrap3.github.io/gwtbootstrap3-demo/) and its
[source code](https://github.com/gwtbootstrap3/gwtbootstrap3-demo/tree/master/src/main/java/org/gwtbootstrap3/demo/client). Also use the [Google Group](https://groups.google.com/forum/?fromgroups#!forum/gwtbootstrap3) for help/discussion.

**Note:** This library is **almost** feature complete. Patches / pull requests are welcome. See *Feature matrix* below.

# Usage

View the online [JavaDocs](http://gwtbootstrap3.github.io/gwtbootstrap3-demo/apidocs/index.html)

Add the dependency to your Maven POM:

```xml
<dependency>
    <groupId>org.gwtbootstrap3</groupId>
    <artifactId>gwtbootstrap3</artifactId>
    <version>0.5</version>
    <scope>provided</scope>
</dependency>
```

or if you want to use the snapshot release:

```xml
<dependency>
    <groupId>org.gwtbootstrap3</groupId>
    <artifactId>gwtbootstrap3</artifactId>
    <version>0.6-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>
```

In order to use snapshot releases you also need to add the Sonatype snapshots
repository to your POM:

```xml
<repositories>
    <repository>
        <id>sonatype-nexus-snapshots</id>
        <url>http://oss.sonatype.org/content/repositories/snapshots</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
        <releases>
            <enabled>false</enabled>
        </releases>
    </repository>
</repositories>
```

Inherit the GwtBootstrap3 module in your GWT module:

```xml
<module>
    <inherits name="org.gwtbootstrap3.GwtBootstrap3"/>
    ...
</module>
```

If you want to use the Bootstrap 2 "look-alike" theme inherit `GwtBootstrap3Theme`
instead of `GwtBootstrap3`.

Make sure to not inherit GWT's default styles or any other styles because
Bootstrap brings its own styles which are provided by the GwtBootstrap3 module.

Use the widgets in your UiBinder XML:

```xml
<ui:UiBinder xmlns:ui="urn:ui:com.google.gwt.uibinder"
             xmlns:g="urn:import:com.google.gwt.user.client.ui"
             xmlns:b="urn:import:org.gwtbootstrap3.client.ui">

    <b:Container>
        <b:PageHeader>Yay buttons!</b:PageHeader>

        <b:Button>Some button</b:Button>
        <b:Button type="DANGER" size="LARGE">Dangerous button</b:Button>
    </b:Container>

</ui:UiBinder>
```

or create them in code if that's what you prefer.

**Tip:** GwtBootstrap3's styles and widgets, especially the fluid grid system,
work best when using the "classic" [panels](http://www.gwtproject.org/doc/latest/DevGuideUiPanels.html)
throughout your application and **not** the absolute positioned layout panels
introduced in GWT 2.0.

# Using a Custom Bootstrap Theme

If you want to use a Custom Bootstrap v3 Theme from websites like [wrapbootstrap](https://wrapbootstrap.com/) its super easy.

* Inherit GWTBootstrap3 module like normal
* Download the theme that you want (make sure that it is Bootstrap v3 compatible (** Will not work with Bootstrap v2.x.x themes **)
* Put the CSS files and any needed JS files into the public folder or create a resources folder for these files
* Link this file as "public" in your *.gwt.xml
* After the inhert of GWTBoostrap3 module, put stylesheet linkers for these CSS/JS files
<commit_msg>Adding in documentation for IE8 support.<commit_after>[![Build Status](https://buildhive.cloudbees.com/job/gwtbootstrap3/job/gwtbootstrap3/badge/icon)](https://buildhive.cloudbees.com/job/gwtbootstrap3/job/gwtbootstrap3/)

GwtBootstrap3 is a GWT wrapper for the Bootstrap front-end framework version 3
containing design templates, styles and beautiful widgets.

Have a look at the [demo](http://gwtbootstrap3.github.io/gwtbootstrap3-demo/) and its
[source code](https://github.com/gwtbootstrap3/gwtbootstrap3-demo/tree/master/src/main/java/org/gwtbootstrap3/demo/client). Also use the [Google Group](https://groups.google.com/forum/?fromgroups#!forum/gwtbootstrap3) for help/discussion.

**Note:** This library is **almost** feature complete. Patches / pull requests are welcome. See *Feature matrix* below.

# Usage

View the online [JavaDocs](http://gwtbootstrap3.github.io/gwtbootstrap3-demo/apidocs/index.html)

Add the dependency to your Maven POM:

```xml
<dependency>
    <groupId>org.gwtbootstrap3</groupId>
    <artifactId>gwtbootstrap3</artifactId>
    <version>0.5</version>
    <scope>provided</scope>
</dependency>
```

or if you want to use the snapshot release:

```xml
<dependency>
    <groupId>org.gwtbootstrap3</groupId>
    <artifactId>gwtbootstrap3</artifactId>
    <version>0.6-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>
```

In order to use snapshot releases you also need to add the Sonatype snapshots
repository to your POM:

```xml
<repositories>
    <repository>
        <id>sonatype-nexus-snapshots</id>
        <url>http://oss.sonatype.org/content/repositories/snapshots</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
        <releases>
            <enabled>false</enabled>
        </releases>
    </repository>
</repositories>
```

Inherit the GwtBootstrap3 module in your GWT module:

```xml
<module>
    <inherits name="org.gwtbootstrap3.GwtBootstrap3"/>
    ...
</module>
```

If you want to use the Bootstrap 2 "look-alike" theme inherit `GwtBootstrap3Theme`
instead of `GwtBootstrap3`.

Make sure to not inherit GWT's default styles or any other styles because
Bootstrap brings its own styles which are provided by the GwtBootstrap3 module.

Use the widgets in your UiBinder XML:

```xml
<ui:UiBinder xmlns:ui="urn:ui:com.google.gwt.uibinder"
             xmlns:g="urn:import:com.google.gwt.user.client.ui"
             xmlns:b="urn:import:org.gwtbootstrap3.client.ui">

    <b:Container>
        <b:PageHeader>Yay buttons!</b:PageHeader>

        <b:Button>Some button</b:Button>
        <b:Button type="DANGER" size="LARGE">Dangerous button</b:Button>
    </b:Container>

</ui:UiBinder>
```

or create them in code if that's what you prefer.

**Tip:** GwtBootstrap3's styles and widgets, especially the fluid grid system,
work best when using the "classic" [panels](http://www.gwtproject.org/doc/latest/DevGuideUiPanels.html)
throughout your application and **not** the absolute positioned layout panels
introduced in GWT 2.0.

# Support for IE8

For support in IE8, you will need to inherit the Respond module as well.

```xml
<module>
    <inherits name="org.gwtbootstrap3.GwtBootstrap3"/>
    <inherits name="org.gwtbootstrap3.extras.respond.Respond"/>
</module>
```

# Using a Custom Bootstrap Theme

If you want to use a Custom Bootstrap v3 Theme from websites like [wrapbootstrap](https://wrapbootstrap.com/) its super easy.

* Inherit GWTBootstrap3 module like normal
* Download the theme that you want (make sure that it is Bootstrap v3 compatible (** Will not work with Bootstrap v2.x.x themes **)
* Put the CSS files and any needed JS files into the public folder or create a resources folder for these files
* Link this file as "public" in your *.gwt.xml
* After the inhert of GWTBoostrap3 module, put stylesheet linkers for these CSS/JS files

{'fraction_non_alphanumeric': 0.11657681940700809, 'fraction_numerical': 0.011051212938005392, 'mean_word_length': 4.167827298050139, 'pattern_counts': {'":': 0, '<': 105, '<?xml version=': 0, '>': 105, 'https://': 10, 'lorem ipsum': 0, 'www.': 2, 'xml': 19}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2286960', 'n_tokens_mistral': 2433, 'n_tokens_neox': 2299, 'n_words': 683}