Updated website

Signed-off-by: Vishal Rana <vr@labstack.com>

Author: vishr

.gitignore

@@ -1,5 +1,5 @@
 # Website
-site
+public
 .publish
 
 # Node.js

website/Dockerfile

@@ -0,0 +1,7 @@
+FROM busybox
+MAINTAINER Vishal Rana <vr@labstack.com>
+
+COPY server /server
+COPY public /public
+
+CMD ["/server"]

website/config.json

@@ -0,0 +1,25 @@
+{
+    "baseurl": "http://labstack.com/echo",
+    "languageCode": "en-us",
+    "title": "Echo",
+
+    "menu": {
+        "main": [{
+            "Name": "Guide",
+            "Pre": "<i class='fa fa-heart'></i>",
+            "Weight": -110,
+            "Identifier": "guide",
+            "URL": "guide"
+        }, {
+            "Name": "Recipes",
+            "Pre": "<i class='fa fa-road'></i>",
+            "Weight": -100,
+            "Identifier": "recipes",
+            "URL": "recipes"
+        }]
+    },
+
+    "params": {
+        "googleAnayticsId": "UA-51208124-3"
+    }
+}

website/content/guide/customization.md

@@ -0,0 +1,35 @@
+---
+title: Customization
+menu:
+  main:
+    parent: guide
+---
+
+### HTTP error handler
+
+`Echo.SetHTTPErrorHandler(h HTTPErrorHandler)`
+
+Registers a custom `Echo.HTTPErrorHandler`.
+
+Default handler rules
+
+- If error is of type `Echo.HTTPError` it sends HTTP response with status code `HTTPError.Code`
+and message `HTTPError.Message`.
+- Else it sends `500 - Internal Server Error`.
+- If debug mode is enabled, it uses `error.Error()` as status message.
+
+### Debug
+
+`Echo.SetDebug(on bool)`
+
+Enables/disables debug mode.
+
+### Disable colored log
+
+`Echo.DisableColoredLog()`
+
+### StripTrailingSlash
+
+StripTrailingSlash enables removing trailing slash from the request path.
+
+`e.StripTrailingSlash()`

website/content/guide/error-handling.md

@@ -0,0 +1,47 @@
+---
+title: Error Handling
+menu:
+  main:
+    parent: guide
+---
+
+Echo advocates centralized HTTP error handling by returning `error` from middleware
+and handlers.
+
+It allows you to
+
+- Debug by writing stack trace to the HTTP response.
+- Customize HTTP responses.
+- Recover from panics inside middleware or handlers.
+
+For example, when basic auth middleware finds invalid credentials it returns
+`401 - Unauthorized` error, aborting the current HTTP request.
+
+```go
+package main
+
+import (
+	"net/http"
+
+	"github.com/labstack/echo"
+)
+
+func main() {
+	e := echo.New()
+	e.Use(func(c *echo.Context) error {
+		// Extract the credentials from HTTP request header and perform a security
+		// check
+
+		// For invalid credentials
+		return echo.NewHTTPError(http.StatusUnauthorized)
+	})
+	e.Get("/welcome", welcome)
+	e.Run(":1323")
+}
+
+func welcome(c *echo.Context) error {
+	return c.String(http.StatusOK, "Welcome!")
+}
+```
+
+See how [HTTPErrorHandler](#customization) handles it.

website/content/guide/installation.md

@@ -0,0 +1,23 @@
+---
+title: Installation
+menu:
+  main:
+    parent: guide
+---
+
+Echo has been developed and tested using Go `1.4.x`
+
+Install the latest version of Echo via `go get`
+
+```sh
+$ go get github.com/labstack/echo
+```
+
+To upgrade
+
+```sh
+$ go get -u github.com/labstack/echo
+```
+
+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).

website/content/guide/middleware.md

@@ -0,0 +1,65 @@
+---
+title: Middleware
+menu:
+  main:
+    parent: guide
+---
+
+Middleware is a function which is chained in the HTTP request-response cycle. Middleware
+has access to the request and response objects which it utilizes to perform a specific
+action, for example, logging every request.
+
+### Logger
+
+Logs each HTTP request with method, path, status, response time and bytes served.
+
+*Example*
+
+```go
+e.Use(Logger())
+
+// Output: `2015/06/07 18:16:16 GET / 200 13.238µs 14`
+```
+
+### BasicAuth
+
+BasicAuth middleware provides an HTTP basic authentication.
+
+- For valid credentials it calls the next handler in the chain.
+- For invalid Authorization header it sends "404 - Bad Request" response.
+- For invalid credentials, it sends "401 - Unauthorized" response.
+
+*Example*
+
+```go
+e.Group("/admin")
+e.Use(mw.BasicAuth(func(usr, pwd string) bool {
+	if usr == "joe" && pwd == "secret" {
+		return true
+	}
+	return false
+}))
+```
+
+### Gzip
+
+Gzip middleware compresses HTTP response using gzip compression scheme.
+
+*Example*
+
+```go
+e.Use(mw.Gzip())
+```
+
+### Recover
+
+Recover middleware recovers from panics anywhere in the chain and handles the control
+to the centralized [HTTPErrorHandler](#error-handling).
+
+*Example*
+
+```go
+e.Use(mw.Recover())
+```
+
+[Examples](https://github.com/labstack/echo/tree/master/examples/middleware)

website/content/guide/request.md

@@ -0,0 +1,64 @@
+---
+title: Request
+menu:
+  main:
+    parent: guide
+---
+
+### Path parameter
+
+Path parameter can be retrieved either by name `Context.Param(name string) string`
+or by index `Context.P(i int) string`. Getting parameter by index gives a slightly
+better performance.
+
+*Example*
+
+```go
+e.Get("/users/:name", func(c *echo.Context) error {
+	// By name
+	name := c.Param("name")
+
+	// By index
+	name := c.P(0)
+
+	return c.String(http.StatusOK, name)
+})
+```
+
+```sh
+$ curl http://localhost:1323/users/joe
+```
+
+### Query parameter
+
+Query parameter can be retrieved by name using `Context.Query(name string)`.
+
+*Example*
+
+```go
+e.Get("/users", func(c *echo.Context) error {
+	name := c.Query("name")
+	return c.String(http.StatusOK, name)
+})
+```
+
+```sh
+$ curl -G -d "name=joe" http://localhost:1323/users
+```
+
+### Form parameter
+
+Form parameter can be retrieved by name using `Context.Form(name string)`.
+
+*Example*
+
+```go
+e.Post("/users", func(c *echo.Context) error {
+	name := c.Form("name")
+	return c.String(http.StatusOK, name)
+})
+```
+
+```sh
+$ curl -d "name=joe" http://localhost:1323/users
+```