Blog / Personal Website

This is a copy of the Personal Site Template. This is a template for your own personal site including a portfolio, blog, and résumé. It is based on the fantastic middleman-zurb-template project.

Installation

• Clone the repo
• Install Bundler
• Install project dependencies

Set-up

Configuration

Most of the site can be configured via altering values in the config.rb file.

Résumé

Drop a PDF of your résumé in the source directory. Now set resume to the name of the file. A link will appear in the top navigation bar.

Social Networking Links

Under the "Social Network link settings" section of config.rb, reset the values to point at your social networking accounts, or set them to nil to leave them out of the navigation.

Projects

You can highlight your projects with the portfolio section of the site. Use the data/projects.yaml file as a template for listing a description of each of your projects. They will automatically

Taking Screenshots

You can use the screenshotter gem to take screenshots of your projects. If you prefer to do it manually, then use Safari to view a live version of your project. Press command-shift-4-space, then click on the Safari window to save a screenshot to the Desktop. Now open the screenshot in Preview, and resize the image to 50% of its original size. Now drop the image file into source/images.

Disqus integration (for blog)

Create a Disqus account for your blog, and set the disqus_shortname variable in config.rb to the shortname for your blog.

Google Analytics integration

Create a Google Analytics account, and set the google_analytics_tracking_id appropriately.

Theming

Choose a theme from the wiki, then uncomment the line with that theme's name in source/stylesheets/theme.css.scss. If you would like to create your own theme, you can use source/stylesheets/themes/template.css.scss as a guide. Create a new file in source/stylesheets/themes with the name of your theme, then add a line to source/stylesheets/theme.css.scss to incorporate it. Be sure to send a pull request if it's awesome!

Blogging

Refer to the middleman-blog docs for information on using the blog.

Removing blog functionality

This template is still a good starting point for sites that don't require blogging functions. To remove blog-specific stuff:

1. git rm source/blog/*
2. git rm source/layouts/article.erb
3. Remove middleman-blog from Gemfile.
4. Remove blog-related styles from source/stylesheets/base.css.scss. They are all at the bottom of the file grouped together under the header "Blog Articles".
5. Remove blog-related settings from config.rb. They are all grouped at the top under the header "Blog Settings".
6. Remove the link to the blog in the markup for the navbar (in layouts/layout.erb).
7. Remove the section.latest-from-blog element from the markup in index.html.erb, and remove the following code from landing-page.css.scss:

section.latest-from-blog, section.featured-project {
  @include grid-column(6);
}

Deploying

To deploy, just run the following again:

bundle exec middleman build
bundle exec middleman deploy

Keeping things up to date

If you want to keep up to date with the latest changes to the base template, start by making sure your repo's stage is clean, then run the following:

git pull upstream master

Using a custom domain name

Create a file source/CNAME containing your domain name:

thatwebmuck.com

Commit this file to your source branch, then build and deploy the site. Now follow GitHub's instructions for adding a custom domain to your Pages site.