Personally Developed
A simple, one column theme for Jekyll that puts your content first. Also available as a stand-alone Jekyll scaffold to use with GitHub Pages.
View a live demo!
Installation
Add this line to your Jekyll site's Gemfile
:
gem "personally-developed"
And add this line to your Jekyll site's _config.yml
:
theme: personally-developed
And then execute:
$ bundle
Or install it yourself as:
$ gem install personally-developed
Usage
Pagination (REQUIRED)
You'll need to include the jekyll-paginate gem for Personally Developed to work correctly.
Add the following to your site's Gemfile
:
gem 'jekyll-paginate'
Add the following to your site's _config.yml
:
gems:
- jekyll-paginate
And then execute:
$ bundle
Or install it yourself as:
$ gem install jekyll-paginate
--
SEO (via jekyll-seo-tag)
Personally Developed supports the jekyll-seo-tag plugin right out of the box. To use it:
Add the following to your site's Gemfile
:
gem 'jekyll-seo-tag'
Add the following to your site's _config.yml
:
gems:
- jekyll-seo-tag
And then execute:
$ bundle
Or install it yourself as:
$ gem install jekyll-seo-tag
--
Customization
To override the default styles of Personally Developed, simply create the appropriate directory at the root of your site, copy the file you wish to customize to that directory, and then edit the file.
e.g., to override the _includes/head.html
file to specify a custom style path, create an _includes
directory, copy _includes/head.html
from gem folder to <yoursite>/_includes
and start editing that file. To find the gem folder, run bundle show personally-developed
.
The site's default CSS exists at assets/main.scss
. To override the default CSS, the file has to exist at your site source. Do any one of the following:
- Create a new instance of
main.scss
at site source.- Create a new file
main.scss
at<your-site>/assets/
- Add the frontmatter dashes, and
- Add
@import "personally-developed";
, to<your-site>/assets/main.scss
- Add your custom CSS.
- Create a new file
- Download the file from this repo
- Create a new file
main.scss
at<your-site>/assets/
- Copy the contents at assets/main.scss onto the
main.scss
you just created, and edit away!
- Create a new file
- Copy directly from the gem
- Go to your local personally-developed gem installation directory ( run
bundle show personally-developed
to get the path to it ). - Copy the
assets/
folder from there into the root of<your-site>
- Change whatever values you want, inside
<your-site>/assets/main.scss
- Go to your local personally-developed gem installation directory ( run
License
The theme is available as open source under the terms of the MIT License.