package module
Version: v0.0.0-...-1ab618c Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Oct 13, 2015 License: Apache-2.0 Imports: 6 Imported by: 153


i18n Build Status

Middleware i18n provides app Internationalization and Localization for Macaron.

go get github.com/macaron-contrib/i18n

Getting Help


This project is under Apache v2 License. See the LICENSE file for the full license text.



Package i18n is a middleware that provides app Internationalization and Localization of Macaron.



This section is empty.


This section is empty.


func I18n

func I18n(options ...Options) macaron.Handler

I18n is a middleware provides localization layer for your application. Paramenter langs must be in the form of "en-US", "zh-CN", etc. Otherwise it may not recognize browser input.

func Version

func Version() string


type LangType

type LangType struct {
	Lang, Name string

type Locale

type Locale struct {

A Locale describles the information of localization.

func (Locale) Language

func (l Locale) Language() string

Language returns language current locale represents.

type Options

type Options struct {
	// Suburl of path. Default is empty.
	SubURL string
	// Directory to load locale files. Default is "conf/locale"
	Directory string
	// File stores actual data of locale files. Used for in-memory purpose.
	Files map[string][]byte
	// Custom directory to overload locale files. Default is "custom/conf/locale"
	CustomDirectory string
	// Langauges that will be supported, order is meaningful.
	Langs []string
	// Human friendly names corresponding to Langs list.
	Names []string
	// Locale file naming style. Default is "locale_%s.ini".
	Format string
	// Name of language parameter name in URL. Default is "lang".
	Parameter string
	// Redirect when user uses get parameter to specify language.
	Redirect bool
	// Name that maps into template variable. Default is "i18n".
	TmplName string
	// Configuration section name. Default is "i18n".
	Section string

Options represents a struct for specifying configuration options for the i18n middleware.

Source Files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL