Tips

Play 2.0 tips and tricks

To use Play Framework 2 with Twitter Bootstrap 2:

Renaming the Bootstrap include files

• Build Play from last sources (near RC3) (Since less version has been updated to 1.2 )
• Copy bootstrap's less files into app/assets/stylesheets/bootstrap
• Add bootstrap/_ before each bootstrap.less import declaration and rename each file the same way ( This is the convention to not compile theses files while packaging compiled assets )
• Move bootstrap.less file into app/assets/stylesheets

This can be done with a script like this (run in app/assets/stylesheets/bootstrap)

for a in *.less; do mv $a _$a; done 
sed -i '|s|@import "|@import "bootstrap/_|' bootstrap.less 
mv bootstrap.less ../bootstrap.less`

Alternative: using the Build.scala configuration file

• Copy bootstrap's less files into app/assets/stylesheets/bootstrap

• Modify the project/Build.scala file to filter out the Bootstrap LESS files we don't want to compile:

  • Define a new BuildPath resolver function

    // Only compile the bootstrap bootstrap.less file and any other *.less file in the stylesheets directory
    def customLessEntryPoints(base: File): PathFinder = (
        (base / "app" / "assets" / "stylesheets" / "bootstrap" * "bootstrap.less") +++
        (base / "app" / "assets" / "stylesheets" * "*.less")
    )

* Override the default `lessEntryPoints` setting key with the new function

    val main = PlayProject(appName, appVersion, appDependencies, mainLang = JAVA).settings(
        lessEntryPoints <<= baseDirectory(customLessEntryPoints)
    )

* Include the `bootstrap.min.css` file in your view(s):

    <link rel="stylesheet" media="screen" href="@routes.Assets.at("stylesheets/bootstrap/bootstrap.min.css")" />