Skip to content

jakelear/pjaxyll

Repository files navigation

Pjaxyll

Runs on Jekyll

Sped up by pjax

Deployed with rake/rsync

I accidentally torpedo'd the demo some time ago. Sorry :(

How it works:

Jekyll is a small static site generator written in ruby.

A rakefile to build and deploy the site. Rake also takes care of the following:

  • Duplicate each post and replace the layout with a pjax specific layout.
  • Add the post date of the YAML front matter of the PJAX version to retain the post date
  • Compile the jekyll site

Installation and Use:

Getting the demo up and running:

To install, clone/fork this repo into an apache-served directory. If you don't already have a directory set up to be served via apache, I recommend something like MAMP to get you up and running quickly. Check out this blog post by Trevor Davis if you need to get .htaccess working in mamp.

MAMP runs by default on localhost:8888, and make sure to point it to the _site directory that is generated by Jekyll.

NOTE: Currently Pjaxyll is configured to work using .htaccess, meaning Apache is a requirement. The concept will work with any server that supports rewrite rules but you'll need to write your own.

Run

bundle install

to install jekyll, rake, sass, and compass.

Run

`rake build`

to generate the first site and you'll be able to visit your fast new demo blog.

Customizing the config to fit your needs:

_config.yml is the Jekyll config. You should update the site name and url here. Also make note of the permalink format. Currently, the htaccess RewriteRules are set up specifically for this format. If you need to change this format, you'll need to alter the RewriteRules in .htaccess to account for any changes.

In Rakefile, there is a task called "deploy" that uses rsync to copy the _site directory up. You can modify this with your ssh username and domain if you wish to use the rake deploy:live task to publish your site.

Building the Site

You can use the demo posts in _posts as an example to write posts. Be sure to use the same format for the post filename. After writing a post, or making other changes to the site (css, javascript, etc), Run

rake build

which generates the site, and creates the pjax versions using the pjax layout.

More info:

I accidentally torpedo'd the demo some time ago. Sorry :( Feel free to get at me on twitter @jakelear if you need anything.

License:

License

About

Pjax and Jekyll working together for fast static blogs

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published