Skip to content
This repository has been archived by the owner on Jun 6, 2021. It is now read-only.

Commit

Permalink
doc update
Browse files Browse the repository at this point in the history
  • Loading branch information
iocast committed Dec 3, 2013
1 parent 5107a59 commit 738dde4
Show file tree
Hide file tree
Showing 3 changed files with 60 additions and 58 deletions.
56 changes: 0 additions & 56 deletions README.md

This file was deleted.

55 changes: 55 additions & 0 deletions README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
The bottle-i18n plugin integrates the multilingual internationalization services `gettext` from Python with your Bottle application.

Usage Example:

::
#!/usr/bin/python
import bottle, os
from bottle.ext.i18n import I18NPlugin, I18NMiddleware, i18n_defaults, i18n_view, i18n_template
i18n_defaults(bottle.SimpleTemplate, bottle.request)
def get():
app = bottle.Bottle()
@app.route('/')
def index():
return bottle.template("<b>{{_('hello')}} I18N<b/>?")
@app.route('/world')
def variable():
return bottle.template("<b>{{_('hello %(variable)s', {'variable': world})}}<b/>?", {'world': app._('world')})
@app.route('/view')
@i18n_view('hello', function="i18n_view")
def tmpl_app_hello():
return {}
@app.route('/tmpl')
def tmpl_app_hello():
return i18n_template('hello', function="i18n_template")
lang_app = bottle.Bottle()
@lang_app.route('/')
def sub():
return bottle.template("current language is {{lang()}}")
app.mount(app = lang_app, prefix = '/lang', skip = None)
return I18NMiddleware(app, I18NPlugin(domain='messages', default='en', locale_dir='./locale'))
__name__ == '__main__':
bottle.run(app=get(), host='localhost', port='8000', quiet=False, reloader=True, debug=True)

Running the above example it automatically loads the default language `en` if in the URL the langauge code or the `HTTP_ACCEPT_LANGUAGE` sent from the browser is missing.

The URL structure is as follow

::
http://localhost:8000/<language-code>/<route>
7 changes: 5 additions & 2 deletions setup.py
Original file line number Diff line number Diff line change
@@ -1,14 +1,17 @@
#!/usr/bin/env python

import os
from distutils.core import setup

try:
from distutils.command.build_py import build_py_2to3 as build_py
except ImportError:
from distutils.command.build_py import build_py

with open('README.md') as file:
long_description = file.read()
long_description = ""
if os.path.exists('README.rst'):
with open('README.rst') as file:
long_description = file.read()

setup(
name = 'bottle-i18n',
Expand Down

0 comments on commit 738dde4

Please sign in to comment.