Go Jekyll

When I grow up, I want to be a Go implementation of Jekyll.

Status

This project is missing more functionality than it implements. It may accidentally work on tiny or simple sites.

It's currently ~50x faster than Jekyll using an embedded Liquid engine (that isn't very completely); and about 5x faster using an un-optimized connection to the harttle/shopify-liquid JavaScript library (documentation TBD) to render Liquid templates.

Content
- Front Matter
- Posts
  - Categories
  - Tags
  - Drafts
  - Future
  - Related
- Static Files
- Variables
- Collections -- rendered, but not available as variables
- Data Files
- Assets
  - Coffeescript
  - Sass/SCSS
    - Sass caching
Customization
- Templates
  - link tag
  - include tag
  - Remaining Jekyll Liquid tags
  - Jekyll Liquid filters
- Includes
- Permalinks
- Pagination
- Themes
- Layouts
Server
- Directory watch
- Live reload
Windows -- not tested

Install

go install osteele/gojekyll/cmd/gojekyll

Sometimes this package benefits from my unmerged improvements to the acstech/liquid library. If you want to use my fork instead:

cd $(go env GOPATH)/src/github.com/acstech/liquid
git remote add osteele https://github.com/osteele/liquid.git
git pull -f osteele

(See articles by Shlomi Noach and Francesc Campoy for how this works and why it is necessary.)

Usage

gojekyll build                # builds into ./_site
gojekyll serve                # serves from memory, w/ live reload
gojekyll render index.md      # render a file to stdout
gojekyll render /             # render a URL to stdout
gojekyll data /               # print a file or URL's variables
gojekyll   # use a local Liquid engine server
gojekyll help

Liquid Template Server

The embedded Liquid server isn't very compliant with Shopfiy Liquid syntax.

You can run a "Liquid Template Server" on the same machine, and tell gojekyll to use this instead. This is currently about 10x slower than using the embedded engine, but still 5x faster than Ruby jekyll.

Download and run (liquid-template-server)[https://github.com/osteele/liquid-template-server].
Invoke gojekyll with the --use-liquid-server option; e.g.:

gojekyll --use-liquid-server build
gojekyll --use-liquid-server serve

Neither the embedded Liquid server nor the Liquid Template Server implements very many Jekyll Liquid filters or tags. I'm adding to these as necessary to support my own sites.

Development

./scripts/gojekyll is an alternative to the gojekyll executable, that uses go run each time it's invoked.

Profiling:

gojekyll --remote-liquid profile
go tool pprof gojekyll gojekyll.prof

Credits

For rendering Liquid templates: the acstech/liquid fork of karlseguin/liquid; or, harttle/shopify-liquid via JSON-RPC.

The gopher image in the test directory is from Wikimedia Commons. It is used under the Creative Commons Attribution-Share Alike 3.0 Unported license.

Hugo isn't Jekyll-compatible (-), but actually works (+++).

Jekyll, of course.

This project is a clean-room implementation of Jekyll, based solely on Jekyll's documentation and testing a few sites.

License

MIT

Alternate Naming Possibilities

"Gekyll". (Hard or soft "g"? See gif.)
"Gekko"

4.3 KiB Raw Blame History