NAME

Dancer::Layout::Bootstrap - Boostrap layout for Dancer

SYNOPSIS

# 1. Copy the included template files to your dancer application
# 2. Change the "layout" parameter in config.yml to "bootstrap3"
# 3. Dance On!

# Preview the layout
plackup -a bin\app.pl

ABSTRACT

Template and dummy application that applies the Bootstrap CSS to Dancer.

SUPPORTED FEATURES

If you want to show alerts etc., the main template already provides support for that via Dancer::Plugin::FlashMessage.

flash success => sprintf "Welcome back, %s",
    session('user')->{name};

... will produce a nice, green "Welcome back" message for the user.

All flash message output is HTML escaped for security reasons.

TEMPLATE FILES IN THIS DISTRIBUTION

The meat of this package are the template and Bootstrap and jQuery files. These don't get installed but live in the distribution. You will need to copy the following files and directories into your application directory, at least until Dancer resp. the dancer application comes with a way to specify default layouts when generating a new application scaffold.

You will likely want to use either Bootstrap 2 or Bootstrap 3. See the appropriate list of files to copy.

LIST OF FILES TO COPY

Bootstrap 3

public/css/bootstrap-3/bootstrap.css Bootstrap 3
public/css/bootstrap-3/bootstrap.min.css Bootstrap 3
public/css/fonts/glyphicons-halflings-regular.eot Bootstrap 3
public/css/fonts/glyphicons-halflings-regular.svg Bootstrap 3
public/css/fonts/glyphicons-halflings-regular.ttf Bootstrap 3
public/css/fonts/glyphicons-halflings-regular.woff Bootstrap 3
public/css/fonts/glyphicons-halflings-regular.woff2 Bootstrap 3
public/javascripts/bootstrap-3/bootstrap.js Bootstrap 3
public/javascripts/bootstrap-3/bootstrap.min.js Bootstrap 3
public/javascripts/jQuery/jquery-3.1.1.min.js jQuery 3.1.1 (for Bootstrap 3)
public/javascripts/jQuery/jquery-ui-1.12.min.js jQuery UI (for Bootstrap 3)
views/index.tt        Index page with Bootstrap layout
views/layouts/bootstrap3.tt    The Bootstrap layout

Bootstrap 2

public/css/bootstrap-responsive.css   Bootstrap 2.3.0
public/css/bootstrap.css      Bootstrap 2.3.0
public/css/bootstrap.min.css  Bootstrap 2.3.0
public/images/glyphicons-halflings-white.png  Glyphicons
public/images/glyphicons-halflings.png        Bootstrap 2.0.3
public/javascripts/bootstrap-2.3.0/bootstrap-alert.js Bootstrap 2.3.0
public/javascripts/bootstrap-2.3.0/bootstrap.js       Bootstrap 2.3.0
public/javascripts/bootstrap-2.3.0/bootstrap.min.js   Bootstrap 2.3.0
public/javascripts/jQuery/jquery-1.7.2.min.js jQuery 1.7.2
public/javascripts/jQuery/jquery.ui.widget.js jQuery 1.7.2
views/index.tt        Index page with Bootstrap layout
views/layouts/bootstrap.tt    The Bootstrap layout

NEEDED MODULES

The simple templating included with Dancer does not properly support user log-in / log out, so the template needs Template::Toolkit.

SEE ALSO

http://twitter.github.com/bootstrap/ - Bootstrap

http://bootswatch.com/ - Themes for Bootstrap

http://glyphicons.com/ - Icons from Glyphicons Free, licensed under CC BY 3.0.

http://jquery.com/ - jQuery 1.7.2 , jQuery 3

http://www.lavishbootstrap.com/ - create new colour schemes

REPOSITORY

The public repository of this module is https://github.com/Corion/dancer-layout-bootstrap.

SUPPORT

The public support forum of this module is https://perlmonks.org/.

BUG TRACKER

Please report bugs in this module via the RT CPAN bug queue at https://rt.cpan.org/Public/Dist/Display.html?Name=Dancer-Layout-Bootstrap or via mail to dancer-layout-bootstrap-Bugs@rt.cpan.org.

AUTHOR

Max Maischein corion@cpan.org

COPYRIGHT (c)

Copyright 2014-2017 by Max Maischein corion@cpan.org.

LICENSE

This module is released under the same terms as Perl itself.

cpanm Dancer::Layout::Bootstrap

perl -MCPAN -e shell
install Dancer::Layout::Bootstrap