Basic Setup for a new Grav site
The simplest way to install HPSTR theme for Grav is to download and install the HPSTR Skeleton package:
- Download HPSTR Skeleton
- Simply unzip the package into your web root folder.
- Point your browser at the folder, job done!
TIP: Check out the general Grav installation instructions for more details on this process.
Existing Grav site
It is possible to install just the theme, but page content will need to reference the HPSTR theme's supported templates. It is strongly advised to at least install the HPSTR Skeleton package to see the theme's capabilities in action.
To install just the theme:
$ bin/gpm install hpstr
Most of the configuration of the theme is done in the
title: Site Title description: Describe your website here. taxonomies: [tags] disqus_shortname: hpstrtheme owner: name: Joe Bloggs email: 'email@example.com' avatar: avatar.jpg bio: "Your bio goes here. It shouldn't be super long but a good two sentences or two should suffice." # Social networking links used in footer. Update and remove as you like. twitter: yourid facebook: github: stackexchange: linkedin: instagram: flickr: tumblr: # For Google Authorship https://plus.google.com/authorship # google plus id, include the '+', eg +mmistakes google_plus: +yourid metadata: description: 'Grav is an easy to use, yet powerful, open source flat-file CMS' navigation: - title: Theme Setup url: /theme-setup - title: External Link url: http://getgrav.org
Most of these options are self explanatory, but there are some important things to know.
Create a Disqus account and change
site.yaml to the Disqus shortname you just setup. By default comments appear on all post and pages if you assigned a shortname. By adding the shortname, you are effectively enabling comments on all blog posts.
To disable commenting on a post or page, add the following to its YAML Front Matter:
Social Share Links
If you provide social sharing account ids, you effectively enable sharing for that service.
To disable Facebook, Twitter, and Google+ share links on a post or page, add the following to its front matter:
Change your name, and avatar photo (200x200 pixels or larger), email, and social networking URLs. If you want to link to an external image on Gravatar or something similar you'll need to edit the path in
user/themes/hpstr/templates/partials/navigation.html.twig since it assumes it is located in
Including a link to your Google+ profile has the added benefit of displaying Google Authorship in Google search results if you've went ahead and applied for it.
Google Analytics and Webmaster Tools
To add additional links in the drop down menu edit the navigation section in the
site.yaml. Use the following format to set the URL and title for as many links as you'd like. External links will open in a new window.
navigation: - title: Theme Setup url: /theme-setup - title: External Link url: http://getgrav.org
This functionality is provided by the ReadingTime plugin. Reading time is enabled by default. You can configure the plugin via it's own options or just disable it if you don't wish to use it.
The related pages that show at the bottom of each blog post is powered by the RelatedPages plugin. This is a powerful Grav plugin that provides flexible and customizable related page calculations.
Syntax Highlighting of Code
Code blocks are automatically syntax-highlighted via the Grav Highlight plugin. It has it's own configuration that enable you to choose a theme, or even disable it on a page where you don't need it.
A good rule of thumb is to keep feature images nice and wide so you don't push the body text too far down. An image cropped around around 1024 x 256 pixels will keep file size down with an acceptable resolution for most devices.
The two layouts make the assumption that the feature images live in the images folder. To add a feature image to a post or page just include the filename in the front matter like so.
image: feature: feature-image-filename.jpg thumb: thumbnail-image.jpg #keep it square 200x200 px is good
If you want to apply attribution to a feature image use the following YAML front matter on posts or pages. Image credits appear directly below the feature image with a link back to the original source.
image: feature: feature-image-filename.jpg credit: Michael Rose #name of the person or site you want to credit creditlink: http://mademistakes.com #url to their site or licensing
Post/Page Thumbnails for OG and Twitter Cards
Post and page thumbnails work the same way. These are used by Open Graph and Twitter Cards meta tags found in
head.html. If you don't assign a thumbnail the image you assigned to
_config.yml will be used.
Here's an example of what a tweet to your site could look like if you activate Twitter Cards and include all the metas in your post's YAML.
TIP: For more information please check out the Meta Page Headers section of the documentation.
Video embeds are responsive and scale with the width of the main content block with the help of FitVids.
<iframe width="560" height="315" src="http://www.youtube.com/embed/PWf4WUoMXwg" frameborder="0"> </iframe>
Twitter cards make it possible to attach images and post summaries to Tweets that link to your content. Summary Card meta tags have been added to
head.html to support this, you just need to validate and apply your domain to turn it on.
Link Post Type
Link blog like a champ by adding
link: http://url-you-want-linked to a post's YAML front matter. Arrow glyph links to the post's permalink and the the
post-title links to the source URL. Here's an example of a link post if you need a visual.
To customize the CSS, you will need to use a SASS compiler as the CSS source is provided in
By editing values found in the theme's
_sass/variables.scss you can fine tune the site's colors and typography.
For example if you wanted a red background instead of white you'd change
$bodycolor: #fff; to
scripts.min.js. Install Node.js, then install Grunt, and then finally install the dependencies for the theme contained in
This theme is free and open source software, distributed under the MIT License version 2 or later. So feel free to to modify this theme to suit your needs.