HTML5 Boilerplate =========================================== Smartmin comes ready to go straight out the box, including using a recent version of the most excellent HTML5 boilerplate so you can build a standards compliant and optimized website. File Layout =========================================== Again, Smartmin defines a layout for your files, things will just be easier if you agree:: /static/ - all static files /css/ - any css stylesheets reset.css - this is the HTML5 boilerplate reset smartmin_styles.css - styles specific to smartmin functionality styles.css - this can be any of your custom styles /img/ - any static images /js/ - your javascript files /libs/ - external javascript libraries you depend on Blocks =========================================== All pages rendered by smartmin inherit from the ``base.html``, which contains the following blocks: title This is the title of the page displayed in the ```` tag extrastyle Any extra stylesheets or CSS you want to include on your page. Surround either in ``<style>`` or ``<link>`` login The login block, will either display a login link or the name of the logged in user with a logout link messages Any messages, or 'flashes', pushed in by the view. content The primary content block of the page, this is the main body. footer Any footer treatment. extrascript Any extra javascript you wanted included, this is put at the bottom of the page Customizing ============================================= You can, and shoud customize the ``base.html`` to your needs. The only thing smartmin depends on is having the content, extrascript and extrastyle blocks available.