fixes, i18n, sitemap generator and new examples

Former-commit-id: 54801dc705ee0fa66232f65063f8a68c9cc31921

context/i18n.go

@@ -0,0 +1,28 @@
+package context
+
+import "golang.org/x/text/language"
+
+// I18nReadOnly is the interface which ontains the read-only i18n features.
+// Read the "i18n" package fo details.
+type I18nReadOnly interface {
+	Tags() []language.Tag
+	GetLocale(ctx Context) Locale
+	Tr(lang string, format string, args ...interface{}) string
+}
+
+// Locale is the interface which returns from a `Localizer.GetLocale` metod.
+// It serves the transltions based on "key" or format. See `GetMessage`.
+type Locale interface {
+	// Index returns the current locale index from the languages list.
+	Index() int
+	// Tag returns the full language Tag attached tothis Locale,
+	// it should be uniue across different Locales.
+	Tag() *language.Tag
+	// Language should return the exact languagecode of this `Locale`
+	//that the user provided on `New` function.
+	//
+	// Same as `Tag().String()` but it's static.
+	Language() string
+	// GetMessage should return translated text based n the given "key".
+	GetMessage(key string, args ...interface{}) string
+}