.github | ||
cmd/liquid | ||
evaluator | ||
expression | ||
filters | ||
parser | ||
render | ||
scripts | ||
tags | ||
.gitignore | ||
.travis.yml | ||
CONTRIBUTING.md | ||
drops.go | ||
engine_test.go | ||
engine.go | ||
LICENSE | ||
liquid_test.go | ||
liquid.go | ||
Makefile | ||
README.md | ||
template_test.go | ||
template.go | ||
test.html |
Go Liquid Template Parser
“Any sufficiently complicated C or Fortran program contains an ad-hoc, informally-specified, bug-ridden, slow implementation of half of Common Lisp.” – Philip Greenspun
liquid
ports Shopify Liquid templates to Go. It was developed for use in gojekyll.
liquid
provides a functional API for defining tags and filters. See examples here, here, and here.
Status
This library is at an early stage of development. There's probably lots of corner cases, and the API for defining tags may still change.
Differences from Liquid
Refer to the feature parity board for a list of known differences from Liquid.
Other differences, that might not change:
- This implementation is probably more liberal in where it accepts parentheses.
- Two hashes with the same keys and values, or two drops that return deeply equal hashes, are equal for purposes of
uniq
. I don't know if it's practical to fix this.
Install
go get -u github.com/osteele/goliquid
make install
install a command-line liquid
program in your GO bin.
This is intended to make it easier to create test cases for bug reports.
Run liquid --help
for help.
Contributing
Bug reports, test cases, and code contributions are more than welcome. Please refer to the contribution guidelines.
References
- Shopify.github.io/liquid
- Liquid for Designers
- Liquid for Programmers
- Help.shopify.com goes into more detail, but includes features that aren't present in core Liquid as used by Jekyll.
Attribution
Package | Author | Description | License |
---|---|---|---|
gopkg.in/yaml.v2 | Canonical | YAML support (for printing parse trees) | Apache License 2.0 |
jeffjen/datefmt | Jeffrey Jen | Go bindings to GNU strftime and strptime |
MIT |
Ragel | Adrian Thurston | scanning expressions | MIT |
Michael Hamrah's Lexing with Ragel and Parsing with Yacc using Go was essential to understanding go yacc
.
The original Liquid engine, of course, for the design and documentation of the Liquid template language. Many of the tag and filter test cases are taken directly from the Liquid documentation.
Other Implementations
Go
- karlseguin/liquid is a dormant implementation that inspired a lot of forks.
- acstech/liquid is a more active fork of Karl Seguin's implementation.
- hownowstephen/go-liquid
Other Languages
See Shopify's ports of Liquid to other environments.
License
MIT License