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/view/template_html_4/main.go

@@ -0,0 +1,71 @@
+// Package main an example on how to naming your routes & use the custom 'url' HTML Template Engine, same for other template engines.
+package main
+
+import (
+	"github.com/kataras/iris"
+	"github.com/kataras/iris/context"
+	"github.com/kataras/iris/core/router"
+)
+
+const (
+	host = "127.0.0.1:8080"
+)
+
+func main() {
+	app := iris.New()
+
+	// create a custom path reverser, iris let you define your own host and scheme
+	// which is useful when you have nginx or caddy in front of iris.
+	rv := router.NewRoutePathReverser(app, router.WithHost(host), router.WithScheme("http"))
+	// locate and define our templates as usual.
+	templates := iris.HTML("./templates", ".html")
+	// add a custom func of "url" and pass the rv.URL as its template function body,
+	// so {{url "routename" "paramsOrSubdomainAsFirstArgument"}} will work inside our templates.
+	templates.AddFunc("url", rv.URL)
+
+	app.RegisterView(templates)
+
+	// wildcard subdomain, will catch username1.... username2.... username3... username4.... username5...
+	// that our below links are providing via page.html's first argument which is the subdomain.
+
+	subdomain := app.Party("*.")
+
+	mypathRoute := subdomain.Get("/mypath", emptyHandler)
+	mypathRoute.Name = "my-page1"
+
+	mypath2Route := subdomain.Get("/mypath2/{paramfirst}/{paramsecond}", emptyHandler)
+	mypath2Route.Name = "my-page2"
+
+	mypath3Route := subdomain.Get("/mypath3/{paramfirst}/statichere/{paramsecond}", emptyHandler)
+	mypath3Route.Name = "my-page3"
+
+	mypath4Route := subdomain.Get("/mypath4/{paramfirst}/statichere/{paramsecond}/{otherparam}/{something:path}", emptyHandler)
+	mypath4Route.Name = "my-page4"
+
+	mypath5Route := subdomain.Handle("GET", "/mypath5/{paramfirst}/statichere/{paramsecond}/{otherparam}/anything/{something:path}", emptyHandler)
+	mypath5Route.Name = "my-page5"
+
+	mypath6Route := subdomain.Get("/mypath6/{paramfirst}/{paramsecond}/staticParam/{paramThirdAfterStatic}", emptyHandler)
+	mypath6Route.Name = "my-page6"
+
+	app.Get("/", func(ctx context.Context) {
+		// for username5./mypath6...
+		paramsAsArray := []string{"username5", "theParam1", "theParam2", "paramThirdAfterStatic"}
+		ctx.ViewData("ParamsAsArray", paramsAsArray)
+		if err := ctx.View("page.html"); err != nil {
+			panic(err)
+		}
+	})
+
+	// http://127.0.0.1:8080
+	app.Run(iris.Addr(host))
+}
+
+func emptyHandler(ctx context.Context) {
+	ctx.Writef("Hello from subdomain: %s , you're in path:  %s", ctx.Subdomain(), ctx.Path())
+}
+
+// Note:
+// If you got an empty string on {{ url }} or {{ urlpath }} it means that
+// args length are not aligned with the route's parameters length
+// or the route didn't found by the passed name.