| cmd/gojekyll | ||
| example | ||
| helpers | ||
| liquid | ||
| scripts | ||
| .gitignore | ||
| .gometalinter.json | ||
| .travis.yml | ||
| build.go | ||
| collection.go | ||
| dynamic_page.go | ||
| layout.go | ||
| LICENSE | ||
| Makefile | ||
| markdown.go | ||
| page.go | ||
| permalinks_test.go | ||
| permalinks.go | ||
| README.md | ||
| sass.go | ||
| server.go | ||
| site_config.go | ||
| site_test.go | ||
| site_variables.go | ||
| site.go | ||
| variable_map_test.go | ||
| variable_map.go | ||
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.
- Content
- Front Matter
- Posts
- Categories
- Tags
- Drafts
- Future
- Related
- Static Files
- Variables
- Collections
- Data Files
- CSV
- JSON
- YAML
- Assets
- Coffeescript
- Sass/SCSS
- Sass caching
- Customization
- Templates
- link tag
- include tag
- Remaining Jekyll Liquid tags
- Jekyll Liquid filters
- Includes
- Permalinks
- Pagination
- Themes
- Layouts
- Templates
- Server
- Directory watch
- Live reload
- Windows -- not tested
Install
go get -u 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 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
gojekyllwith the--use-liquid-serveroption; 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.
Develop
Install package dependencies and development tools:
make setup
Test:
make test
make lint
gojekyll render index.md # render a file to stdout
gojekyll render / # render a URL to stdout
gojekyll variables / # print a file or URL's variables
./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: ACS Technologies's fork acstech/liquid of Karl Seguin's karlseguin/liquid Go implementation; or, Jun Yang's JavaScript implementation harttle/shopify-liquid via JSON-RPC.
Jascha Ephraim's jaschaephraim/lrserver Live Reload server.
https://github.com/pkg/browser to open the URL in a browser.
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.
Related
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"