Ginger Roots is a fork of the incredible Wordpress Roots Theme mixed together with {{Mustache}} templates
PHP JavaScript
Pull request Compare This branch is 37 commits ahead, 1732 commits behind roots:master.
Latest commit 55df994 Jan 16, 2012 @gingerlime using $this instead of class name for lambda functions
+ a little tidy-up
Permalink
Failed to load latest commit information.
css
img
inc
js
lang
lib
templates
.gitignore
404.php
README.md
archive.php
comments.php
editor-style.css
footer.php
front-page.php
functions.php
header.php
index.php
loop-page.php
loop-search.php
loop-single.php
loop.php
page-custom.php
page-full.php
page.php
screenshot.png
search.php
searchform.php
sidebar.php
single.php
style.css

README.md

Ginger Roots

Ginger Roots is a fork of the incredible Roots Theme mixed together with {{Mustache}} templates. It uses Mustache.php to wrap and convert existing .php templates into .mustache files.

Mustache Theme support

Many of the built-in Mustache features are supported, plus wordpress-specific adaptation, including:

  • i18n via custom {{#__}}{{/__}} tags

  • partials {{> }} to include other templates

  • Wordpress foundations such as the loop (via {{#the_loop}})

  • Pre-populated wordpress context data, e.g. {{is_singular}}, {{the_permalink}}

  • All mustache templates are located inside templates folder

  • Templates correspond to their .php counterparts, i.e. there is page.php which uses templates/page.mustache

  • New templates can be created even without a php counterpart, as long as they don't need new context data

Why Mustache?

Because it's neat. Wordpress and PHP are very powerful, but adjusting php templates embedded with html can easily become messy. Mustache forces you to split application logic and presentation in a nice way.

Quick start

  • Clone the git repo - git clone git://github.com/gingerlime/ginger-roots.git - or download it
  • Read Theme Activation to understand everything that happens once you activate Roots

Ginger Roots specifics:

Terms:

  • Rootache - the very unattractive name for the Mustache.php sub-class used in Ginger Roots
  • template / $template - the mustache template, before rendering
  • context / $context - the 'storage space' for all data used to render the template. Typically a $context is a Rootache instance.

Editing Templates:

  • Hack away any file in templates/

Adding data or logic:

  • Use the appropriate php file to add data to the context
  • Extend the Rootache class

Roots Theme

Roots is a starting WordPress theme made for developers that’s based on HTML5 Boilerplate, Starkers, and the most popular CSS frameworks.

Roots includes support for Blueprint CSS, 960 Grid System, 1140px Grid, Adapt.js, Less Framework, Foundation, and Bootstrap with the ability to set site-wide classes for the main content area and the sidebar. There's also the option to not use any CSS framework.

Features

  • HTML5 Boilerplate's markup, style, and .htaccess
  • Popular CSS frameworks included (with the option to use none)
  • Clean URLs (no more /wp-content/)
  • All static theme assets are rewritten to the website root (/css/, /img/, and /js/)
  • Cleaner HTML output of navigation menus
  • Root relative URLs
  • Posts use the hNews microformat
  • The gallery shortcode has been modified to use <figure> and <figcaption>
  • wp_head has been cleaned up along with the output of enqueued styles and scripts
  • Robots.txt optimized for SEO
  • Multilingual ready (English, Spanish, French, Italian, Dutch, Brazilian Portuguese, Macedonian, Finnish, Danish, and Turkish)

Theme Options

Theme Options

Contributing

Anyone and everyone is welcome to contribute. There are several ways you can help out:

  1. Raising issues on GitHub
  2. Sending pull requests for bug fixes or new features and improvements
  3. Making the docs better
  4. Replying to questions on the mailing list

Project information

License

Major components:

  • HTML5 Boilerplate: The Unlicense
  • Modernizr: MIT/BSD license
  • jQuery: MIT/GPL license
  • Normalize.css: Public Domain
  • Blueprint CSS: Modified MIT License
  • 960 Grid System: MIT/GPL License
  • The 1140px Grid: CC BY-SA 3.0 Australia License
  • Adapt.js: MIT/GPL license
  • Less Framework 4: MIT license
  • Foundation: MIT license
  • Bootstrap: Apache 2.0 license

Everything else:

The Unlicense (aka: public domain)