You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
- Update to Jekyll v3.0- Switch from Pygments.rb to Rouge for syntax highlighting- Include jekyll-gist gem- Update theme documentation-Closemmistakes#123
They say three times the charm, so here is another free responsive Jekyll blog theme for you. I've learned a ton since open sourcing my first two themes[on Github](http://github.com/mmistakes), and wanted to try a few new things this time around.
13
13
14
14
If you've used any of[my other themes](http://mademistakes.com/work/jekyll-themes/) most of this should be familiar territory...
15
15
16
-
##WhatHPSTRbrings to the table:
16
+
##HPSTRFeatures:
17
17
18
+
* Compatible with Jekyll 3 and GitHub Pages.
18
19
* Responsive templates for post, page, and post index`_layouts`. Looks great on mobile, tablet, and desktop devices.
19
-
* Gracefully degrads in older browsers. Compatible with Internet Explorer 8+ and all modern browsers.
20
-
* Modern and minimal design.
20
+
* Gracefully degrades in older browsers. Compatible with Internet Explorer 8+ and all modern browsers.
21
21
* Sweet animated menu.
22
22
* Background image support.
23
-
* Readable typography to make your words shine.
24
23
* Support for large images to call out your favorite posts.
25
-
* Built-in support for Sass courtesy of Jekyll 2.x.
26
24
* Optional[Disqus](http://disqus.com) comments.
27
25
* Simple and clear permalink structure[^1].
28
26
*[Open Graph](https://developers.facebook.com/docs/opengraph/) and[Twitter Cards](https://dev.twitter.com/docs/cards) support for a better social sharing experience.
29
-
*Simple[custom 404 page]({{ site.url }}/404.html) to get you started.
30
-
*Stylesheets for Pygments and Coderay[syntax highlighting]({{ site.url }}/code-highlighting-post/) to make your code examples look snazzy.
27
+
*[Custom 404 page]({{ site.url }}/404.html) to get you started.
28
+
*[Syntax highlighting]({{ site.url }}/code-highlighting-post/) stylesheets to make your code examples look snazzy.
Copy file name to clipboardExpand all lines: theme-setup/index.md
+4-44Lines changed: 4 additions & 44 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,6 +11,8 @@ share: true
11
11
12
12
General notes and suggestions for customizing**HPSTR**.
13
13
14
+
HPSTR now requires[Jekyll](http://jekyllrb.com/) 3.0. Make sure to run`bundle update` if you aren't on the latest version to update all gem dependencies.
15
+
14
16
##Basic Setup for a new Jekyll site
15
17
16
18
1.[Install Bundler](http://bundler.io)`gem install bundler` and then install[Jekyll](http://jekyllrb.com) and all dependencies`bundle install`.
@@ -31,55 +33,13 @@ General notes and suggestions for customizing **HPSTR**.
31
33
32
34
1. Clone the following folders:`_includes`,`_layouts`,`_sass`,`assets`, and`images`.
33
35
2. Clone the following folders/files and personalize content as need:`about/`,`posts/`,`tags/`,`feed.xml` and`index.html`.
34
-
3. Set the following variables in your`config.yml` file:
35
-
36
-
{% highlight yaml %}
37
-
title: Site Title
38
-
description: Describe your website here.
39
-
disqus_shortname: shortname
40
-
#Your site's domain goes here (eg: //mmistakes.github.io,http://mademistakes.com, etc)
41
-
#When testing locally leave blank or usehttp://localhost:4000
42
-
url: //mmistakes.github.io
43
-
44
-
#Owner/author information
45
-
owner:
46
-
name: Your Name
47
-
avatar: avatar.jpg
48
-
bio: "Your bio goes here. It shouldn't be super long but a good two sentences or two should suffice."
49
-
email:you@email.com
50
-
#Social networking links used in footer. Update and remove as you like.
51
-
twitter:
52
-
facebook:
53
-
github:
54
-
stackexchange:
55
-
linkedin:
56
-
instagram:
57
-
flickr:
58
-
tumblr:
59
-
#google plus id, include the '+', eg +mmistakes
60
-
google_plus: +yourid
61
-
62
-
#Analytics and webmaster tools stuff goes here
63
-
google_analytics:
64
-
google_verify:
65
-
#https://ssl.bing.com/webmaster/configure/verify/ownership Option 2 content= goes here
If`jekyll build` and`jekyll serve` throw errors you may havetorun Jekyll with`bundle exec` instead.
42
+
The preferred method for running Jekyll is with`bundle exec`, but if you're willing to deal gem conflicts feel freetogo cowboy witha`jekyll build` or`jekyll serve`.
83
43
84
44
>In some cases, running executables without bundle exec may work, if the executable happens to be installed in your system and does not pull in any gems that conflict with your bundle.