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: 3 months ago
JSON representation

HTML template engine for Go

Lists

README 

        
# Ace - HTML template engine for Go



[![wercker status](https://app.wercker.com/status/8d3c657bcae7f31d10c8f88bbfa966d8/m "wercker status")](https://app.wercker.com/project/bykey/8d3c657bcae7f31d10c8f88bbfa966d8)

[![GoDoc](http://godoc.org/github.com/yosssi/ace?status.svg)](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!