Add notes for the new lead maintainer of the open-source iris project and align with @get-ion/ion by @hiveminded

Former-commit-id: da4f38eb9034daa49446df3ee529423b98f9b331

_examples/miscellaneous/i18n/locales/locale_el-GR.ini

@@ -0,0 +1 @@
+hi = γεια, %s

_examples/miscellaneous/i18n/locales/locale_en-US.ini

@@ -0,0 +1 @@
+hi = hello, %s

_examples/miscellaneous/i18n/locales/locale_zh-CN.ini

@@ -0,0 +1 @@
+hi = 您好，%s

_examples/miscellaneous/i18n/main.go

@@ -0,0 +1,55 @@
+package main
+
+import (
+	"github.com/kataras/iris"
+	"github.com/kataras/iris/context"
+	"github.com/kataras/iris/middleware/i18n"
+)
+
+func newApp() *iris.Application {
+	app := iris.New()
+
+	app.Use(i18n.New(i18n.Config{
+		Default:      "en-US",
+		URLParameter: "lang",
+		Languages: map[string]string{
+			"en-US": "./locales/locale_en-US.ini",
+			"el-GR": "./locales/locale_el-GR.ini",
+			"zh-CN": "./locales/locale_zh-CN.ini"}}))
+
+	app.Get("/", func(ctx context.Context) {
+
+		// it tries to find the language by:
+		// ctx.Values().GetString("language")
+		// if that was empty then
+		// it tries to find from the URLParameter setted on the configuration
+		// if not found then
+		// it tries to find the language by the "language" cookie
+		// if didn't found then it it set to the Default setted on the configuration
+
+		// hi is the key, 'iris' is the %s on the .ini file
+		// the second parameter is optional
+
+		// hi := ctx.Translate("hi", "iris")
+		// or:
+		hi := i18n.Translate(ctx, "hi", "iris")
+
+		language := ctx.Values().GetString(ctx.Application().ConfigurationReadOnly().GetTranslateLanguageContextKey())
+		// return is form of 'en-US'
+
+		// The first succeed language found saved at the cookie with name ("language"),
+		//  you can change that by changing the value of the:  iris.TranslateLanguageContextKey
+		ctx.Writef("From the language %s translated output: %s", language, hi)
+	})
+
+	return app
+}
+
+func main() {
+	app := newApp()
+
+	// go to http://localhost:8080/?lang=el-GR
+	// or http://localhost:8080
+	// or http://localhost:8080/?lang=zh-CN
+	app.Run(iris.Addr(":8080"))
+}

_examples/miscellaneous/i18n/main_test.go

@@ -0,0 +1,29 @@
+package main
+
+import (
+	"fmt"
+	"testing"
+
+	"github.com/kataras/iris/httptest"
+)
+
+func TestI18n(t *testing.T) {
+	app := newApp()
+
+	expectedf := "From the language %s translated output: %s"
+	var (
+		elgr = fmt.Sprintf(expectedf, "el-GR", "γεια, iris")
+		enus = fmt.Sprintf(expectedf, "en-US", "hello, iris")
+		zhcn = fmt.Sprintf(expectedf, "zh-CN", "您好，iris")
+	)
+
+	e := httptest.New(t, app)
+	// default is en-US
+	e.GET("/").Expect().Status(httptest.StatusOK).Body().Equal(enus)
+	// default is en-US if lang query unable to be found
+	e.GET("/").WithQueryString("lang=un-EX").Expect().Status(httptest.StatusOK).Body().Equal(enus)
+
+	e.GET("/").WithQueryString("lang=el-GR").Expect().Status(httptest.StatusOK).Body().Equal(elgr)
+	e.GET("/").WithQueryString("lang=en-US").Expect().Status(httptest.StatusOK).Body().Equal(enus)
+	e.GET("/").WithQueryString("lang=zh-CN").Expect().Status(httptest.StatusOK).Body().Equal(zhcn)
+}