Pixyll is a simple, beautiful theme for Jekyll that emphasizes content rather than aesthetic fluff. It's mobile first, fluidly responsive, and delightfully lightweight.
It's pretty minimal, but leverages large type and drastic contrast to make a statement, on all devices.
This Jekyll theme was crafted with <3 by John Otander (@4lpine).
中文版 https://github.com/ee0703/pixyll-zh-cn.
If you're completely new to Jekyll, I recommend checking out the documentation at http://jekyllrb.com or there's a tutorial by Smashing Magazine.
If you don't have Jekyll already installed, you will need to go ahead and do that.
$ gem install jekyll
It's important to also check your version of Jekyll since this project uses Native Sass which is only supported by 2.0+.
$ jekyll -v
# This should be jekyll 2.0.0 or later
$ git clone git@github.com:johnotander/pixyll.git
$ cd pixyll
$ bundle install
Fork the repo, and then clone it so you've got the code locally.
The _config.yml
located in the root of the Pixyll directory contains all of the configuration details
for the Jekyll site. The defaults are:
# Site settings
title: Pixyll
email: your_email@example.com
author: John Otander
description: "A simple, beautiful theme for Jekyll that emphasizes content rather than aesthetic fluff."
baseurl: ""
url: "http://pixyll.com"
# Build settings
markdown: kramdown
permalink: pretty
paginate: 3
Then, start the Jekyll Server. I always like to give the --watch
option so it updates the generated HTML when I make changes.
$ jekyll serve --watch
Now you can navigate to localhost:4000
in your browser to see the site.
You can host your Jekyll site for free with Github Pages. Click here for more information.
In addition to your github-username.github.io repo that maps to the root url, you can serve up sites by using a gh-pages branch for other repos so they're available at github-username.github.io/repo-name.
This will require you to modify the _config.yml
like so:
# Site settings
title: Repo Name
email: your_email@example.com
author: John Otander
description: "Repo description"
baseurl: "/repo-name"
url: "http://github-username.github.io"
# Build settings
markdown: kramdown
permalink: pretty
paginate: 3
This will ensure that the the correct relative path is constructed for your assets and posts. Also, in order to run the project locally, you will need to specify the blank string for the baseurl: $ jekyll serve --baseurl ''
.
You will also need to tweak the header include /{{ site.baseurl }}
:
<header class="site-header px2 px-responsive">
<div class="mt2 wrap">
<div class="measure">
<a href="{{ site.url }}/{{ site.baseurl }}">{{ site.title }}</a>
<nav class="site-nav right">
{% include navigation.html %}
</nav>
</div>
</div>
</header>
A relevant Jekyll Github Issue: jekyll/jekyll#332
The contact form uses http://formspree.io. It will require you to fill the form out and submit it once, before going live, to confirm your email.
More setup instructions and advanced options can be found at http://formspree.io
To configure Disqus, set up a Disqus site with the same name as your site. Then, in _config.yml
, edit the disqus_shortname
value to enable Disqus.
All variables can be found in the _sass/_variables.scss
file, toggle these as you'd like to change the look and feel of Pixyll.
If you would like to add a fade-in-down effect, you can add animated: true
to your _config.yml
.
If you want to give credit to the Pixyll theme with a link to http://pixyll.com or my personal website http://johnotander.com somewhere, that'd be awesome. No worries if you don't.
I hope you enjoy using Pixyll. If you encounter any issues, please feel free to let me know by creating an issue. I'd love to help.
Pixyll is always being improved by its users, so sometimes one may need to upgrade.
If git remote -v
doesn't have an upstream listed, you can do the following to add it:
git remote add upstream https://github.com/johnotander/pixyll.git
git pull upstream master
There may be merge conflicts, so be sure to fix the files that git lists if they occur. That's it!
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request