A SEO and social media optimized Middleman template
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data
helpers
source
.bowerrc
.gitignore
Gemfile
Gemfile.lock
README.md
Rakefile
bower.json
config.rb

README.md

middleman-seo

A SEO-optimized project template for Middleman, the amazing static site building tool.

Confused about what it means to SEO-optimize your site from a technical perspective? Read this.

Looking for a Middleman 4 template with external asset pipeline? Check out this branch

Design goals

  • Simple
  • Grokkable
  • Out of the box search engine and social media optimizations

Features

SEO Features

  • Comprehensive meta tags for search engines and social media platforms
  • Easily manage critical site-wide information in data/site.yml
  • Customizable page-level title, description, and image via Frontmatter
  • Sitemaps generated in both HTML and XML
  • Accurate social share URL template helpers
  • Customizable robots.txt generation via middleman-robots
  • Preferred URL (rel="canonical") for any page by setting the preferred_url key in the page's frontmatter
    • Example: preferred_url: http://medium.com/article-name will produce <link href="http://medium.com/article-name" rel="canonical">

Other Features

  • Optionally manage frontend dependencies via Bower
    1. Install package: bower install package-name -S
    2. The bower package is automatically imported into asset pipeline
    3. Include them directly in your javascript or Sass file

Dependencies

Usage

Clone this repo into your ~/.middleman directory as "seo"

git clone git@github.com:secretsaucehq/middleman-seo.git ~/.middleman/seo

Now you can simply init new projects with the "seo" template:

middleman init my-project --template=seo

This template uses Bower to manage JavaScript and CSS packages. Install these before Middleman can build your site:

bower install

Just don't forget to update ~/.middleman/seo every now and then.

TODO's

  • SEO optimize the Middleman blog extension.