diff options
Diffstat (limited to 'docs/_locale/ja_JP')
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/api.po | 1488 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/async.po | 208 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/changelog.po | 1014 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/configuration.po | 313 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/contact.po | 87 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/deployment.po | 433 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/development.po | 435 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/faq.po | 89 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/index.po | 136 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/plugindev.po | 396 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/plugins/index.po | 241 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/recipes.po | 308 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/routing.po | 233 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/stpl.po | 271 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/tutorial.po | 1461 | ||||
-rw-r--r-- | docs/_locale/ja_JP/LC_MESSAGES/tutorial_app.po | 901 |
16 files changed, 8014 insertions, 0 deletions
diff --git a/docs/_locale/ja_JP/LC_MESSAGES/api.po b/docs/_locale/ja_JP/LC_MESSAGES/api.po new file mode 100644 index 0000000..767546d --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/api.po @@ -0,0 +1,1488 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../api.rst:3 +msgid "API Reference" +msgstr "" + +#: ../../api.rst:10 +msgid "" +"This is a mostly auto-generated API. If you are new to bottle, you might " +"find the narrative :doc:`tutorial` more helpful." +msgstr "" + +#: ../../api.rst:17 +msgid "Module Contents" +msgstr "" + +#: ../../api.rst:19 +msgid "The module defines several functions, constants, and an exception." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.debug:1 +msgid "" +"Change the debug level. There is only one debug level supported at the " +"moment." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.run:1 +msgid "" +"Start a server instance. This method blocks until the server terminates." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.run:0 ../../../bottle.pydocstring of +#: bottle.path_shift:0 ../../../bottle.pydocstring of bottle.MultiDict.get:0 +#: ../../../bottle.pydocstring of bottle.HeaderDict.get:0 +#: ../../../bottle.pydocstring of bottle.ResourceManager:0 +#: ../../../bottle.pydocstring of bottle.ResourceManager.add_path:0 +#: ../../../bottle.pydocstring of bottle.FileUpload.save:0 +#: ../../../bottle.pydocstring of bottle.Bottle:0 ../../../bottle.pydocstring +#: of bottle.Bottle.mount:0 ../../../bottle.pydocstring of +#: bottle.Bottle.route:0 ../../../bottle.pydocstring of +#: bottle.BaseRequest.path_shift:0 ../../../bottle.pydocstring of +#: bottle.BaseResponse:0 ../../../bottle.pydocstring of +#: bottle.BaseResponse.set_cookie:0 ../../../bottle.pydocstring of +#: bottle.BaseResponse.set_cookie:0 +msgid "Parameters" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.run:3 +msgid "" +"WSGI application or target string supported by :func:`load_app`. (default: " +":func:`default_app`)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.run:5 +msgid "" +"Server adapter to use. See :data:`server_names` keys for valid names or pass" +" a :class:`ServerAdapter` subclass. (default: `wsgiref`)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.run:8 +msgid "" +"Server address to bind to. Pass ``0.0.0.0`` to listens on all interfaces " +"including the external one. (default: 127.0.0.1)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.run:10 +msgid "" +"Server port to bind to. Values below 1024 require root privileges. (default:" +" 8080)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.run:12 +msgid "Start auto-reloading server? (default: False)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.run:13 +msgid "Auto-reloader interval in seconds (default: 1)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.run:14 +msgid "Suppress output to stdout and stderr? (default: False)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.run:15 +msgid "Options passed to the server adapter." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.load:1 +msgid "Import a module or fetch an object from a module." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.load:3 +msgid "``package.module`` returns `module` as a module object." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.load:4 +msgid "``pack.mod:name`` returns the module variable `name` from `pack.mod`." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.load:5 +msgid "``pack.mod:func()`` calls `pack.mod.func()` and returns the result." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.load:7 +msgid "" +"The last form accepts not only function calls, but any type of expression. " +"Keyword arguments passed to this function are available as local variables. " +"Example: ``import_string('re:compile(x)', x='[a-z]')``" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.load_app:1 +msgid "" +"Load a bottle application from a module and make sure that the import does " +"not affect the current default application, but returns a separate " +"application object. See :func:`load` for the target parameter." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.request:1 ../../../bottle.pydocstring +#: of bottle.request:1 +msgid "" +"A thread-safe instance of :class:`LocalRequest`. If accessed from within a " +"request callback, this instance always refers to the *current* request (even" +" on a multi-threaded server)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.response:1 +msgid "" +"A thread-safe instance of :class:`LocalResponse`. It is used to change the " +"HTTP response for the *current* request." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.HTTP_CODES:1 +msgid "" +"A dict to map HTTP status codes (e.g. 404) to phrases (e.g. 'Not Found')" +msgstr "" + +#: ../../api.rst:38 +msgid "" +"Return the current :ref:`default-app`. Actually, these are callable " +"instances of :class:`AppStack` and implement a stack-like API." +msgstr "" + +#: ../../api.rst:42 +msgid "Routing" +msgstr "" + +#: ../../api.rst:44 +msgid "" +"Bottle maintains a stack of :class:`Bottle` instances (see :func:`app` and " +":class:`AppStack`) and uses the top of the stack as a *default application* " +"for some of the module-level functions and decorators." +msgstr "" + +#: ../../api.rst:54 +msgid "" +"Decorator to install a route to the current default application. See " +":meth:`Bottle.route` for details." +msgstr "" + +#: ../../api.rst:59 +msgid "" +"Decorator to install an error handler to the current default application. " +"See :meth:`Bottle.error` for details." +msgstr "" + +#: ../../api.rst:63 +msgid "WSGI and HTTP Utilities" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.parse_date:1 +msgid "Parse rfc1123, rfc850 and asctime timestamps and return UTC epoch." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.parse_auth:1 +msgid "" +"Parse rfc2617 HTTP authentication header string (basic) and return " +"(user,pass) tuple or None" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.cookie_encode:1 +msgid "Encode and sign a pickle-able object. Return a (byte) string" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.cookie_decode:1 +msgid "Verify and decode an encoded string. Return an object or None." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.cookie_is_encoded:1 +msgid "Return True if the argument looks like a encoded cookie." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.yieldroutes:1 +msgid "" +"Return a generator for routes that match the signature (name, args) of the " +"func parameter. This may yield more than one route if the function takes " +"optional keyword arguments. The output is best described by example::" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.path_shift:1 +msgid "Shift path fragments from PATH_INFO to SCRIPT_NAME and vice versa." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.path_shift:0 +msgid "Returns" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.path_shift:3 +msgid "The modified paths." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.path_shift:4 +msgid "The SCRIPT_NAME path." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.path_shift:5 +msgid "The PATH_INFO path." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.path_shift:6 +msgid "" +"The number of path fragments to shift. May be negative to change the shift " +"direction. (default: 1)" +msgstr "" + +#: ../../api.rst:81 +msgid "Data Structures" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.MultiDict:1 +msgid "" +"This dict stores multiple values per key, but behaves exactly like a normal " +"dict in that it returns only the newest value for any given key. There are " +"special methods available to access the full list of values." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.MultiDict.keys:1 +msgid "D.keys() -> a set-like object providing a view on D's keys" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.MultiDict.values:1 +msgid "D.values() -> an object providing a view on D's values" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.MultiDict.items:1 +msgid "D.items() -> a set-like object providing a view on D's items" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.MultiDict.get:1 +#: ../../../bottle.pydocstring of bottle.HeaderDict.get:1 +msgid "Return the most recent value for a key." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.MultiDict.get:3 +#: ../../../bottle.pydocstring of bottle.HeaderDict.get:3 +msgid "" +"The default value to be returned if the key is not present or the type " +"conversion fails." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.MultiDict.get:5 +#: ../../../bottle.pydocstring of bottle.HeaderDict.get:5 +msgid "An index for the list of available values." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.MultiDict.get:6 +#: ../../../bottle.pydocstring of bottle.HeaderDict.get:6 +msgid "" +"If defined, this callable is used to cast the value into a specific type. " +"Exception are suppressed and result in the default value to be returned." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.MultiDict.append:1 +#: ../../../bottle.pydocstring of bottle.HeaderDict.append:1 +msgid "Add a new value to the list of values for this key." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.MultiDict.replace:1 +#: ../../../bottle.pydocstring of bottle.HeaderDict.replace:1 +msgid "Replace the list of values with a single value." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.MultiDict.getall:1 +#: ../../../bottle.pydocstring of bottle.MultiDict.getall:1 +#: ../../../bottle.pydocstring of bottle.HeaderDict.getall:1 +msgid "Return a (possibly empty) list of values for a key." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.MultiDict.get:1 +msgid "Aliases for WTForms to mimic other multi-dict APIs (Django)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.HeaderDict:1 +msgid "" +"A case-insensitive version of :class:`MultiDict` that defaults to replace " +"the old value instead of appending it." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FormsDict:1 +msgid "" +"This :class:`MultiDict` subclass is used to store request form data. " +"Additionally to the normal dict-like item access methods (which return " +"unmodified data as native strings), this container also supports attribute-" +"like access to its values. Attributes are automatically de- or recoded to " +"match :attr:`input_encoding` (default: 'utf8'). Missing attributes default " +"to an empty string." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FormsDict.input_encoding:1 +msgid "Encoding used for attribute values." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FormsDict.recode_unicode:1 +msgid "" +"If true (default), unicode strings are first encoded with `latin1` and then " +"decoded to match :attr:`input_encoding`." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FormsDict.decode:1 +msgid "" +"Returns a copy with all keys and values de- or recoded to match " +":attr:`input_encoding`. Some libraries (e.g. WTForms) want a unicode " +"dictionary." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FormsDict.getunicode:1 +msgid "Return the value as a unicode string, or the default." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.WSGIHeaderDict:1 +msgid "" +"This dict-like class wraps a WSGI environ dict and provides convenient " +"access to HTTP_* fields. Keys and values are native strings (2.x bytes or " +"3.x unicode) and keys are case-insensitive. If the WSGI environment contains" +" non-native string values, these are de- or encoded using a lossless " +"'latin1' character set." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.WSGIHeaderDict:7 +msgid "" +"The API will remain stable even on changes to the relevant PEPs. Currently " +"PEP 333, 444 and 3333 are supported. (PEP 444 is the only one that uses non-" +"native strings.)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.WSGIHeaderDict.cgikeys:1 +msgid "List of keys that do not have a ``HTTP_`` prefix." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.WSGIHeaderDict.raw:1 +msgid "Return the header value as is (may be bytes or unicode)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.AppStack:1 +msgid "A stack-like list. Calling it returns the head of the stack." +msgstr "" + +#: ../../api.rst:100 +msgid "Return the current default application and remove it from the stack." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.AppStack.push:1 +#: ../../../bottle.pydocstring of bottle.AppStack.push:1 +msgid "Add a new :class:`Bottle` instance to the stack" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ResourceManager:1 +msgid "" +"This class manages a list of search paths and helps to find and open " +"application-bound resources (files)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ResourceManager:4 +msgid "default value for :meth:`add_path` calls." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ResourceManager:5 +msgid "callable used to open resources." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ResourceManager:6 +msgid "controls which lookups are cached. One of 'all', 'found' or 'none'." +msgstr "" + +#: ../docstring of bottle.ResourceManager.path:1 +msgid "A list of search paths. See :meth:`add_path` for details." +msgstr "" + +#: ../docstring of bottle.ResourceManager.cache:1 +msgid "A cache for resolved paths. ``res.cache.clear()`` clears the cache." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ResourceManager.add_path:1 +msgid "" +"Add a new path to the list of search paths. Return False if the path does " +"not exist." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ResourceManager.add_path:4 +msgid "" +"The new search path. Relative paths are turned into an absolute and " +"normalized form. If the path looks like a file (not ending in `/`), the " +"filename is stripped off." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ResourceManager.add_path:7 +msgid "" +"Path used to absolutize relative search paths. Defaults to :attr:`base` " +"which defaults to ``os.getcwd()``." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ResourceManager.add_path:9 +msgid "" +"Position within the list of search paths. Defaults to last index (appends to" +" the list)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ResourceManager.add_path:12 +msgid "" +"The `base` parameter makes it easy to reference files installed along with a" +" python module or package::" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ResourceManager.lookup:1 +msgid "Search for a resource and return an absolute file path, or `None`." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ResourceManager.lookup:3 +msgid "" +"The :attr:`path` list is searched in order. The first match is returned. " +"Symlinks are followed. The result is cached to speed up future lookups." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ResourceManager.open:1 +msgid "Find a resource and return a file object, or raise IOError." +msgstr "" + +#: ../docstring of bottle.FileUpload.file:1 +msgid "Open file(-like) object (BytesIO buffer or temporary file)" +msgstr "" + +#: ../docstring of bottle.FileUpload.name:1 +msgid "Name of the upload form field" +msgstr "" + +#: ../docstring of bottle.FileUpload.raw_filename:1 +msgid "Raw filename as sent by the client (may contain unsafe characters)" +msgstr "" + +#: ../docstring of bottle.FileUpload.headers:1 +msgid "A :class:`HeaderDict` with additional headers (e.g. content-type)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FileUpload.content_type:1 +#: ../../../bottle.pydocstring of bottle.BaseResponse.content_type:1 +msgid "Current value of the 'Content-Type' header." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FileUpload.content_length:1 +#: ../../../bottle.pydocstring of bottle.BaseResponse.content_length:1 +msgid "Current value of the 'Content-Length' header." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FileUpload.get_header:1 +msgid "Return the value of a header within the mulripart part." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FileUpload.filename:1 +msgid "" +"Name of the file on the client file system, but normalized to ensure file " +"system compatibility. An empty filename is returned as 'empty'." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FileUpload.filename:4 +msgid "" +"Only ASCII letters, digits, dashes, underscores and dots are allowed in the " +"final filename. Accents are removed, if possible. Whitespace is replaced by " +"a single dash. Leading or tailing dots or dashes are removed. The filename " +"is limited to 255 characters." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FileUpload.save:1 +msgid "" +"Save file to disk or copy its content to an open file(-like) object. If " +"*destination* is a directory, :attr:`filename` is added to the path. " +"Existing files are not overwritten by default (IOError)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FileUpload.save:5 +msgid "File path, directory or file(-like) object." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FileUpload.save:6 +msgid "If True, replace existing files. (default: False)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.FileUpload.save:7 +msgid "Bytes to read at a time. (default: 64kb)" +msgstr "" + +#: ../../api.rst:109 +msgid "Exceptions" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BottleException:1 +msgid "A base class for exceptions used by bottle." +msgstr "" + +#: ../../api.rst:117 +msgid "The :class:`Bottle` Class" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle:1 +msgid "" +"Each Bottle object represents a single, distinct web application and " +"consists of routes, callbacks, plugins, resources and configuration. " +"Instances are callable WSGI applications." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle:5 +msgid "" +"If true (default), handle all exceptions. Turn off to let debugging " +"middleware handle exceptions." +msgstr "" + +#: ../docstring of bottle.Bottle.config:1 +msgid "A :class:`ConfigDict` for app specific configuration." +msgstr "" + +#: ../docstring of bottle.Bottle.resources:1 +msgid "A :class:`ResourceManager` for application files" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.catchall:1 +msgid "If true, most exceptions are caught and returned as :exc:`HTTPError`" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.add_hook:1 +msgid "Attach a callback to a hook. Three hooks are currently implemented:" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.add_hook:4 +msgid "before_request" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.add_hook:4 +msgid "" +"Executed once before each request. The request context is available, but no " +"routing has happened yet." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.add_hook:6 +msgid "after_request" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.add_hook:7 +msgid "Executed once after each request regardless of its outcome." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.add_hook:8 +msgid "app_reset" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.add_hook:9 +msgid "Called whenever :meth:`Bottle.reset` is called." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.remove_hook:1 +msgid "Remove a callback from a hook." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.trigger_hook:1 +msgid "Trigger a hook and return a list of results." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.hook:1 +msgid "" +"Return a decorator that attaches a callback to a hook. See :meth:`add_hook` " +"for details." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.mount:1 +msgid "" +"Mount an application (:class:`Bottle` or plain WSGI) to a specific URL " +"prefix. Example::" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.mount:6 +msgid "path prefix or `mount-point`." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.mount:7 +msgid "an instance of :class:`Bottle` or a WSGI application." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.mount:9 +msgid "" +"Plugins from the parent application are not applied to the routes of the " +"mounted child application. If you need plugins in the child application, " +"install them separately." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.mount:13 +msgid "" +"While it is possible to use path wildcards within the prefix path " +"(:class:`Bottle` childs only), it is highly discouraged." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.mount:16 +msgid "" +"The prefix path must end with a slash. If you want to access the root of the" +" child application via `/prefix` in addition to `/prefix/`, consider adding " +"a route with a 307 redirect to the parent application." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.merge:1 +msgid "" +"Merge the routes of another :class:`Bottle` application or a list of " +":class:`Route` objects into this application. The routes keep their 'owner'," +" meaning that the :data:`Route.app` attribute is not changed." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.install:1 +msgid "" +"Add a plugin to the list of plugins and prepare it for being applied to all " +"routes of this application. A plugin may be a simple decorator or an object " +"that implements the :class:`Plugin` API." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.uninstall:1 +msgid "" +"Uninstall plugins. Pass an instance to remove a specific plugin, a type " +"object to remove all plugins that match that type, a string to remove all " +"plugins with a matching ``name`` attribute or ``True`` to remove all " +"plugins. Return the list of removed plugins." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.reset:1 +msgid "" +"Reset all routes (force plugins to be re-applied) and clear all caches. If " +"an ID or route object is given, only that specific route is affected." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.close:1 +msgid "Close the application and all installed plugins." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.run:1 +msgid "Calls :func:`run` with the same parameters." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.match:1 +msgid "" +"Search for a matching route and return a (:class:`Route`, urlargs) tuple. " +"The second value is a dictionary with parameters extracted from the URL. " +"Raise :exc:`HTTPError` (404/405) on a non-match." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.get_url:1 +msgid "Return a string that matches a named route" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.add_route:1 +msgid "Add a route object, but do not change the :data:`Route.app` attribute." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.route:1 +msgid "A decorator to bind a function to a request URL. Example::" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.route:7 +msgid "" +"The ``<name>`` part is a wildcard. See :class:`Router` for syntax details." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.route:10 +msgid "" +"Request path or a list of paths to listen to. If no path is specified, it is" +" automatically generated from the signature of the function." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.route:13 +msgid "" +"HTTP method (`GET`, `POST`, `PUT`, ...) or a list of methods to listen to. " +"(default: `GET`)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.route:15 +msgid "" +"An optional shortcut to avoid the decorator syntax. ``route(..., " +"callback=func)`` equals ``route(...)(func)``" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.route:17 +msgid "The name for this route. (default: None)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.route:18 +msgid "" +"A decorator or plugin or a list of plugins. These are applied to the route " +"callback in addition to installed plugins." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.route:20 +msgid "" +"A list of plugins, plugin classes or names. Matching plugins are not " +"installed to this route. ``True`` skips all." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.route:23 +msgid "" +"Any additional keyword arguments are stored as route-specific configuration " +"and passed to plugins (see :meth:`Plugin.apply`)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.get:1 +msgid "Equals :meth:`route`." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.post:1 +msgid "Equals :meth:`route` with a ``POST`` method parameter." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.put:1 +msgid "Equals :meth:`route` with a ``PUT`` method parameter." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.delete:1 +msgid "Equals :meth:`route` with a ``DELETE`` method parameter." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.patch:1 +msgid "Equals :meth:`route` with a ``PATCH`` method parameter." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.error:1 +msgid "" +"Register an output handler for a HTTP error code. Can be used as a decorator" +" or called directly ::" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Bottle.wsgi:1 +msgid "The bottle WSGI-interface." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Route:1 +msgid "" +"This class wraps a route callback along with route specific metadata and " +"configuration and applies Plugins on demand. It is also responsible for " +"turning an URL path rule into a regular expression usable by the Router." +msgstr "" + +#: ../docstring of bottle.Route.app:1 +msgid "The application this route is installed to." +msgstr "" + +#: ../docstring of bottle.Route.rule:1 +msgid "The path-rule string (e.g. ``/wiki/<page>``)." +msgstr "" + +#: ../docstring of bottle.Route.method:1 +msgid "The HTTP method as a string (e.g. ``GET``)." +msgstr "" + +#: ../docstring of bottle.Route.callback:1 +msgid "" +"The original callback with no plugins applied. Useful for introspection." +msgstr "" + +#: ../docstring of bottle.Route.name:1 +msgid "The name of the route (if specified) or ``None``." +msgstr "" + +#: ../docstring of bottle.Route.plugins:1 +msgid "A list of route-specific plugins (see :meth:`Bottle.route`)." +msgstr "" + +#: ../docstring of bottle.Route.skiplist:1 +msgid "" +"A list of plugins to not apply to this route (see :meth:`Bottle.route`)." +msgstr "" + +#: ../docstring of bottle.Route.config:1 +msgid "" +"Additional keyword arguments passed to the :meth:`Bottle.route` decorator " +"are stored in this dictionary. Used for route-specific plugin configuration " +"and meta-data." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Route.call:1 +msgid "" +"The route callback with all plugins applied. This property is created on " +"demand and then cached to speed up subsequent requests." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Route.reset:1 +msgid "" +"Forget any cached values. The next time :attr:`call` is accessed, all " +"plugins are re-applied." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Route.prepare:1 +msgid "Do all on-demand work immediately (useful for debugging)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Route.all_plugins:1 +msgid "Yield all Plugins affecting this route." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Route.get_undecorated_callback:1 +msgid "" +"Return the callback. If the callback is a decorated function, try to recover" +" the original function." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Route.get_callback_args:1 +msgid "" +"Return a list of argument names the callback (most likely) accepts as " +"keyword arguments. If the callback is a decorated function, try to recover " +"the original function before inspection." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.Route.get_config:1 +msgid "" +"Lookup a config field and return its value, first checking the route.config," +" then route.app.config." +msgstr "" + +#: ../../api.rst:127 +msgid "The :class:`Request` Object" +msgstr "" + +#: ../../api.rst:129 +msgid "" +"The :class:`Request` class wraps a WSGI environment and provides helpful " +"methods to parse and access form data, cookies, file uploads and other " +"metadata. Most of the attributes are read-only." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest:1 +msgid "" +"A wrapper for WSGI environment dictionaries that adds a lot of convenient " +"access methods and properties. Most of them are read-only." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest:4 +msgid "" +"Adding new attributes to a request actually adds them to the environ " +"dictionary (as 'bottle.request.ext.<name>'). This is the recommended way to " +"store and access request-specific data." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.MEMFILE_MAX:1 +msgid "Maximum size of memory buffer for :attr:`body` in bytes." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.environ:1 +msgid "" +"The wrapped WSGI environ dictionary. This is the only real attribute. All " +"other attributes actually are read-only properties." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.app:1 +msgid "Bottle application handling this request." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.route:1 +msgid "The bottle :class:`Route` object that matches this request." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.url_args:1 +msgid "The arguments extracted from the URL." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.path:1 +msgid "" +"The value of ``PATH_INFO`` with exactly one prefixed slash (to fix broken " +"clients and avoid the \"empty path\" edge case)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.method:1 +msgid "The ``REQUEST_METHOD`` value as an uppercase string." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.headers:1 +msgid "" +"A :class:`WSGIHeaderDict` that provides case-insensitive access to HTTP " +"request headers." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.get_header:1 +msgid "Return the value of a request header, or a given default value." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.cookies:1 +msgid "" +"Cookies parsed into a :class:`FormsDict`. Signed cookies are NOT decoded. " +"Use :meth:`get_cookie` if you expect signed cookies." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.get_cookie:1 +msgid "" +"Return the content of a cookie. To read a `Signed Cookie`, the `secret` must" +" match the one used to create the cookie (see " +":meth:`BaseResponse.set_cookie`). If anything goes wrong (missing cookie or " +"wrong signature), return a default value." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.query:1 +msgid "" +"The :attr:`query_string` parsed into a :class:`FormsDict`. These values are " +"sometimes called \"URL arguments\" or \"GET parameters\", but not to be " +"confused with \"URL wildcards\" as they are provided by the :class:`Router`." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.forms:1 +msgid "" +"Form values parsed from an `url-encoded` or `multipart/form-data` encoded " +"POST or PUT request body. The result is returned as a :class:`FormsDict`. " +"All keys and values are strings. File uploads are stored separately in " +":attr:`files`." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.params:1 +msgid "" +"A :class:`FormsDict` with the combined values of :attr:`query` and " +":attr:`forms`. File uploads are stored in :attr:`files`." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.files:1 +msgid "" +"File uploads parsed from `multipart/form-data` encoded POST or PUT request " +"body. The values are instances of :class:`FileUpload`." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.json:1 +msgid "" +"If the ``Content-Type`` header is ``application/json`` or ``application" +"/json-rpc``, this property holds the parsed content of the request body. " +"Only requests smaller than :attr:`MEMFILE_MAX` are processed to avoid memory" +" exhaustion. Invalid JSON raises a 400 error response." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.body:1 +msgid "" +"The HTTP request body as a seek-able file-like object. Depending on " +":attr:`MEMFILE_MAX`, this is either a temporary file or a " +":class:`io.BytesIO` instance. Accessing this property for the first time " +"reads and replaces the ``wsgi.input`` environ variable. Subsequent accesses " +"just do a `seek(0)` on the file object." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.chunked:1 +msgid "True if Chunked transfer encoding was." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.query:1 +msgid "An alias for :attr:`query`." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.POST:1 +msgid "" +"The values of :attr:`forms` and :attr:`files` combined into a single " +":class:`FormsDict`. Values are either strings (form values) or instances of " +":class:`cgi.FieldStorage` (file uploads)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.url:1 +msgid "" +"The full request URI including hostname and scheme. If your app lives behind" +" a reverse proxy or load balancer and you get confusing results, make sure " +"that the ``X-Forwarded-Host`` header is set correctly." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.urlparts:1 +msgid "" +"The :attr:`url` string as an :class:`urlparse.SplitResult` tuple. The tuple " +"contains (scheme, host, path, query_string and fragment), but the fragment " +"is always empty because it is not visible to the server." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.fullpath:1 +msgid "Request path including :attr:`script_name` (if present)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.query_string:1 +msgid "" +"The raw :attr:`query` part of the URL (everything in between ``?`` and " +"``#``) as a string." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.script_name:1 +msgid "" +"The initial portion of the URL's `path` that was removed by a higher level " +"(server or routing middleware) before the application was called. This " +"script path is returned with leading and tailing slashes." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.path_shift:2 +msgid "Shift path segments from :attr:`path` to :attr:`script_name` and" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.path_shift:2 +msgid "vice versa." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.path_shift:4 +msgid "" +"The number of path segments to shift. May be negative to change the shift " +"direction. (default: 1)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.content_length:1 +msgid "" +"The request body length as an integer. The client is responsible to set this" +" header. Otherwise, the real length of the body is unknown and -1 is " +"returned. In this case, :attr:`body` will be empty." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.content_type:1 +msgid "The Content-Type header as a lowercase-string (default: empty)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.is_xhr:1 +msgid "" +"True if the request was triggered by a XMLHttpRequest. This only works with " +"JavaScript libraries that support the `X-Requested-With` header (most of the" +" popular libraries do)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.is_ajax:1 +msgid "Alias for :attr:`is_xhr`. \"Ajax\" is not the right term." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.auth:1 +msgid "" +"HTTP authentication data as a (user, password) tuple. This implementation " +"currently supports basic (not digest) authentication only. If the " +"authentication happened at a higher level (e.g. in the front web-server or a" +" middleware), the password field is None, but the user field is looked up " +"from the ``REMOTE_USER`` environ variable. On any errors, None is returned." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.remote_route:1 +msgid "" +"A list of all IPs that were involved in this request, starting with the " +"client IP and followed by zero or more proxies. This does only work if all " +"proxies support the ```X-Forwarded-For`` header. Note that this information " +"can be forged by malicious clients." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.remote_addr:1 +msgid "" +"The client IP as a string. Note that this information can be forged by " +"malicious clients." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.copy:1 +msgid "Return a new :class:`Request` with a shallow :attr:`environ` copy." +msgstr "" + +#: ../../api.rst:137 +msgid "" +"The module-level :data:`bottle.request` is a proxy object (implemented in " +":class:`LocalRequest`) and always refers to the `current` request, or in " +"other words, the request that is currently processed by the request handler " +"in the current thread. This `thread locality` ensures that you can safely " +"use a global instance in a multi-threaded environment." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.LocalRequest:1 +msgid "" +"A thread-local subclass of :class:`BaseRequest` with a different set of " +"attributes for each thread. There is usually only one global instance of " +"this class (:data:`request`). If accessed during a request/response cycle, " +"this instance always refers to the *current* request (even on a " +"multithreaded server)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseRequest.__init__:1 +msgid "Wrap a WSGI environ dictionary." +msgstr "" + +#: ../../api.rst:146 +msgid "The :class:`Response` Object" +msgstr "" + +#: ../../api.rst:148 +msgid "" +"The :class:`Response` class stores the HTTP status code as well as headers " +"and cookies that are to be sent to the client. Similar to " +":data:`bottle.request` there is a thread-local :data:`bottle.response` " +"instance that can be used to adjust the `current` response. Moreover, you " +"can instantiate :class:`Response` and return it from your request handler. " +"In this case, the custom instance overrules the headers and cookies defined " +"in the global one." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse:1 +msgid "Storage class for a response body as well as headers and cookies." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse:3 +msgid "" +"This class does support dict-like case-insensitive item-access to headers, " +"but is NOT a dict. Most notably, iterating over a response yields parts of " +"the body and not the headers." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse:7 +msgid "The response body as one of the supported types." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse:8 +msgid "" +"Either an HTTP status code (e.g. 200) or a status line including the reason " +"phrase (e.g. '200 OK')." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse:10 +msgid "A dictionary or a list of name-value pairs." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse:12 +msgid "" +"Additional keyword arguments are added to the list of headers. Underscores " +"in the header name are replaced with dashes." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.copy:1 +msgid "Returns a copy of self." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.status_line:1 +msgid "The HTTP status line as a string (e.g. ``404 Not Found``)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.status_code:1 +msgid "The HTTP status code as an integer (e.g. 404)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.status:1 +msgid "" +"A writeable property to change the HTTP response status. It accepts either a" +" numeric code (100-999) or a string with a custom reason phrase (e.g. \"404 " +"Brain not found\"). Both :data:`status_line` and :data:`status_code` are " +"updated accordingly. The return value is always a status string." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.headers:1 +msgid "" +"An instance of :class:`HeaderDict`, a case-insensitive dict-like view on the" +" response headers." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.get_header:1 +msgid "" +"Return the value of a previously defined header. If there is no header with " +"that name, return a default value." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_header:1 +msgid "" +"Create a new response header, replacing any previously defined headers with " +"the same name." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.add_header:1 +msgid "Add an additional response header, not removing duplicates." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.iter_headers:1 +msgid "" +"Yield (header, value) tuples, skipping headers that are not allowed with the" +" current response status code." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.headerlist:1 +msgid "WSGI conform list of (header, value) tuples." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.expires:1 +msgid "Current value of the 'Expires' header." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.charset:1 +msgid "" +"Return the charset specified in the content-type header (default: utf8)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:1 +msgid "" +"Create a new cookie or replace an old one. If the `secret` parameter is set," +" create a `Signed Cookie` (described below)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:4 +msgid "the name of the cookie." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:5 +msgid "the value of the cookie." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:6 +msgid "a signature key required for signed cookies." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:8 +msgid "" +"Additionally, this method accepts all RFC 2109 attributes that are supported" +" by :class:`cookie.Morsel`, including:" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:11 +msgid "maximum age in seconds. (default: None)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:12 +msgid "a datetime object or UNIX timestamp. (default: None)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:13 +msgid "" +"the domain that is allowed to read the cookie. (default: current domain)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:15 +msgid "limits the cookie to a given path (default: current path)" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:16 +msgid "limit the cookie to HTTPS connections (default: off)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:17 +msgid "" +"prevents client-side javascript to read this cookie (default: off, requires " +"Python 2.6 or newer)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:19 +msgid "" +"Control or disable third-party use for this cookie. Possible values: `lax`, " +"`strict` or `none` (default)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:22 +msgid "" +"If neither `expires` nor `maxage` is set (default), the cookie will expire " +"at the end of the browser session (as soon as the browser window is closed)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:26 +msgid "" +"Signed cookies may store any pickle-able object and are cryptographically " +"signed to prevent manipulation. Keep in mind that cookies are limited to 4kb" +" in most browsers." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:30 +msgid "" +"Warning: Pickle is a potentially dangerous format. If an attacker gains " +"access to the secret key, he could forge cookies that execute code on server" +" side if unpickled. Using pickle is discouraged and support for it will be " +"removed in later versions of bottle." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.set_cookie:35 +msgid "" +"Warning: Signed cookies are not encrypted (the client can still see the " +"content) and not copy-protected (the client can restore an old cookie). The " +"main intention is to make pickling and unpickling save, not to store secret " +"information at client side." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.delete_cookie:1 +msgid "" +"Delete a cookie. Be sure to use the same `domain` and `path` settings as " +"used to create the cookie." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.LocalResponse:1 +msgid "" +"A thread-local subclass of :class:`BaseResponse` with a different set of " +"attributes for each thread. There is usually only one global instance of " +"this class (:data:`response`). Its attributes are used to build the HTTP " +"response at the end of the request/response cycle." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseResponse.__init__:1 +msgid "Initialize self. See help(type(self)) for accurate signature." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.LocalResponse.body:1 +msgid "Thread-local property" +msgstr "" + +#: ../../api.rst:160 +msgid "" +"The following two classes can be raised as an exception. The most noticeable" +" difference is that bottle invokes error handlers for :class:`HTTPError`, " +"but not for :class:`HTTPResponse` or other response types." +msgstr "" + +#: ../../api.rst:172 +msgid "Templates" +msgstr "" + +#: ../../api.rst:174 +msgid "" +"All template engines supported by :mod:`bottle` implement the " +":class:`BaseTemplate` API. This way it is possible to switch and mix " +"template engines without changing the application code at all." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseTemplate:1 +msgid "Base class and minimal API for template adapters" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseTemplate.__init__:1 +msgid "" +"Create a new template. If the source parameter (str or buffer) is missing, " +"the name argument is used to guess a template filename. Subclasses can " +"assume that self.source and/or self.filename are set. Both are strings. The " +"lookup, encoding and settings parameters are stored as instance variables. " +"The lookup parameter stores a list containing directory paths. The encoding " +"parameter should be used to decode byte strings or files. The settings " +"parameter contains a dict for engine-specific settings." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseTemplate.search:1 +msgid "" +"Search name in all directories specified in lookup. First without, then with" +" common extensions. Return first hit." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseTemplate.global_config:1 +msgid "This reads or sets the global settings stored in class.settings." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseTemplate.prepare:1 +msgid "" +"Run preparations (parsing, caching, ...). It should be possible to call this" +" again to refresh a template or to update settings." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.BaseTemplate.render:1 +msgid "" +"Render the template with the specified local variables and return a single " +"byte or unicode string. If it is a byte string, the encoding must match " +"self.encoding. This method must be thread-safe! Local variables may be " +"provided in dictionaries (args) or directly, as keywords (kwargs)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.view:1 +msgid "" +"Decorator: renders a template for a handler. The handler can control its " +"behavior like that:" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.view:4 +msgid "return a dict of template vars to fill out the template" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.view:5 +msgid "" +"return something other than a dict and the view decorator will not process " +"the template, but return the handler result as is. This includes returning a" +" HTTPResponse(dict) to get, for instance, JSON with autojson or other " +"castfilters." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.template:1 +msgid "" +"Get a rendered template as a string iterator. You can use a name, a filename" +" or a template string as first parameter. Template rendering arguments can " +"be passed as dictionaries or directly (as keyword arguments)." +msgstr "" + +#: ../../api.rst:185 +msgid "" +"You can write your own adapter for your favourite template engine or use one" +" of the predefined adapters. Currently there are four fully supported " +"template engines:" +msgstr "" + +#: ../../api.rst:188 +msgid "Class" +msgstr "" + +#: ../../api.rst:188 +msgid "URL" +msgstr "" + +#: ../../api.rst:188 +msgid "Decorator" +msgstr "" + +#: ../../api.rst:188 +msgid "Render function" +msgstr "" + +#: ../../api.rst:190 +msgid ":class:`SimpleTemplate`" +msgstr "" + +#: ../../api.rst:190 +msgid ":doc:`stpl`" +msgstr "" + +#: ../../api.rst:190 +msgid ":func:`view`" +msgstr "" + +#: ../../api.rst:190 +msgid ":func:`template`" +msgstr "" + +#: ../../api.rst:191 +msgid ":class:`MakoTemplate`" +msgstr "" + +#: ../../api.rst:191 +msgid "http://www.makotemplates.org" +msgstr "" + +#: ../../api.rst:191 +msgid ":func:`mako_view`" +msgstr "" + +#: ../../api.rst:191 +msgid ":func:`mako_template`" +msgstr "" + +#: ../../api.rst:192 +msgid ":class:`CheetahTemplate`" +msgstr "" + +#: ../../api.rst:192 +msgid "http://www.cheetahtemplate.org/" +msgstr "" + +#: ../../api.rst:192 +msgid ":func:`cheetah_view`" +msgstr "" + +#: ../../api.rst:192 +msgid ":func:`cheetah_template`" +msgstr "" + +#: ../../api.rst:193 +msgid ":class:`Jinja2Template`" +msgstr "" + +#: ../../api.rst:193 +msgid "http://jinja.pocoo.org/" +msgstr "" + +#: ../../api.rst:193 +msgid ":func:`jinja2_view`" +msgstr "" + +#: ../../api.rst:193 +msgid ":func:`jinja2_template`" +msgstr "" + +#: ../../api.rst:196 +msgid "" +"To use :class:`MakoTemplate` as your default template engine, just import " +"its specialised decorator and render function::" +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/async.po b/docs/_locale/ja_JP/LC_MESSAGES/async.po new file mode 100644 index 0000000..2840edf --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/async.po @@ -0,0 +1,208 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2015-01-22 19:17+0000\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../async.rst:2 +msgid "Primer to Asynchronous Applications" +msgstr "" + +#: ../../async.rst:4 +msgid "" +"Asynchronous design patterns don't mix well with the synchronous nature of " +"`WSGI <http://www.python.org/dev/peps/pep-3333/>`_. This is why most " +"asynchronous frameworks (tornado, twisted, ...) implement a specialized API " +"to expose their asynchronous features. Bottle is a WSGI framework and shares" +" the synchronous nature of WSGI, but thanks to the awesome `gevent project " +"<http://www.gevent.org/>`_, it is still possible to write asynchronous " +"applications with bottle. This article documents the usage of Bottle with " +"Asynchronous WSGI." +msgstr "" + +#: ../../async.rst:7 +msgid "The Limits of Synchronous WSGI" +msgstr "" + +#: ../../async.rst:9 +msgid "" +"Briefly worded, the `WSGI specification (pep 3333) " +"<http://www.python.org/dev/peps/pep-3333/>`_ defines a request/response " +"circle as follows: The application callable is invoked once for each request" +" and must return a body iterator. The server then iterates over the body and" +" writes each chunk to the socket. As soon as the body iterator is exhausted," +" the client connection is closed." +msgstr "" + +#: ../../async.rst:11 +msgid "" +"Simple enough, but there is a snag: All this happens synchronously. If your " +"application needs to wait for data (IO, sockets, databases, ...), it must " +"either yield empty strings (busy wait) or block the current thread. Both " +"solutions occupy the handling thread and prevent it from answering new " +"requests. There is consequently only one ongoing request per thread." +msgstr "" + +#: ../../async.rst:13 +msgid "" +"Most servers limit the number of threads to avoid their relatively high " +"overhead. Pools of 20 or less threads are common. As soon as all threads are" +" occupied, any new connection is stalled. The server is effectively dead for" +" everyone else. If you want to implement a chat that uses long-polling ajax " +"requests to get real-time updates, you'd reach the limited at 20 concurrent " +"connections. That's a pretty small chat." +msgstr "" + +#: ../../async.rst:16 +msgid "Greenlets to the rescue" +msgstr "" + +#: ../../async.rst:18 +msgid "" +"Most servers limit the size of their worker pools to a relatively low number" +" of concurrent threads, due to the high overhead involved in switching " +"between and creating new threads. While threads are cheap compared to " +"processes (forks), they are still expensive to create for each new " +"connection." +msgstr "" + +#: ../../async.rst:20 +msgid "" +"The `gevent <http://www.gevent.org/>`_ module adds *greenlets* to the mix. " +"Greenlets behave similar to traditional threads, but are very cheap to " +"create. A gevent-based server can spawn thousands of greenlets (one for each" +" connection) with almost no overhead. Blocking individual greenlets has no " +"impact on the servers ability to accept new requests. The number of " +"concurrent connections is virtually unlimited." +msgstr "" + +#: ../../async.rst:22 +msgid "" +"This makes creating asynchronous applications incredibly easy, because they " +"look and feel like synchronous applications. A gevent-based server is " +"actually not asynchronous, but massively multi-threaded. Here is an " +"example::" +msgstr "" + +#: ../../async.rst:39 +msgid "" +"The first line is important. It causes gevent to monkey-patch most of " +"Python's blocking APIs to not block the current thread, but pass the CPU to " +"the next greenlet instead. It actually replaces Python's threading with " +"gevent-based pseudo-threads. This is why you can still use ``time.sleep()`` " +"which would normally block the whole thread. If you don't feel comfortable " +"with monkey-patching python built-ins, you can use the corresponding gevent " +"functions (``gevent.sleep()`` in this case)." +msgstr "" + +#: ../../async.rst:41 +msgid "" +"If you run this script and point your browser to " +"``http://localhost:8080/stream``, you should see `START`, `MIDDLE`, and " +"`END` show up one by one (rather than waiting 8 seconds to see them all at " +"once). It works exactly as with normal threads, but now your server can " +"handle thousands of concurrent requests without any problems." +msgstr "" + +#: ../../async.rst:45 +msgid "" +"Some browsers buffer a certain amount of data before they start rendering a " +"page. You might need to yield more than a few bytes to see an effect in " +"these browsers. Additionally, many browsers have a limit of one concurrent " +"connection per URL. If this is the case, you can use a second browser or a " +"benchmark tool (e.g. `ab` or `httperf`) to measure performance." +msgstr "" + +#: ../../async.rst:52 +msgid "Event Callbacks" +msgstr "" + +#: ../../async.rst:54 +msgid "" +"A very common design pattern in asynchronous frameworks (including tornado, " +"twisted, node.js and friends) is to use non-blocking APIs and bind callbacks" +" to asynchronous events. The socket object is kept open until it is closed " +"explicitly to allow callbacks to write to the socket at a later point. Here " +"is an example based on the `tornado library " +"<http://www.tornadoweb.org/documentation#non-blocking-asynchronous-" +"requests>`_::" +msgstr "" + +#: ../../async.rst:63 +msgid "" +"The main benefit is that the request handler terminates early. The handling " +"thread can move on and accept new requests while the callbacks continue to " +"write to sockets of previous requests. This is how these frameworks manage " +"to process a lot of concurrent requests with only a small number of OS " +"threads." +msgstr "" + +#: ../../async.rst:65 +msgid "" +"With Gevent+WSGI, things are different: First, terminating early has no " +"benefit because we have an unlimited pool of (pseudo)threads to accept new " +"connections. Second, we cannot terminate early because that would close the " +"socket (as required by WSGI). Third, we must return an iterable to conform " +"to WSGI." +msgstr "" + +#: ../../async.rst:67 +msgid "" +"In order to conform to the WSGI standard, all we have to do is to return a " +"body iterable that we can write to asynchronously. With the help of " +"`gevent.queue <http://www.gevent.org/gevent.queue.html>`_, we can *simulate*" +" a detached socket and rewrite the previous example as follows::" +msgstr "" + +#: ../../async.rst:78 +msgid "" +"From the server perspective, the queue object is iterable. It blocks if " +"empty and stops as soon as it reaches ``StopIteration``. This conforms to " +"WSGI. On the application side, the queue object behaves like a non-blocking " +"socket. You can write to it at any time, pass it around and even start a new" +" (pseudo)thread that writes to it asynchronously. This is how long-polling " +"is implemented most of the time." +msgstr "" + +#: ../../async.rst:82 +msgid "Finally: WebSockets" +msgstr "" + +#: ../../async.rst:84 +msgid "" +"Lets forget about the low-level details for a while and speak about " +"WebSockets. Since you are reading this article, you probably know what " +"WebSockets are: A bidirectional communication channel between a browser " +"(client) and a web application (server)." +msgstr "" + +#: ../../async.rst:86 +msgid "" +"Thankfully the `gevent-websocket <http://pypi.python.org/pypi/gevent-" +"websocket/>`_ package does all the hard work for us. Here is a simple " +"WebSocket endpoint that receives messages and just sends them back to the " +"client::" +msgstr "" + +#: ../../async.rst:111 +msgid "" +"The while-loop runs until the client closes the connection. You get the idea" +" :)" +msgstr "" + +#: ../../async.rst:113 +msgid "The client-site JavaScript API is really straight forward, too::" +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/changelog.po b/docs/_locale/ja_JP/LC_MESSAGES/changelog.po new file mode 100644 index 0000000..560af4b --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/changelog.po @@ -0,0 +1,1014 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../changelog.rst:6 +msgid "Release Notes and Changelog" +msgstr "" + +#: ../../changelog.rst:9 +msgid "Release 0.13" +msgstr "" + +#: ../../changelog.rst:11 +msgid "Not released yet." +msgstr "" + +#: ../../changelog.rst:14 +msgid "Dropped support for Python versions that reached their end-of-life." +msgstr "" + +#: ../../changelog.rst:15 +msgid "" +"Keeping up support for ancient Python versions hinders adaptation of new " +"features and serves no real purpose. If you need support for older Python " +"versions, you can stay on bottle-0.12. The updated list of tested and " +"supported python releases is as follows:" +msgstr "" + +#: ../../changelog.rst:20 +msgid "Python 2.7 (>= 2.7.3)" +msgstr "" + +#: ../../changelog.rst:21 +msgid "Python 3.6" +msgstr "" + +#: ../../changelog.rst:22 +msgid "Python 3.7" +msgstr "" + +#: ../../changelog.rst:23 +msgid "Python 3.8" +msgstr "" + +#: ../../changelog.rst:24 +msgid "Python 3.9" +msgstr "" + +#: ../../changelog.rst:25 +msgid "PyPy 2.7" +msgstr "" + +#: ../../changelog.rst:26 +msgid "PyPy 3.6" +msgstr "" + +#: ../../changelog.rst:27 +msgid "PyPy 3.7" +msgstr "" + +#: ../../changelog.rst:29 +msgid "" +"Support for Python 2.5 was marked as deprecated since 0.12. We decided to go" +" a step further and also remove support for 2.6 and 3.1 to 3.5 even if it " +"was never deprecated explicitly in bottle. This means that this release is " +"*not* backwards compatible in Python <2.7.3 or <3.6 environments. " +"Maintainers for distributions or systems that still use these old python " +"versions should not update to Bottle 0.13 and stick with 0.12 instead." +msgstr "" + +#: ../../changelog.rst:35 +msgid "Stabilized APIs" +msgstr "" + +#: ../../changelog.rst:36 +msgid "" +"The documented API of the :class:`ConfigDict` class is now considered stable" +" and ready to use." +msgstr "" + +#: ../../changelog.rst:38 +msgid "Deprecated APIs" +msgstr "" + +#: ../../changelog.rst:39 +msgid "" +"The old route syntax (``/hello/:name``) is deprecated in favor of the more " +"readable and flexible ``/hello/<name>`` syntax." +msgstr "" + +#: ../../changelog.rst:40 +msgid "" +":meth:`Bottle.mount` now recognizes Bottle instance and will warn about " +"parameters that are not compatible with the new mounting behavior. The old " +"behavior (mount applications as WSGI callable) still works and is used as a " +"fallback automatically." +msgstr "" + +#: ../../changelog.rst:41 +msgid "The undocumented :func:`local_property` helper is now deprecated." +msgstr "" + +#: ../../changelog.rst:42 +msgid "" +"The server adapter for google app engine is not useful anymore and marked as" +" deprecated." +msgstr "" + +#: ../../changelog.rst:43 +msgid "" +"Bottle uses pickle to store arbitrary objects into signed cookies. This is " +"safe, as long as the signature key remains a secret. Unfortunately, people " +"tend to push code with signature keys to github all the time, so we decided " +"to remove pickle-support from bottle. Signed cookies will now issue a " +"deprecation warning if the value is not a string, and support for non-string" +" values will be removed in 0.14. The global :func:`cookie_encode`, " +":func:`cookie_decode` and :func:`is_cookie_encoded` are now also deprecated." +" If you are using this feature, think about using json to serialize your " +"objects before storing them into cookies, or switch to a session system that" +" stores data server-side instead of client-side." +msgstr "" + +#: ../../changelog.rst:45 +msgid "Removed APIs (deprecated since 0.12)" +msgstr "" + +#: ../../changelog.rst:46 +msgid "" +"Plugins with the old API (``api=1`` or no api attribute) will no longer " +"work." +msgstr "" + +#: ../../changelog.rst:47 +msgid "" +"Parameter order of :meth:`Bottle.mount` changed in 0.10. The old order will " +"now result in an error instead of a warning." +msgstr "" + +#: ../../changelog.rst:48 +msgid "" +"The :class:`ConfigDict` class was introduced in 0.11 and changed during " +"0.12. These changes are now final." +msgstr "" + +#: ../../changelog.rst:50 +msgid "" +"Attribute access and assignment was removed due to high overhead and limited" +" usability." +msgstr "" + +#: ../../changelog.rst:51 +msgid "" +"Namespaced sub-instance creation was removed. ``config[\"a\"][\"b\"]`` has a" +" high overhead and little benefit over ``config[\"a.b\"]``." +msgstr "" + +#: ../../changelog.rst:52 +msgid "" +":class:`ConfigDict` instances are no longer callable. This was a shortcut " +"for :meth:`ConfigDict.update`." +msgstr "" + +#: ../../changelog.rst:53 +msgid "" +":class:`ConfigDict` constructor no longer accepts any parameters. Use the " +"`load_*` methods instead." +msgstr "" + +#: ../../changelog.rst:55 +msgid "" +"Bottle 0.12 changed some aspects of the Simple Template Engine. These " +"changes are now final and the old syntax will now longer work." +msgstr "" + +#: ../../changelog.rst:57 +msgid "" +"The magic ``{{rebase()}}`` call was replaced by a ``base`` variable. " +"Example: ``{{base}}``" +msgstr "" + +#: ../../changelog.rst:58 +msgid "" +"In STPL Templates, the 'rebase' and 'include' keywords were replaced with " +"functions in 0.12." +msgstr "" + +#: ../../changelog.rst:59 +msgid "" +"PEP-263 encoding strings are no longer recognized. Templates are always " +"utf-8." +msgstr "" + +#: ../../changelog.rst:61 +msgid "" +"The 'geventSocketIO' server adapter was removed without notice. It did not " +"work anyway." +msgstr "" + +#: ../../changelog.rst:63 +msgid "Changes" +msgstr "" + +#: ../../changelog.rst:64 +msgid "These changes might require special care when updating." +msgstr "" + +#: ../../changelog.rst:66 +msgid "" +"Signed cookies now use a stronger HMAC algorithm by default. This will " +"result in old cookies to appear invalid after the update. Pass an explicit " +"``digestmod=hashlib.md5`` to :meth:`Request.get_cookie` and " +":meth:`Response.set_cookie` to get the old behavior." +msgstr "" + +#: ../../changelog.rst:68 +msgid "Other Improvements" +msgstr "" + +#: ../../changelog.rst:69 +msgid "" +"Bottle() instances are now context managers. If used in a with-statement, " +"the default application changes to the specific instance and the shortcuts " +"for many instance methods can be used." +msgstr "" + +#: ../../changelog.rst:70 +msgid "" +"Added support for ``PATCH`` requests and the :meth:`Bottle.patch` decorator." +msgstr "" + +#: ../../changelog.rst:71 +msgid "" +"Added `aiohttp <http://aiohttp.readthedocs.io/en/stable/>`_ and `uvloop " +"<https://github.com/MagicStack/uvloop>`_ server adapters." +msgstr "" + +#: ../../changelog.rst:72 +msgid "Added command-line arguments for config from json or ini files." +msgstr "" + +#: ../../changelog.rst:73 +msgid "" +":meth:`Bottle.mount` now recognizes instances of :class:`Bottle` and mounts " +"them with significantly less overhead than other WSGI applications." +msgstr "" + +#: ../../changelog.rst:74 +msgid "" +"The :attr:`Request.json` property now accepts ``application/json-rpc`` " +"requests." +msgstr "" + +#: ../../changelog.rst:75 +msgid "" +":func:`static_file` gained support for ``ETag`` headers. It will generate " +"ETags and recognizes ``If-None-Match`` headers." +msgstr "" + +#: ../../changelog.rst:76 +msgid "Jinja2 templates will produce better error messages than before." +msgstr "" + +#: ../../changelog.rst:82 +msgid "Release 0.12" +msgstr "" + +#: ../../changelog.rst:84 +msgid "New SimpleTemplate parser implementation" +msgstr "" + +#: ../../changelog.rst:86 +msgid "Support for multi-line code blocks (`<% ... %>`)." +msgstr "" + +#: ../../changelog.rst:87 +msgid "" +"The keywords `include` and `rebase` are functions now and can accept " +"variable template names." +msgstr "" + +#: ../../changelog.rst:89 +msgid "" +"The new :attr:`BaseRequest.route` property returns the :class:`Route` that " +"originally matched the request." +msgstr "" + +#: ../../changelog.rst:90 +msgid "" +"Removed the ``BaseRequest.MAX_PARAMS`` limit. The hash collision bug in " +"CPythons dict() implementation was fixed over a year ago. If you are still " +"using Python 2.5 in production, consider upgrading or at least make sure " +"that you get security fixed from your distributor." +msgstr "" + +#: ../../changelog.rst:91 +msgid "New :class:`ConfigDict` API (see :doc:`configuration`)" +msgstr "" + +#: ../../changelog.rst:93 +msgid "" +"More information can be found in this `development blog post " +"<http://blog.bottlepy.org/2013/07/19/preview-bottle-012.html>`_." +msgstr "" + +#: ../../changelog.rst:97 +msgid "Release 0.11" +msgstr "" + +#: ../../changelog.rst:99 +msgid "" +"Native support for Python 2.x and 3.x syntax. No need to run 2to3 anymore." +msgstr "" + +#: ../../changelog.rst:100 +msgid "" +"Support for partial downloads (``Range`` header) in :func:`static_file`." +msgstr "" + +#: ../../changelog.rst:101 +msgid "" +"The new :class:`ResourceManager` interface helps locating files bundled with" +" an application." +msgstr "" + +#: ../../changelog.rst:102 +msgid "" +"Added a server adapter for `waitress " +"<http://docs.pylonsproject.org/projects/waitress/en/latest/>`_." +msgstr "" + +#: ../../changelog.rst:103 +msgid "" +"New :meth:`Bottle.merge` method to install all routes from one application " +"into another." +msgstr "" + +#: ../../changelog.rst:104 +msgid "" +"New :attr:`BaseRequest.app` property to get the application object that " +"handles a request." +msgstr "" + +#: ../../changelog.rst:105 +msgid "" +"Added :meth:`FormsDict.decode()` to get an all-unicode version (needed by " +"WTForms)." +msgstr "" + +#: ../../changelog.rst:106 +msgid ":class:`MultiDict` and subclasses are now pickle-able." +msgstr "" + +#: ../../changelog.rst:109 +msgid "API Changes" +msgstr "" + +#: ../../changelog.rst:110 +msgid "" +":attr:`Response.status` is a read-write property that can be assigned either" +" a numeric status code or a status string with a reason phrase (``200 OK``)." +" The return value is now a string to better match existing APIs (WebOb, " +"werkzeug). To be absolutely clear, you can use the read-only properties " +":attr:`BaseResponse.status_code` and :attr:`BaseResponse.status_line`." +msgstr "" + +#: ../../changelog.rst:113 +msgid "API Deprecations" +msgstr "" + +#: ../../changelog.rst:114 +msgid "" +":class:`SimpleTALTemplate` is now deprecating. There seems to be no demand." +msgstr "" + +#: ../../changelog.rst:117 +msgid "Release 0.10" +msgstr "" + +#: ../../changelog.rst:119 +msgid "Plugin API v2" +msgstr "" + +#: ../../changelog.rst:121 +msgid "To use the new API, set :attr:`Plugin.api` to ``2``." +msgstr "" + +#: ../../changelog.rst:122 +msgid "" +":meth:`Plugin.apply` receives a :class:`Route` object instead of a context " +"dictionary as second parameter. The new object offers some additional " +"information and may be extended in the future." +msgstr "" + +#: ../../changelog.rst:123 +msgid "" +"Plugin names are considered unique now. The topmost plugin with a given name" +" on a given route is installed, all other plugins with the same name are " +"silently ignored." +msgstr "" + +#: ../../changelog.rst:125 +msgid "The Request/Response Objects" +msgstr "" + +#: ../../changelog.rst:127 +msgid "" +"Added :attr:`BaseRequest.json`, :attr:`BaseRequest.remote_route`, " +":attr:`BaseRequest.remote_addr`, :attr:`BaseRequest.query` and " +":attr:`BaseRequest.script_name`." +msgstr "" + +#: ../../changelog.rst:128 +msgid "" +"Added :attr:`BaseResponse.status_line` and :attr:`BaseResponse.status_code` " +"attributes. In future releases, :attr:`BaseResponse.status` will return a " +"string (e.g. ``200 OK``) instead of an integer to match the API of other " +"common frameworks. To make the transition as smooth as possible, you should " +"use the verbose attributes from now on." +msgstr "" + +#: ../../changelog.rst:129 +msgid "" +"Replaced :class:`MultiDict` with a specialized :class:`FormsDict` in many " +"places. The new dict implementation allows attribute access and handles " +"unicode form values transparently." +msgstr "" + +#: ../../changelog.rst:131 +msgid "Templates" +msgstr "" + +#: ../../changelog.rst:133 +msgid "" +"Added three new functions to the SimpleTemplate default namespace that " +"handle undefined variables: :func:`stpl.defined`, :func:`stpl.get` and " +":func:`stpl.setdefault`." +msgstr "" + +#: ../../changelog.rst:134 +msgid "" +"The default escape function for SimpleTemplate now additionally escapes " +"single and double quotes." +msgstr "" + +#: ../../changelog.rst:136 +msgid "Routing" +msgstr "" + +#: ../../changelog.rst:138 +msgid "" +"A new route syntax (e.g. ``/object/<id:int>``) and support for route " +"wildcard filters." +msgstr "" + +#: ../../changelog.rst:139 +msgid "Four new wildcard filters: `int`, `float`, `path` and `re`." +msgstr "" + +#: ../../changelog.rst:141 +msgid "Other changes" +msgstr "" + +#: ../../changelog.rst:143 +msgid "Added command line interface to load applications and start servers." +msgstr "" + +#: ../../changelog.rst:144 +msgid "" +"Introduced a :class:`ConfigDict` that makes accessing configuration a lot " +"easier (attribute access and auto-expanding namespaces)." +msgstr "" + +#: ../../changelog.rst:145 +msgid "Added support for raw WSGI applications to :meth:`Bottle.mount`." +msgstr "" + +#: ../../changelog.rst:146 +msgid ":meth:`Bottle.mount` parameter order changed." +msgstr "" + +#: ../../changelog.rst:147 +msgid "" +":meth:`Bottle.route` now accpets an import string for the ``callback`` " +"parameter." +msgstr "" + +#: ../../changelog.rst:148 +msgid "Dropped Gunicorn 0.8 support. Current supported version is 0.13." +msgstr "" + +#: ../../changelog.rst:149 +msgid "Added custom options to Gunicorn server." +msgstr "" + +#: ../../changelog.rst:150 +msgid "" +"Finally dropped support for type filters. Replace with a custom plugin of " +"needed." +msgstr "" + +#: ../../changelog.rst:154 +msgid "Release 0.9" +msgstr "" + +#: ../../changelog.rst:157 +msgid "Whats new?" +msgstr "" + +#: ../../changelog.rst:158 +msgid "" +"A brand new plugin-API. See :ref:`plugins` and :doc:`plugindev` for details." +msgstr "" + +#: ../../changelog.rst:159 +msgid "" +"The :func:`route` decorator got a lot of new features. See " +":meth:`Bottle.route` for details." +msgstr "" + +#: ../../changelog.rst:160 +msgid "" +"New server adapters for `gevent <http://www.gevent.org/>`_, `meinheld " +"<http://meinheld.org/>`_ and `bjoern " +"<https://github.com/jonashaag/bjoern>`_." +msgstr "" + +#: ../../changelog.rst:161 +msgid "Support for SimpleTAL templates." +msgstr "" + +#: ../../changelog.rst:162 +msgid "Better runtime exception handling for mako templates in debug mode." +msgstr "" + +#: ../../changelog.rst:163 +msgid "Lots of documentation, fixes and small improvements." +msgstr "" + +#: ../../changelog.rst:164 +msgid "A new :data:`Request.urlparts` property." +msgstr "" + +#: ../../changelog.rst:167 +msgid "Performance improvements" +msgstr "" + +#: ../../changelog.rst:168 +msgid "" +"The :class:`Router` now special-cases ``wsgi.run_once`` environments to " +"speed up CGI." +msgstr "" + +#: ../../changelog.rst:169 +msgid "" +"Reduced module load time by ~30% and optimized template parser. See `8ccb2d " +"</commit/8ccb2d>`_, `f72a7c </commit/f72a7c>`_ and `b14b9a " +"</commit/b14b9a>`_ for details." +msgstr "" + +#: ../../changelog.rst:170 +msgid "" +"Support for \"App Caching\" on Google App Engine. See `af93ec " +"</commit/af93ec>`_." +msgstr "" + +#: ../../changelog.rst:171 +msgid "" +"Some of the rarely used or deprecated features are now plugins that avoid " +"overhead if the feature is not used." +msgstr "" + +#: ../../changelog.rst:174 ../../changelog.rst:185 +msgid "API changes" +msgstr "" + +#: ../../changelog.rst:175 +msgid "" +"This release is mostly backward compatible, but some APIs are marked " +"deprecated now and will be removed for the next release. Most noteworthy:" +msgstr "" + +#: ../../changelog.rst:177 +msgid "" +"The ``static`` route parameter is deprecated. You can escape wild-cards with" +" a backslash." +msgstr "" + +#: ../../changelog.rst:178 +msgid "" +"Type-based output filters are deprecated. They can easily be replaced with " +"plugins." +msgstr "" + +#: ../../changelog.rst:182 +msgid "Release 0.8" +msgstr "" + +#: ../../changelog.rst:186 +msgid "These changes may break compatibility with previous versions." +msgstr "" + +#: ../../changelog.rst:188 +msgid "" +"The built-in Key/Value database is not available anymore. It is marked " +"deprecated since 0.6.4" +msgstr "" + +#: ../../changelog.rst:189 +msgid "The Route syntax and behaviour changed." +msgstr "" + +#: ../../changelog.rst:191 +msgid "" +"Regular expressions must be encapsulated with ``#``. In 0.6 all non-" +"alphanumeric characters not present in the regular expression were allowed." +msgstr "" + +#: ../../changelog.rst:192 +msgid "" +"Regular expressions not part of a route wildcard are escaped automatically. " +"You don't have to escape dots or other regular control characters anymore. " +"In 0.6 the whole URL was interpreted as a regular expression. You can use " +"anonymous wildcards (``/index:#(\\.html)?#``) to achieve a similar " +"behaviour." +msgstr "" + +#: ../../changelog.rst:194 +msgid "" +"The ``BreakTheBottle`` exception is gone. Use :class:`HTTPResponse` instead." +msgstr "" + +#: ../../changelog.rst:195 +msgid "" +"The :class:`SimpleTemplate` engine escapes HTML special characters in " +"``{{bad_html}}`` expressions automatically. Use the new ``{{!good_html}}`` " +"syntax to get old behaviour (no escaping)." +msgstr "" + +#: ../../changelog.rst:196 +msgid "" +"The :class:`SimpleTemplate` engine returns unicode strings instead of lists " +"of byte strings." +msgstr "" + +#: ../../changelog.rst:197 +msgid "" +"``bottle.optimize()`` and the automatic route optimization is obsolete." +msgstr "" + +#: ../../changelog.rst:198 +msgid "Some functions and attributes were renamed:" +msgstr "" + +#: ../../changelog.rst:200 +msgid ":attr:`Request._environ` is now :attr:`Request.environ`" +msgstr "" + +#: ../../changelog.rst:201 +msgid ":attr:`Response.header` is now :attr:`Response.headers`" +msgstr "" + +#: ../../changelog.rst:202 +msgid ":func:`default_app` is obsolete. Use :func:`app` instead." +msgstr "" + +#: ../../changelog.rst:204 +msgid "The default :func:`redirect` code changed from 307 to 303." +msgstr "" + +#: ../../changelog.rst:205 +msgid "Removed support for ``@default``. Use ``@error(404)`` instead." +msgstr "" + +#: ../../changelog.rst:209 +msgid "New features" +msgstr "" + +#: ../../changelog.rst:210 +msgid "This is an incomplete list of new features and improved functionality." +msgstr "" + +#: ../../changelog.rst:212 +msgid "" +"The :class:`Request` object got new properties: :attr:`Request.body`, " +":attr:`Request.auth`, :attr:`Request.url`, :attr:`Request.header`, " +":attr:`Request.forms`, :attr:`Request.files`." +msgstr "" + +#: ../../changelog.rst:213 +msgid "" +"The :meth:`Response.set_cookie` and :meth:`Request.get_cookie` methods are " +"now able to encode and decode python objects. This is called a *secure " +"cookie* because the encoded values are signed and protected from changes on " +"client side. All pickle-able data structures are allowed." +msgstr "" + +#: ../../changelog.rst:214 +msgid "" +"The new :class:`Router` class drastically improves performance for setups " +"with lots of dynamic routes and supports named routes (named route + dict = " +"URL string)." +msgstr "" + +#: ../../changelog.rst:215 +msgid "" +"It is now possible (and recommended) to return :exc:`HTTPError` and " +":exc:`HTTPResponse` instances or other exception objects instead of raising " +"them." +msgstr "" + +#: ../../changelog.rst:216 +msgid "" +"The new function :func:`static_file` equals :func:`send_file` but returns a " +":exc:`HTTPResponse` or :exc:`HTTPError` instead of raising it. " +":func:`send_file` is deprecated." +msgstr "" + +#: ../../changelog.rst:217 +msgid "" +"New :func:`get`, :func:`post`, :func:`put` and :func:`delete` decorators." +msgstr "" + +#: ../../changelog.rst:218 +msgid "The :class:`SimpleTemplate` engine got full unicode support." +msgstr "" + +#: ../../changelog.rst:219 +msgid "Lots of non-critical bugfixes." +msgstr "" + +#: ../../changelog.rst:225 +msgid "Contributors" +msgstr "" + +#: ../../../AUTHORS:1 +msgid "" +"Bottle is written and maintained by Marcel Hellkamp <marc@bottlepy.org>." +msgstr "" + +#: ../../../AUTHORS:3 +msgid "" +"Thanks to all the people who found bugs, sent patches, spread the word, " +"helped each other on the mailing-list and made this project possible. I hope" +" the following (alphabetically sorted) list is complete. If you miss your " +"name on that list (or want your name removed) please :doc:`tell me " +"<contact>` or add it yourself." +msgstr "" + +#: ../../../AUTHORS:5 +msgid "acasajus" +msgstr "" + +#: ../../../AUTHORS:6 +msgid "Adam R. Smith" +msgstr "" + +#: ../../../AUTHORS:7 +msgid "Alexey Borzenkov" +msgstr "" + +#: ../../../AUTHORS:8 +msgid "Alexis Daboville" +msgstr "" + +#: ../../../AUTHORS:9 +msgid "Anton I. Sipos" +msgstr "" + +#: ../../../AUTHORS:10 +msgid "Anton Kolechkin" +msgstr "" + +#: ../../../AUTHORS:11 +msgid "apexi200sx" +msgstr "" + +#: ../../../AUTHORS:12 +msgid "apheage" +msgstr "" + +#: ../../../AUTHORS:13 +msgid "BillMa" +msgstr "" + +#: ../../../AUTHORS:14 +msgid "Brad Greenlee" +msgstr "" + +#: ../../../AUTHORS:15 +msgid "Brandon Gilmore" +msgstr "" + +#: ../../../AUTHORS:16 +msgid "Branko Vukelic" +msgstr "" + +#: ../../../AUTHORS:17 +msgid "Brian Sierakowski" +msgstr "" + +#: ../../../AUTHORS:18 +msgid "Brian Wickman" +msgstr "" + +#: ../../../AUTHORS:19 +msgid "Carl Scharenberg" +msgstr "" + +#: ../../../AUTHORS:20 +msgid "Damien Degois" +msgstr "" + +#: ../../../AUTHORS:21 +msgid "David Buxton" +msgstr "" + +#: ../../../AUTHORS:22 +msgid "Duane Johnson" +msgstr "" + +#: ../../../AUTHORS:23 +msgid "fcamel" +msgstr "" + +#: ../../../AUTHORS:24 +msgid "Frank Murphy" +msgstr "" + +#: ../../../AUTHORS:25 +msgid "Frederic Junod" +msgstr "" + +#: ../../../AUTHORS:26 +msgid "goldfaber3012" +msgstr "" + +#: ../../../AUTHORS:27 +msgid "Greg Milby" +msgstr "" + +#: ../../../AUTHORS:28 +msgid "gstein" +msgstr "" + +#: ../../../AUTHORS:29 +msgid "Ian Davis" +msgstr "" + +#: ../../../AUTHORS:30 +msgid "Itamar Nabriski" +msgstr "" + +#: ../../../AUTHORS:31 +msgid "Iuri de Silvio" +msgstr "" + +#: ../../../AUTHORS:32 +msgid "Jaimie Murdock" +msgstr "" + +#: ../../../AUTHORS:33 +msgid "Jeff Nichols" +msgstr "" + +#: ../../../AUTHORS:34 +msgid "Jeremy Kelley" +msgstr "" + +#: ../../../AUTHORS:35 +msgid "joegester" +msgstr "" + +#: ../../../AUTHORS:36 +msgid "Johannes Krampf" +msgstr "" + +#: ../../../AUTHORS:37 +msgid "Jonas Haag" +msgstr "" + +#: ../../../AUTHORS:38 +msgid "Joshua Roesslein" +msgstr "" + +#: ../../../AUTHORS:39 +msgid "Judson Neer" +msgstr "" + +#: ../../../AUTHORS:40 +msgid "Karl" +msgstr "" + +#: ../../../AUTHORS:41 +msgid "Kevin Zuber" +msgstr "" + +#: ../../../AUTHORS:42 +msgid "Kraken" +msgstr "" + +#: ../../../AUTHORS:43 +msgid "Kyle Fritz" +msgstr "" + +#: ../../../AUTHORS:44 +msgid "m35" +msgstr "" + +#: ../../../AUTHORS:45 +msgid "Marcos Neves" +msgstr "" + +#: ../../../AUTHORS:46 +msgid "masklinn" +msgstr "" + +#: ../../../AUTHORS:47 +msgid "Michael Labbe" +msgstr "" + +#: ../../../AUTHORS:48 +msgid "Michael Soulier" +msgstr "" + +#: ../../../AUTHORS:49 +msgid "`reddit <http://reddit.com/r/python>`_" +msgstr "" + +#: ../../../AUTHORS:50 +msgid "Nicolas Vanhoren" +msgstr "" + +#: ../../../AUTHORS:51 +msgid "Oz N Tiram" +msgstr "" + +#: ../../../AUTHORS:52 +msgid "Robert Rollins" +msgstr "" + +#: ../../../AUTHORS:53 +msgid "rogererens" +msgstr "" + +#: ../../../AUTHORS:54 +msgid "rwxrwx" +msgstr "" + +#: ../../../AUTHORS:55 +msgid "Santiago Gala" +msgstr "" + +#: ../../../AUTHORS:56 +msgid "Sean M. Collins" +msgstr "" + +#: ../../../AUTHORS:57 +msgid "Sebastian Wollrath" +msgstr "" + +#: ../../../AUTHORS:58 +msgid "Seth" +msgstr "" + +#: ../../../AUTHORS:59 +msgid "Sigurd Høgsbro" +msgstr "" + +#: ../../../AUTHORS:60 +msgid "Stuart Rackham" +msgstr "" + +#: ../../../AUTHORS:61 +msgid "Sun Ning" +msgstr "" + +#: ../../../AUTHORS:62 +msgid "Tomás A. Schertel" +msgstr "" + +#: ../../../AUTHORS:63 +msgid "Tristan Zajonc" +msgstr "" + +#: ../../../AUTHORS:64 +msgid "voltron" +msgstr "" + +#: ../../../AUTHORS:65 +msgid "Wieland Hoffmann" +msgstr "" + +#: ../../../AUTHORS:66 +msgid "zombat" +msgstr "" + +#: ../../../AUTHORS:67 +msgid "Thiago Avelino" +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/configuration.po b/docs/_locale/ja_JP/LC_MESSAGES/configuration.po new file mode 100644 index 0000000..fccaa8d --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/configuration.po @@ -0,0 +1,313 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../configuration.rst:3 +msgid "Configuration (DRAFT)" +msgstr "" + +#: ../../configuration.rst:8 +msgid "" +"This is a draft for a new API. `Tell us <mailto:bottlepy@googlegroups.com>`_" +" what you think." +msgstr "" + +#: ../../configuration.rst:10 +msgid "" +"Bottle applications can store their configuration in :attr:`Bottle.config`, " +"a dict-like object and central place for application specific settings. This" +" dictionary controls many aspects of the framework, tells (newer) plugins " +"what to do, and can be used to store your own configuration as well." +msgstr "" + +#: ../../configuration.rst:13 +msgid "Configuration Basics" +msgstr "" + +#: ../../configuration.rst:15 +msgid "" +"The :attr:`Bottle.config` object behaves a lot like an ordinary dictionary. " +"All the common dict methods work as expected. Let us start with some " +"examples::" +msgstr "" + +#: ../../configuration.rst:44 +msgid "" +"The app object is not always available, but as long as you are within a " +"request context, you can use the `request` object to get the current " +"application and its configuration::" +msgstr "" + +#: ../../configuration.rst:51 +msgid "Naming Convention" +msgstr "" + +#: ../../configuration.rst:53 +msgid "" +"To make life easier, plugins and applications should follow some simple " +"rules when it comes to config parameter names:" +msgstr "" + +#: ../../configuration.rst:55 +msgid "" +"All keys should be lowercase strings and follow the rules for python " +"identifiers (no special characters but the underscore)." +msgstr "" + +#: ../../configuration.rst:56 +msgid "" +"Namespaces are separated by dots (e.g. ``namespace.field`` or " +"``namespace.subnamespace.field``)." +msgstr "" + +#: ../../configuration.rst:57 +msgid "" +"Bottle uses the root namespace for its own configuration. Plugins should " +"store all their variables in their own namespace (e.g. ``sqlite.db`` or " +"``werkzeug.use_debugger``)." +msgstr "" + +#: ../../configuration.rst:58 +msgid "" +"Your own application should use a separate namespace (e.g. ``myapp.*``)." +msgstr "" + +#: ../../configuration.rst:62 +msgid "Loading Configuration from a File" +msgstr "" + +#: ../../configuration.rst:66 +msgid "" +"Configuration files are useful if you want to enable non-programmers to " +"configure your application, or just don't want to hack python module files " +"just to change the database port. A very common syntax for configuration " +"files is shown here:" +msgstr "" + +#: ../../configuration.rst:78 +msgid "" +"With :meth:`ConfigDict.load_config` you can load these ``*.ini`` style " +"configuration files from disk and import their values into your existing " +"configuration::" +msgstr "" + +#: ../../configuration.rst:85 +msgid "Loading Configuration from a python module" +msgstr "" + +#: ../../configuration.rst:89 +msgid "" +"Loading configuration from a Python module is a common pattern for Python " +"programs and frameworks. Bottle assumes that configuration keys are all " +"upper case:" +msgstr "" + +#: ../../configuration.rst:98 +msgid "" +"You can load the this Python module with :met:`ConfigDict.load_module`::" +msgstr "" + +#: ../../configuration.rst:107 +msgid "" +"Note the second parameter to disable loading as namespaced items as in " +":meth:`ConfigDict.load_dict`. By default, loading from a Python module will " +"call this method, unless you specifically call this method with `False` as " +"the second argument." +msgstr "" + +#: ../../configuration.rst:110 +msgid "Loading Configuration from a nested :class:`dict`" +msgstr "" + +#: ../../configuration.rst:114 +msgid "" +"Another useful method is :meth:`ConfigDict.load_dict`. This method takes an " +"entire structure of nested dictionaries and turns it into a flat list of " +"keys and values with namespaced keys::" +msgstr "" + +#: ../../configuration.rst:135 +msgid "Listening to configuration changes" +msgstr "" + +#: ../../configuration.rst:139 +msgid "" +"The ``config`` hook on the application object is triggered each time a value" +" in :attr:`Bottle.config` is changed. This hook can be used to react on " +"configuration changes at runtime, for example reconnect to a new database, " +"change the debug settings on a background service or resize worker thread " +"pools. The hook callback receives two arguments (key, new_value) and is " +"called before the value is actually changed in the dictionary. Raising an " +"exception from a hook callback cancels the change and the old value is " +"preserved." +msgstr "" + +#: ../../configuration.rst:148 +msgid "" +"The hook callbacks cannot *change* the value that is to be stored to the " +"dictionary. That is what filters are for." +msgstr "" + +#: ../../configuration.rst:154 +msgid "Filters and other Meta Data" +msgstr "" + +#: ../../configuration.rst:158 +msgid "" +":class:`ConfigDict` allows you to store meta data along with configuration " +"keys. Two meta fields are currently defined:" +msgstr "" + +#: ../../configuration.rst:162 +msgid "help" +msgstr "" + +#: ../../configuration.rst:161 +msgid "" +"A help or description string. May be used by debugging, introspection or " +"admin tools to help the site maintainer configuring their application." +msgstr "" + +#: ../../configuration.rst:165 +msgid "filter" +msgstr "" + +#: ../../configuration.rst:165 +msgid "" +"A callable that accepts and returns a single value. If a filter is defined " +"for a key, any new value stored to that key is first passed through the " +"filter callback. The filter can be used to cast the value to a different " +"type, check for invalid values (throw a ValueError) or trigger side effects." +msgstr "" + +#: ../../configuration.rst:167 +msgid "" +"This feature is most useful for plugins. They can validate their config " +"parameters or trigger side effects using filters and document their " +"configuration via ``help`` fields::" +msgstr "" + +#: ../../configuration.rst:189 +msgid "API Documentation" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict:1 +msgid "" +"A dict-like configuration storage with additional support for namespaces, " +"validators, meta-data, overlays and more." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict:4 +msgid "" +"This dict-like class is heavily optimized for read access. All read-only " +"methods as well as item access should be as fast as the built-in dict." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.load_module:1 +msgid "Load values from a Python module." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.load_module:3 +msgid "Example modue ``config.py``::" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.load_module:0 +#: ../../../bottle.pydocstring of bottle.ConfigDict.load_config:0 +msgid "Parameters" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.load_module:17 +msgid "" +"If true (default), dictionary values are assumed to represent namespaces " +"(see :meth:`load_dict`)." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.load_config:1 +msgid "Load values from an ``*.ini`` style config file." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.load_config:3 +msgid "" +"A configuration file consists of sections, each led by a ``[section]`` " +"header, followed by key/value entries separated by either ``=`` or ``:``. " +"Section names and keys are case-insensitive. Leading and trailing whitespace" +" is removed from keys and values. Values can be omitted, in which case the " +"key/value delimiter may also be left out. Values can also span multiple " +"lines, as long as they are indented deeper than the first line of the value." +" Commands are prefixed by ``#`` or ``;`` and may only appear on their own on" +" an otherwise empty line." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.load_config:13 +msgid "" +"Both section and key names may contain dots (``.``) as namespace separators." +" The actual configuration parameter name is constructed by joining section " +"name and key name together and converting to lower case." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.load_config:18 +msgid "" +"The special sections ``bottle`` and ``ROOT`` refer to the root namespace and" +" the ``DEFAULT`` section defines default values for all other sections." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.load_config:22 +msgid "With Python 3, extended string interpolation is enabled." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.load_config:24 +msgid "The path of a config file, or a list of paths." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.load_config:25 +msgid "" +"All keyword parameters are passed to the underlying " +":class:`python:configparser.ConfigParser` constructor call." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.load_dict:1 +msgid "" +"Load values from a dictionary structure. Nesting can be used to represent " +"namespaces." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.update:1 +msgid "" +"If the first parameter is a string, all keys are prefixed with this " +"namespace. Apart from that it works just as the usual dict.update()." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.setdefault:1 +msgid "Insert key with a value of default if key is not in the dictionary." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.setdefault:3 +msgid "Return the value for key if key is in the dictionary, else default." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.meta_get:1 +msgid "Return the value of a meta field for a key." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.meta_set:1 +msgid "Set the meta field for a key to a new value." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.ConfigDict.meta_list:1 +msgid "Return an iterable of meta field names defined for a key." +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/contact.po b/docs/_locale/ja_JP/LC_MESSAGES/contact.po new file mode 100644 index 0000000..8e41049 --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/contact.po @@ -0,0 +1,87 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../contact.rst:3 +msgid "Contact" +msgstr "" + +#: ../../contact.rst:6 +msgid "About the Author" +msgstr "" + +#: ../../contact.rst:7 +msgid "" +"Hi, I'm *Marcel Hellkamp* (aka *defnull*), author of Bottle and the guy " +"behind this website. I'm 27 years old and studying computer science at the " +"Georg-August-University in Göttingen, Germany. Python is my favorite " +"language, but I also code in ruby and JavaScript a lot. Watch me on `twitter" +" <http://twitter.com/bottlepy>`_ or visit my profile at `GitHub " +"<http://github.com/defnull>`_ to get in contact. A `mailinglist " +"<http://groups.google.de/group/bottlepy>`_ is open for Bottle related " +"questions, too." +msgstr "" + +#: ../../contact.rst:10 +msgid "About Bottle" +msgstr "" + +#: ../../contact.rst:11 +msgid "" +"This is my first open source project so far. It started and a small " +"experiment but soon got so much positive feedback I decided to make " +"something real out of it. Here it is." +msgstr "" + +#: ../../contact.rst:14 +msgid "Impressum und Kontaktdaten" +msgstr "" + +#: ../../contact.rst:15 +msgid "" +"(This is required by `German law " +"<http://bundesrecht.juris.de/tmg/__5.html>`_)" +msgstr "" + +#: ../../contact.rst:17 +msgid "" +"Die Nutzung der folgenden Kontaktdaten ist ausschließlich für die " +"Kontaktaufnahme mit dem Betreiber dieser Webseite bei rechtlichen Problemen " +"vorgesehen. Insbesondere die Nutzung zu Werbe- oder ähnlichen Zwecken ist " +"ausdrücklich untersagt." +msgstr "" + +#: ../../contact.rst:22 +msgid "**Betreiber**: Marcel Hellkamp" +msgstr "" + +#: ../../contact.rst:23 +msgid "**Ort**: D - 37075 Göttingen" +msgstr "" + +#: ../../contact.rst:24 +msgid "**Strasse**: Theodor-Heuss Strasse 13" +msgstr "" + +#: ../../contact.rst:25 +msgid "**Telefon**: +49 (0) 551 20005915" +msgstr "" + +#: ../../contact.rst:26 +msgid "**E-Mail**: marc at gsites dot de" +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/deployment.po b/docs/_locale/ja_JP/LC_MESSAGES/deployment.po new file mode 100644 index 0000000..a3724ab --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/deployment.po @@ -0,0 +1,433 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../deployment.rst:27 +msgid "Deployment" +msgstr "" + +#: ../../deployment.rst:29 +msgid "" +"The bottle :func:`run` function, when called without any parameters, starts " +"a local development server on port 8080. You can access and test your " +"application via http://localhost:8080/ if you are on the same host." +msgstr "" + +#: ../../deployment.rst:31 +msgid "" +"To get your application available to the outside world, specify the IP the " +"server should listen to (e.g. ``run(host='192.168.0.1')``) or let the server" +" listen to all interfaces at once (e.g. ``run(host='0.0.0.0')``). The " +"listening port can be changed in a similar way, but you need root or admin " +"rights to choose a port below 1024. Port 80 is the standard for HTTP " +"servers::" +msgstr "" + +#: ../../deployment.rst:37 +msgid "Server Options" +msgstr "" + +#: ../../deployment.rst:39 +msgid "" +"The built-in default server is based on `wsgiref WSGIServer " +"<http://docs.python.org/library/wsgiref.html#module-" +"wsgiref.simple_server>`_. This non-threading HTTP server is perfectly fine " +"for development, but may become a performance bottleneck when server load " +"increases. There are three ways to eliminate this bottleneck:" +msgstr "" + +#: ../../deployment.rst:41 +msgid "" +"Use a different server that is either multi-threaded or supports " +"asynchronous IO." +msgstr "" + +#: ../../deployment.rst:42 +msgid "" +"Start multiple server processes and spread the load with a load-balancer." +msgstr "" + +#: ../../deployment.rst:43 +msgid "Do both." +msgstr "" + +#: ../../deployment.rst:45 +msgid "" +"**Multi-threaded** servers are the 'classic' way to do it. They are very " +"robust, reasonably fast and easy to manage. As a drawback, they can only " +"handle a limited number of connections at the same time and utilize only one" +" CPU core due to the \"Global Interpreter Lock\" (GIL) of the Python " +"runtime. This does not hurt most applications, they are waiting for network " +"IO most of the time anyway, but may slow down CPU intensive tasks (e.g. " +"image processing)." +msgstr "" + +#: ../../deployment.rst:47 +msgid "" +"**Asynchronous IO** servers are very fast, can handle a virtually unlimited " +"number of concurrent connections and are easy to manage. To take full " +"advantage of their potential, you need to design your application " +"accordingly and understand the concepts of the specific server." +msgstr "" + +#: ../../deployment.rst:49 +msgid "" +"**Multi-processing** (forking) servers are not limited by the GIL and " +"utilize more than one CPU core, but make communication between server " +"instances more expensive. You need a database or external message query to " +"share state between processes, or design your application so that it does " +"not need any shared state. The setup is also a bit more complicated, but " +"there are good tutorials available." +msgstr "" + +#: ../../deployment.rst:52 +msgid "Switching the Server Backend" +msgstr "" + +#: ../../deployment.rst:54 +msgid "" +"The easiest way to increase performance is to install a multi-threaded " +"server library like paste_ or cherrypy_ and tell Bottle to use that instead " +"of the single-threaded default server::" +msgstr "" + +#: ../../deployment.rst:58 +msgid "" +"Bottle ships with a lot of ready-to-use adapters for the most common WSGI " +"servers and automates the setup process. Here is an incomplete list:" +msgstr "" + +#: ../../deployment.rst:61 +msgid "Name" +msgstr "" + +#: ../../deployment.rst:61 +msgid "Homepage" +msgstr "" + +#: ../../deployment.rst:61 +msgid "Description" +msgstr "" + +#: ../../deployment.rst:63 +msgid "cgi" +msgstr "" + +#: ../../deployment.rst:63 +msgid "Run as CGI script" +msgstr "" + +#: ../../deployment.rst:64 +msgid "flup" +msgstr "" + +#: ../../deployment.rst:64 +msgid "flup_" +msgstr "" + +#: ../../deployment.rst:64 +msgid "Run as FastCGI process" +msgstr "" + +#: ../../deployment.rst:65 +msgid "gae" +msgstr "" + +#: ../../deployment.rst:65 +msgid "gae_" +msgstr "" + +#: ../../deployment.rst:65 +msgid "Helper for Google App Engine deployments" +msgstr "" + +#: ../../deployment.rst:66 +msgid "wsgiref" +msgstr "" + +#: ../../deployment.rst:66 +msgid "wsgiref_" +msgstr "" + +#: ../../deployment.rst:66 +msgid "Single-threaded default server" +msgstr "" + +#: ../../deployment.rst:67 +msgid "cherrypy" +msgstr "" + +#: ../../deployment.rst:67 +msgid "cherrypy_" +msgstr "" + +#: ../../deployment.rst:67 +msgid "Multi-threaded and very stable" +msgstr "" + +#: ../../deployment.rst:68 +msgid "paste" +msgstr "" + +#: ../../deployment.rst:68 +msgid "paste_" +msgstr "" + +#: ../../deployment.rst:68 +msgid "Multi-threaded, stable, tried and tested" +msgstr "" + +#: ../../deployment.rst:69 +msgid "waitress" +msgstr "" + +#: ../../deployment.rst:69 +msgid "waitress_" +msgstr "" + +#: ../../deployment.rst:69 +msgid "Multi-threaded, poweres Pyramid" +msgstr "" + +#: ../../deployment.rst:70 +msgid "gunicorn" +msgstr "" + +#: ../../deployment.rst:70 +msgid "gunicorn_" +msgstr "" + +#: ../../deployment.rst:70 +msgid "Pre-forked, partly written in C" +msgstr "" + +#: ../../deployment.rst:71 +msgid "eventlet" +msgstr "" + +#: ../../deployment.rst:71 +msgid "eventlet_" +msgstr "" + +#: ../../deployment.rst:71 +msgid "Asynchronous framework with WSGI support." +msgstr "" + +#: ../../deployment.rst:72 +msgid "gevent" +msgstr "" + +#: ../../deployment.rst:72 +msgid "gevent_" +msgstr "" + +#: ../../deployment.rst:72 ../../deployment.rst:73 +msgid "Asynchronous (greenlets)" +msgstr "" + +#: ../../deployment.rst:73 +msgid "diesel" +msgstr "" + +#: ../../deployment.rst:73 +msgid "diesel_" +msgstr "" + +#: ../../deployment.rst:74 +msgid "tornado" +msgstr "" + +#: ../../deployment.rst:74 +msgid "tornado_" +msgstr "" + +#: ../../deployment.rst:74 +msgid "Asynchronous, powers some parts of Facebook" +msgstr "" + +#: ../../deployment.rst:75 +msgid "twisted" +msgstr "" + +#: ../../deployment.rst:75 +msgid "twisted_" +msgstr "" + +#: ../../deployment.rst:75 +msgid "Asynchronous, well tested but... twisted" +msgstr "" + +#: ../../deployment.rst:76 +msgid "meinheld" +msgstr "" + +#: ../../deployment.rst:76 +msgid "meinheld_" +msgstr "" + +#: ../../deployment.rst:76 +msgid "Asynchronous, partly written in C" +msgstr "" + +#: ../../deployment.rst:77 +msgid "bjoern" +msgstr "" + +#: ../../deployment.rst:77 +msgid "bjoern_" +msgstr "" + +#: ../../deployment.rst:77 +msgid "Asynchronous, very fast and written in C" +msgstr "" + +#: ../../deployment.rst:78 +msgid "auto" +msgstr "" + +#: ../../deployment.rst:78 +msgid "Automatically selects an available server adapter" +msgstr "" + +#: ../../deployment.rst:81 +msgid "The full list is available through :data:`server_names`." +msgstr "" + +#: ../../deployment.rst:83 +msgid "" +"If there is no adapter for your favorite server or if you need more control " +"over the server setup, you may want to start the server manually. Refer to " +"the server documentation on how to run WSGI applications. Here is an example" +" for paste_::" +msgstr "" + +#: ../../deployment.rst:91 +msgid "Apache mod_wsgi" +msgstr "" + +#: ../../deployment.rst:93 +msgid "" +"Instead of running your own HTTP server from within Bottle, you can attach " +"Bottle applications to an `Apache server <apache>`_ using mod_wsgi_." +msgstr "" + +#: ../../deployment.rst:95 +msgid "" +"All you need is an ``app.wsgi`` file that provides an ``application`` " +"object. This object is used by mod_wsgi to start your application and should" +" be a WSGI-compatible Python callable." +msgstr "" + +#: ../../deployment.rst:97 +msgid "File ``/var/www/yourapp/app.wsgi``::" +msgstr "" + +#: ../../deployment.rst:108 +msgid "The Apache configuration may look like this::" +msgstr "" + +#: ../../deployment.rst:126 +msgid "uWSGI" +msgstr "" + +#: ../../deployment.rst:128 +msgid "" +"uWSGI_ is a modern alternative to FastCGI and the recommended deployment " +"option on servers like nginx_, lighttpd_, and cherokee_. The uWSGI project " +"provides an application server that runs your application, and defines a " +"protocol that frontend webservers can speak to. Have a look at the excellent" +" `Quickstart for Python/WSGI applications <https://uwsgi-" +"docs.readthedocs.io/en/latest/WSGIquickstart.html>`_." +msgstr "" + +#: ../../deployment.rst:132 +msgid "Google AppEngine" +msgstr "" + +#: ../../deployment.rst:136 +msgid "" +"New App Engine applications using the Python 2.7 runtime environment support" +" any WSGI application and should be configured to use the Bottle application" +" object directly. For example suppose your application's main module is " +"``myapp.py``::" +msgstr "" + +#: ../../deployment.rst:146 +msgid "" +"Then you can configure App Engine's ``app.yaml`` to use the ``app`` object " +"like so::" +msgstr "" + +#: ../../deployment.rst:158 +msgid "" +"It is always a good idea to let GAE serve static files directly. Here is " +"example for a working ``app.yaml`` (using the legacy Python 2.5 runtime " +"environment)::" +msgstr "" + +#: ../../deployment.rst:175 +msgid "Load Balancer (Manual Setup)" +msgstr "" + +#: ../../deployment.rst:177 +msgid "" +"A single Python process can utilize only one CPU at a time, even if there " +"are more CPU cores available. The trick is to balance the load between " +"multiple independent Python processes to utilize all of your CPU cores." +msgstr "" + +#: ../../deployment.rst:179 +msgid "" +"Instead of a single Bottle application server, you start one instance for " +"each CPU core available using different local port (localhost:8080, 8081, " +"8082, ...). You can choose any server adapter you want, even asynchronous " +"ones. Then a high performance load balancer acts as a reverse proxy and " +"forwards each new requests to a random port, spreading the load between all " +"available back-ends. This way you can use all of your CPU cores and even " +"spread out the load between different physical servers." +msgstr "" + +#: ../../deployment.rst:181 +msgid "" +"One of the fastest load balancers available is Pound_ but most common web " +"servers have a proxy-module that can do the work just fine." +msgstr "" + +#: ../../deployment.rst:183 +msgid "Pound example::" +msgstr "" + +#: ../../deployment.rst:201 +msgid "Apache example::" +msgstr "" + +#: ../../deployment.rst:209 +msgid "Lighttpd example::" +msgstr "" + +#: ../../deployment.rst:221 +msgid "Good old CGI" +msgstr "" + +#: ../../deployment.rst:223 +msgid "" +"A CGI server starts a new process for each request. This adds a lot of " +"overhead but is sometimes the only option, especially on cheap hosting " +"packages. The `cgi` server adapter does not actually start a CGI server, but" +" transforms your bottle application into a valid CGI application::" +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/development.po b/docs/_locale/ja_JP/LC_MESSAGES/development.po new file mode 100644 index 0000000..1a40fdb --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/development.po @@ -0,0 +1,435 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../development.rst:2 +msgid "Developer Notes" +msgstr "" + +#: ../../development.rst:4 +msgid "" +"This document is intended for developers and package maintainers interested " +"in the bottle development and release workflow. If you want to contribute, " +"you are just right!" +msgstr "" + +#: ../../development.rst:8 +msgid "Get involved" +msgstr "" + +#: ../../development.rst:10 +msgid "" +"There are several ways to join the community and stay up to date. Here are " +"some of them:" +msgstr "" + +#: ../../development.rst:12 +msgid "" +"**Mailing list**: Join our mailing list by sending an email to " +"`bottlepy+subscribe@googlegroups.com " +"<mailto:bottlepy+subscribe@googlegroups.com>`_ (no google account required)." +msgstr "" + +#: ../../development.rst:13 +msgid "" +"**Twitter**: `Follow us on Twitter <https://twitter.com/bottlepy>`_ or " +"search for the `#bottlepy <https://twitter.com/#!/search/%23bottlepy>`_ tag." +msgstr "" + +#: ../../development.rst:14 +msgid "" +"**IRC**: Join `#bottlepy on irc.freenode.net " +"<irc://irc.freenode.net/bottlepy>`_ or use the `web chat interface " +"<http://webchat.freenode.net/?channels=bottlepy>`_." +msgstr "" + +#: ../../development.rst:15 +msgid "" +"**Google plus**: We sometimes `blog about Bottle, releases and technical " +"stuff " +"<https://plus.google.com/b/104025895326575643538/104025895326575643538/posts>`_" +" on our Google+ page." +msgstr "" + +#: ../../development.rst:19 +msgid "Get the Sources" +msgstr "" + +#: ../../development.rst:21 +msgid "" +"The bottle `development repository <https://github.com/bottlepy/bottle>`_ " +"and the `issue tracker <https://github.com/bottlepy/bottle/issues>`_ are " +"both hosted at `github <https://github.com/bottlepy/bottle>`_. If you plan " +"to contribute, it is a good idea to create an account there and fork the " +"main repository. This way your changes and ideas are visible to other " +"developers and can be discussed openly. Even without an account, you can " +"clone the repository or just download the latest development version as a " +"source archive." +msgstr "" + +#: ../../development.rst:23 +msgid "**git:** ``git clone git://github.com/bottlepy/bottle.git``" +msgstr "" + +#: ../../development.rst:24 +msgid "**git/https:** ``git clone https://github.com/bottlepy/bottle.git``" +msgstr "" + +#: ../../development.rst:25 +msgid "" +"**Download:** Development branch as `tar archive " +"<http://github.com/bottlepy/bottle/tarball/master>`_ or `zip file " +"<http://github.com/bottlepy/bottle/zipball/master>`_." +msgstr "" + +#: ../../development.rst:26 +msgid "" +"**Translations:** `transifex.com/projects/p/bottle " +"<https://www.transifex.com/projects/p/bottle/>`_" +msgstr "" + +#: ../../development.rst:30 +msgid "Releases and Updates" +msgstr "" + +#: ../../development.rst:32 +msgid "" +"Bottle is released at irregular intervals and distributed through `PyPI " +"<http://pypi.python.org/pypi/bottle>`_. Release candidates and bugfix-" +"revisions of outdated releases are only available from the git repository " +"mentioned above. Some Linux distributions may offer packages for outdated " +"releases, though." +msgstr "" + +#: ../../development.rst:34 +msgid "" +"The Bottle version number splits into three parts " +"(**major.minor.revision**). These are *not* used to promote new features but" +" to indicate important bug-fixes and/or API changes. Critical bugs are fixed" +" in at least the two latest minor releases and announced in all available " +"channels (mailinglist, twitter, github). Non-critical bugs or features are " +"not guaranteed to be backported. This may change in the future, through." +msgstr "" + +#: ../../development.rst:37 +msgid "Major Release (x.0)" +msgstr "" + +#: ../../development.rst:37 +msgid "" +"The major release number is increased on important milestones or updates " +"that completely break backward compatibility. You probably have to work over" +" your entire application to use a new release. These releases are very rare," +" through." +msgstr "" + +#: ../../development.rst:40 +msgid "Minor Release (x.y)" +msgstr "" + +#: ../../development.rst:40 +msgid "" +"The minor release number is increased on updates that change the API or " +"behaviour in some way. You might get some depreciation warnings any may have" +" to tweak some configuration settings to restore the old behaviour, but in " +"most cases these changes are designed to be backward compatible for at least" +" one minor release. You should update to stay up do date, but don't have to." +" An exception is 0.8, which *will* break backward compatibility hard. (This " +"is why 0.7 was skipped). Sorry about that." +msgstr "" + +#: ../../development.rst:43 +msgid "Revision (x.y.z)" +msgstr "" + +#: ../../development.rst:43 +msgid "" +"The revision number is increased on bug-fixes and other patches that do not " +"change the API or behaviour. You can safely update without editing your " +"application code. In fact, you really should as soon as possible, because " +"important security fixes are released this way." +msgstr "" + +#: ../../development.rst:47 +msgid "Pre-Release Versions" +msgstr "" + +#: ../../development.rst:46 +msgid "" +"Release candidates are marked by an ``rc`` in their revision number. These " +"are API stable most of the time and open for testing, but not officially " +"released yet. You should not use these for production." +msgstr "" + +#: ../../development.rst:50 +msgid "Repository Structure" +msgstr "" + +#: ../../development.rst:52 +msgid "The source repository is structured as follows:" +msgstr "" + +#: ../../development.rst:55 +msgid "``master`` branch" +msgstr "" + +#: ../../development.rst:55 +msgid "" +"This is the integration, testing and development branch. All changes that " +"are planned to be part of the next release are merged and tested here." +msgstr "" + +#: ../../development.rst:58 +msgid "``release-x.y`` branches" +msgstr "" + +#: ../../development.rst:58 +msgid "" +"As soon as the master branch is (almost) ready for a new release, it is " +"branched into a new release branch. This \"release candidate\" is feature-" +"frozen but may receive bug-fixes and last-minute changes until it is " +"considered production ready and officially released. From that point on it " +"is called a \"support branch\" and still receives bug-fixes, but only " +"important ones. The revision number is increased on each push to these " +"branches, so you can keep up with important changes." +msgstr "" + +#: ../../development.rst:62 +msgid "Feature branches" +msgstr "" + +#: ../../development.rst:61 +msgid "" +"All other branches are feature branches. These are based on the master " +"branch and only live as long as they are still active and not merged back " +"into ``master``." +msgstr "" + +#: ../../development.rst:65 +msgid "What does this mean for a developer?" +msgstr "" + +#: ../../development.rst:66 +msgid "" +"If you want to add a feature, create a new branch from ``master``. If you " +"want to fix a bug, branch ``release-x.y`` for each affected release. Please " +"use a separate branch for each feature or bug to make integration as easy as" +" possible. Thats all. There are git workflow examples at the bottom of this " +"page." +msgstr "" + +#: ../../development.rst:68 +msgid "" +"Oh, and never ever change the release number. We'll do that on integration. " +"You never know in which order we pull pending requests anyway :)" +msgstr "" + +#: ../../development.rst:72 +msgid "What does this mean for a maintainer ?" +msgstr "" + +#: ../../development.rst:73 +msgid "" +"Watch the tags (and the mailing list) for bug-fixes and new releases. If you" +" want to fetch a specific release from the git repository, trust the tags, " +"not the branches. A branch may contain changes that are not released yet, " +"but a tag marks the exact commit which changed the version number." +msgstr "" + +#: ../../development.rst:77 +msgid "Submitting Patches" +msgstr "" + +#: ../../development.rst:79 +msgid "" +"The best way to get your changes integrated into the main development branch" +" is to fork the main repository at github, create a new feature-branch, " +"apply your changes and send a pull-request. Further down this page is a " +"small collection of git workflow examples that may guide you. Submitting " +"git-compatible patches to the mailing list is fine too. In any case, please " +"follow some basic rules:" +msgstr "" + +#: ../../development.rst:81 +msgid "" +"**Documentation:** Tell us what your patch does. Comment your code. If you " +"introduced a new feature, add to the documentation so others can learn about" +" it." +msgstr "" + +#: ../../development.rst:82 +msgid "" +"**Test:** Write tests to prove that your code works as expected and does not" +" break anything. If you fixed a bug, write at least one test-case that " +"triggers the bug. Make sure that all tests pass before you submit a patch." +msgstr "" + +#: ../../development.rst:83 +msgid "" +"**One patch at a time:** Only fix one bug or add one feature at a time. " +"Design your patches so that they can be applyed as a whole. Keep your " +"patches clean, small and focused." +msgstr "" + +#: ../../development.rst:84 +msgid "" +"**Sync with upstream:** If the ``upstream/master`` branch changed while you " +"were working on your patch, rebase or pull to make sure that your patch " +"still applies without conflicts." +msgstr "" + +#: ../../development.rst:88 +msgid "Building the Documentation" +msgstr "" + +#: ../../development.rst:90 +msgid "" +"You need a recent version of Sphinx to build the documentation. The " +"recommended way is to install :command:`virtualenv` using your distribution " +"package repository and install sphinx manually to get an up-to-date version." +msgstr "" + +#: ../../development.rst:121 +msgid "GIT Workflow Examples" +msgstr "" + +#: ../../development.rst:123 +msgid "" +"The following examples assume that you have an (free) `github account " +"<https://github.com>`_. This is not mandatory, but makes things a lot " +"easier." +msgstr "" + +#: ../../development.rst:125 +msgid "" +"First of all you need to create a fork (a personal clone) of the official " +"repository. To do this, you simply click the \"fork\" button on the `bottle " +"project page <https://github.com/bottlepy/bottle>`_. When the fork is done, " +"you will be presented with a short introduction to your new repository." +msgstr "" + +#: ../../development.rst:127 +msgid "" +"The fork you just created is hosted at github and read-able by everyone, but" +" write-able only by you. Now you need to clone the fork locally to actually " +"make changes to it. Make sure you use the private (read-write) URL and *not*" +" the public (read-only) one::" +msgstr "" + +#: ../../development.rst:131 +msgid "" +"Once the clone is complete your repository will have a remote named " +"\"origin\" that points to your fork on github. Don’t let the name confuse " +"you, this does not point to the original bottle repository, but to your own " +"fork. To keep track of the official repository, add another remote named " +"\"upstream\"::" +msgstr "" + +#: ../../development.rst:137 +msgid "" +"Note that \"upstream\" is a public clone URL, which is read-only. You cannot" +" push changes directly to it. Instead, we will pull from your public " +"repository. This is described later." +msgstr "" + +#: ../../development.rst:140 +msgid "Submit a Feature" +msgstr "" + +#: ../../development.rst:141 +msgid "" +"New features are developed in separate feature-branches to make integration " +"easy. Because they are going to be integrated into the ``master`` branch, " +"they must be based on ``upstream/master``. To create a new feature-branch, " +"type the following::" +msgstr "" + +#: ../../development.rst:145 +msgid "" +"Now implement your feature, write tests, update the documentation, make sure" +" that all tests pass and commit your changes::" +msgstr "" + +#: ../../development.rst:149 +msgid "" +"If the ``upstream/master`` branch changed in the meantime, there may be " +"conflicts with your changes. To solve these, 'rebase' your feature-branch " +"onto the top of the updated ``upstream/master`` branch::" +msgstr "" + +#: ../../development.rst:154 +msgid "" +"This is equivalent to undoing all your changes, updating your branch to the " +"latest version and reapplying all your patches again. If you released your " +"branch already (see next step), this is not an option because it rewrites " +"your history. You can do a normal pull instead. Resolve any conflicts, run " +"the tests again and commit." +msgstr "" + +#: ../../development.rst:156 +msgid "" +"Now you are almost ready to send a pull request. But first you need to make " +"your feature-branch public by pushing it to your github fork::" +msgstr "" + +#: ../../development.rst:160 +msgid "" +"After you’ve pushed your commit(s) you need to inform us about the new " +"feature. One way is to send a pull-request using github. Another way would " +"be to start a thread in the mailing-list, which is recommended. It allows " +"other developers to see and discuss your patches and you get some feedback " +"for free :)" +msgstr "" + +#: ../../development.rst:162 +msgid "" +"If we accept your patch, we will integrate it into the official development " +"branch and make it part of the next release." +msgstr "" + +#: ../../development.rst:165 +msgid "Fix a Bug" +msgstr "" + +#: ../../development.rst:166 +msgid "" +"The workflow for bug-fixes is very similar to the one for features, but " +"there are some differences:" +msgstr "" + +#: ../../development.rst:168 +msgid "" +"Branch off of the affected release branches instead of just the development " +"branch." +msgstr "" + +#: ../../development.rst:169 +msgid "Write at least one test-case that triggers the bug." +msgstr "" + +#: ../../development.rst:170 +msgid "" +"Do this for each affected branch including ``upstream/master`` if it is " +"affected. ``git cherry-pick`` may help you reducing repetitive work." +msgstr "" + +#: ../../development.rst:171 +msgid "" +"Name your branch after the release it is based on to avoid confusion. " +"Examples: ``my_bugfix-x.y`` or ``my_bugfix-dev``." +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/faq.po b/docs/_locale/ja_JP/LC_MESSAGES/faq.po new file mode 100644 index 0000000..da3aa00 --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/faq.po @@ -0,0 +1,89 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../faq.rst:10 +msgid "Frequently Asked Questions" +msgstr "" + +#: ../../faq.rst:13 +msgid "About Bottle" +msgstr "" + +#: ../../faq.rst:16 +msgid "Is bottle suitable for complex applications?" +msgstr "" + +#: ../../faq.rst:18 +msgid "" +"Bottle is a *micro* framework designed for prototyping and building small " +"web applications and services. It stays out of your way and allows you to " +"get things done fast, but misses some advanced features and ready-to-use " +"solutions found in other frameworks (MVC, ORM, form validation, scaffolding," +" XML-RPC). Although it *is* possible to add these features and build complex" +" applications with Bottle, you should consider using a full-stack Web " +"framework like pylons_ or paste_ instead." +msgstr "" + +#: ../../faq.rst:22 +msgid "Common Problems and Pitfalls" +msgstr "" + +#: ../../faq.rst:29 +msgid "\"Template Not Found\" in mod_wsgi/mod_python" +msgstr "" + +#: ../../faq.rst:31 +msgid "" +"Bottle searches in ``./`` and ``./views/`` for templates. In a mod_python_ " +"or mod_wsgi_ environment, the working directory (``./``) depends on your " +"Apache settings. You should add an absolute path to the template search " +"path::" +msgstr "" + +#: ../../faq.rst:35 +msgid "so bottle searches the right paths." +msgstr "" + +#: ../../faq.rst:38 +msgid "Dynamic Routes and Slashes" +msgstr "" + +#: ../../faq.rst:40 +msgid "" +"In :ref:`dynamic route syntax <tutorial-dynamic-routes>`, a placeholder " +"token (``<name>``) matches everything up to the next slash. This equals to " +"``[^/]+`` in regular expression syntax. To accept slashes too, you have to " +"add a custom regular pattern to the placeholder. An example: " +"``/images/<filepath:path>`` would match ``/images/icons/error.png`` but " +"``/images/<filename>`` won't." +msgstr "" + +#: ../../faq.rst:43 +msgid "Problems with reverse proxies" +msgstr "" + +#: ../../faq.rst:45 +msgid "" +"Redirects and url-building only works if bottle knows the public address and" +" location of your application. If you run bottle locally behind a reverse " +"proxy or load balancer, some information might get lost along the way. For " +"example, the ``wsgi.url_scheme`` value or the ``Host`` header might reflect " +"the local request by your proxy, not the real request by the client. Here is" +" a small WSGI middleware snippet that helps to fix these values::" +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/index.po b/docs/_locale/ja_JP/LC_MESSAGES/index.po new file mode 100644 index 0000000..d46bd94 --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/index.po @@ -0,0 +1,136 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +# Manabu Shimohira <mshimohi@gmail.com>, 2017 +# taisa007 <g5.taisa007@gmail.com>, 2016 +# taisa007 <g5.taisa007@gmail.com>, 2016 +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../index.rst:20 +msgid "Bottle: Python Web Framework" +msgstr "Bottle: Python Webフレームワーク" + +#: ../../index.rst:22 +msgid "" +"Bottle is a fast, simple and lightweight WSGI_ micro web-framework for " +"Python_. It is distributed as a single file module and has no dependencies " +"other than the `Python Standard Library <http://docs.python.org/library/>`_." +msgstr "BottleはPython製の早くてシンプルでライトウェイトなWSGIマイクロWebフレームワークです。Bottleは1つのファイルで構成されていて、Pythonの標準ライブラリには依存していません。" + +#: ../../index.rst:25 +msgid "" +"**Routing:** Requests to function-call mapping with support for clean and " +"dynamic URLs." +msgstr "**ルーティング:** リクエストをファンクションとマッピングします。また、ダイナミックURLもサポートしています。" + +#: ../../index.rst:26 +msgid "" +"**Templates:** Fast and pythonic :ref:`built-in template engine <tutorial-" +"templates>` and support for mako_, jinja2_ and cheetah_ templates." +msgstr "**テンプレート:** Pythonのビルドインテンプレートやmako、jinja2、cheetahテンプレートをサポートしています。" + +#: ../../index.rst:27 +msgid "" +"**Utilities:** Convenient access to form data, file uploads, cookies, " +"headers and other HTTP-related metadata." +msgstr "ファイルアップロートやクッキー、ヘッダー、その他HTTPに関連するデータに簡単にアクセスすることが可能です。" + +#: ../../index.rst:28 +msgid "" +"**Server:** Built-in HTTP development server and support for paste_, " +"bjoern_, gae_, cherrypy_ or any other WSGI_ capable HTTP server." +msgstr "" + +#: ../../index.rst:31 +msgid "Example: \"Hello World\" in a bottle" +msgstr "例: Bottleによる \"Hello World\"" + +#: ../../index.rst:42 +msgid "" +"Run this script or paste it into a Python console, then point your browser " +"to `<http://localhost:8080/hello/world>`_. That's it." +msgstr "このスクリプトを実行するかPythonコンソールに貼り付けて実行し、ブラウザに次のURLを入力してください。`<http://localhost:8080/hello/world>`" + +#: ../../index.rst:45 +msgid "Download and Install" +msgstr "ダウンロードとインストール" + +#: ../../index.rst:48 +msgid "" +"Install the latest stable release with ``pip install bottle`` or download " +"`bottle.py`__ (unstable) into your project directory. There are no hard [1]_" +" dependencies other than the Python standard library. Bottle supports " +"**Python 2.7 and Python 3**." +msgstr "" + +#: ../../index.rst:50 +msgid "Support for Python 2.5 and 2.6 was dropped with this release." +msgstr "" + +#: ../../index.rst:55 +msgid "User's Guide" +msgstr "ユーザーズガイド" + +#: ../../index.rst:56 +msgid "" +"Start here if you want to learn how to use the bottle framework for web " +"development. If you have any questions not answered here, feel free to ask " +"the `mailing list <mailto:bottlepy@googlegroups.com>`_." +msgstr "Bottleの使い方はここから調べることができます。ここで分からないことについてはメーリングリスト`<mailto:bottlepy@googlegroups.com>`_で質問してください。" + +#: ../../index.rst:71 +msgid "Knowledge Base" +msgstr "ナレッジベース" + +#: ../../index.rst:72 +msgid "A collection of articles, guides and HOWTOs." +msgstr "Bottleに関する記事や使い方のノウハウ集です。" + +#: ../../index.rst:84 +msgid "Development and Contribution" +msgstr "コントリビューション" + +#: ../../index.rst:86 +msgid "" +"These chapters are intended for developers interested in the bottle " +"development and release workflow." +msgstr "このチャプターはBottleの開発やリリースワークフローに興味のある人向けのコンテンツです。" + +#: ../../index.rst:103 +msgid "License" +msgstr "ライセンス" + +#: ../../index.rst:105 +msgid "Code and documentation are available according to the MIT License:" +msgstr "コードとドキュメントはMITライセンスに応じてご利用いただけます" + +#: ../../index.rst:110 +msgid "" +"The Bottle logo however is *NOT* covered by that license. It is allowed to " +"use the logo as a link to the bottle homepage or in direct context with the " +"unmodified library. In all other cases please ask first." +msgstr "Bottleロゴの利用はライセンスによって制限されていない為、Bottleのホームページへのリンクなどにご利用いただけます。" + +#: ../../index.rst:115 +msgid "Footnotes" +msgstr "脚注" + +#: ../../index.rst:116 +msgid "" +"Usage of the template or server adapter classes requires the corresponding " +"template or server modules." +msgstr "テンプレートやサーバーアダプタークラスの使用方法は、対応するテンプレートやサーバーモジュールが必要です。" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/plugindev.po b/docs/_locale/ja_JP/LC_MESSAGES/plugindev.po new file mode 100644 index 0000000..f042c99 --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/plugindev.po @@ -0,0 +1,396 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../plugindev.rst:6 +msgid "Plugin Development Guide" +msgstr "" + +#: ../../plugindev.rst:8 +msgid "" +"This guide explains the plugin API and how to write custom plugins. I " +"suggest reading :ref:`plugins` first if you have not done that already. You " +"might also want to have a look at the :doc:`/plugins/index` for some " +"practical examples." +msgstr "" + +#: ../../plugindev.rst:12 +msgid "" +"This is a draft. If you see any errors or find that a specific part is not " +"explained clear enough, please tell the `mailing-list " +"<mailto:bottlepy@googlegroups.com>`_ or file a `bug report " +"<https://github.com/bottlepy/bottle/issues>`_." +msgstr "" + +#: ../../plugindev.rst:16 +msgid "How Plugins Work: The Basics" +msgstr "" + +#: ../../plugindev.rst:18 +msgid "" +"The plugin API builds on the concept of `decorators " +"<http://docs.python.org/glossary.html#term-decorator>`_. To put it briefly, " +"a plugin is a decorator applied to every single route callback of an " +"application." +msgstr "" + +#: ../../plugindev.rst:20 +msgid "" +"This is just a simplification. Plugins can do a lot more than just " +"decorating route callbacks, but it is a good starting point. Lets have a " +"look at some code::" +msgstr "" + +#: ../../plugindev.rst:36 +msgid "" +"This plugin measures the execution time for each request and adds an " +"appropriate ``X-Exec-Time`` header to the response. As you can see, the " +"plugin returns a wrapper and the wrapper calls the original callback " +"recursively. This is how decorators usually work." +msgstr "" + +#: ../../plugindev.rst:38 +msgid "" +"The last line tells Bottle to install the plugin to the default application." +" This causes the plugin to be automatically applied to all routes of that " +"application. In other words, ``stopwatch()`` is called once for each route " +"callback and the return value is used as a replacement for the original " +"callback." +msgstr "" + +#: ../../plugindev.rst:40 +msgid "" +"Plugins are applied on demand, that is, as soon as a route is requested for " +"the first time. For this to work properly in multi-threaded environments, " +"the plugin should be thread-safe. This is not a problem most of the time, " +"but keep it in mind." +msgstr "" + +#: ../../plugindev.rst:42 +msgid "" +"Once all plugins are applied to a route, the wrapped callback is cached and " +"subsequent requests are handled by the cached version directly. This means " +"that a plugin is usually applied only once to a specific route. That cache, " +"however, is cleared every time the list of installed plugins changes. Your " +"plugin should be able to decorate the same route more than once." +msgstr "" + +#: ../../plugindev.rst:44 +msgid "" +"The decorator API is quite limited, though. You don't know anything about " +"the route being decorated or the associated application object and have no " +"way to efficiently store data that is shared among all routes. But fear not!" +" Plugins are not limited to just decorator functions. Bottle accepts " +"anything as a plugin as long as it is callable or implements an extended " +"API. This API is described below and gives you a lot of control over the " +"whole process." +msgstr "" + +#: ../../plugindev.rst:48 +msgid "Plugin API" +msgstr "" + +#: ../../plugindev.rst:50 +msgid "" +":class:`Plugin` is not a real class (you cannot import it from " +":mod:`bottle`) but an interface that plugins are expected to implement. " +"Bottle accepts any object of any type as a plugin, as long as it conforms to" +" the following API." +msgstr "" + +#: ../../plugindev.rst:54 +msgid "" +"Plugins must be callable or implement :meth:`apply`. If :meth:`apply` is " +"defined, it is always preferred over calling the plugin directly. All other " +"methods and attributes are optional." +msgstr "" + +#: ../../plugindev.rst:58 +msgid "" +"Both :meth:`Bottle.uninstall` and the `skip` parameter of " +":meth:`Bottle.route()` accept a name string to refer to a plugin or plugin " +"type. This works only for plugins that have a name attribute." +msgstr "" + +#: ../../plugindev.rst:62 +msgid "" +"The Plugin API is still evolving. This integer attribute tells bottle which " +"version to use. If it is missing, bottle defaults to the first version. The " +"current version is ``2``. See :ref:`plugin-changelog` for details." +msgstr "" + +#: ../../plugindev.rst:66 +msgid "" +"Called as soon as the plugin is installed to an application (see " +":meth:`Bottle.install`). The only parameter is the associated application " +"object." +msgstr "" + +#: ../../plugindev.rst:70 +msgid "" +"As long as :meth:`apply` is not defined, the plugin itself is used as a " +"decorator and applied directly to each route callback. The only parameter is" +" the callback to decorate. Whatever is returned by this method replaces the " +"original callback. If there is no need to wrap or replace a given callback, " +"just return the unmodified callback parameter." +msgstr "" + +#: ../../plugindev.rst:74 +msgid "" +"If defined, this method is used in favor of :meth:`__call__` to decorate " +"route callbacks. The additional `route` parameter is an instance of " +":class:`Route` and provides a lot of meta-information and context for that " +"route. See :ref:`route-context` for details." +msgstr "" + +#: ../../plugindev.rst:78 +msgid "" +"Called immediately before the plugin is uninstalled or the application is " +"closed (see :meth:`Bottle.uninstall` or :meth:`Bottle.close`)." +msgstr "" + +#: ../../plugindev.rst:81 +msgid "" +"Both :meth:`Plugin.setup` and :meth:`Plugin.close` are *not* called for " +"plugins that are applied directly to a route via the :meth:`Bottle.route()` " +"decorator, but only for plugins installed to an application." +msgstr "" + +#: ../../plugindev.rst:87 +msgid "Plugin API changes" +msgstr "" + +#: ../../plugindev.rst:89 +msgid "" +"The Plugin API is still evolving and changed with Bottle 0.10 to address " +"certain issues with the route context dictionary. To ensure backwards " +"compatibility with 0.9 Plugins, we added an optional :attr:`Plugin.api` " +"attribute to tell bottle which API to use. The API differences are " +"summarized here." +msgstr "" + +#: ../../plugindev.rst:91 +msgid "**Bottle 0.9 API 1** (:attr:`Plugin.api` not present)" +msgstr "" + +#: ../../plugindev.rst:93 +msgid "Original Plugin API as described in the 0.9 docs." +msgstr "" + +#: ../../plugindev.rst:95 +msgid "**Bottle 0.10 API 2** (:attr:`Plugin.api` equals 2)" +msgstr "" + +#: ../../plugindev.rst:97 +msgid "" +"The `context` parameter of the :meth:`Plugin.apply` method is now an " +"instance of :class:`Route` instead of a context dictionary." +msgstr "" + +#: ../../plugindev.rst:103 +msgid "The Route Context" +msgstr "" + +#: ../../plugindev.rst:105 +msgid "" +"The :class:`Route` instance passed to :meth:`Plugin.apply` provides detailed" +" informations about the associated route. The most important attributes are " +"summarized here:" +msgstr "" + +#: ../../plugindev.rst:108 +msgid "Attribute" +msgstr "" + +#: ../../plugindev.rst:108 +msgid "Description" +msgstr "" + +#: ../../plugindev.rst:110 +msgid "app" +msgstr "" + +#: ../../plugindev.rst:110 +msgid "The application object this route is installed to." +msgstr "" + +#: ../../plugindev.rst:111 +msgid "rule" +msgstr "" + +#: ../../plugindev.rst:111 +msgid "The rule string (e.g. ``/wiki/<page>``)." +msgstr "" + +#: ../../plugindev.rst:112 +msgid "method" +msgstr "" + +#: ../../plugindev.rst:112 +msgid "The HTTP method as a string (e.g. ``GET``)." +msgstr "" + +#: ../../plugindev.rst:113 +msgid "callback" +msgstr "" + +#: ../../plugindev.rst:113 +msgid "" +"The original callback with no plugins applied. Useful for introspection." +msgstr "" + +#: ../../plugindev.rst:115 +msgid "name" +msgstr "" + +#: ../../plugindev.rst:115 +msgid "The name of the route (if specified) or ``None``." +msgstr "" + +#: ../../plugindev.rst:116 +msgid "plugins" +msgstr "" + +#: ../../plugindev.rst:116 +msgid "" +"A list of route-specific plugins. These are applied in addition to " +"application-wide plugins. (see :meth:`Bottle.route`)." +msgstr "" + +#: ../../plugindev.rst:118 +msgid "skiplist" +msgstr "" + +#: ../../plugindev.rst:118 +msgid "" +"A list of plugins to not apply to this route (again, see " +":meth:`Bottle.route`)." +msgstr "" + +#: ../../plugindev.rst:120 +msgid "config" +msgstr "" + +#: ../../plugindev.rst:120 +msgid "" +"Additional keyword arguments passed to the :meth:`Bottle.route` decorator " +"are stored in this dictionary. Used for route-specific configuration and " +"meta-data." +msgstr "" + +#: ../../plugindev.rst:125 +msgid "" +"For your plugin, :attr:`Route.config` is probably the most important " +"attribute. Keep in mind that this dictionary is local to the route, but " +"shared between all plugins. It is always a good idea to add a unique prefix " +"or, if your plugin needs a lot of configuration, store it in a separate " +"namespace within the `config` dictionary. This helps to avoid naming " +"collisions between plugins." +msgstr "" + +#: ../../plugindev.rst:129 +msgid "Changing the :class:`Route` object" +msgstr "" + +#: ../../plugindev.rst:131 +msgid "" +"While some :class:`Route` attributes are mutable, changes may have unwanted " +"effects on other plugins. It is most likely a bad idea to monkey-patch a " +"broken route instead of providing a helpful error message and let the user " +"fix the problem." +msgstr "" + +#: ../../plugindev.rst:133 +msgid "" +"In some rare cases, however, it might be justifiable to break this rule. " +"After you made your changes to the :class:`Route` instance, raise " +":exc:`RouteReset` as an exception. This removes the current route from the " +"cache and causes all plugins to be re-applied. The router is not updated, " +"however. Changes to `rule` or `method` values have no effect on the router, " +"but only on plugins. This may change in the future, though." +msgstr "" + +#: ../../plugindev.rst:137 +msgid "Runtime optimizations" +msgstr "" + +#: ../../plugindev.rst:139 +msgid "" +"Once all plugins are applied to a route, the wrapped route callback is " +"cached to speed up subsequent requests. If the behavior of your plugin " +"depends on configuration, and you want to be able to change that " +"configuration at runtime, you need to read the configuration on each " +"request. Easy enough." +msgstr "" + +#: ../../plugindev.rst:141 +msgid "" +"For performance reasons, however, it might be worthwhile to choose a " +"different wrapper based on current needs, work with closures, or enable or " +"disable a plugin at runtime. Let's take the built-in HooksPlugin as an " +"example: If no hooks are installed, the plugin removes itself from all " +"affected routes and has virtually no overhead. As soon as you install the " +"first hook, the plugin activates itself and takes effect again." +msgstr "" + +#: ../../plugindev.rst:143 +msgid "" +"To achieve this, you need control over the callback cache: " +":meth:`Route.reset` clears the cache for a single route and " +":meth:`Bottle.reset` clears all caches for all routes of an application at " +"once. On the next request, all plugins are re-applied to the route as if it " +"were requested for the first time." +msgstr "" + +#: ../../plugindev.rst:145 +msgid "" +"Both methods won't affect the current request if called from within a route " +"callback, of cause. To force a restart of the current request, raise " +":exc:`RouteReset` as an exception." +msgstr "" + +#: ../../plugindev.rst:149 +msgid "Plugin Example: SQLitePlugin" +msgstr "" + +#: ../../plugindev.rst:151 +msgid "" +"This plugin provides an sqlite3 database connection handle as an additional " +"keyword argument to wrapped callbacks, but only if the callback expects it. " +"If not, the route is ignored and no overhead is added. The wrapper does not " +"affect the return value, but handles plugin-related exceptions properly. " +":meth:`Plugin.setup` is used to inspect the application and search for " +"conflicting plugins." +msgstr "" + +#: ../../plugindev.rst:218 +msgid "" +"This plugin is actually useful and very similar to the version bundled with " +"Bottle. Not bad for less than 60 lines of code, don't you think? Here is a " +"usage example::" +msgstr "" + +#: ../../plugindev.rst:239 +msgid "" +"The first route needs a database connection and tells the plugin to create a" +" handle by requesting a ``db`` keyword argument. The second route does not " +"need a database and is therefore ignored by the plugin. The third route does" +" expect a 'db' keyword argument, but explicitly skips the sqlite plugin. " +"This way the argument is not overruled by the plugin and still contains the " +"value of the same-named url argument." +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/plugins/index.po b/docs/_locale/ja_JP/LC_MESSAGES/plugins/index.po new file mode 100644 index 0000000..2e5bc4a --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/plugins/index.po @@ -0,0 +1,241 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../plugins/index.rst:5 +msgid "List of available Plugins" +msgstr "" + +#: ../../plugins/index.rst:7 +msgid "" +"This is a list of third-party plugins that add extend Bottles core " +"functionality or integrate other libraries with the Bottle framework." +msgstr "" + +#: ../../plugins/index.rst:9 +msgid "" +"Have a look at :ref:`plugins` for general questions about plugins " +"(installation, usage). If you plan to develop a new plugin, the " +":doc:`/plugindev` may help you." +msgstr "" + +#: ../../plugins/index.rst:12 +msgid "`Bottle-Beaker <http://pypi.python.org/pypi/bottle-beaker/>`_" +msgstr "" + +#: ../../plugins/index.rst:12 +msgid "Beaker to session and caching library with WSGI Middleware" +msgstr "" + +#: ../../plugins/index.rst:15 +msgid "`Bottle-Cork <http://cork.firelet.net/>`_" +msgstr "" + +#: ../../plugins/index.rst:15 +msgid "" +"Cork provides a simple set of methods to implement Authentication and " +"Authorization in web applications based on Bottle." +msgstr "" + +#: ../../plugins/index.rst:18 +msgid "`Bottle-Cors-plugin <http://pypi.org/project/bottle-cors-plugin/>`_" +msgstr "" + +#: ../../plugins/index.rst:18 +msgid "" +"Cors-plugin is the easiest way to implement cors on your bottle web " +"application" +msgstr "" + +#: ../../plugins/index.rst:21 +msgid "`Bottle-Extras <http://pypi.python.org/pypi/bottle-extras/>`_" +msgstr "" + +#: ../../plugins/index.rst:21 +msgid "Meta package to install the bottle plugin collection." +msgstr "" + +#: ../../plugins/index.rst:24 +msgid "`Bottle-Flash <http://pypi.python.org/pypi/bottle-flash/>`_" +msgstr "" + +#: ../../plugins/index.rst:24 +msgid "flash plugin for bottle" +msgstr "" + +#: ../../plugins/index.rst:27 +msgid "`Bottle-Hotqueue <http://pypi.python.org/pypi/bottle-hotqueue/>`_" +msgstr "" + +#: ../../plugins/index.rst:27 +msgid "FIFO Queue for Bottle built upon redis" +msgstr "" + +#: ../../plugins/index.rst:30 +msgid "`Macaron <http://nobrin.github.com/macaron/webapp.html>`_" +msgstr "" + +#: ../../plugins/index.rst:30 +msgid "Macaron is an object-relational mapper (ORM) for SQLite." +msgstr "" + +#: ../../plugins/index.rst:33 +msgid "`Bottle-Memcache <http://pypi.python.org/pypi/bottle-memcache/>`_" +msgstr "" + +#: ../../plugins/index.rst:33 +msgid "Memcache integration for Bottle." +msgstr "" + +#: ../../plugins/index.rst:36 +msgid "`Bottle-Mongo <http://pypi.python.org/pypi/bottle-mongo/>`_" +msgstr "" + +#: ../../plugins/index.rst:36 +msgid "MongoDB integration for Bottle" +msgstr "" + +#: ../../plugins/index.rst:39 +msgid "`Bottle-OAuthlib <http://pypi.python.org/pypi/bottle-oauthlib/>`_" +msgstr "" + +#: ../../plugins/index.rst:39 +msgid "Adapter for oauthlib - create your own OAuth2.0 implementation" +msgstr "" + +#: ../../plugins/index.rst:42 +msgid "`Bottle-Redis <http://pypi.python.org/pypi/bottle-redis/>`_" +msgstr "" + +#: ../../plugins/index.rst:42 +msgid "Redis integration for Bottle." +msgstr "" + +#: ../../plugins/index.rst:45 +msgid "`Bottle-Renderer <http://pypi.python.org/pypi/bottle-renderer/>`_" +msgstr "" + +#: ../../plugins/index.rst:45 +msgid "Renderer plugin for bottle" +msgstr "" + +#: ../../plugins/index.rst:48 +msgid "`Bottle-Servefiles <http://pypi.python.org/pypi/bottle-servefiles/>`_" +msgstr "" + +#: ../../plugins/index.rst:48 +msgid "A reusable app that serves static files for bottle apps" +msgstr "" + +#: ../../plugins/index.rst:51 +msgid "`Bottle-Sqlalchemy <http://pypi.python.org/pypi/bottle-sqlalchemy/>`_" +msgstr "" + +#: ../../plugins/index.rst:51 +msgid "SQLAlchemy integration for Bottle." +msgstr "" + +#: ../../plugins/index.rst:54 +msgid "`Bottle-Sqlite <http://pypi.python.org/pypi/bottle-sqlite/>`_" +msgstr "" + +#: ../../plugins/index.rst:54 +msgid "SQLite3 database integration for Bottle." +msgstr "" + +#: ../../plugins/index.rst:57 +msgid "`Bottle-Web2pydal <http://pypi.python.org/pypi/bottle-web2pydal/>`_" +msgstr "" + +#: ../../plugins/index.rst:57 +msgid "Web2py Dal integration for Bottle." +msgstr "" + +#: ../../plugins/index.rst:60 +msgid "`Bottle-Werkzeug <http://pypi.python.org/pypi/bottle-werkzeug/>`_" +msgstr "" + +#: ../../plugins/index.rst:60 +msgid "" +"Integrates the `werkzeug` library (alternative request and response objects," +" advanced debugging middleware and more)." +msgstr "" + +#: ../../plugins/index.rst:63 +msgid "" +"`bottle-smart-filters <https://github.com/agile4you/bottle-smart-filters/>`_" +msgstr "" + +#: ../../plugins/index.rst:63 +msgid "Bottle Querystring smart guessing." +msgstr "" + +#: ../../plugins/index.rst:66 +msgid "`bottle-jwt <https://github.com/agile4you/bottle-jwt/>`_" +msgstr "" + +#: ../../plugins/index.rst:66 +msgid "JSON Web Token authentication plugin for bottle.py" +msgstr "" + +#: ../../plugins/index.rst:69 +msgid "`Bottle-jwt <https://github.com/agalera/bottlejwt>`_" +msgstr "" + +#: ../../plugins/index.rst:69 +msgid "JWT integration for bottle" +msgstr "" + +#: ../../plugins/index.rst:72 +msgid "`canister <https://github.com/dagnelies/canister>`_" +msgstr "" + +#: ../../plugins/index.rst:72 +msgid "a bottle wrapper to provide logging, sessions and authentication" +msgstr "" + +#: ../../plugins/index.rst:75 +msgid "`bottle-cerberus <https://github.com/agalera/bottle-cerberus>`_" +msgstr "" + +#: ../../plugins/index.rst:75 +msgid "Cerberus integration for bottle" +msgstr "" + +#: ../../plugins/index.rst:78 +msgid "`Bottle-errorsrest <https://github.com/agalera/bottle-errorsrest>`_" +msgstr "" + +#: ../../plugins/index.rst:78 +msgid "All errors generated from bottle are returned in json" +msgstr "" + +#: ../../plugins/index.rst:82 +msgid "`Bottle-tools <https://github.com/theSage21/bottle-tools>`_" +msgstr "" + +#: ../../plugins/index.rst:81 +msgid "" +"Decorators that auto-supply function arguments using POST/query string data." +msgstr "" + +#: ../../plugins/index.rst:84 +msgid "" +"Plugins listed here are not part of Bottle or the Bottle project, but " +"developed and maintained by third parties." +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/recipes.po b/docs/_locale/ja_JP/LC_MESSAGES/recipes.po new file mode 100644 index 0000000..b603f96 --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/recipes.po @@ -0,0 +1,308 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../recipes.rst:16 +msgid "Recipes" +msgstr "" + +#: ../../recipes.rst:18 +msgid "" +"This is a collection of code snippets and examples for common use cases." +msgstr "" + +#: ../../recipes.rst:21 +msgid "Keeping track of Sessions" +msgstr "" + +#: ../../recipes.rst:23 +msgid "" +"There is no built-in support for sessions because there is no *right* way to" +" do it (in a micro framework). Depending on requirements and environment you" +" could use beaker_ middleware with a fitting backend or implement it " +"yourself. Here is an example for beaker sessions with a file-based backend::" +msgstr "" + +#: ../../recipes.rst:45 +msgid "" +"WARNING: Beaker's SessionMiddleware is not thread safe. If two concurrent " +"requests modify the same session at the same time, one of the updates might " +"get lost. For this reason, sessions should only be populated once and " +"treated as a read-only store after that. If you find yourself updating " +"sessions regularly, and don't want to risk losing any updates, think about " +"using a real database instead or seek alternative session middleware " +"libraries." +msgstr "" + +#: ../../recipes.rst:49 +msgid "Debugging with Style: Debugging Middleware" +msgstr "" + +#: ../../recipes.rst:51 +msgid "" +"Bottle catches all Exceptions raised in your app code to prevent your WSGI " +"server from crashing. If the built-in :func:`debug` mode is not enough and " +"you need exceptions to propagate to a debugging middleware, you can turn off" +" this behaviour::" +msgstr "" + +#: ../../recipes.rst:59 +msgid "" +"Now, bottle only catches its own exceptions (:exc:`HTTPError`, " +":exc:`HTTPResponse` and :exc:`BottleException`) and your middleware can " +"handle the rest." +msgstr "" + +#: ../../recipes.rst:61 +msgid "" +"The werkzeug_ and paste_ libraries both ship with very powerful debugging " +"WSGI middleware. Look at :class:`werkzeug.debug.DebuggedApplication` for " +"werkzeug_ and :class:`paste.evalexception.middleware.EvalException` for " +"paste_. They both allow you do inspect the stack and even execute python " +"code within the stack context, so **do not use them in production**." +msgstr "" + +#: ../../recipes.rst:65 +msgid "Unit-Testing Bottle Applications" +msgstr "" + +#: ../../recipes.rst:67 +msgid "" +"Unit-testing is usually performed against methods defined in your web " +"application without running a WSGI environment." +msgstr "" + +#: ../../recipes.rst:69 +msgid "A simple example using `Nose <http://readthedocs.org/docs/nose>`_::" +msgstr "" + +#: ../../recipes.rst:80 ../../recipes.rst:97 +msgid "Test script::" +msgstr "" + +#: ../../recipes.rst:87 +msgid "" +"In the example the Bottle route() method is never executed - only index() is" +" tested." +msgstr "" + +#: ../../recipes.rst:89 +msgid "" +"If the code being tested requires access to ``bottle.request`` you can mock " +"it using `Boddle <https://github.com/keredson/boddle>`_::" +msgstr "" + +#: ../../recipes.rst:108 +msgid "Functional Testing Bottle Applications" +msgstr "" + +#: ../../recipes.rst:110 +msgid "" +"Any HTTP-based testing system can be used with a running WSGI server, but " +"some testing frameworks work more intimately with WSGI, and provide the " +"ability the call WSGI applications in a controlled environment, with " +"tracebacks and full use of debugging tools. `Testing tools for WSGI " +"<http://www.wsgi.org/en/latest/testing.html>`_ is a good starting point." +msgstr "" + +#: ../../recipes.rst:112 +msgid "" +"Example using `WebTest <http://webtest.pythonpaste.org/>`_ and `Nose " +"<http://readthedocs.org/docs/nose>`_::" +msgstr "" + +#: ../../recipes.rst:132 +msgid "Embedding other WSGI Apps" +msgstr "" + +#: ../../recipes.rst:134 +msgid "" +"This is not the recommend way (you should use a middleware in front of " +"bottle to do this) but you can call other WSGI applications from within your" +" bottle app and let bottle act as a pseudo-middleware. Here is an example::" +msgstr "" + +#: ../../recipes.rst:150 +msgid "" +"Again, this is not the recommend way to implement subprojects. It is only " +"here because many people asked for this and to show how bottle maps to WSGI." +msgstr "" + +#: ../../recipes.rst:154 +msgid "Ignore trailing slashes" +msgstr "" + +#: ../../recipes.rst:156 +msgid "" +"For Bottle, ``/example`` and ``/example/`` are two different routes [1]_. To" +" treat both URLs the same you can add two ``@route`` decorators::" +msgstr "" + +#: ../../recipes.rst:162 +msgid "add a WSGI middleware that strips trailing slashes from all URLs::" +msgstr "" + +#: ../../recipes.rst:175 +msgid "or add a ``before_request`` hook to strip the trailing slashes::" +msgstr "" + +#: ../../recipes.rst:182 +msgid "Footnotes" +msgstr "脚注" + +#: ../../recipes.rst:183 +msgid "Because they are. See <http://www.ietf.org/rfc/rfc3986.txt>" +msgstr "" + +#: ../../recipes.rst:187 +msgid "Keep-alive requests" +msgstr "" + +#: ../../recipes.rst:191 +msgid "For a more detailed explanation, see :doc:`async`." +msgstr "" + +#: ../../recipes.rst:193 +msgid "" +"Several \"push\" mechanisms like XHR multipart need the ability to write " +"response data without closing the connection in conjunction with the " +"response header \"Connection: keep-alive\". WSGI does not easily lend itself" +" to this behavior, but it is still possible to do so in Bottle by using the " +"gevent_ async framework. Here is a sample that works with either the gevent_" +" HTTP server or the paste_ HTTP server (it may work with others, but I have " +"not tried). Just change ``server='gevent'`` to ``server='paste'`` to use the" +" paste_ server::" +msgstr "" + +#: ../../recipes.rst:210 +msgid "" +"If you browse to ``http://localhost:8080/stream``, you should see 'START', " +"'MIDDLE', and 'END' show up one at a time (rather than waiting 8 seconds to " +"see them all at once)." +msgstr "" + +#: ../../recipes.rst:213 +msgid "Gzip Compression in Bottle" +msgstr "" + +#: ../../recipes.rst:216 +msgid "For a detailed discussion, see compression_" +msgstr "" + +#: ../../recipes.rst:218 +msgid "" +"A common feature request is for Bottle to support Gzip compression, which " +"speeds up sites by compressing static resources (like CSS and JS files) " +"during a request." +msgstr "" + +#: ../../recipes.rst:220 +msgid "" +"Supporting Gzip compression is not a straightforward proposition, due to a " +"number of corner cases that crop up frequently. A proper Gzip implementation" +" must:" +msgstr "" + +#: ../../recipes.rst:222 +msgid "Compress on the fly and be fast doing so." +msgstr "" + +#: ../../recipes.rst:223 +msgid "Do not compress for browsers that don't support it." +msgstr "" + +#: ../../recipes.rst:224 +msgid "Do not compress files that are compressed already (images, videos)." +msgstr "" + +#: ../../recipes.rst:225 +msgid "Do not compress dynamic files." +msgstr "" + +#: ../../recipes.rst:226 +msgid "Support two differed compression algorithms (gzip and deflate)." +msgstr "" + +#: ../../recipes.rst:227 +msgid "Cache compressed files that don't change often." +msgstr "" + +#: ../../recipes.rst:228 +msgid "De-validate the cache if one of the files changed anyway." +msgstr "" + +#: ../../recipes.rst:229 +msgid "Make sure the cache does not get to big." +msgstr "" + +#: ../../recipes.rst:230 +msgid "" +"Do not cache small files because a disk seek would take longer than on-the-" +"fly compression." +msgstr "" + +#: ../../recipes.rst:232 +msgid "" +"Because of these requirements, it is the recommendation of the Bottle " +"project that Gzip compression is best handled by the WSGI server Bottle runs" +" on top of. WSGI servers such as cherrypy_ provide a GzipFilter_ middleware " +"that can be used to accomplish this." +msgstr "" + +#: ../../recipes.rst:236 +msgid "Using the hooks plugin" +msgstr "" + +#: ../../recipes.rst:238 +msgid "" +"For example, if you want to allow Cross-Origin Resource Sharing for the " +"content returned by all of your URL, you can use the hook decorator and " +"setup a callback function::" +msgstr "" + +#: ../../recipes.rst:256 +msgid "" +"You can also use the ``before_request`` to take an action before every " +"function gets called." +msgstr "" + +#: ../../recipes.rst:261 +msgid "Using Bottle with Heroku" +msgstr "" + +#: ../../recipes.rst:263 +msgid "" +"Heroku_, a popular cloud application platform now provides support for " +"running Python applications on their infastructure." +msgstr "" + +#: ../../recipes.rst:266 +msgid "" +"This recipe is based upon the `Heroku Quickstart " +"<http://devcenter.heroku.com/articles/quickstart>`_, with Bottle specific " +"code replacing the `Write Your App " +"<http://devcenter.heroku.com/articles/python#write_your_app>`_ section of " +"the `Getting Started with Python on Heroku/Cedar " +"<http://devcenter.heroku.com/articles/python>`_ guide::" +msgstr "" + +#: ../../recipes.rst:282 +msgid "" +"Heroku's app stack passes the port that the application needs to listen on " +"for requests, using the `os.environ` dictionary." +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/routing.po b/docs/_locale/ja_JP/LC_MESSAGES/routing.po new file mode 100644 index 0000000..73e37ea --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/routing.po @@ -0,0 +1,233 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../routing.rst:3 +msgid "Request Routing" +msgstr "" + +#: ../../routing.rst:5 +msgid "" +"Bottle uses a powerful routing engine to find the right callback for each " +"request. The :ref:`tutorial <tutorial-routing>` shows you the basics. This " +"document covers advanced techniques and rule mechanics in detail." +msgstr "" + +#: ../../routing.rst:8 +msgid "Rule Syntax" +msgstr "" + +#: ../../routing.rst:10 +msgid "" +"The :class:`Router` distinguishes between two basic types of routes: " +"**static routes** (e.g. ``/contact``) and **dynamic routes** (e.g. " +"``/hello/<name>``). A route that contains one or more *wildcards* it is " +"considered dynamic. All other routes are static." +msgstr "" + +#: ../../routing.rst:14 +msgid "" +"The simplest form of a wildcard consists of a name enclosed in angle " +"brackets (e.g. ``<name>``). The name should be unique for a given route and " +"form a valid python identifier (alphanumeric, starting with a letter). This " +"is because wildcards are used as keyword arguments for the request callback " +"later." +msgstr "" + +#: ../../routing.rst:16 +msgid "" +"Each wildcard matches one or more characters, but stops at the first slash " +"(``/``). This equals a regular expression of ``[^/]+`` and ensures that only" +" one path segment is matched and routes with more than one wildcard stay " +"unambiguous." +msgstr "" + +#: ../../routing.rst:18 +msgid "The rule ``/<action>/<item>`` matches as follows:" +msgstr "" + +#: ../../routing.rst:21 +msgid "Path" +msgstr "" + +#: ../../routing.rst:21 +msgid "Result" +msgstr "" + +#: ../../routing.rst:23 +msgid "/save/123" +msgstr "" + +#: ../../routing.rst:23 +msgid "``{'action': 'save', 'item': '123'}``" +msgstr "" + +#: ../../routing.rst:24 +msgid "/save/123/" +msgstr "" + +#: ../../routing.rst:24 ../../routing.rst:25 ../../routing.rst:26 +msgid "`No Match`" +msgstr "" + +#: ../../routing.rst:25 +msgid "/save/" +msgstr "" + +#: ../../routing.rst:26 +msgid "//123" +msgstr "" + +#: ../../routing.rst:29 +msgid "" +"Is it possible to escape characters like colon ``:`` with a backslash " +"``\\``. This will prevent to trigger the old syntax in case you need to use " +"``:``. For example: the rule ``/<action>/item:<id>`` triggers the old " +"syntax, (see below) but ``/action/item\\:<id>`` works as intended with the " +"new syntax." +msgstr "" + +#: ../../routing.rst:33 +msgid "" +"You can change the exact behaviour in many ways using filters. This is " +"described in the next section." +msgstr "" + +#: ../../routing.rst:36 +msgid "Wildcard Filters" +msgstr "" + +#: ../../routing.rst:40 +msgid "" +"Filters are used to define more specific wildcards, and/or transform the " +"matched part of the URL before it is passed to the callback. A filtered " +"wildcard is declared as ``<name:filter>`` or ``<name:filter:config>``. The " +"syntax for the optional config part depends on the filter used." +msgstr "" + +#: ../../routing.rst:42 +msgid "The following standard filters are implemented:" +msgstr "" + +#: ../../routing.rst:44 +msgid "**:int** matches (signed) digits and converts the value to integer." +msgstr "" + +#: ../../routing.rst:45 +msgid "**:float** similar to :int but for decimal numbers." +msgstr "" + +#: ../../routing.rst:46 +msgid "" +"**:path** matches all characters including the slash character in a non-" +"greedy way and may be used to match more than one path segment." +msgstr "" + +#: ../../routing.rst:47 +msgid "" +"**:re[:exp]** allows you to specify a custom regular expression in the " +"config field. The matched value is not modified." +msgstr "" + +#: ../../routing.rst:49 +msgid "" +"You can add your own filters to the router. All you need is a function that " +"returns three elements: A regular expression string, a callable to convert " +"the URL fragment to a python value, and a callable that does the opposite. " +"The filter function is called with the configuration string as the only " +"parameter and may parse it as needed::" +msgstr "" + +#: ../../routing.rst:75 +msgid "Legacy Syntax" +msgstr "" + +#: ../../routing.rst:79 +msgid "" +"The new rule syntax was introduce in **Bottle 0.10** to simplify some common" +" use cases, but the old syntax still works and you can find lot code " +"examples still using it. The differences are best described by example:" +msgstr "" + +#: ../../routing.rst:82 +msgid "Old Syntax" +msgstr "" + +#: ../../routing.rst:82 +msgid "New Syntax" +msgstr "" + +#: ../../routing.rst:84 +msgid "``:name``" +msgstr "" + +#: ../../routing.rst:84 +msgid "``<name>``" +msgstr "" + +#: ../../routing.rst:85 +msgid "``:name#regexp#``" +msgstr "" + +#: ../../routing.rst:85 +msgid "``<name:re:regexp>``" +msgstr "" + +#: ../../routing.rst:86 +msgid "``:#regexp#``" +msgstr "" + +#: ../../routing.rst:86 +msgid "``<:re:regexp>``" +msgstr "" + +#: ../../routing.rst:87 +msgid "``:##``" +msgstr "" + +#: ../../routing.rst:87 +msgid "``<:re>``" +msgstr "" + +#: ../../routing.rst:90 +msgid "" +"Try to avoid the old syntax in future projects if you can. It is not " +"currently deprecated, but will be eventually." +msgstr "" + +#: ../../routing.rst:95 +msgid "Explicit routing configuration" +msgstr "" + +#: ../../routing.rst:97 +msgid "" +"Route decorator can also be directly called as method. This way provides " +"flexibility in complex setups, allowing you to directly control, when and " +"how routing configuration done." +msgstr "" + +#: ../../routing.rst:99 +msgid "" +"Here is a basic example of explicit routing configuration for default bottle" +" application::" +msgstr "" + +#: ../../routing.rst:105 +msgid "" +"In fact, any :class:`Bottle` instance routing can be configured same way::" +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/stpl.po b/docs/_locale/ja_JP/LC_MESSAGES/stpl.po new file mode 100644 index 0000000..4fa8dee --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/stpl.po @@ -0,0 +1,271 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../stpl.rst:3 +msgid "SimpleTemplate Engine" +msgstr "" + +#: ../../stpl.rst:7 +msgid "" +"Bottle comes with a fast, powerful and easy to learn built-in template " +"engine called *SimpleTemplate* or *stpl* for short. It is the default engine" +" used by the :func:`view` and :func:`template` helpers but can be used as a " +"stand-alone general purpose template engine too. This document explains the " +"template syntax and shows examples for common use cases." +msgstr "" + +#: ../../stpl.rst:10 +msgid "Basic API Usage:" +msgstr "" + +#: ../../stpl.rst:11 +msgid ":class:`SimpleTemplate` implements the :class:`BaseTemplate` API::" +msgstr "" + +#: ../../stpl.rst:18 +msgid "" +"In this document we use the :func:`template` helper in examples for the sake" +" of simplicity::" +msgstr "" + +#: ../../stpl.rst:24 +msgid "" +"You can also pass a dictionary into the template using keyword arguments::" +msgstr "" + +#: ../../stpl.rst:31 +msgid "" +"Just keep in mind that compiling and rendering templates are two different " +"actions, even if the :func:`template` helper hides this fact. Templates are " +"usually compiled only once and cached internally, but rendered many times " +"with different keyword arguments." +msgstr "" + +#: ../../stpl.rst:34 +msgid ":class:`SimpleTemplate` Syntax" +msgstr "" + +#: ../../stpl.rst:36 +msgid "" +"Python is a very powerful language but its whitespace-aware syntax makes it " +"difficult to use as a template language. SimpleTemplate removes some of " +"these restrictions and allows you to write clean, readable and maintainable " +"templates while preserving full access to the features, libraries and speed " +"of the Python language." +msgstr "" + +#: ../../stpl.rst:40 +msgid "" +"The :class:`SimpleTemplate` syntax compiles directly to python bytecode and " +"is executed on each :meth:`SimpleTemplate.render` call. Do not render " +"untrusted templates! They may contain and execute harmful python code." +msgstr "" + +#: ../../stpl.rst:43 +msgid "Inline Expressions" +msgstr "" + +#: ../../stpl.rst:45 +msgid "" +"You already learned the use of the ``{{...}}`` syntax from the \"Hello " +"World!\" example above, but there is more: any python expression is allowed " +"within the curly brackets as long as it evaluates to a string or something " +"that has a string representation::" +msgstr "" + +#: ../../stpl.rst:54 +msgid "" +"The contained python expression is executed at render-time and has access to" +" all keyword arguments passed to the :meth:`SimpleTemplate.render` method. " +"HTML special characters are escaped automatically to prevent `XSS " +"<http://en.wikipedia.org/wiki/Cross-Site_Scripting>`_ attacks. You can start" +" the expression with an exclamation mark to disable escaping for that " +"expression::" +msgstr "" + +#: ../../stpl.rst:62 +msgid "Embedded python code" +msgstr "" + +#: ../../stpl.rst:66 +msgid "" +"The template engine allows you to embed lines or blocks of python code " +"within your template. Code lines start with ``%`` and code blocks are " +"surrounded by ``<%`` and ``%>`` tokens::" +msgstr "" + +#: ../../stpl.rst:76 +msgid "" +"Embedded python code follows regular python syntax, but with two additional " +"syntax rules:" +msgstr "" + +#: ../../stpl.rst:78 +msgid "" +"**Indentation is ignored.** You can put as much whitespace in front of " +"statements as you want. This allows you to align your code with the " +"surrounding markup and can greatly improve readability." +msgstr "" + +#: ../../stpl.rst:79 +msgid "" +"Blocks that are normally indented now have to be closed explicitly with an " +"``end`` keyword." +msgstr "" + +#: ../../stpl.rst:89 +msgid "" +"Both the ``%`` and the ``<%`` tokens are only recognized if they are the " +"first non-whitespace characters in a line. You don't have to escape them if " +"they appear mid-text in your template markup. Only if a line of text starts " +"with one of these tokens, you have to escape it with a backslash. In the " +"rare case where the backslash + token combination appears in your markup at " +"the beginning of a line, you can always help yourself with a string literal " +"in an inline expression::" +msgstr "" + +#: ../../stpl.rst:96 +msgid "" +"If you find yourself needing to escape a lot, consider using :ref:`custom " +"tokens <stpl-custom-tokens>`." +msgstr "" + +#: ../../stpl.rst:98 +msgid "" +"Note that ``%`` and ``<% %>`` work in *exactly* the same way. The latter is " +"only a convenient way to type less and avoid clutter for longer code " +"segments. This means that in ``<% %>`` blocks, all indented code must be " +"terminated with an ``end``, as in the following example::" +msgstr "" + +#: ../../stpl.rst:114 +msgid "Whitespace Control" +msgstr "" + +#: ../../stpl.rst:116 +msgid "" +"Code blocks and code lines always span the whole line. Whitespace in front " +"of after a code segment is stripped away. You won't see empty lines or " +"dangling whitespace in your template because of embedded code::" +msgstr "" + +#: ../../stpl.rst:124 +msgid "This snippet renders to clean and compact html::" +msgstr "" + +#: ../../stpl.rst:130 +msgid "" +"But embedding code still requires you to start a new line, which may not " +"what you want to see in your rendered template. To skip the newline in front" +" of a code segment, end the text line with a double-backslash::" +msgstr "" + +#: ../../stpl.rst:138 +msgid "This time the rendered template looks like this::" +msgstr "" + +#: ../../stpl.rst:142 +msgid "" +"This only works directly in front of code segments. In all other places you " +"can control the whitespace yourself and don't need any special syntax." +msgstr "" + +#: ../../stpl.rst:145 +msgid "Template Functions" +msgstr "" + +#: ../../stpl.rst:147 +msgid "" +"Each template is preloaded with a bunch of functions that help with the most" +" common use cases. These functions are always available. You don't have to " +"import or provide them yourself. For everything not covered here there are " +"probably good python libraries available. Remember that you can ``import`` " +"anything you want within your templates. They are python programs after all." +msgstr "" + +#: ../../stpl.rst:151 +msgid "" +"Prior to this release, :func:`include` and :func:`rebase` were syntax " +"keywords, not functions." +msgstr "" + +#: ../../stpl.rst:156 +msgid "" +"Render a sub-template with the specified variables and insert the resulting " +"text into the current template. The function returns a dictionary containing" +" the local variables passed to or defined within the sub-template::" +msgstr "" + +#: ../../stpl.rst:164 +msgid "" +"Mark the current template to be later included into a different template. " +"After the current template is rendered, its resulting text is stored in a " +"variable named ``base`` and passed to the base-template, which is then " +"rendered. This can be used to `wrap` a template with surrounding text, or " +"simulate the inheritance feature found in other template engines::" +msgstr "" + +#: ../../stpl.rst:169 +msgid "This can be combined with the following ``base.tpl``::" +msgstr "" + +#: ../../stpl.rst:181 +msgid "" +"Accessing undefined variables in a template raises :exc:`NameError` and " +"stops rendering immediately. This is standard python behavior and nothing " +"new, but vanilla python lacks an easy way to check the availability of a " +"variable. This quickly gets annoying if you want to support flexible inputs " +"or use the same template in different situations. These functions may help:" +msgstr "" + +#: ../../stpl.rst:189 +msgid "" +"Return True if the variable is defined in the current template namespace, " +"False otherwise." +msgstr "" + +#: ../../stpl.rst:194 +msgid "Return the variable, or a default value." +msgstr "" + +#: ../../stpl.rst:198 +msgid "" +"If the variable is not defined, create it with the given default value. " +"Return the variable." +msgstr "" + +#: ../../stpl.rst:201 +msgid "" +"Here is an example that uses all three functions to implement optional " +"template variables in different ways::" +msgstr "" + +#: ../../stpl.rst:215 +msgid ":class:`SimpleTemplate` API" +msgstr "" + +#: ../../../bottle.pydocstring of bottle.SimpleTemplate.prepare:1 +msgid "" +"Run preparations (parsing, caching, ...). It should be possible to call this" +" again to refresh a template or to update settings." +msgstr "" + +#: ../../../bottle.pydocstring of bottle.SimpleTemplate.render:1 +msgid "Render the template using keyword arguments as local variables." +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/tutorial.po b/docs/_locale/ja_JP/LC_MESSAGES/tutorial.po new file mode 100644 index 0000000..4572ba4 --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/tutorial.po @@ -0,0 +1,1461 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +# Manabu Shimohira <mshimohi@gmail.com>, 2017 +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../tutorial.rst:24 +msgid "Tutorial" +msgstr "チュートリアル" + +#: ../../tutorial.rst:26 +msgid "" +"This tutorial introduces you to the concepts and features of the Bottle web " +"framework and covers basic and advanced topics alike. You can read it from " +"start to end, or use it as a reference later on. The automatically generated" +" :doc:`api` may be interesting for you, too. It covers more details, but " +"explains less than this tutorial. Solutions for the most common questions " +"can be found in our :doc:`recipes` collection or on the :doc:`faq` page. If " +"you need any help, join our `mailing list " +"<mailto:bottlepy@googlegroups.com>`_ or visit us in our `IRC channel " +"<http://webchat.freenode.net/?channels=bottlepy>`_." +msgstr "このチュートリアルでは、Bottle Webフレームワークの概念と機能を、基礎から上級までカバーして紹介します。最初から最後まで読み通すのもいいでしょうし、リファレンスとしてあとで参照するのも良いでしょう。自動的に生成される :doc: 'api' も興味を引くことでしょう。そこには詳細について述べられていますが、このチュートリアルよりも説明は多くは述べられていません。一般的に共通した質問についての答えは :doc:`recipes` コレクションか :doc:`faq` ページで見つけることができます。なんらかの助けが必要な場合には <mailto:bottlepy@googlegroups.com>`_ のメーリングリストに参加するか、<http://webchat.freenode.net/?channels=bottlepy>`_のIRCチャネルを訪問してください。" + +#: ../../tutorial.rst:31 +msgid "Installation" +msgstr "インストール" + +#: ../../tutorial.rst:33 +msgid "" +"Bottle does not depend on any external libraries. You can just download " +"`bottle.py </bottle.py>`_ into your project directory and start coding:" +msgstr "Bottleはどの外部ライブラリーにも依存していません。 `bottle.py </bottle.py>`_ をコンピューターにダウンロードすればコーディングを始めることができます。" + +#: ../../tutorial.rst:39 +msgid "" +"This will get you the latest development snapshot that includes all the new " +"features. If you prefer a more stable environment, you should stick with the" +" stable releases. These are available on `PyPI " +"<http://pypi.python.org/pypi/bottle>`_ and can be installed via " +":command:`pip` (recommended), :command:`easy_install` or your package " +"manager:" +msgstr "これにより全ての新機能が含まれた最新の開発スナップショットを入手することが可能になります。より安定した環境を希望する場合には、安定リリースを選択してください。これらは :command:`pip` (推奨), :command:`easy_install` を実行することで`PyPI <http://pypi.python.org/pypi/bottle>`_やその他のパッケージ管理ツールから入手することができます。" + +#: ../../tutorial.rst:47 +msgid "" +"Either way, you'll need Python 2.7 or newer (including 3.4+) to run bottle " +"applications. If you do not have permissions to install packages system-wide" +" or simply don't want to, create a `virtualenv " +"<http://pypi.python.org/pypi/virtualenv>`_ first:" +msgstr "" + +#: ../../tutorial.rst:55 +msgid "Or, if virtualenv is not installed on your system:" +msgstr "" + +#: ../../tutorial.rst:67 +msgid "Quickstart: \"Hello World\"" +msgstr "" + +#: ../../tutorial.rst:69 +msgid "" +"This tutorial assumes you have Bottle either :ref:`installed <installation>`" +" or copied into your project directory. Let's start with a very basic " +"\"Hello World\" example::" +msgstr "" + +#: ../../tutorial.rst:79 +msgid "" +"This is it. Run this script, visit http://localhost:8080/hello and you will " +"see \"Hello World!\" in your browser. Here is how it works:" +msgstr "" + +#: ../../tutorial.rst:81 +msgid "" +"The :func:`route` decorator binds a piece of code to an URL path. In this " +"case, we link the ``/hello`` path to the ``hello()`` function. This is " +"called a `route` (hence the decorator name) and is the most important " +"concept of this framework. You can define as many routes as you want. " +"Whenever a browser requests a URL, the associated function is called and the" +" return value is sent back to the browser. It's as simple as that." +msgstr "" + +#: ../../tutorial.rst:83 +msgid "" +"The :func:`run` call in the last line starts a built-in development server. " +"It runs on ``localhost`` port ``8080`` and serves requests until you hit " +":kbd:`Control-c`. You can switch the server backend later, but for now a " +"development server is all we need. It requires no setup at all and is an " +"incredibly painless way to get your application up and running for local " +"tests." +msgstr "" + +#: ../../tutorial.rst:85 +msgid "" +"The :ref:`tutorial-debugging` is very helpful during early development, but " +"should be switched off for public applications. Keep that in mind." +msgstr "" + +#: ../../tutorial.rst:87 +msgid "" +"This is just a demonstration of the basic concept of how applications are " +"built with Bottle. Continue reading and you'll see what else is possible." +msgstr "" + +#: ../../tutorial.rst:92 +msgid "The Default Application" +msgstr "" + +#: ../../tutorial.rst:94 +msgid "" +"For the sake of simplicity, most examples in this tutorial use a module-" +"level :func:`route` decorator to define routes. This adds routes to a global" +" \"default application\", an instance of :class:`Bottle` that is " +"automatically created the first time you call :func:`route`. Several other " +"module-level decorators and functions relate to this default application, " +"but if you prefer a more object oriented approach and don't mind the extra " +"typing, you can create a separate application object and use that instead of" +" the global one::" +msgstr "" + +#: ../../tutorial.rst:106 +msgid "" +"The object-oriented approach is further described in the :ref:`default-app` " +"section. Just keep in mind that you have a choice." +msgstr "" + +#: ../../tutorial.rst:114 +msgid "Request Routing" +msgstr "" + +#: ../../tutorial.rst:116 +msgid "" +"In the last chapter we built a very simple web application with only a " +"single route. Here is the routing part of the \"Hello World\" example " +"again::" +msgstr "" + +#: ../../tutorial.rst:122 +msgid "" +"The :func:`route` decorator links an URL path to a callback function, and " +"adds a new route to the :ref:`default application <tutorial-default>`. An " +"application with just one route is kind of boring, though. Let's add some " +"more (don't forget ``from bottle import template``)::" +msgstr "" + +#: ../../tutorial.rst:129 +msgid "" +"This example demonstrates two things: You can bind more than one route to a " +"single callback, and you can add wildcards to URLs and access them via " +"keyword arguments." +msgstr "" + +#: ../../tutorial.rst:136 +msgid "Dynamic Routes" +msgstr "" + +#: ../../tutorial.rst:138 +msgid "" +"Routes that contain wildcards are called `dynamic routes` (as opposed to " +"`static routes`) and match more than one URL at the same time. A simple " +"wildcard consists of a name enclosed in angle brackets (e.g. ``<name>``) and" +" accepts one or more characters up to the next slash (``/``). For example, " +"the route ``/hello/<name>`` accepts requests for ``/hello/alice`` as well as" +" ``/hello/bob``, but not for ``/hello``, ``/hello/`` or ``/hello/mr/smith``." +msgstr "" + +#: ../../tutorial.rst:140 +msgid "" +"Each wildcard passes the covered part of the URL as a keyword argument to " +"the request callback. You can use them right away and implement RESTful, " +"nice-looking and meaningful URLs with ease. Here are some other examples " +"along with the URLs they'd match::" +msgstr "" + +#: ../../tutorial.rst:150 +msgid "" +"Filters can be used to define more specific wildcards, and/or transform the " +"covered part of the URL before it is passed to the callback. A filtered " +"wildcard is declared as ``<name:filter>`` or ``<name:filter:config>``. The " +"syntax for the optional config part depends on the filter used." +msgstr "" + +#: ../../tutorial.rst:152 +msgid "" +"The following filters are implemented by default and more may be added:" +msgstr "" + +#: ../../tutorial.rst:154 +msgid "" +"**:int** matches (signed) digits only and converts the value to integer." +msgstr "" + +#: ../../tutorial.rst:155 +msgid "**:float** similar to :int but for decimal numbers." +msgstr "" + +#: ../../tutorial.rst:156 +msgid "" +"**:path** matches all characters including the slash character in a non-" +"greedy way and can be used to match more than one path segment." +msgstr "" + +#: ../../tutorial.rst:157 +msgid "" +"**:re** allows you to specify a custom regular expression in the config " +"field. The matched value is not modified." +msgstr "" + +#: ../../tutorial.rst:159 +msgid "Let's have a look at some practical examples::" +msgstr "" + +#: ../../tutorial.rst:173 +msgid "You can add your own filters as well. See :doc:`routing` for details." +msgstr "" + +#: ../../tutorial.rst:177 +msgid "HTTP Request Methods" +msgstr "" + +#: ../../tutorial.rst:181 +msgid "" +"The HTTP protocol defines several `request methods`__ (sometimes referred to" +" as \"verbs\") for different tasks. GET is the default for all routes with " +"no other method specified. These routes will match GET requests only. To " +"handle other methods such as POST, PUT, DELETE or PATCH, add a ``method`` " +"keyword argument to the :func:`route` decorator or use one of the five " +"alternative decorators: :func:`get`, :func:`post`, :func:`put`, " +":func:`delete` or :func:`patch`." +msgstr "" + +#: ../../tutorial.rst:183 +msgid "" +"The POST method is commonly used for HTML form submission. This example " +"shows how to handle a login form using POST::" +msgstr "" + +#: ../../tutorial.rst:206 +msgid "" +"In this example the ``/login`` URL is linked to two distinct callbacks, one " +"for GET requests and another for POST requests. The first one displays a " +"HTML form to the user. The second callback is invoked on a form submission " +"and checks the login credentials the user entered into the form. The use of " +":attr:`Request.forms` is further described in the :ref:`tutorial-request` " +"section." +msgstr "" + +#: ../../tutorial.rst:209 +msgid "Special Methods: HEAD and ANY" +msgstr "" + +#: ../../tutorial.rst:210 +msgid "" +"The HEAD method is used to ask for the response identical to the one that " +"would correspond to a GET request, but without the response body. This is " +"useful for retrieving meta-information about a resource without having to " +"download the entire document. Bottle handles these requests automatically by" +" falling back to the corresponding GET route and cutting off the request " +"body, if present. You don't have to specify any HEAD routes yourself." +msgstr "" + +#: ../../tutorial.rst:212 +msgid "" +"Additionally, the non-standard ANY method works as a low priority fallback: " +"Routes that listen to ANY will match requests regardless of their HTTP " +"method but only if no other more specific route is defined. This is helpful " +"for *proxy-routes* that redirect requests to more specific sub-applications." +msgstr "" + +#: ../../tutorial.rst:214 +msgid "" +"To sum it up: HEAD requests fall back to GET routes and all requests fall " +"back to ANY routes, but only if there is no matching route for the original " +"request method. It's as simple as that." +msgstr "" + +#: ../../tutorial.rst:219 +msgid "Routing Static Files" +msgstr "" + +#: ../../tutorial.rst:221 +msgid "" +"Static files such as images or CSS files are not served automatically. You " +"have to add a route and a callback to control which files get served and " +"where to find them::" +msgstr "" + +#: ../../tutorial.rst:228 +msgid "" +"The :func:`static_file` function is a helper to serve files in a safe and " +"convenient way (see :ref:`tutorial-static-files`). This example is limited " +"to files directly within the ``/path/to/your/static/files`` directory " +"because the ``<filename>`` wildcard won't match a path with a slash in it. " +"To serve files in subdirectories, change the wildcard to use the `path` " +"filter::" +msgstr "" + +#: ../../tutorial.rst:234 +msgid "" +"Be careful when specifying a relative root-path such as " +"``root='./static/files'``. The working directory (``./``) and the project " +"directory are not always the same." +msgstr "" + +#: ../../tutorial.rst:242 +msgid "Error Pages" +msgstr "" + +#: ../../tutorial.rst:244 +msgid "" +"If anything goes wrong, Bottle displays an informative but fairly plain " +"error page. You can override the default for a specific HTTP status code " +"with the :func:`error` decorator::" +msgstr "" + +#: ../../tutorial.rst:251 +msgid "" +"From now on, `404 File not Found` errors will display a custom error page to" +" the user. The only parameter passed to the error-handler is an instance of " +":exc:`HTTPError`. Apart from that, an error-handler is quite similar to a " +"regular request callback. You can read from :data:`request`, write to " +":data:`response` and return any supported data-type except for " +":exc:`HTTPError` instances." +msgstr "" + +#: ../../tutorial.rst:253 +msgid "" +"Error handlers are used only if your application returns or raises an " +":exc:`HTTPError` exception (:func:`abort` does just that). Changing " +":attr:`Request.status` or returning :exc:`HTTPResponse` won't trigger the " +"error handler." +msgstr "" + +#: ../../tutorial.rst:263 +msgid "Generating content" +msgstr "" + +#: ../../tutorial.rst:265 +msgid "" +"In pure WSGI, the range of types you may return from your application is " +"very limited. Applications must return an iterable yielding byte strings. " +"You may return a string (because strings are iterable) but this causes most " +"servers to transmit your content char by char. Unicode strings are not " +"allowed at all. This is not very practical." +msgstr "" + +#: ../../tutorial.rst:267 +msgid "" +"Bottle is much more flexible and supports a wide range of types. It even " +"adds a ``Content-Length`` header if possible and encodes unicode " +"automatically, so you don't have to. What follows is a list of data types " +"you may return from your application callbacks and a short description of " +"how these are handled by the framework:" +msgstr "" + +#: ../../tutorial.rst:270 +msgid "Dictionaries" +msgstr "" + +#: ../../tutorial.rst:270 +msgid "" +"As mentioned above, Python dictionaries (or subclasses thereof) are " +"automatically transformed into JSON strings and returned to the browser with" +" the ``Content-Type`` header set to ``application/json``. This makes it easy" +" to implement json-based APIs. Data formats other than json are supported " +"too. See the :ref:`tutorial-output-filter` to learn more." +msgstr "" + +#: ../../tutorial.rst:273 +msgid "Empty Strings, ``False``, ``None`` or other non-true values:" +msgstr "" + +#: ../../tutorial.rst:273 +msgid "" +"These produce an empty output with the ``Content-Length`` header set to 0." +msgstr "" + +#: ../../tutorial.rst:276 +msgid "Unicode strings" +msgstr "" + +#: ../../tutorial.rst:276 +msgid "" +"Unicode strings (or iterables yielding unicode strings) are automatically " +"encoded with the codec specified in the ``Content-Type`` header (utf8 by " +"default) and then treated as normal byte strings (see below)." +msgstr "" + +#: ../../tutorial.rst:279 +msgid "Byte strings" +msgstr "" + +#: ../../tutorial.rst:279 +msgid "" +"Bottle returns strings as a whole (instead of iterating over each char) and " +"adds a ``Content-Length`` header based on the string length. Lists of byte " +"strings are joined first. Other iterables yielding byte strings are not " +"joined because they may grow too big to fit into memory. The ``Content-" +"Length`` header is not set in this case." +msgstr "" + +#: ../../tutorial.rst:282 +msgid "Instances of :exc:`HTTPError` or :exc:`HTTPResponse`" +msgstr "" + +#: ../../tutorial.rst:282 +msgid "" +"Returning these has the same effect as when raising them as an exception. In" +" case of an :exc:`HTTPError`, the error handler is applied. See :ref" +":`tutorial-errorhandling` for details." +msgstr "" + +#: ../../tutorial.rst:285 +msgid "File objects" +msgstr "" + +#: ../../tutorial.rst:285 +msgid "" +"Everything that has a ``.read()`` method is treated as a file or file-like " +"object and passed to the ``wsgi.file_wrapper`` callable defined by the WSGI " +"server framework. Some WSGI server implementations can make use of optimized" +" system calls (sendfile) to transmit files more efficiently. In other cases " +"this just iterates over chunks that fit into memory. Optional headers such " +"as ``Content-Length`` or ``Content-Type`` are *not* set automatically. Use " +":func:`send_file` if possible. See :ref:`tutorial-static-files` for details." +msgstr "" + +#: ../../tutorial.rst:288 +msgid "Iterables and generators" +msgstr "" + +#: ../../tutorial.rst:288 +msgid "" +"You are allowed to use ``yield`` within your callbacks or return an " +"iterable, as long as the iterable yields byte strings, unicode strings, " +":exc:`HTTPError` or :exc:`HTTPResponse` instances. Nested iterables are not " +"supported, sorry. Please note that the HTTP status code and the headers are " +"sent to the browser as soon as the iterable yields its first non-empty " +"value. Changing these later has no effect." +msgstr "" + +#: ../../tutorial.rst:290 +msgid "" +"The ordering of this list is significant. You may for example return a " +"subclass of :class:`str` with a ``read()`` method. It is still treated as a " +"string instead of a file, because strings are handled first." +msgstr "" + +#: ../../tutorial.rst:293 +msgid "Changing the Default Encoding" +msgstr "" + +#: ../../tutorial.rst:294 +msgid "" +"Bottle uses the `charset` parameter of the ``Content-Type`` header to decide" +" how to encode unicode strings. This header defaults to ``text/html; " +"charset=UTF8`` and can be changed using the :attr:`Response.content_type` " +"attribute or by setting the :attr:`Response.charset` attribute directly. " +"(The :class:`Response` object is described in the section :ref:`tutorial-" +"response`.)" +msgstr "" + +#: ../../tutorial.rst:309 +msgid "" +"In some rare cases the Python encoding names differ from the names supported" +" by the HTTP specification. Then, you have to do both: first set the " +":attr:`Response.content_type` header (which is sent to the client unchanged)" +" and then set the :attr:`Response.charset` attribute (which is used to " +"encode unicode)." +msgstr "" + +#: ../../tutorial.rst:314 +msgid "Static Files" +msgstr "" + +#: ../../tutorial.rst:316 +msgid "" +"You can directly return file objects, but :func:`static_file` is the " +"recommended way to serve static files. It automatically guesses a mime-type," +" adds a ``Last-Modified`` header, restricts paths to a ``root`` directory " +"for security reasons and generates appropriate error responses (403 on " +"permission errors, 404 on missing files). It even supports the ``If-" +"Modified-Since`` header and eventually generates a ``304 Not Modified`` " +"response. You can pass a custom MIME type to disable guessing." +msgstr "" + +#: ../../tutorial.rst:329 +msgid "" +"You can raise the return value of :func:`static_file` as an exception if you" +" really need to." +msgstr "" + +#: ../../tutorial.rst:332 +msgid "Forced Download" +msgstr "" + +#: ../../tutorial.rst:333 +msgid "" +"Most browsers try to open downloaded files if the MIME type is known and " +"assigned to an application (e.g. PDF files). If this is not what you want, " +"you can force a download dialog and even suggest a filename to the user::" +msgstr "" + +#: ../../tutorial.rst:339 +msgid "" +"If the ``download`` parameter is just ``True``, the original filename is " +"used." +msgstr "" + +#: ../../tutorial.rst:344 +msgid "HTTP Errors and Redirects" +msgstr "" + +#: ../../tutorial.rst:346 +msgid "" +"The :func:`abort` function is a shortcut for generating HTTP error pages." +msgstr "" + +#: ../../tutorial.rst:355 +msgid "" +"To redirect a client to a different URL, you can send a ``303 See Other`` " +"response with the ``Location`` header set to the new URL. :func:`redirect` " +"does that for you::" +msgstr "" + +#: ../../tutorial.rst:362 +msgid "You may provide a different HTTP status code as a second parameter." +msgstr "" + +#: ../../tutorial.rst:365 +msgid "" +"Both functions will interrupt your callback code by raising an " +":exc:`HTTPResponse` exception." +msgstr "" + +#: ../../tutorial.rst:368 +msgid "Other Exceptions" +msgstr "" + +#: ../../tutorial.rst:369 +msgid "" +"All exceptions other than :exc:`HTTPResponse` or :exc:`HTTPError` will " +"result in a ``500 Internal Server Error`` response, so they won't crash your" +" WSGI server. You can turn off this behavior to handle exceptions in your " +"middleware by setting ``bottle.app().catchall`` to ``False``." +msgstr "" + +#: ../../tutorial.rst:375 +msgid "The :class:`Response` Object" +msgstr "" + +#: ../../tutorial.rst:377 +msgid "" +"Response metadata such as the HTTP status code, response headers and cookies" +" are stored in an object called :data:`response` up to the point where they " +"are transmitted to the browser. You can manipulate these metadata directly " +"or use the predefined helper methods to do so. The full API and feature list" +" is described in the API section (see :class:`Response`), but the most " +"common use cases and features are covered here, too." +msgstr "" + +#: ../../tutorial.rst:380 +msgid "Status Code" +msgstr "" + +#: ../../tutorial.rst:381 +msgid "" +"The `HTTP status code <http_code>`_ controls the behavior of the browser and" +" defaults to ``200 OK``. In most scenarios you won't need to set the " +":attr:`Response.status` attribute manually, but use the :func:`abort` helper" +" or return an :exc:`HTTPResponse` instance with the appropriate status code." +" Any integer is allowed, but codes other than the ones defined by the `HTTP " +"specification <http_code>`_ will only confuse the browser and break " +"standards." +msgstr "" + +#: ../../tutorial.rst:384 +msgid "Response Header" +msgstr "" + +#: ../../tutorial.rst:385 +msgid "" +"Response headers such as ``Cache-Control`` or ``Location`` are defined via " +":meth:`Response.set_header`. This method takes two parameters, a header name" +" and a value. The name part is case-insensitive::" +msgstr "" + +#: ../../tutorial.rst:392 +msgid "" +"Most headers are unique, meaning that only one header per name is send to " +"the client. Some special headers however are allowed to appear more than " +"once in a response. To add an additional header, use " +":meth:`Response.add_header` instead of :meth:`Response.set_header`::" +msgstr "" + +#: ../../tutorial.rst:397 +msgid "" +"Please note that this is just an example. If you want to work with cookies, " +"read :ref:`ahead <tutorial-cookies>`." +msgstr "" + +#: ../../tutorial.rst:403 ../../tutorial.rst:533 +msgid "Cookies" +msgstr "" + +#: ../../tutorial.rst:405 +msgid "" +"A cookie is a named piece of text stored in the user's browser profile. You " +"can access previously defined cookies via :meth:`Request.get_cookie` and set" +" new cookies with :meth:`Response.set_cookie`::" +msgstr "" + +#: ../../tutorial.rst:415 +msgid "" +"The :meth:`Response.set_cookie` method accepts a number of additional " +"keyword arguments that control the cookies lifetime and behavior. Some of " +"the most common settings are described here:" +msgstr "" + +#: ../../tutorial.rst:417 +msgid "**max_age:** Maximum age in seconds. (default: ``None``)" +msgstr "" + +#: ../../tutorial.rst:418 +msgid "" +"**expires:** A datetime object or UNIX timestamp. (default: ``None``)" +msgstr "" + +#: ../../tutorial.rst:419 +msgid "" +"**domain:** The domain that is allowed to read the cookie. (default: " +"current domain)" +msgstr "" + +#: ../../tutorial.rst:420 +msgid "**path:** Limit the cookie to a given path (default: ``/``)" +msgstr "" + +#: ../../tutorial.rst:421 +msgid "**secure:** Limit the cookie to HTTPS connections (default: off)." +msgstr "" + +#: ../../tutorial.rst:422 +msgid "" +"**httponly:** Prevent client-side javascript to read this cookie (default:" +" off, requires Python 2.7 or newer)." +msgstr "" + +#: ../../tutorial.rst:423 +msgid "" +"**same_site:** Disables third-party use for a cookie. Allowed attributes: " +"`lax` and `strict`. In strict mode the cookie will never be sent. In lax " +"mode the cookie is only sent with a top-level GET request." +msgstr "" + +#: ../../tutorial.rst:425 +msgid "" +"If neither `expires` nor `max_age` is set, the cookie expires at the end of " +"the browser session or as soon as the browser window is closed. There are " +"some other gotchas you should consider when using cookies:" +msgstr "" + +#: ../../tutorial.rst:427 +msgid "Cookies are limited to 4 KB of text in most browsers." +msgstr "" + +#: ../../tutorial.rst:428 +msgid "" +"Some users configure their browsers to not accept cookies at all. Most " +"search engines ignore cookies too. Make sure that your application still " +"works without cookies." +msgstr "" + +#: ../../tutorial.rst:429 +msgid "" +"Cookies are stored at client side and are not encrypted in any way. Whatever" +" you store in a cookie, the user can read it. Worse than that, an attacker " +"might be able to steal a user's cookies through `XSS " +"<http://en.wikipedia.org/wiki/HTTP_cookie#Cookie_theft_and_session_hijacking>`_" +" vulnerabilities on your side. Some viruses are known to read the browser " +"cookies, too. Thus, never store confidential information in cookies." +msgstr "" + +#: ../../tutorial.rst:430 +msgid "Cookies are easily forged by malicious clients. Do not trust cookies." +msgstr "" + +#: ../../tutorial.rst:435 +msgid "Signed Cookies" +msgstr "" + +#: ../../tutorial.rst:436 +msgid "" +"As mentioned above, cookies are easily forged by malicious clients. Bottle " +"can cryptographically sign your cookies to prevent this kind of " +"manipulation. All you have to do is to provide a signature key via the " +"`secret` keyword argument whenever you read or set a cookie and keep that " +"key a secret. As a result, :meth:`Request.get_cookie` will return ``None`` " +"if the cookie is not signed or the signature keys don't match::" +msgstr "" + +#: ../../tutorial.rst:456 +msgid "" +"In addition, Bottle automatically pickles and unpickles any data stored to " +"signed cookies. This allows you to store any pickle-able object (not only " +"strings) to cookies, as long as the pickled data does not exceed the 4 KB " +"limit." +msgstr "" + +#: ../../tutorial.rst:458 +msgid "" +"Signed cookies are not encrypted (the client can still see the content) and " +"not copy-protected (the client can restore an old cookie). The main " +"intention is to make pickling and unpickling safe and prevent manipulation, " +"not to store secret information at client side." +msgstr "" + +#: ../../tutorial.rst:471 +msgid "Request Data" +msgstr "" + +#: ../../tutorial.rst:473 +msgid "" +"Cookies, HTTP header, HTML ``<form>`` fields and other request data is " +"available through the global :data:`request` object. This special object " +"always refers to the *current* request, even in multi-threaded environments " +"where multiple client connections are handled at the same time::" +msgstr "" + +#: ../../tutorial.rst:482 +msgid "" +"The :data:`request` object is a subclass of :class:`BaseRequest` and has a " +"very rich API to access data. We only cover the most commonly used features " +"here, but it should be enough to get started." +msgstr "" + +#: ../../tutorial.rst:487 +msgid "Introducing :class:`FormsDict`" +msgstr "" + +#: ../../tutorial.rst:489 +msgid "" +"Bottle uses a special type of dictionary to store form data and cookies. " +":class:`FormsDict` behaves like a normal dictionary, but has some additional" +" features to make your life easier." +msgstr "" + +#: ../../tutorial.rst:491 +msgid "" +"**Attribute access**: All values in the dictionary are also accessible as " +"attributes. These virtual attributes return unicode strings, even if the " +"value is missing or unicode decoding fails. In that case, the string is " +"empty, but still present::" +msgstr "" + +#: ../../tutorial.rst:506 +msgid "" +"**Multiple values per key:** :class:`FormsDict` is a subclass of " +":class:`MultiDict` and can store more than one value per key. The standard " +"dictionary access methods will only return a single value, but the " +":meth:`~MultiDict.getall` method returns a (possibly empty) list of all " +"values for a specific key::" +msgstr "" + +#: ../../tutorial.rst:511 +msgid "" +"**WTForms support:** Some libraries (e.g. `WTForms " +"<http://wtforms.simplecodes.com/>`_) want all-unicode dictionaries as input." +" :meth:`FormsDict.decode` does that for you. It decodes all values and " +"returns a copy of itself, while preserving multiple values per key and all " +"the other features." +msgstr "" + +#: ../../tutorial.rst:515 +msgid "" +"In **Python 2** all keys and values are byte-strings. If you need unicode, " +"you can call :meth:`FormsDict.getunicode` or fetch values via attribute " +"access. Both methods try to decode the string (default: utf8) and return an " +"empty string if that fails. No need to catch :exc:`UnicodeError`::" +msgstr "" + +#: ../../tutorial.rst:522 +msgid "" +"In **Python 3** all strings are unicode, but HTTP is a byte-based wire " +"protocol. The server has to decode the byte strings somehow before they are " +"passed to the application. To be on the safe side, WSGI suggests ISO-8859-1 " +"(aka latin1), a reversible single-byte codec that can be re-encoded with a " +"different encoding later. Bottle does that for :meth:`FormsDict.getunicode` " +"and attribute access, but not for the dict-access methods. These return the " +"unchanged values as provided by the server implementation, which is probably" +" not what you want." +msgstr "" + +#: ../../tutorial.rst:529 +msgid "" +"If you need the whole dictionary with correctly decoded values (e.g. for " +"WTForms), you can call :meth:`FormsDict.decode` to get a re-encoded copy." +msgstr "" + +#: ../../tutorial.rst:535 +msgid "" +"Cookies are small pieces of text stored in the clients browser and sent back" +" to the server with each request. They are useful to keep some state around " +"for more than one request (HTTP itself is stateless), but should not be used" +" for security related stuff. They can be easily forged by the client." +msgstr "" + +#: ../../tutorial.rst:537 +msgid "" +"All cookies sent by the client are available through " +":attr:`BaseRequest.cookies` (a :class:`FormsDict`). This example shows a " +"simple cookie-based view counter::" +msgstr "" + +#: ../../tutorial.rst:547 +msgid "" +"The :meth:`BaseRequest.get_cookie` method is a different way do access " +"cookies. It supports decoding :ref:`signed cookies <tutorial-signed-" +"cookies>` as described in a separate section." +msgstr "" + +#: ../../tutorial.rst:550 +msgid "HTTP Headers" +msgstr "" + +#: ../../tutorial.rst:552 +msgid "" +"All HTTP headers sent by the client (e.g. ``Referer``, ``Agent`` or " +"``Accept-Language``) are stored in a :class:`WSGIHeaderDict` and accessible " +"through the :attr:`BaseRequest.headers` attribute. A :class:`WSGIHeaderDict`" +" is basically a dictionary with case-insensitive keys::" +msgstr "" + +#: ../../tutorial.rst:564 +msgid "Query Variables" +msgstr "" + +#: ../../tutorial.rst:566 +msgid "" +"The query string (as in ``/forum?id=1&page=5``) is commonly used to transmit" +" a small number of key/value pairs to the server. You can use the " +":attr:`BaseRequest.query` attribute (a :class:`FormsDict`) to access these " +"values and the :attr:`BaseRequest.query_string` attribute to get the whole " +"string." +msgstr "" + +#: ../../tutorial.rst:579 +msgid "HTML `<form>` Handling" +msgstr "" + +#: ../../tutorial.rst:581 +msgid "" +"Let us start from the beginning. In HTML, a typical ``<form>`` looks " +"something like this:" +msgstr "" + +#: ../../tutorial.rst:591 +msgid "" +"The ``action`` attribute specifies the URL that will receive the form data. " +"``method`` defines the HTTP method to use (``GET`` or ``POST``). With " +"``method=\"get\"`` the form values are appended to the URL and available " +"through :attr:`BaseRequest.query` as described above. This is considered " +"insecure and has other limitations, so we use ``method=\"post\"`` here. If " +"in doubt, use ``POST`` forms." +msgstr "" + +#: ../../tutorial.rst:593 +msgid "" +"Form fields transmitted via ``POST`` are stored in :attr:`BaseRequest.forms`" +" as a :class:`FormsDict`. The server side code may look like this::" +msgstr "" + +#: ../../tutorial.rst:616 +msgid "" +"There are several other attributes used to access form data. Some of them " +"combine values from different sources for easier access. The following table" +" should give you a decent overview." +msgstr "" + +#: ../../tutorial.rst:619 +msgid "Attribute" +msgstr "" + +#: ../../tutorial.rst:619 +msgid "GET Form fields" +msgstr "" + +#: ../../tutorial.rst:619 +msgid "POST Form fields" +msgstr "" + +#: ../../tutorial.rst:619 +msgid "File Uploads" +msgstr "" + +#: ../../tutorial.rst:621 +msgid ":attr:`BaseRequest.query`" +msgstr "" + +#: ../../tutorial.rst:621 ../../tutorial.rst:622 ../../tutorial.rst:623 +#: ../../tutorial.rst:624 ../../tutorial.rst:624 ../../tutorial.rst:625 +#: ../../tutorial.rst:626 ../../tutorial.rst:626 +msgid "yes" +msgstr "" + +#: ../../tutorial.rst:621 ../../tutorial.rst:621 ../../tutorial.rst:622 +#: ../../tutorial.rst:622 ../../tutorial.rst:623 ../../tutorial.rst:623 +#: ../../tutorial.rst:624 ../../tutorial.rst:625 ../../tutorial.rst:625 +#: ../../tutorial.rst:626 +msgid "no" +msgstr "" + +#: ../../tutorial.rst:622 +msgid ":attr:`BaseRequest.forms`" +msgstr "" + +#: ../../tutorial.rst:623 +msgid ":attr:`BaseRequest.files`" +msgstr "" + +#: ../../tutorial.rst:624 +msgid ":attr:`BaseRequest.params`" +msgstr "" + +#: ../../tutorial.rst:625 +msgid ":attr:`BaseRequest.GET`" +msgstr "" + +#: ../../tutorial.rst:626 +msgid ":attr:`BaseRequest.POST`" +msgstr "" + +#: ../../tutorial.rst:631 +msgid "File uploads" +msgstr "" + +#: ../../tutorial.rst:633 +msgid "" +"To support file uploads, we have to change the ``<form>`` tag a bit. First, " +"we tell the browser to encode the form data in a different way by adding an " +"``enctype=\"multipart/form-data\"`` attribute to the ``<form>`` tag. Then, " +"we add ``<input type=\"file\" />`` tags to allow the user to select a file. " +"Here is an example:" +msgstr "" + +#: ../../tutorial.rst:643 +msgid "" +"Bottle stores file uploads in :attr:`BaseRequest.files` as " +":class:`FileUpload` instances, along with some metadata about the upload. " +"Let us assume you just want to save the file to disk::" +msgstr "" + +#: ../../tutorial.rst:657 +msgid "" +":attr:`FileUpload.filename` contains the name of the file on the clients " +"file system, but is cleaned up and normalized to prevent bugs caused by " +"unsupported characters or path segments in the filename. If you need the " +"unmodified name as sent by the client, have a look at " +":attr:`FileUpload.raw_filename`." +msgstr "" + +#: ../../tutorial.rst:659 +msgid "" +"The :attr:`FileUpload.save` method is highly recommended if you want to " +"store the file to disk. It prevents some common errors (e.g. it does not " +"overwrite existing files unless you tell it to) and stores the file in a " +"memory efficient way. You can access the file object directly via " +":attr:`FileUpload.file`. Just be careful." +msgstr "" + +#: ../../tutorial.rst:663 +msgid "JSON Content" +msgstr "" + +#: ../../tutorial.rst:665 +msgid "" +"Some JavaScript or REST clients send ``application/json`` content to the " +"server. The :attr:`BaseRequest.json` attribute contains the parsed data " +"structure, if available." +msgstr "" + +#: ../../tutorial.rst:669 +msgid "The raw request body" +msgstr "" + +#: ../../tutorial.rst:671 +msgid "" +"You can access the raw body data as a file-like object via " +":attr:`BaseRequest.body`. This is a :class:`BytesIO` buffer or a temporary " +"file depending on the content length and :attr:`BaseRequest.MEMFILE_MAX` " +"setting. In both cases the body is completely buffered before you can access" +" the attribute. If you expect huge amounts of data and want to get direct " +"unbuffered access to the stream, have a look at ``request['wsgi.input']``." +msgstr "" + +#: ../../tutorial.rst:676 +msgid "WSGI Environment" +msgstr "" + +#: ../../tutorial.rst:678 +msgid "" +"Each :class:`BaseRequest` instance wraps a WSGI environment dictionary. The " +"original is stored in :attr:`BaseRequest.environ`, but the request object " +"itself behaves like a dictionary, too. Most of the interesting data is " +"exposed through special methods or attributes, but if you want to access " +"`WSGI environ variables <WSGI_Specification>`_ directly, you can do so::" +msgstr "" + +#: ../../tutorial.rst:696 +msgid "Templates" +msgstr "" + +#: ../../tutorial.rst:698 +msgid "" +"Bottle comes with a fast and powerful built-in template engine called " +":doc:`stpl`. To render a template you can use the :func:`template` function " +"or the :func:`view` decorator. All you have to do is to provide the name of " +"the template and the variables you want to pass to the template as keyword " +"arguments. Here’s a simple example of how to render a template::" +msgstr "" + +#: ../../tutorial.rst:705 +msgid "" +"This will load the template file ``hello_template.tpl`` and render it with " +"the ``name`` variable set. Bottle will look for templates in the " +"``./views/`` folder or any folder specified in the ``bottle.TEMPLATE_PATH`` " +"list." +msgstr "" + +#: ../../tutorial.rst:707 +msgid "" +"The :func:`view` decorator allows you to return a dictionary with the " +"template variables instead of calling :func:`template`::" +msgstr "" + +#: ../../tutorial.rst:716 +msgid "Syntax" +msgstr "" + +#: ../../tutorial.rst:719 +msgid "" +"The template syntax is a very thin layer around the Python language. Its " +"main purpose is to ensure correct indentation of blocks, so you can format " +"your template without worrying about indentation. Follow the link for a full" +" syntax description: :doc:`stpl`" +msgstr "" + +#: ../../tutorial.rst:721 +msgid "Here is an example template::" +msgstr "" + +#: ../../tutorial.rst:732 +msgid "Caching" +msgstr "" + +#: ../../tutorial.rst:733 +msgid "" +"Templates are cached in memory after compilation. Modifications made to the " +"template files will have no affect until you clear the template cache. Call " +"``bottle.TEMPLATES.clear()`` to do so. Caching is disabled in debug mode." +msgstr "" + +#: ../../tutorial.rst:743 +msgid "Plugins" +msgstr "" + +#: ../../tutorial.rst:747 +msgid "" +"Bottle's core features cover most common use-cases, but as a micro-framework" +" it has its limits. This is where \"Plugins\" come into play. Plugins add " +"missing functionality to the framework, integrate third party libraries, or " +"just automate some repetitive work." +msgstr "" + +#: ../../tutorial.rst:749 +msgid "" +"We have a growing :doc:`/plugins/index` and most plugins are designed to be " +"portable and re-usable across applications. The chances are high that your " +"problem has already been solved and a ready-to-use plugin exists. If not, " +"the :doc:`/plugindev` may help you." +msgstr "" + +#: ../../tutorial.rst:751 +msgid "" +"The effects and APIs of plugins are manifold and depend on the specific " +"plugin. The ``SQLitePlugin`` plugin for example detects callbacks that " +"require a ``db`` keyword argument and creates a fresh database connection " +"object every time the callback is called. This makes it very convenient to " +"use a database::" +msgstr "" + +#: ../../tutorial.rst:771 +msgid "" +"Other plugin may populate the thread-safe :data:`local` object, change " +"details of the :data:`request` object, filter the data returned by the " +"callback or bypass the callback completely. An \"auth\" plugin for example " +"could check for a valid session and return a login page instead of calling " +"the original callback. What happens exactly depends on the plugin." +msgstr "" + +#: ../../tutorial.rst:775 +msgid "Application-wide Installation" +msgstr "" + +#: ../../tutorial.rst:777 +msgid "" +"Plugins can be installed application-wide or just to some specific routes " +"that need additional functionality. Most plugins can safely be installed to " +"all routes and are smart enough to not add overhead to callbacks that do not" +" need their functionality." +msgstr "" + +#: ../../tutorial.rst:779 +msgid "" +"Let us take the ``SQLitePlugin`` plugin for example. It only affects route " +"callbacks that need a database connection. Other routes are left alone. " +"Because of this, we can install the plugin application-wide with no " +"additional overhead." +msgstr "" + +#: ../../tutorial.rst:781 +msgid "" +"To install a plugin, just call :func:`install` with the plugin as first " +"argument::" +msgstr "" + +#: ../../tutorial.rst:786 +msgid "" +"The plugin is not applied to the route callbacks yet. This is delayed to " +"make sure no routes are missed. You can install plugins first and add routes" +" later, if you want to. The order of installed plugins is significant, " +"though. If a plugin requires a database connection, you need to install the " +"database plugin first." +msgstr "" + +#: ../../tutorial.rst:790 +msgid "Uninstall Plugins" +msgstr "" + +#: ../../tutorial.rst:791 +msgid "" +"You can use a name, class or instance to :func:`uninstall` a previously " +"installed plugin::" +msgstr "" + +#: ../../tutorial.rst:801 +msgid "" +"Plugins can be installed and removed at any time, even at runtime while " +"serving requests. This enables some neat tricks (installing slow debugging " +"or profiling plugins only when needed) but should not be overused. Each time" +" the list of plugins changes, the route cache is flushed and all plugins are" +" re-applied." +msgstr "" + +#: ../../tutorial.rst:804 +msgid "" +"The module-level :func:`install` and :func:`uninstall` functions affect the " +":ref:`default-app`. To manage plugins for a specific application, use the " +"corresponding methods on the :class:`Bottle` application object." +msgstr "" + +#: ../../tutorial.rst:808 +msgid "Route-specific Installation" +msgstr "" + +#: ../../tutorial.rst:810 +msgid "" +"The ``apply`` parameter of the :func:`route` decorator comes in handy if you" +" want to install plugins to only a small number of routes::" +msgstr "" + +#: ../../tutorial.rst:820 +msgid "Blacklisting Plugins" +msgstr "" + +#: ../../tutorial.rst:822 +msgid "" +"You may want to explicitly disable a plugin for a number of routes. The " +":func:`route` decorator has a ``skip`` parameter for this purpose::" +msgstr "" + +#: ../../tutorial.rst:844 +msgid "" +"The ``skip`` parameter accepts a single value or a list of values. You can " +"use a name, class or instance to identify the plugin that is to be skipped. " +"Set ``skip=True`` to skip all plugins at once." +msgstr "" + +#: ../../tutorial.rst:847 +msgid "Plugins and Sub-Applications" +msgstr "" + +#: ../../tutorial.rst:849 +msgid "" +"Most plugins are specific to the application they were installed to. " +"Consequently, they should not affect sub-applications mounted with " +":meth:`Bottle.mount`. Here is an example::" +msgstr "" + +#: ../../tutorial.rst:860 +msgid "" +"Whenever you mount an application, Bottle creates a proxy-route on the main-" +"application that forwards all requests to the sub-application. Plugins are " +"disabled for this kind of proxy-route by default. As a result, our " +"(fictional) `WTForms` plugin affects the ``/contact`` route, but does not " +"affect the routes of the ``/blog`` sub-application." +msgstr "" + +#: ../../tutorial.rst:862 +msgid "" +"This behavior is intended as a sane default, but can be overridden. The " +"following example re-activates all plugins for a specific proxy-route::" +msgstr "" + +#: ../../tutorial.rst:866 +msgid "" +"But there is a snag: The plugin sees the whole sub-application as a single " +"route, namely the proxy-route mentioned above. In order to affect each " +"individual route of the sub-application, you have to install the plugin to " +"the mounted application explicitly." +msgstr "" + +#: ../../tutorial.rst:871 +msgid "Development" +msgstr "" + +#: ../../tutorial.rst:873 +msgid "" +"So you have learned the basics and want to write your own application? Here " +"are some tips that might help you being more productive." +msgstr "" + +#: ../../tutorial.rst:879 +msgid "Default Application" +msgstr "" + +#: ../../tutorial.rst:881 +msgid "" +"Bottle maintains a global stack of :class:`Bottle` instances and uses the " +"top of the stack as a default for some of the module-level functions and " +"decorators. The :func:`route` decorator, for example, is a shortcut for " +"calling :meth:`Bottle.route` on the default application::" +msgstr "" + +#: ../../tutorial.rst:889 +msgid "" +"This is very convenient for small applications and saves you some typing, " +"but also means that, as soon as your module is imported, routes are " +"installed to the global default application. To avoid this kind of import " +"side-effects, Bottle offers a second, more explicit way to build " +"applications::" +msgstr "" + +#: ../../tutorial.rst:899 +msgid "" +"Separating the application object improves re-usability a lot, too. Other " +"developers can safely import the ``app`` object from your module and use " +":meth:`Bottle.mount` to merge applications together." +msgstr "" + +#: ../../tutorial.rst:904 +msgid "" +"Starting with bottle-0.13 you can use :class:`Bottle` instances as context " +"managers::" +msgstr "" + +#: ../../tutorial.rst:929 +msgid "Debug Mode" +msgstr "" + +#: ../../tutorial.rst:931 +msgid "During early development, the debug mode can be very helpful." +msgstr "" + +#: ../../tutorial.rst:939 +msgid "" +"In this mode, Bottle is much more verbose and provides helpful debugging " +"information whenever an error occurs. It also disables some optimisations " +"that might get in your way and adds some checks that warn you about possible" +" misconfiguration." +msgstr "" + +#: ../../tutorial.rst:941 +msgid "Here is an incomplete list of things that change in debug mode:" +msgstr "" + +#: ../../tutorial.rst:943 +msgid "The default error page shows a traceback." +msgstr "" + +#: ../../tutorial.rst:944 +msgid "Templates are not cached." +msgstr "" + +#: ../../tutorial.rst:945 +msgid "Plugins are applied immediately." +msgstr "" + +#: ../../tutorial.rst:947 +msgid "Just make sure not to use the debug mode on a production server." +msgstr "" + +#: ../../tutorial.rst:950 +msgid "Auto Reloading" +msgstr "" + +#: ../../tutorial.rst:952 +msgid "" +"During development, you have to restart the server a lot to test your recent" +" changes. The auto reloader can do this for you. Every time you edit a " +"module file, the reloader restarts the server process and loads the newest " +"version of your code." +msgstr "" + +#: ../../tutorial.rst:962 +msgid "" +"How it works: the main process will not start a server, but spawn a new " +"child process using the same command line arguments used to start the main " +"process. All module-level code is executed at least twice! Be careful." +msgstr "" + +#: ../../tutorial.rst:967 +msgid "" +"The child process will have ``os.environ['BOTTLE_CHILD']`` set to ``True`` " +"and start as a normal non-reloading app server. As soon as any of the loaded" +" modules changes, the child process is terminated and re-spawned by the main" +" process. Changes in template files will not trigger a reload. Please use " +"debug mode to deactivate template caching." +msgstr "" + +#: ../../tutorial.rst:973 +msgid "" +"The reloading depends on the ability to stop the child process. If you are " +"running on Windows or any other operating system not supporting " +"``signal.SIGINT`` (which raises ``KeyboardInterrupt`` in Python), " +"``signal.SIGTERM`` is used to kill the child. Note that exit handlers and " +"finally clauses, etc., are not executed after a ``SIGTERM``." +msgstr "" + +#: ../../tutorial.rst:981 +msgid "Command Line Interface" +msgstr "" + +#: ../../tutorial.rst:985 +msgid "Starting with version 0.10 you can use bottle as a command-line tool:" +msgstr "" + +#: ../../tutorial.rst:1009 +msgid "" +"The `ADDRESS` field takes an IP address or an IP:PORT pair and defaults to " +"``localhost:8080``. The other parameters should be self-explanatory." +msgstr "" + +#: ../../tutorial.rst:1011 +msgid "" +"Both plugins and applications are specified via import expressions. These " +"consist of an import path (e.g. ``package.module``) and an expression to be " +"evaluated in the namespace of that module, separated by a colon. See " +":func:`load` for details. Here are some examples:" +msgstr "" + +#: ../../tutorial.rst:1032 +msgid "Deployment" +msgstr "" + +#: ../../tutorial.rst:1034 +msgid "" +"Bottle runs on the built-in `wsgiref WSGIServer " +"<http://docs.python.org/library/wsgiref.html#module-wsgiref.simple_server>`_" +" by default. This non-threading HTTP server is perfectly fine for " +"development, but may become a performance bottleneck when server load " +"increases." +msgstr "" + +#: ../../tutorial.rst:1036 +msgid "" +"The easiest way to increase performance is to install a multi-threaded " +"server library like paste_ or cherrypy_ and tell Bottle to use that instead " +"of the single-threaded server::" +msgstr "" + +#: ../../tutorial.rst:1040 +msgid "" +"This, and many other deployment options are described in a separate article:" +" :doc:`deployment`" +msgstr "" + +#: ../../tutorial.rst:1048 +msgid "Glossary" +msgstr "" + +#: ../../tutorial.rst:1051 +msgid "callback" +msgstr "" + +#: ../../tutorial.rst:1053 +msgid "" +"Programmer code that is to be called when some external action happens. In " +"the context of web frameworks, the mapping between URL paths and application" +" code is often achieved by specifying a callback function for each URL." +msgstr "" + +#: ../../tutorial.rst:1057 +msgid "decorator" +msgstr "" + +#: ../../tutorial.rst:1059 +msgid "" +"A function returning another function, usually applied as a function " +"transformation using the ``@decorator`` syntax. See `python documentation " +"for function definition " +"<http://docs.python.org/reference/compound_stmts.html#function>`_ for more " +"about decorators." +msgstr "" + +#: ../../tutorial.rst:1060 +msgid "environ" +msgstr "" + +#: ../../tutorial.rst:1062 +msgid "" +"A structure where information about all documents under the root is saved, " +"and used for cross-referencing. The environment is pickled after the " +"parsing stage, so that successive runs only need to read and parse new and " +"changed documents." +msgstr "" + +#: ../../tutorial.rst:1066 +msgid "handler function" +msgstr "" + +#: ../../tutorial.rst:1068 +msgid "" +"A function to handle some specific event or situation. In a web framework, " +"the application is developed by attaching a handler function as callback for" +" each specific URL comprising the application." +msgstr "" + +#: ../../tutorial.rst:1071 +msgid "source directory" +msgstr "" + +#: ../../tutorial.rst:1073 +msgid "" +"The directory which, including its subdirectories, contains all source files" +" for one Sphinx project." +msgstr "" diff --git a/docs/_locale/ja_JP/LC_MESSAGES/tutorial_app.po b/docs/_locale/ja_JP/LC_MESSAGES/tutorial_app.po new file mode 100644 index 0000000..db47187 --- /dev/null +++ b/docs/_locale/ja_JP/LC_MESSAGES/tutorial_app.po @@ -0,0 +1,901 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2009-2020, Marcel Hellkamp +# This file is distributed under the same license as the Bottle package. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: bottle\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2020-12-31 18:35+0100\n" +"PO-Revision-Date: 2020-12-31 17:35+0000\n" +"Last-Translator: defnull <marc@gsites.de>\n" +"Language-Team: Japanese (Japan) (http://www.transifex.com/bottle/bottle/language/ja_JP/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ja_JP\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +#: ../../tutorial_app.rst:19 +msgid "Tutorial: Todo-List Application" +msgstr "" + +#: ../../tutorial_app.rst:23 +msgid "" +"This tutorial is a work in progress and written by `noisefloor " +"<http://github.com/noisefloor>`_." +msgstr "" + +#: ../../tutorial_app.rst:26 +msgid "" +"This tutorial should give a brief introduction to the Bottle_ WSGI " +"Framework. The main goal is to be able, after reading through this tutorial," +" to create a project using Bottle. Within this document, not all abilities " +"will be shown, but at least the main and important ones like routing, " +"utilizing the Bottle template abilities to format output and handling GET / " +"POST parameters." +msgstr "" + +#: ../../tutorial_app.rst:28 +msgid "" +"To understand the content here, it is not necessary to have a basic " +"knowledge of WSGI, as Bottle tries to keep WSGI away from the user anyway. " +"You should have a fair understanding of the Python_ programming language. " +"Furthermore, the example used in the tutorial retrieves and stores data in a" +" SQL database, so a basic idea about SQL helps, but is not a must to " +"understand the concepts of Bottle. Right here, SQLite_ is used. The output " +"of Bottle sent to the browser is formatted in some examples by the help of " +"HTML. Thus, a basic idea about the common HTML tags does help as well." +msgstr "" + +#: ../../tutorial_app.rst:30 +msgid "" +"For the sake of introducing Bottle, the Python code \"in between\" is kept " +"short, in order to keep the focus. Also all code within the tutorial is " +"working fine, but you may not necessarily use it \"in the wild\", e.g. on a " +"public web server. In order to do so, you may add e.g. more error handling, " +"protect the database with a password, test and escape the input etc." +msgstr "" + +#: ../../tutorial_app.rst:32 +msgid "Table of Contents" +msgstr "" + +#: ../../tutorial_app.rst:35 +msgid "Goals" +msgstr "" + +#: ../../tutorial_app.rst:37 +msgid "" +"At the end of this tutorial, we will have a simple, web-based ToDo list. The" +" list contains a text (with max 100 characters) and a status (0 for closed, " +"1 for open) for each item. Through the web-based user interface, open items " +"can be view and edited and new items can be added." +msgstr "" + +#: ../../tutorial_app.rst:39 +msgid "" +"During development, all pages will be available on ``localhost`` only, but " +"later on it will be shown how to adapt the application for a \"real\" " +"server, including how to use with Apache's mod_wsgi." +msgstr "" + +#: ../../tutorial_app.rst:41 +msgid "" +"Bottle will do the routing and format the output, with the help of " +"templates. The items of the list will be stored inside a SQLite database. " +"Reading and writing the database will be done by Python code." +msgstr "" + +#: ../../tutorial_app.rst:43 +msgid "" +"We will end up with an application with the following pages and " +"functionality:" +msgstr "" + +#: ../../tutorial_app.rst:45 +msgid "start page ``http://localhost:8080/todo``" +msgstr "" + +#: ../../tutorial_app.rst:46 +msgid "adding new items to the list: ``http://localhost:8080/new``" +msgstr "" + +#: ../../tutorial_app.rst:47 +msgid "page for editing items: ``http://localhost:8080/edit/<no:int>``" +msgstr "" + +#: ../../tutorial_app.rst:48 +msgid "catching errors" +msgstr "" + +#: ../../tutorial_app.rst:51 +msgid "Before We Start..." +msgstr "" + +#: ../../tutorial_app.rst:55 +msgid "Install Bottle" +msgstr "" + +#: ../../tutorial_app.rst:56 +msgid "" +"Assuming that you have a fairly new installation of Python (version 2.5 or " +"higher), you only need to install Bottle in addition to that. Bottle has no " +"other dependencies than Python itself." +msgstr "" + +#: ../../tutorial_app.rst:58 +msgid "" +"You can either manually install Bottle or use Python's easy_install: " +"``easy_install bottle``" +msgstr "" + +#: ../../tutorial_app.rst:62 +msgid "Further Software Necessities" +msgstr "" + +#: ../../tutorial_app.rst:63 +msgid "" +"As we use SQLite3 as a database, make sure it is installed. On Linux " +"systems, most distributions have SQLite3 installed by default. SQLite is " +"available for Windows and MacOS X as well and the `sqlite3` module is part " +"of the python standard library." +msgstr "" + +#: ../../tutorial_app.rst:66 +msgid "Create An SQL Database" +msgstr "" + +#: ../../tutorial_app.rst:67 +msgid "" +"First, we need to create the database we use later on. To do so, save the " +"following script in your project directory and run it with python. You can " +"use the interactive interpreter too::" +msgstr "" + +#: ../../tutorial_app.rst:78 +msgid "" +"This generates a database-file `todo.db` with tables called ``todo`` and " +"three columns ``id``, ``task``, and ``status``. ``id`` is a unique id for " +"each row, which is used later on to reference the rows. The column ``task`` " +"holds the text which describes the task, it can be max 100 characters long. " +"Finally, the column ``status`` is used to mark a task as open (value 1) or " +"closed (value 0)." +msgstr "" + +#: ../../tutorial_app.rst:81 +msgid "Using Bottle for a Web-Based ToDo List" +msgstr "" + +#: ../../tutorial_app.rst:83 +msgid "" +"Now it is time to introduce Bottle in order to create a web-based " +"application. But first, we need to look into a basic concept of Bottle: " +"routes." +msgstr "" + +#: ../../tutorial_app.rst:87 +msgid "Understanding routes" +msgstr "" + +#: ../../tutorial_app.rst:88 +msgid "" +"Basically, each page visible in the browser is dynamically generated when " +"the page address is called. Thus, there is no static content. That is " +"exactly what is called a \"route\" within Bottle: a certain address on the " +"server. So, for example, when the page ``http://localhost:8080/todo`` is " +"called from the browser, Bottle \"grabs\" the call and checks if there is " +"any (Python) function defined for the route \"todo\". If so, Bottle will " +"execute the corresponding Python code and return its result." +msgstr "" + +#: ../../tutorial_app.rst:92 +msgid "First Step - Showing All Open Items" +msgstr "" + +#: ../../tutorial_app.rst:93 +msgid "" +"So, after understanding the concept of routes, let's create the first one. " +"The goal is to see all open items from the ToDo list::" +msgstr "" + +#: ../../tutorial_app.rst:108 +msgid "" +"Save the code a ``todo.py``, preferably in the same directory as the file " +"``todo.db``. Otherwise, you need to add the path to ``todo.db`` in the " +"``sqlite3.connect()`` statement." +msgstr "" + +#: ../../tutorial_app.rst:110 +msgid "" +"Let's have a look what we just did: We imported the necessary module " +"``sqlite3`` to access to SQLite database and from Bottle we imported " +"``route`` and ``run``. The ``run()`` statement simply starts the web server " +"included in Bottle. By default, the web server serves the pages on localhost" +" and port 8080. Furthermore, we imported ``route``, which is the function " +"responsible for Bottle's routing. As you can see, we defined one function, " +"``todo_list()``, with a few lines of code reading from the database. The " +"important point is the `decorator statement`_ ``@route('/todo')`` right " +"before the ``def todo_list()`` statement. By doing this, we bind this " +"function to the route ``/todo``, so every time the browsers calls " +"``http://localhost:8080/todo``, Bottle returns the result of the function " +"``todo_list()``. That is how routing within bottle works." +msgstr "" + +#: ../../tutorial_app.rst:112 +msgid "" +"Actually you can bind more than one route to a function. So the following " +"code::" +msgstr "" + +#: ../../tutorial_app.rst:119 +msgid "" +"will work fine, too. What will not work is to bind one route to more than " +"one function." +msgstr "" + +#: ../../tutorial_app.rst:121 +msgid "" +"What you will see in the browser is what is returned, thus the value given " +"by the ``return`` statement. In this example, we need to convert ``result`` " +"in to a string by ``str()``, as Bottle expects a string or a list of strings" +" from the return statement. But here, the result of the database query is a " +"list of tuples, which is the standard defined by the `Python DB API`_." +msgstr "" + +#: ../../tutorial_app.rst:123 +msgid "" +"Now, after understanding the little script above, it is time to execute it " +"and watch the result yourself. Remember that on Linux- / Unix-based systems " +"the file ``todo.py`` needs to be executable first. Then, just run ``python " +"todo.py`` and call the page ``http://localhost:8080/todo`` in your browser. " +"In case you made no mistake writing the script, the output should look like " +"this::" +msgstr "" + +#: ../../tutorial_app.rst:127 +msgid "" +"If so - congratulations! You are now a successful user of Bottle. In case it" +" did not work and you need to make some changes to the script, remember to " +"stop Bottle serving the page, otherwise the revised version will not be " +"loaded." +msgstr "" + +#: ../../tutorial_app.rst:129 +msgid "" +"Actually, the output is not really exciting nor nice to read. It is the raw " +"result returned from the SQL query." +msgstr "" + +#: ../../tutorial_app.rst:131 +msgid "" +"So, in the next step we format the output in a nicer way. But before we do " +"that, we make our life easier." +msgstr "" + +#: ../../tutorial_app.rst:135 +msgid "Debugging and Auto-Reload" +msgstr "" + +#: ../../tutorial_app.rst:136 +msgid "" +"Maybe you already noticed that Bottle sends a short error message to the " +"browser in case something within the script is wrong, e.g. the connection to" +" the database is not working. For debugging purposes it is quite helpful to " +"get more details. This can be easily achieved by adding the following " +"statement to the script::" +msgstr "" + +#: ../../tutorial_app.rst:144 +msgid "" +"By enabling \"debug\", you will get a full stacktrace of the Python " +"interpreter, which usually contains useful information for finding bugs. " +"Furthermore, templates (see below) are not cached, thus changes to templates" +" will take effect without stopping the server." +msgstr "" + +#: ../../tutorial_app.rst:148 +msgid "" +"That ``debug(True)`` is supposed to be used for development only, it should " +"*not* be used in production environments." +msgstr "" + +#: ../../tutorial_app.rst:152 +msgid "" +"Another quite nice feature is auto-reloading, which is enabled by modifying " +"the ``run()`` statement to" +msgstr "" + +#: ../../tutorial_app.rst:158 +msgid "" +"This will automatically detect changes to the script and reload the new " +"version once it is called again, without the need to stop and start the " +"server." +msgstr "" + +#: ../../tutorial_app.rst:160 +msgid "" +"Again, the feature is mainly supposed to be used while developing, not on " +"production systems." +msgstr "" + +#: ../../tutorial_app.rst:164 +msgid "Bottle Template To Format The Output" +msgstr "" + +#: ../../tutorial_app.rst:165 +msgid "" +"Now let's have a look at casting the output of the script into a proper " +"format." +msgstr "" + +#: ../../tutorial_app.rst:167 +msgid "" +"Actually Bottle expects to receive a string or a list of strings from a " +"function and returns them by the help of the built-in server to the browser." +" Bottle does not bother about the content of the string itself, so it can be" +" text formatted with HTML markup, too." +msgstr "" + +#: ../../tutorial_app.rst:169 +msgid "" +"Bottle brings its own easy-to-use template engine with it. Templates are " +"stored as separate files having a ``.tpl`` extension. The template can be " +"called then from within a function. Templates can contain any type of text " +"(which will be most likely HTML-markup mixed with Python statements). " +"Furthermore, templates can take arguments, e.g. the result set of a database" +" query, which will be then formatted nicely within the template." +msgstr "" + +#: ../../tutorial_app.rst:171 +msgid "" +"Right here, we are going to cast the result of our query showing the open " +"ToDo items into a simple table with two columns: the first column will " +"contain the ID of the item, the second column the text. The result set is, " +"as seen above, a list of tuples, each tuple contains one set of results." +msgstr "" + +#: ../../tutorial_app.rst:173 +msgid "To include the template in our example, just add the following lines::" +msgstr "" + +#: ../../tutorial_app.rst:183 +msgid "" +"So we do here two things: first, we import ``template`` from Bottle in order" +" to be able to use templates. Second, we assign the output of the template " +"``make_table`` to the variable ``output``, which is then returned. In " +"addition to calling the template, we assign ``result``, which we received " +"from the database query, to the variable ``rows``, which is later on used " +"within the template. If necessary, you can assign more than one variable / " +"value to a template." +msgstr "" + +#: ../../tutorial_app.rst:185 +msgid "" +"Templates always return a list of strings, thus there is no need to convert " +"anything. We can save one line of code by writing ``return " +"template('make_table', rows=result)``, which gives exactly the same result " +"as above." +msgstr "" + +#: ../../tutorial_app.rst:187 +msgid "" +"Now it is time to write the corresponding template, which looks like this::" +msgstr "" + +#: ../../tutorial_app.rst:201 +msgid "" +"Save the code as ``make_table.tpl`` in the same directory where ``todo.py`` " +"is stored." +msgstr "" + +#: ../../tutorial_app.rst:203 +msgid "" +"Let's have a look at the code: every line starting with % is interpreted as " +"Python code. Because it is effectively Python, only valid Python statements " +"are allowed. The template will raise exceptions, just as any other Python " +"code would. The other lines are plain HTML markup." +msgstr "" + +#: ../../tutorial_app.rst:205 +msgid "" +"As you can see, we use Python's ``for`` statement two times, in order to go " +"through ``rows``. As seen above, ``rows`` is a variable which holds the " +"result of the database query, so it is a list of tuples. The first ``for`` " +"statement accesses the tuples within the list, the second one the items " +"within the tuple, which are put each into a cell of the table. It is " +"important that you close all ``for``, ``if``, ``while`` etc. statements with" +" ``%end``, otherwise the output may not be what you expect." +msgstr "" + +#: ../../tutorial_app.rst:207 +msgid "" +"If you need to access a variable within a non-Python code line inside the " +"template, you need to put it into double curly braces. This tells the " +"template to insert the actual value of the variable right in place." +msgstr "" + +#: ../../tutorial_app.rst:209 +msgid "" +"Run the script again and look at the output. Still not really nice, but at " +"least more readable than the list of tuples. You can spice-up the very " +"simple HTML markup above, e.g. by using in-line styles to get a better " +"looking output." +msgstr "" + +#: ../../tutorial_app.rst:213 +msgid "Using GET and POST Values" +msgstr "" + +#: ../../tutorial_app.rst:214 +msgid "" +"As we can review all open items properly, we move to the next step, which is" +" adding new items to the ToDo list. The new item should be received from a " +"regular HTML-based form, which sends its data by the GET method." +msgstr "" + +#: ../../tutorial_app.rst:216 +msgid "" +"To do so, we first add a new route to our script and tell the route that it " +"should get GET data::" +msgstr "" + +#: ../../tutorial_app.rst:239 +msgid "" +"To access GET (or POST) data, we need to import ``request`` from Bottle. To " +"assign the actual data to a variable, we use the statement " +"``request.GET.task.strip()`` statement, where ``task`` is the name of the " +"GET data we want to access. That's all. If your GET data has more than one " +"variable, multiple ``request.GET.get()`` statements can be used and assigned" +" to other variables." +msgstr "" + +#: ../../tutorial_app.rst:241 +msgid "" +"The rest of this piece of code is just processing of the gained data: " +"writing to the database, retrieve the corresponding id from the database and" +" generate the output." +msgstr "" + +#: ../../tutorial_app.rst:243 +msgid "" +"But where do we get the GET data from? Well, we can use a static HTML page " +"holding the form. Or, what we do right now, is to use a template which is " +"output when the route ``/new`` is called without GET data." +msgstr "" + +#: ../../tutorial_app.rst:245 +msgid "The code needs to be extended to::" +msgstr "" + +#: ../../tutorial_app.rst:268 +msgid "``new_task.tpl`` looks like this::" +msgstr "" + +#: ../../tutorial_app.rst:276 +msgid "That's all. As you can see, the template is plain HTML this time." +msgstr "" + +#: ../../tutorial_app.rst:278 +msgid "Now we are able to extend our to do list." +msgstr "" + +#: ../../tutorial_app.rst:280 +msgid "" +"By the way, if you prefer to use POST data: this works exactly the same way," +" just use ``request.POST.get()`` instead." +msgstr "" + +#: ../../tutorial_app.rst:284 +msgid "Editing Existing Items" +msgstr "" + +#: ../../tutorial_app.rst:285 +msgid "The last point to do is to enable editing of existing items." +msgstr "" + +#: ../../tutorial_app.rst:287 +msgid "" +"By using only the routes we know so far it is possible, but may be quite " +"tricky. But Bottle knows something called \"dynamic routes\", which makes " +"this task quite easy." +msgstr "" + +#: ../../tutorial_app.rst:289 +msgid "The basic statement for a dynamic route looks like this::" +msgstr "" + +#: ../../tutorial_app.rst:293 +msgid "" +"This tells Bottle to accept for ``<something>`` any string up to the next " +"slash. Furthermore, the value of ``something`` will be passed to the " +"function assigned to that route, so the data can be processed within the " +"function, like this::" +msgstr "" + +#: ../../tutorial_app.rst:321 +msgid "" +"It is basically pretty much the same what we already did above when adding " +"new items, like using ``GET`` data etc. The main addition here is using the " +"dynamic route ``<no:int>``, which here passes the number to the " +"corresponding function. As you can see, ``no`` is integer ID and used within" +" the function to access the right row of data within the database." +msgstr "" + +#: ../../tutorial_app.rst:324 +msgid "" +"The template ``edit_task.tpl`` called within the function looks like this::" +msgstr "" + +#: ../../tutorial_app.rst:339 +msgid "" +"Again, this template is a mix of Python statements and HTML, as already " +"explained above." +msgstr "" + +#: ../../tutorial_app.rst:341 +msgid "" +"A last word on dynamic routes: you can even use a regular expression for a " +"dynamic route, as demonstrated later." +msgstr "" + +#: ../../tutorial_app.rst:345 +msgid "Validating Dynamic Routes" +msgstr "" + +#: ../../tutorial_app.rst:346 +msgid "" +"Using dynamic routes is fine, but for many cases it makes sense to validate " +"the dynamic part of the route. For example, we expect an integer number in " +"our route for editing above. But if a float, characters or so are received, " +"the Python interpreter throws an exception, which is not what we want." +msgstr "" + +#: ../../tutorial_app.rst:348 +msgid "" +"For those cases, Bottle offers the ``<name:int>`` wildcard filter, which " +"matches (signed) digits and converts the value to integer. In order to apply" +" the wildcard filter, extend the code as follows::" +msgstr "" + +#: ../../tutorial_app.rst:356 +msgid "" +"Save the code and call the page again using incorrect value for " +"``<no:int>``, e.g. a float. You will receive not an exception, but a \"404 " +"Not Found\" error." +msgstr "" + +#: ../../tutorial_app.rst:360 +msgid "Dynamic Routes Using Regular Expressions" +msgstr "" + +#: ../../tutorial_app.rst:361 +msgid "" +"Bottle can also handle dynamic routes, where the \"dynamic part\" of the " +"route can be a regular expression." +msgstr "" + +#: ../../tutorial_app.rst:363 +msgid "" +"So, just to demonstrate that, let's assume that all single items in our ToDo" +" list should be accessible by their plain number, by a term like e.g. " +"\"item1\". For obvious reasons, you do not want to create a route for every " +"item. Furthermore, the simple dynamic routes do not work either, as part of " +"the route, the term \"item\" is static." +msgstr "" + +#: ../../tutorial_app.rst:365 +msgid "As said above, the solution is a regular expression::" +msgstr "" + +#: ../../tutorial_app.rst:380 +msgid "" +"The line ``@route(/item<item:re:[0-9]+>)`` starts like a normal route, but " +"the third part of the wildcard is interpreted as a regular expression, which" +" is the dynamic part of the route. So in this case, we want to match any " +"digit between 0 and 9. The following function \"show_item\" just checks " +"whether the given item is present in the database or not. In case it is " +"present, the corresponding text of the task is returned. As you can see, " +"only the regular expression part of the route is passed forward. " +"Furthermore, it is always forwarded as a string, even if it is a plain " +"integer number, like in this case." +msgstr "" + +#: ../../tutorial_app.rst:384 +msgid "Returning Static Files" +msgstr "" + +#: ../../tutorial_app.rst:385 +msgid "" +"Sometimes it may become necessary to associate a route not to a Python " +"function, but just return a static file. So if you have for example a help " +"page for your application, you may want to return this page as plain HTML. " +"This works as follows::" +msgstr "" + +#: ../../tutorial_app.rst:393 +msgid "" +"At first, we need to import the ``static_file`` function from Bottle. As you" +" can see, the ``return static_file`` statement replaces the ``return`` " +"statement. It takes at least two arguments: the name of the file to be " +"returned and the path to the file. Even if the file is in the same directory" +" as your application, the path needs to be stated. But in this case, you can" +" use ``'.'`` as a path, too. Bottle guesses the MIME-type of the file " +"automatically, but in case you like to state it explicitly, add a third " +"argument to ``static_file``, which would be here ``mimetype='text/html'``. " +"``static_file`` works with any type of route, including the dynamic ones." +msgstr "" + +#: ../../tutorial_app.rst:397 +msgid "Returning JSON Data" +msgstr "" + +#: ../../tutorial_app.rst:398 +msgid "" +"There may be cases where you do not want your application to generate the " +"output directly, but return data to be processed further on, e.g. by " +"JavaScript. For those cases, Bottle offers the possibility to return JSON " +"objects, which is sort of standard for exchanging data between web " +"applications. Furthermore, JSON can be processed by many programming " +"languages, including Python" +msgstr "" + +#: ../../tutorial_app.rst:400 +msgid "" +"So, let's assume we want to return the data generated in the regular " +"expression route example as a JSON object. The code looks like this::" +msgstr "" + +#: ../../tutorial_app.rst:415 +msgid "" +"As you can, that is fairly simple: just return a regular Python dictionary " +"and Bottle will convert it automatically into a JSON object prior to " +"sending. So if you e.g. call \"http://localhost/json1\" Bottle should in " +"this case return the JSON object ``{\"task\": [\"Read A-byte-of-python to " +"get a good introduction into Python\"]}``." +msgstr "" + +#: ../../tutorial_app.rst:420 +msgid "Catching Errors" +msgstr "" + +#: ../../tutorial_app.rst:421 +msgid "" +"The next step may is to catch the error with Bottle itself, to keep away any" +" type of error message from the user of your application. To do that, Bottle" +" has an \"error-route\", which can be a assigned to a HTML-error." +msgstr "" + +#: ../../tutorial_app.rst:423 +msgid "In our case, we want to catch a 403 error. The code is as follows::" +msgstr "" + +#: ../../tutorial_app.rst:431 +msgid "" +"So, at first we need to import ``error`` from Bottle and define a route by " +"``error(403)``, which catches all \"403 forbidden\" errors. The function " +"\"mistake\" is assigned to that. Please note that ``error()`` always passes " +"the error-code to the function - even if you do not need it. Thus, the " +"function always needs to accept one argument, otherwise it will not work." +msgstr "" + +#: ../../tutorial_app.rst:433 +msgid "" +"Again, you can assign more than one error-route to a function, or catch " +"various errors with one function each. So this code::" +msgstr "" + +#: ../../tutorial_app.rst:440 +msgid "works fine, the following one as well::" +msgstr "" + +#: ../../tutorial_app.rst:452 +msgid "Summary" +msgstr "" + +#: ../../tutorial_app.rst:453 +msgid "" +"After going through all the sections above, you should have a brief " +"understanding how the Bottle WSGI framework works. Furthermore you have all " +"the knowledge necessary to use Bottle for your applications." +msgstr "" + +#: ../../tutorial_app.rst:455 +msgid "" +"The following chapter give a short introduction how to adapt Bottle for " +"larger projects. Furthermore, we will show how to operate Bottle with web " +"servers which perform better on a higher load / more web traffic than the " +"one we used so far." +msgstr "" + +#: ../../tutorial_app.rst:458 +msgid "Server Setup" +msgstr "" + +#: ../../tutorial_app.rst:460 +msgid "" +"So far, we used the standard server used by Bottle, which is the `WSGI " +"reference Server`_ shipped along with Python. Although this server is " +"perfectly suitable for development purposes, it is not really suitable for " +"larger applications. But before we have a look at the alternatives, let's " +"have a look how to tweak the settings of the standard server first." +msgstr "" + +#: ../../tutorial_app.rst:464 +msgid "Running Bottle on a different port and IP" +msgstr "" + +#: ../../tutorial_app.rst:465 +msgid "" +"As standard, Bottle serves the pages on the IP address 127.0.0.1, also known" +" as ``localhost``, and on port ``8080``. To modify the setting is pretty " +"simple, as additional parameters can be passed to Bottle's ``run()`` " +"function to change the port and the address." +msgstr "" + +#: ../../tutorial_app.rst:467 +msgid "" +"To change the port, just add ``port=portnumber`` to the run command. So, for" +" example::" +msgstr "" + +#: ../../tutorial_app.rst:471 +msgid "would make Bottle listen to port 80." +msgstr "" + +#: ../../tutorial_app.rst:473 +msgid "To change the IP address where Bottle is listening::" +msgstr "" + +#: ../../tutorial_app.rst:477 +msgid "If needed, both parameters can be combined, like::" +msgstr "" + +#: ../../tutorial_app.rst:481 +msgid "" +"The ``port`` and ``host`` parameter can also be applied when Bottle is " +"running with a different server, as shown in the following section." +msgstr "" + +#: ../../tutorial_app.rst:485 +msgid "Running Bottle with a different server" +msgstr "" + +#: ../../tutorial_app.rst:486 +msgid "" +"As said above, the standard server is perfectly suitable for development, " +"personal use or a small group of people only using your application based on" +" Bottle. For larger tasks, the standard server may become a bottleneck, as " +"it is single-threaded, thus it can only serve one request at a time." +msgstr "" + +#: ../../tutorial_app.rst:488 +msgid "" +"But Bottle has already various adapters to multi-threaded servers on board, " +"which perform better on higher load. Bottle supports Cherrypy_, Flup_ and " +"Paste_." +msgstr "" + +#: ../../tutorial_app.rst:490 +msgid "" +"If you want to run for example Bottle with the Paste server, use the " +"following code::" +msgstr "" + +#: ../../tutorial_app.rst:496 +msgid "" +"This works exactly the same way with ``FlupServer``, ``CherryPyServer`` and " +"``FapwsServer``." +msgstr "" + +#: ../../tutorial_app.rst:500 +msgid "Running Bottle on Apache with mod_wsgi" +msgstr "" + +#: ../../tutorial_app.rst:501 +msgid "" +"Maybe you already have an Apache_ or you want to run a Bottle-based " +"application large scale - then it is time to think about Apache with " +"mod_wsgi_." +msgstr "" + +#: ../../tutorial_app.rst:503 +msgid "" +"We assume that your Apache server is up and running and mod_wsgi is working " +"fine as well. On a lot of Linux distributions, mod_wsgi can be easily " +"installed via whatever package management system is in use." +msgstr "" + +#: ../../tutorial_app.rst:505 +msgid "" +"Bottle brings an adapter for mod_wsgi with it, so serving your application " +"is an easy task." +msgstr "" + +#: ../../tutorial_app.rst:507 +msgid "" +"In the following example, we assume that you want to make your application " +"\"ToDo list\" accessible through ``http://www.mypage.com/todo`` and your " +"code, templates and SQLite database are stored in the path " +"``/var/www/todo``." +msgstr "" + +#: ../../tutorial_app.rst:509 +msgid "" +"When you run your application via mod_wsgi, it is imperative to remove the " +"``run()`` statement from your code, otherwise it won't work here." +msgstr "" + +#: ../../tutorial_app.rst:511 +msgid "" +"After that, create a file called ``adapter.wsgi`` with the following " +"content::" +msgstr "" + +#: ../../tutorial_app.rst:522 +msgid "" +"and save it in the same path, ``/var/www/todo``. Actually the name of the " +"file can be anything, as long as the extension is ``.wsgi``. The name is " +"only used to reference the file from your virtual host." +msgstr "" + +#: ../../tutorial_app.rst:524 +msgid "" +"Finally, we need to add a virtual host to the Apache configuration, which " +"looks like this::" +msgstr "" + +#: ../../tutorial_app.rst:540 +msgid "" +"After restarting the server, your ToDo list should be accessible at " +"``http://www.mypage.com/todo``" +msgstr "" + +#: ../../tutorial_app.rst:543 +msgid "Final Words" +msgstr "" + +#: ../../tutorial_app.rst:545 +msgid "" +"Now we are at the end of this introduction and tutorial to Bottle. We " +"learned about the basic concepts of Bottle and wrote a first application " +"using the Bottle framework. In addition to that, we saw how to adapt Bottle " +"for large tasks and serve Bottle through an Apache web server with mod_wsgi." +msgstr "" + +#: ../../tutorial_app.rst:547 +msgid "" +"As said in the introduction, this tutorial is not showing all shades and " +"possibilities of Bottle. What we skipped here is e.g. receiving file objects" +" and streams and how to handle authentication data. Furthermore, we did not " +"show how templates can be called from within another template. For an " +"introduction into those points, please refer to the full `Bottle " +"documentation`_ ." +msgstr "" + +#: ../../tutorial_app.rst:550 +msgid "Complete Example Listing" +msgstr "" + +#: ../../tutorial_app.rst:552 +msgid "" +"As the ToDo list example was developed piece by piece, here is the complete " +"listing:" +msgstr "" + +#: ../../tutorial_app.rst:554 +msgid "Main code for the application ``todo.py``::" +msgstr "" + +#: ../../tutorial_app.rst:675 +msgid "Template ``make_table.tpl``::" +msgstr "" + +#: ../../tutorial_app.rst:689 +msgid "Template ``edit_task.tpl``::" +msgstr "" + +#: ../../tutorial_app.rst:704 +msgid "Template ``new_task.tpl``::" +msgstr "" |