Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yosssi/ace
HTML template engine for Go
https://github.com/yosssi/ace
Last synced: about 1 month ago
JSON representation
HTML template engine for Go
- Host: GitHub
- URL: https://github.com/yosssi/ace
- Owner: yosssi
- License: mit
- Created: 2014-07-13T13:39:19.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2018-06-17T06:37:00.000Z (over 6 years ago)
- Last Synced: 2024-08-03T17:16:47.599Z (4 months ago)
- Language: Go
- Homepage:
- Size: 133 KB
- Stars: 832
- Watchers: 22
- Forks: 89
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- go-awesome - Ace
- awesome-go - ace - HTML template engine for Go - ★ 730 (Template Engines)
README
# Ace - HTML template engine for Go
[](https://app.wercker.com/project/bykey/8d3c657bcae7f31d10c8f88bbfa966d8)
[](http://godoc.org/github.com/yosssi/ace)
## Overview
Ace is an HTML template engine for Go. This is inspired by [Slim](http://slim-lang.com/) and [Jade](http://jade-lang.com/). This is a refinement of [Gold](http://gold.yoss.si/).
## Example
```ace
= doctype html
html lang=en
head
title Hello Ace
= css
h1 { color: blue; }
body
h1 {{.Msg}}
#container.wrapper
p..
Ace is an HTML template engine for Go.
This engine simplifies HTML coding in Go web application development.
= javascript
console.log('Welcome to Ace');
```
becomes
```html
Hello Ace
h1 { color: blue; }
Hello Ace
Ace is an HTML template engine for Go.
This engine simplifies HTML coding in Go web application development.
console.log('Welcome to Ace');
```
## Features
### Making Use of the Go Standard Template Package
**Ace fully utilizes the strength of the [html/template](http://golang.org/pkg/html/template/) package.** You can embed [actions](http://golang.org/pkg/text/template/#hdr-Actions) of the template package in Ace templates. Ace also uses [nested template definitions](http://golang.org/pkg/text/template/#hdr-Nested_template_definitions) of the template package and Ace templates can pass [pipelines](http://golang.org/pkg/text/template/#hdr-Pipelines) (parameters) to other templates which they include.
### Simple Syntax
Ace has a simple syntax and **this makes template files simple and light**.
### Caching Function
Ace has a caching function which caches the result data of the templates parsing process. **You can omit the templates parsing process and save template parsing time** by using this function.
### Binary Template Load Function
Ace has a binary template load function which loads Ace templates from binary data in memory instead of template files on disk. **You can compile your web application into one binary file** by using this function. [go-bindata](https://github.com/jteeuwen/go-bindata) is the best for generating binary data from template files.
## Getting Started
Please check the following documentation.
* [Getting Started](documentation/getting-started.md) - shows the getting started guide.
* [Examples](examples) - shows the examples of the web applications which use the Ace template engine.
## Documentation
You can get the documentation about Ace via the following channels:
* [Documentation](documentation) - includes the getting started guide and the syntax documentation.
* [GoDoc](https://godoc.org/github.com/yosssi/ace) - includes the API documentation.
## Discussion & Contact
You can discuss Ace and contact the Ace development team via the following channels:
* [GitHub Issues](https://github.com/yosssi/ace/issues)
* [Gitter (Chat)](https://gitter.im/yosssi/ace)
## Contributions
**Any contributions are welcome.** Please feel free to [create an issue](https://github.com/yosssi/ace/issues/new) or [send a pull request](https://github.com/yosssi/ace/compare/).
## Renderers for web frameworks
* [Martini Acerender](https://github.com/yosssi/martini-acerender) - For [Martini](http://martini.codegangsta.io/)
## Tools
* [vim-ace](https://github.com/yosssi/vim-ace) - Vim syntax highlighting for Ace templates
* [ace-tmbundle](https://github.com/yosssi/ace-tmbundle) - TextMate/Sublime syntax highlighting for Ace templates
* [atom-ace](https://github.com/pariz/atom-ace) - Atom Editor syntax highlighting for Ace templates
## Projects using Ace
[Here](documentation/projects-using-ace.md) is the list of the projects using Ace. Please feel free to add your awesome project to the list!