diff --git a/README.md b/README.md index 9bd00a95..ec9dbb17 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,5 @@ # [Echo] (https://echo.labstack.com) [![GoDoc](http://img.shields.io/badge/go-documentation-blue.svg?style=flat-square)](http://godoc.org/github.com/labstack/echo) [![License](http://img.shields.io/badge/license-mit-blue.svg?style=flat-square)](https://raw.githubusercontent.com/labstack/echo/master/LICENSE) [![Build Status](http://img.shields.io/travis/labstack/echo.svg?style=flat-square)](https://travis-ci.org/labstack/echo) [![Coverage Status](http://img.shields.io/coveralls/labstack/echo.svg?style=flat-square)](https://coveralls.io/r/labstack/echo) [![Join the chat at https://gitter.im/labstack/echo](https://img.shields.io/badge/gitter-join%20chat-brightgreen.svg?style=flat-square)](https://gitter.im/labstack/echo) [![Twitter](https://img.shields.io/badge/twitter-@labstack-55acee.svg?style=flat-square)](https://twitter.com/labstack) -### Fast and unfancy HTTP server framework for Go (Golang). - ## Feature Overview - Optimized HTTP router which smartly prioritize routes @@ -16,6 +14,7 @@ - Define your format for the logger - Highly customizable - Automatic TLS via Let’s Encrypt +- HTTP/2 support - Built-in graceful shutdown ## Performance diff --git a/website/config.json b/website/config.json index 6eacf415..9aa7119e 100644 --- a/website/config.json +++ b/website/config.json @@ -1,7 +1,7 @@ { "baseurl": "https://echo.labstack.com", "languageCode": "en-us", - "title": "Echo - Fast and unfancy HTTP server framework for Go (Golang)", + "title": "Echo - Fast and Unfancy Go Web Framework", "canonifyurls": true, "googleAnalytics": "UA-85059636-2", "permalinks": { @@ -10,7 +10,6 @@ "recipes": "/recipes/:filename" }, "params": { - "image": "https://echo.labstack.com/images/logo.png", "description": "Echo is a high performance, extensible, minimalist web framework for Go (Golang)." } } diff --git a/website/content/guide.md b/website/content/guide.md index b60608b5..3900ebd0 100644 --- a/website/content/guide.md +++ b/website/content/guide.md @@ -200,9 +200,9 @@ Server any file from static directory for path `/static/*`. e.Static("/static", "static") ``` -##### [Learn More](https://echo.labstack.com/guide/static-files) +#### [Learn More](/guide/static-files) -### [Template Rendering](https://echo.labstack.com/guide/templates) +### [Template Rendering](/guide/templates) ### Middleware @@ -231,3 +231,5 @@ e.GET("/users", func(c echo.Context) error { return c.String(http.StatusOK, "/users") }, track) ``` + +#### [Learn More](/middleware) diff --git a/website/content/guide/installation.md b/website/content/guide/installation.md index 6257e9bf..3495ac16 100644 --- a/website/content/guide/installation.md +++ b/website/content/guide/installation.md @@ -7,15 +7,32 @@ description = "Installing Echo" weight = 1 +++ -Echo is developed and tested using Go `1.6.x` and `1.7.x` +## Prerequisites + +- [Install](https://golang.org/doc/install) Go +- [Set](https://golang.org/doc/code.html#GOPATH) GOPATH + +## Using [go get](https://golang.org/cmd/go/#hdr-Download_and_install_packages_and_dependencies) ```sh +$ cd $ go get -u github.com/labstack/echo ``` -> Ideally you should rely on a [package manager](https://github.com/avelino/awesome-go#package-management) like glide or govendor to use a specific [version](https://github.com/labstack/echo/releases) of Echo. +## Using [glide](http://glide.sh) -## [Migrating Guide](/guide/migration) +```sh +$ cd +$ glide get github.com/labstack/echo#~3.0 +``` -Echo follows [semantic versioning](http://semver.org) managed through GitHub releases. -Specific version of Echo can be installed using a [package manager](https://github.com/avelino/awesome-go#package-management). +## Using [govendor](https://github.com/kardianos/govendor) + +```sh +$ cd +$ govendor fetch github.com/labstack/echo@v3.0 +``` + +Echo is developed using Go `1.7.x` and tested with Go `1.6.x` and `1.7.x`. +Echo follows [semantic versioning](http://semver.org) managed through GitHub +releases, specific version of Echo can be installed using a [package manager](https://github.com/avelino/awesome-go#package-management). diff --git a/website/content/guide/testing.md b/website/content/guide/testing.md index f1981f10..0fdec54b 100644 --- a/website/content/guide/testing.md +++ b/website/content/guide/testing.md @@ -156,4 +156,4 @@ req, err := http.NewRequest(echo.POST, "/?"+q.Encode(), nil) *TBD* -You can looking to built-in middleware [test cases](https://github.com/labstack/echo/tree/master/middleware). +For now you can look into built-in middleware [test cases](https://github.com/labstack/echo/tree/master/middleware). diff --git a/website/content/middleware/redirect.md b/website/content/middleware/redirect.md index e9b3690e..c85b1d56 100644 --- a/website/content/middleware/redirect.md +++ b/website/content/middleware/redirect.md @@ -7,7 +7,7 @@ description = "Redirect middleware for Echo" weight = 5 +++ -## HTTPSRedirect Middleware +## HTTPSRedirect HTTPSRedirect middleware redirects http requests to https. For example, http://labstack.com will be redirected to https://labstack.com. @@ -19,7 +19,7 @@ e := echo.New() e.Pre(middleware.HTTPSRedirect()) ``` -## HTTPSWWWRedirect Middleware +## HTTPSWWWRedirect HTTPSWWWRedirect redirects http requests to www https. For example, http://labstack.com will be redirected to https://www.labstack.com. @@ -31,7 +31,7 @@ e := echo.New() e.Pre(middleware.HTTPSWWWRedirect()) ``` -## HTTPSNonWWWRedirect Middleware +## HTTPSNonWWWRedirect HTTPSNonWWWRedirect redirects http requests to https non www. For example, http://www.labstack.com will be redirect to https://labstack.com. @@ -43,7 +43,7 @@ e := echo.New() e.Pre(middleware.HTTPSNonWWWRedirect()) ``` -## WWWRedirect Middleware +## WWWRedirect WWWRedirect redirects non www requests to www. @@ -56,7 +56,7 @@ e := echo.New() e.Pre(middleware.WWWRedirect()) ``` -## NonWWWRedirect Middleware +## NonWWWRedirect NonWWWRedirect redirects www requests to non www. For example, http://www.labstack.com will be redirected to http://labstack.com. diff --git a/website/data/index.toml b/website/data/index.toml index f15bf631..0fd13881 100644 --- a/website/data/index.toml +++ b/website/data/index.toml @@ -1,27 +1,44 @@ -h1 = "Echo" -h2 = "High performance, extensible, minimalist web framework for Go" +heading = "Echo" +description = "High performance, extensible, minimalist Go web framework" [[features]] icon = "rocket" title = "Optimized Router" - text = "Highly optimized HTTP router which smartly prioritize routes" + text = """ + Highly optimized HTTP router with zero dynamic memory allocation which smartly + prioritize routes. + """ [[features]] icon = "cloud" - title = "RESTful API" - text = "Build robust and scalable RESTful API" + title = "Scalable" + text = "Build robust and scalable RESTful API, easily organized into groups." [[features]] icon = "license" title = "Automatic TLS" - text = "Automatically install TLS certificates from Let's Encrypt" + text = "Automatically install TLS certificates from Let's Encrypt." [[features]] icon = "funnel" - title = "Middleware Levels" - text = "Define middleware at root, group or route level" + title = "Middleware" + text = """ + Many built-in middleware to use, or define your own. Middleware can be set at root, + group or route level. + """ [[features]] - icon = "sync" + icon = "database_upload" title = "Data Binding" - text = "Data binding for JSON, XML and form payload" + text = "Data binding for HTTP request payload, including JSON, XML or form-data." +[[features]] + icon = "database_download" + title = "Data Rendering" + text = """ + API to send variety of HTTP response, including JSON, XML, HTML, File, Attachment, + Inline, Stream or Blob. + """ [[features]] icon = "code" title = "Templates" - text = "Template rendering with any template engine" + text = "Template rendering using any template engine." +[[features]] + icon = "equalizer" + title = "Extensible" + text = "Customized central HTTP error handling. Easily extendable API." diff --git a/website/layouts/index.html b/website/layouts/index.html index f9373ca0..d1868bd9 100644 --- a/website/layouts/index.html +++ b/website/layouts/index.html @@ -9,8 +9,8 @@
-

{{ .Site.Data.index.h1 }}

-

{{ .Site.Data.index.h2 }}

+

{{ .Site.Data.index.heading }}

+

{{ .Site.Data.index.description }}

Echo

diff --git a/website/layouts/partials/head.html b/website/layouts/partials/head.html index 981ee311..932cf6a5 100644 --- a/website/layouts/partials/head.html +++ b/website/layouts/partials/head.html @@ -3,18 +3,18 @@ - + - - + + - + - + {{ if ne .URL "/" }}{{ .Title }} | {{ end }}{{ .Site.Title }}