Neo-HPSTR Metalsmith Theme

Neo-HPSTR Metalsmith is a responsive and modern blog template based on Neo-HPSTR Jekyll

Demo

Contents

• Installation
• Features
• Configuration
• License

Installation

Boilerplate / Fork

1. Fork the repo
2. Clone the fork locally (git clone [email protected]:username/reponame.git)
3. Delete the stock posts and images
4. Install NPM modules (npm install)
5. Build into /public (node .)
6. Make it your own!

NOTE: If you're going to serve this using GitHub Pages, be sure to enable GitHub Pages in your settings and select your desired source.

Features

• Modern design.
• Responsive templates (post, page and home) in /layouts. Looks great on mobile, tablet and desktop devices.
• Gracefully degrades in older browsers. Compatible with Internet Explorer 8+ and all modern browsers.
• Sweet topbar animated menu with support for drop-downs.
• Optional Disqus command and social sharing links.
• Open Graph and Twitter Cards support for a better social sharing experience.
• Simple custom 404 page to get you started.
• Syntax highlighting to make your code examples look snazzy.
• Author panel with social links.

Configuration

Here are some tips on how to customize your blog theme. If you have questions, just open a new issue. :)

Project tree

├── assets/
│   ├── fonts/                  # fonts (i.e. FontAwesome)
│   ├── images/                 # images (i.e. logo, favicon, etc)
│   ├── javascripts/            # third-party and page specific js
│   ├── stylesheets/            # css (compiled from /sass)
├── content/
│   ├── _posts/                 # blog posts
│   ├── about/index.md          # about page
│   ├── posts/index.html.hbs    # archives page
│   ├── search/index.html.hbs   # search page
│   ├── 404.html.hbs            # 404 page
│   ├── index.html.hbs          # home page
├── helpers/                    # handlebars helpers
├── layouts/                    # blog layouts
│   ├── home.html
│   ├── page.html
│   └── post.html
├── partials/
│   ├── author.hbs              # author banner (at the end of post)
│   ├── disqus-comments.hbs     # comments
│   ├── footer.hbs              # page footer
│   ├── head.hbs                # site head, with css includes and metadata
│   ├── header.hbs              # header menu
│   ├── icons.hbs               # site icons
│   ├── pagination.hbs          # pagination
│   ├── read-more.hbs           # read-more banner, to recommend posts
│   ├── scripts.hbs             # js scripts
│   └── social-share.hbs        # floating social share integration
├── sass/                       # blog style
├── Guplfile.js                 # some gupl tasks, useful for theme developing
├── index.js                    # main config and process file
├── LICENSE
├── package.json
├── README.md

License

The theme is available as open source under the terms of the MIT License.