From f6869242ca11577e04d036ae74e00a82d94fb372 Mon Sep 17 00:00:00 2001 From: Rapptz Date: Sun, 24 Feb 2019 04:10:48 -0500 Subject: [PATCH] Update Japanese .po files. --- .../locale/ja/LC_MESSAGES/ext/commands/api.po | 479 +++++++++++++----- .../ja/LC_MESSAGES/ext/commands/cogs.po | 225 ++++++++ .../ja/LC_MESSAGES/ext/commands/extensions.po | 111 ++++ docs/locale/ja/LC_MESSAGES/migrating.po | 198 ++++++-- 4 files changed, 821 insertions(+), 192 deletions(-) create mode 100644 docs/locale/ja/LC_MESSAGES/ext/commands/cogs.po create mode 100644 docs/locale/ja/LC_MESSAGES/ext/commands/extensions.po diff --git a/docs/locale/ja/LC_MESSAGES/ext/commands/api.po b/docs/locale/ja/LC_MESSAGES/ext/commands/api.po index 00bf8e1ce..4d5506973 100644 --- a/docs/locale/ja/LC_MESSAGES/ext/commands/api.po +++ b/docs/locale/ja/LC_MESSAGES/ext/commands/api.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: discord.py 1.0.0a\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2019-02-18 03:50-0500\n" +"POT-Creation-Date: 2019-02-24 04:09-0500\n" "PO-Revision-Date: 2019-02-18 15:00+0000\n" "Last-Translator: cod , 2019\n" "Language: ja_JP\n" @@ -195,10 +195,9 @@ msgstr "" #: discord.ext.commands.Bot.before_invoke #: discord.ext.commands.Bot.change_presence discord.ext.commands.Bot.connect #: discord.ext.commands.Bot.create_guild discord.ext.commands.Bot.delete_invite -#: discord.ext.commands.Bot.get_cog discord.ext.commands.Bot.get_cog_commands -#: discord.ext.commands.Bot.get_command discord.ext.commands.Bot.get_context -#: discord.ext.commands.Bot.get_invite discord.ext.commands.Bot.get_prefix -#: discord.ext.commands.Bot.get_user_info +#: discord.ext.commands.Bot.get_cog discord.ext.commands.Bot.get_command +#: discord.ext.commands.Bot.get_context discord.ext.commands.Bot.get_invite +#: discord.ext.commands.Bot.get_prefix discord.ext.commands.Bot.get_user_info #: discord.ext.commands.Bot.get_user_profile discord.ext.commands.Bot.invoke #: discord.ext.commands.Bot.is_owner discord.ext.commands.Bot.load_extension #: discord.ext.commands.Bot.login discord.ext.commands.Bot.process_commands @@ -208,6 +207,9 @@ msgstr "" #: discord.ext.commands.Bot.request_offline_members #: discord.ext.commands.Bot.unload_extension discord.ext.commands.Bot.wait_for #: discord.ext.commands.CategoryChannelConverter.convert +#: discord.ext.commands.Cog.cog_after_invoke +#: discord.ext.commands.Cog.cog_before_invoke +#: discord.ext.commands.Cog.cog_command_error discord.ext.commands.Cog.listener #: discord.ext.commands.ColourConverter.convert #: discord.ext.commands.Command.after_invoke #: discord.ext.commands.Command.before_invoke @@ -265,25 +267,40 @@ msgid "A cog is a class that has its own event listeners and commands." msgstr "" #: discord.ext.commands.Bot.add_cog:5 of -msgid "" -"They are meant as a way to organize multiple relevant commands into a " -"singular class that shares some state or no state at all." +msgid "The cog to register to the bot." msgstr "" -#: discord.ext.commands.Bot.add_cog:8 of -msgid "" -"The cog can also have a ``__global_check`` member function that allows " -"you to define a global check. See :meth:`.check` for more info. If the " -"name is ``__global_check_once`` then it's equivalent to the " -":meth:`.check_once` decorator." -msgstr "" +#: discord.ext.commands.Bot.add_cog discord.ext.commands.Bot.add_command +#: discord.ext.commands.Bot.after_invoke +#: discord.ext.commands.Bot.application_info +#: discord.ext.commands.Bot.before_invoke +#: discord.ext.commands.Bot.change_presence discord.ext.commands.Bot.connect +#: discord.ext.commands.Bot.create_guild discord.ext.commands.Bot.delete_invite +#: discord.ext.commands.Bot.get_invite discord.ext.commands.Bot.get_user_info +#: discord.ext.commands.Bot.get_user_profile +#: discord.ext.commands.Bot.get_webhook_info discord.ext.commands.Bot.listen +#: discord.ext.commands.Bot.load_extension discord.ext.commands.Bot.login +#: discord.ext.commands.Bot.request_offline_members +#: discord.ext.commands.Bot.wait_for discord.ext.commands.Cog.listener +#: discord.ext.commands.Command.after_invoke +#: discord.ext.commands.Command.before_invoke +#: discord.ext.commands.Command.can_run discord.ext.commands.Command.error +#: discord.ext.commands.Context.get_message +#: discord.ext.commands.Context.history discord.ext.commands.Context.pins +#: discord.ext.commands.Context.send discord.ext.commands.Group.add_command +#: discord.ext.commands.Group.after_invoke +#: discord.ext.commands.Group.before_invoke discord.ext.commands.Group.can_run +#: discord.ext.commands.Group.error discord.ext.commands.GroupMixin.add_command +#: discord.ext.commands.Paginator.add_line discord.ext.commands.command of +msgid "raises" +msgstr "例外" -#: discord.ext.commands.Bot.add_cog:13 of -msgid "More information will be documented soon." +#: discord.ext.commands.Bot.add_cog:7 of +msgid ":exc:`TypeError` -- The cog does not inherit from :class:`.Cog`." msgstr "" -#: discord.ext.commands.Bot.add_cog:15 of -msgid "The cog to register to the bot." +#: discord.ext.commands.Bot.add_cog:8 of +msgid ":exc:`CommandError` -- An error happened during loading." msgstr "" #: discord.ext.commands.Bot.add_command:1 @@ -308,29 +325,6 @@ msgstr "" msgid "The command to add." msgstr "" -#: discord.ext.commands.Bot.add_command discord.ext.commands.Bot.after_invoke -#: discord.ext.commands.Bot.application_info -#: discord.ext.commands.Bot.before_invoke -#: discord.ext.commands.Bot.change_presence discord.ext.commands.Bot.connect -#: discord.ext.commands.Bot.create_guild discord.ext.commands.Bot.delete_invite -#: discord.ext.commands.Bot.get_invite discord.ext.commands.Bot.get_user_info -#: discord.ext.commands.Bot.get_user_profile -#: discord.ext.commands.Bot.get_webhook_info discord.ext.commands.Bot.listen -#: discord.ext.commands.Bot.load_extension discord.ext.commands.Bot.login -#: discord.ext.commands.Bot.request_offline_members -#: discord.ext.commands.Bot.wait_for discord.ext.commands.Command.after_invoke -#: discord.ext.commands.Command.before_invoke -#: discord.ext.commands.Command.can_run discord.ext.commands.Command.error -#: discord.ext.commands.Context.get_message -#: discord.ext.commands.Context.history discord.ext.commands.Context.pins -#: discord.ext.commands.Context.send discord.ext.commands.Group.add_command -#: discord.ext.commands.Group.after_invoke -#: discord.ext.commands.Group.before_invoke discord.ext.commands.Group.can_run -#: discord.ext.commands.Group.error discord.ext.commands.GroupMixin.add_command -#: discord.ext.commands.Paginator.add_line discord.ext.commands.command of -msgid "raises" -msgstr "例外" - #: discord.ext.commands.Bot.add_command:9 #: discord.ext.commands.Group.add_command:9 #: discord.ext.commands.GroupMixin.add_command:9 of @@ -455,11 +449,9 @@ msgid "Retrieve's the bot's application information." msgstr "" #: discord.ext.commands.Bot.application_info -#: discord.ext.commands.Bot.create_guild -#: discord.ext.commands.Bot.get_cog_commands -#: discord.ext.commands.Bot.get_command discord.ext.commands.Bot.get_context -#: discord.ext.commands.Bot.get_invite discord.ext.commands.Bot.get_prefix -#: discord.ext.commands.Bot.get_user_info +#: discord.ext.commands.Bot.create_guild discord.ext.commands.Bot.get_command +#: discord.ext.commands.Bot.get_context discord.ext.commands.Bot.get_invite +#: discord.ext.commands.Bot.get_prefix discord.ext.commands.Bot.get_user_info #: discord.ext.commands.Bot.get_user_profile #: discord.ext.commands.Bot.get_webhook_info #: discord.ext.commands.Bot.remove_command discord.ext.commands.Bot.wait_for @@ -482,11 +474,9 @@ msgid "A namedtuple representing the application info." msgstr "" #: discord.ext.commands.Bot.application_info -#: discord.ext.commands.Bot.create_guild -#: discord.ext.commands.Bot.get_cog_commands -#: discord.ext.commands.Bot.get_command discord.ext.commands.Bot.get_context -#: discord.ext.commands.Bot.get_invite discord.ext.commands.Bot.get_prefix -#: discord.ext.commands.Bot.get_user_info +#: discord.ext.commands.Bot.create_guild discord.ext.commands.Bot.get_command +#: discord.ext.commands.Bot.get_context discord.ext.commands.Bot.get_invite +#: discord.ext.commands.Bot.get_prefix discord.ext.commands.Bot.get_user_info #: discord.ext.commands.Bot.get_user_profile #: discord.ext.commands.Bot.get_webhook_info #: discord.ext.commands.Bot.remove_command discord.ext.commands.Bot.wait_for @@ -802,27 +792,10 @@ msgid "If the cog is not found, ``None`` is returned instead." msgstr "" #: discord.ext.commands.Bot.get_cog:5 of -msgid "The name of the cog you are requesting." -msgstr "" - -#: discord.ext.commands.Bot.get_cog_commands:1 of -msgid "Gets a unique set of the cog's registered commands without aliases." -msgstr "" - -#: discord.ext.commands.Bot.get_cog_commands:4 of -msgid "If the cog is not found, an empty set is returned." -msgstr "" - -#: discord.ext.commands.Bot.get_cog_commands:6 of -msgid "The name of the cog whose commands you are requesting." -msgstr "" - -#: discord.ext.commands.Bot.get_cog_commands:9 of -msgid "A unique set of commands without aliases that belong to the cog." -msgstr "" - -#: discord.ext.commands.Bot.get_cog_commands:11 of -msgid "Set[:class:`.Command`]" +msgid "" +"The name of the cog you are requesting. This is equivalent to the name " +"passed via keyword argument in class creation or the class name if " +"unspecified." msgstr "" #: discord.ext.commands.Bot.get_command:1 @@ -1291,13 +1264,6 @@ msgid "If no cog is found then this method has no effect." msgstr "" #: discord.ext.commands.Bot.remove_cog:8 of -msgid "" -"If the cog defines a special member function named ``__unload`` then it " -"is called when removal has completed. This function **cannot** be a " -"coroutine. It must be a regular function." -msgstr "" - -#: discord.ext.commands.Bot.remove_cog:12 of msgid "The name of the cog to remove." msgstr "" @@ -1576,7 +1542,8 @@ msgid "A default one is provided (:meth:`.Bot.on_command_error`)." msgstr "" #: ../../ext/commands/api.rst:40 ../../ext/commands/api.rst:52 -#: ../../ext/commands/api.rst:62 +#: ../../ext/commands/api.rst:62 discord.ext.commands.Cog.cog_after_invoke:7 +#: discord.ext.commands.Cog.cog_before_invoke:7 of msgid "The invocation context." msgstr "" @@ -1756,6 +1723,21 @@ msgid "" "``True``." msgstr "" +#: discord.ext.commands.Command.update:1 discord.ext.commands.Group.update:1 of +msgid "Updates :class:`Command` instance with updated attribute." +msgstr "" + +#: discord.ext.commands.Command.update:3 discord.ext.commands.Group.update:3 of +msgid "" +"This works similarly to the :func:`.command` decorator in terms of " +"parameters in that they are passed to the :class:`Command` or subclass " +"constructors, sans the name and callback." +msgstr "" + +#: discord.ext.commands.Command.copy:1 of +msgid "Creates a copy of this :class:`Command`." +msgstr "" + #: discord.ext.commands.Command.clean_params:1 #: discord.ext.commands.Group.clean_params:1 of msgid "" @@ -1939,6 +1921,10 @@ msgid "" "insensitive. Defaults to ``False``." msgstr "" +#: discord.ext.commands.Group.copy:1 of +msgid "Creates a copy of this :class:`Group`." +msgstr "" + #: discord.ext.commands.GroupMixin:1 of msgid "" "A mixin that implements common functionality for classes that behave " @@ -1958,6 +1944,187 @@ msgid "" msgstr "" #: ../../ext/commands/api.rst:87 +msgid "Cogs" +msgstr "" + +#: discord.ext.commands.Cog:1 of +msgid "The base class that all cogs must inherit from." +msgstr "" + +#: discord.ext.commands.Cog:3 of +msgid "" +"A cog is a collection of commands, listeners, and optional state to help " +"group commands together. More information on them can be found on the " +":ref:`ext_commands_cogs` page." +msgstr "" + +#: discord.ext.commands.Cog:7 of +msgid "" +"When inheriting from this class, the options shown in :class:`CogMeta` " +"are equally valid here." +msgstr "" + +#: discord.ext.commands.Cog.get_commands:1 of +msgid "" +"Returns a :class:`list` of :class:`.Command`\\s that are defined inside " +"this cog." +msgstr "" + +#: discord.ext.commands.Cog.get_commands:6 of +msgid "This does not include subcommands." +msgstr "" + +#: discord.ext.commands.Cog.walk_commands:1 of +msgid "" +"An iterator that recursively walks through this cog's commands and " +"subcommands." +msgstr "" + +#: discord.ext.commands.Cog.get_listeners:1 of +msgid "" +"Returns a :class:`list` of (name, function) listener pairs that are " +"defined in this cog." +msgstr "" + +#: discord.ext.commands.Cog.listener:1 of +msgid "A decorator that marks a function as a listener." +msgstr "" + +#: discord.ext.commands.Cog.listener:3 of +msgid "This is the cog equivalent of :meth:`.Bot.listen`." +msgstr "" + +#: discord.ext.commands.Cog.listener:5 of +#, fuzzy +msgid "" +"The name of the event being listened to. If not provided, it defaults to " +"the function's name." +msgstr "使用するコマンドのデフォルトの名前は ``func.__name__`` です。" + +#: discord.ext.commands.Cog.listener:9 of +msgid ":exc:`TypeError` -- The function is not a coroutine function." +msgstr "" + +#: discord.ext.commands.Cog.cog_unload:1 of +msgid "A special method that is called when the cog gets removed." +msgstr "" + +#: discord.ext.commands.Cog.cog_unload:3 of +msgid "This function **cannot** be a coroutine. It must be a regular function." +msgstr "" + +#: discord.ext.commands.Cog.cog_unload:6 of +msgid "Subclasses must replace this if they want special unloading behaviour." +msgstr "" + +#: discord.ext.commands.Cog.bot_check_once:1 of +msgid "A special method that registers as a :meth:`.Bot.check_once` check." +msgstr "" + +#: discord.ext.commands.Cog.bot_check:4 +#: discord.ext.commands.Cog.bot_check_once:4 +#: discord.ext.commands.Cog.cog_check:4 of +msgid "" +"This function **can** be a coroutine and must take a sole parameter, " +"``ctx``, to represent the :class:`.Context`." +msgstr "" + +#: discord.ext.commands.Cog.bot_check:1 of +msgid "A special method that registers as a :meth:`.Bot.check` check." +msgstr "" + +#: discord.ext.commands.Cog.cog_check:1 of +msgid "" +"A special method that registers as a :func:`commands.check` for every " +"command and subcommand in this cog." +msgstr "" + +#: discord.ext.commands.Cog.cog_command_error:1 of +msgid "" +"A special method that is called whenever an error is dispatched inside " +"this cog." +msgstr "" + +#: discord.ext.commands.Cog.cog_command_error:4 of +msgid "" +"This is similar to :func:`.on_command_error` except only applying to the " +"commands inside this cog." +msgstr "" + +#: discord.ext.commands.Cog.cog_command_error:7 of +msgid "This function **can** be a coroutine." +msgstr "" + +#: discord.ext.commands.Cog.cog_command_error:9 of +msgid "The invocation context where the error happened." +msgstr "" + +#: discord.ext.commands.Cog.cog_command_error:11 of +msgid "The error that happened." +msgstr "" + +#: discord.ext.commands.Cog.cog_after_invoke:1 of +msgid "A special method that acts as a cog local post-invoke hook." +msgstr "" + +#: discord.ext.commands.Cog.cog_after_invoke:3 of +msgid "This is similar to :meth:`.Command.after_invoke`." +msgstr "" + +#: discord.ext.commands.Cog.cog_after_invoke:5 +#: discord.ext.commands.Cog.cog_before_invoke:5 of +msgid "This **must** be a coroutine." +msgstr "" + +#: discord.ext.commands.Cog.cog_before_invoke:1 of +msgid "A special method that acts as a cog local pre-invoke hook." +msgstr "" + +#: discord.ext.commands.Cog.cog_before_invoke:3 of +msgid "This is similar to :meth:`.Command.before_invoke`." +msgstr "" + +#: discord.ext.commands.CogMeta:1 of +msgid "A metaclass for defining a cog." +msgstr "" + +#: discord.ext.commands.CogMeta:3 of +msgid "" +"Note that you should probably not use this directly. It is exposed purely" +" for documentation purposes along with making custom metaclasses to " +"intermix with other metaclasses such as the :class:`abc.ABCMeta` " +"metaclass." +msgstr "" + +#: discord.ext.commands.CogMeta:7 of +msgid "" +"For example, to create an abstract cog mixin class, the following would " +"be done." +msgstr "" + +#: discord.ext.commands.CogMeta:24 of +msgid "" +"When passing an attribute of a metaclass that is documented below, note " +"that you must pass it as a keyword-only argument to the class creation " +"like the following example:" +msgstr "" + +#: discord.ext.commands.CogMeta:35 of +msgid "" +":class:`str` -- The cog name. By default, it is the name of the class " +"with no modification." +msgstr "" + +#: discord.ext.commands.CogMeta:39 of +msgid "" +":class:`dict` -- A list of attributes to apply to every command inside " +"this cog. The dictionary is passed into the :class:`Command` (or its " +"subclass) options at ``__init__``. If you specify attributes inside the " +"command attribute in the class, it will override the one specified inside" +" this attribute. For example:" +msgstr "" + +#: ../../ext/commands/api.rst:98 msgid "Formatters" msgstr "" @@ -2013,8 +2180,7 @@ msgstr "" msgid "" "The default base implementation that handles formatting of the help " "command." -msgstr "" -"helpコマンドの出力フォーマットに関する実装のデフォルトで、ベースクラスです。" +msgstr "helpコマンドの出力フォーマットに関する実装のデフォルトで、ベースクラスです。" #: discord.ext.commands.HelpFormatter:4 of msgid "" @@ -2022,33 +2188,28 @@ msgid "" ":meth:`~.HelpFormatter.format` should be overridden. A number of utility " "functions are provided for use inside that method." msgstr "" -"このクラスのフォーマット動作を上書きするには、" -":meth:`~.HelpFormatter.format` 関数をオーバーライドする必要があります。" -"本クラスでは、この関数内で使うことが出来るユーティリティ関数が数多く提供されています。" +"このクラスのフォーマット動作を上書きするには、:meth:`~.HelpFormatter.format` " +"関数をオーバーライドする必要があります。本クラスでは、この関数内で使うことが出来るユーティリティ関数が数多く提供されています。" #: discord.ext.commands.HelpFormatter:10 of msgid "" ":class:`bool` -- Dictates if hidden commands should be shown in the " "output. Defaults to ``False``." -msgstr "" -":class:`bool` -- 隠しコマンドを表示するかどうかを指定します。" -"デフォルトでは ``False`` です。" +msgstr ":class:`bool` -- 隠しコマンドを表示するかどうかを指定します。デフォルトでは ``False`` です。" #: discord.ext.commands.HelpFormatter:15 of msgid "" ":class:`bool` -- Dictates if commands that have their " ":attr:`.Command.checks` failed shown. Defaults to ``False``." msgstr "" -":class:`bool` -- :attr:`.Command.checks` が失敗したコマンドを表示するかどうかを指定します。" -"デフォルトでは ``False`` です。" +":class:`bool` -- :attr:`.Command.checks` が失敗したコマンドを表示するかどうかを指定します。デフォルトでは" +" ``False`` です。" #: discord.ext.commands.HelpFormatter:20 of msgid "" ":class:`int` -- The maximum number of characters that fit in a line. " "Defaults to 80." -msgstr "" -":class:`int` -- 1行に収める最大の文字数を指定します。" -"デフォルトでは80です。" +msgstr ":class:`int` -- 1行に収める最大の文字数を指定します。デフォルトでは80です。" #: discord.ext.commands.HelpFormatter:25 of msgid "" @@ -2056,10 +2217,9 @@ msgid "" "command is invoked with a category name. Useful for i18n. Defaults to " "``\"Commands:\"``" msgstr "" -":class:`str` -- help コマンドがカテゴリ名を伴って起動された際に、" -"コマンドの表題として表示される文字列を示します。" -"Botを翻訳する際に使うことができます。" -"デフォルトでは ``\"Commands:\"`` です。" +":class:`str` -- help " +"コマンドがカテゴリ名を伴って起動された際に、コマンドの表題として表示される文字列を示します。Botを翻訳する際に使うことができます。デフォルトでは" +" ``\"Commands:\"`` です。" #: discord.ext.commands.HelpFormatter:30 of msgid "" @@ -2067,77 +2227,71 @@ msgid "" "belong to any category(cog). Useful for i18n. Defaults to ``\"No " "Category\"``" msgstr "" -":class:`str` -- help コマンドが起動された際に、" -"いずれのカテゴリ(cog)にも属さないコマンドの表題として表示される文字列を示します。" -"Botを翻訳する際に使うことができます。" -"デフォルトでは ``\"No Category\"`` です。" +":class:`str` -- help " +"コマンドが起動された際に、いずれのカテゴリ(cog)にも属さないコマンドの表題として表示される文字列を示します。Botを翻訳する際に使うことができます。デフォルトでは" +" ``\"No Category\"`` です。" #: discord.ext.commands.HelpFormatter.has_subcommands:1 of msgid ":class:`bool`: Specifies if the command has subcommands." -msgstr "" -":class:`bool`: コマンドがサブコマンドを持つかを表します。" +msgstr ":class:`bool`: コマンドがサブコマンドを持つかを表します。" #: discord.ext.commands.HelpFormatter.is_bot:1 of msgid ":class:`bool`: Specifies if the command being formatted is the bot itself." -msgstr "" -":class:`bool`: フォーマット対象のコマンドが、bot自体であるかを表します。" +msgstr ":class:`bool`: フォーマット対象のコマンドが、bot自体であるかを表します。" #: discord.ext.commands.HelpFormatter.is_cog:1 of msgid ":class:`bool`: Specifies if the command being formatted is actually a cog." -msgstr "" -":class:`bool`: フォーマット対象のコマンドが、cogであるかを表します。" +msgstr ":class:`bool`: フォーマット対象のコマンドが、cogであるかを表します。" #: discord.ext.commands.HelpFormatter.shorten:1 of msgid "Shortens text to fit into the :attr:`width`." -msgstr "" -"渡された文字列を、 :attr:`width` に収まるよう省略します。" +msgstr "渡された文字列を、 :attr:`width` に収まるよう省略します。" #: discord.ext.commands.HelpFormatter.max_name_size:1 of msgid "" ":class:`int` -- Returns the largest name length of a command or if it has" " subcommands the largest subcommand name." -msgstr "" -"コマンドまたはサブコマンドのうち、最も長い名前の文字数を返します。" +msgstr "コマンドまたはサブコマンドのうち、最も長い名前の文字数を返します。" #: discord.ext.commands.HelpFormatter.clean_prefix:1 of msgid "" "The cleaned up invoke prefix. i.e. mentions are ``@name`` instead of " "``<@id>``." -msgstr "" -"「クリーンアップ」されたプレフィックスを返します。" -"たとえば、メンションは ``<@id>`` のかわりに ``@name`` となります。" +msgstr "「クリーンアップ」されたプレフィックスを返します。たとえば、メンションは ``<@id>`` のかわりに ``@name`` となります。" #: discord.ext.commands.HelpFormatter.get_command_signature:1 of msgid "Retrieves the signature portion of the help page." msgstr "ヘルプページに表示される、コマンドの使用方法を示す文字列を返します。" +#: discord.ext.commands.HelpFormatter.get_ending_note:1 of +msgid "" +"Returns help command's ending note. This is mainly useful to override for" +" i18n purposes." +msgstr "" + #: discord.ext.commands.HelpFormatter.filter_command_list:1 of msgid "" "Returns a filtered list of commands based on the two attributes provided," " :attr:`show_check_failure` and :attr:`show_hidden`. Also filters based " "on if :meth:`~.HelpFormatter.is_cog` is valid." msgstr "" -":attr:`show_check_failure` と :attr:`show_hidden` に基づき、" -"フィルタリングされたコマンドのリストを返します。" -"また、 :meth:`~.HelpFormatter.is_cog` が有効かどうかにも基づいてフィルタリングします。" +":attr:`show_check_failure` と :attr:`show_hidden` " +"に基づき、フィルタリングされたコマンドのリストを返します。また、 :meth:`~.HelpFormatter.is_cog` " +"が有効かどうかにも基づいてフィルタリングします。" #: discord.ext.commands.HelpFormatter.filter_command_list:5 of msgid "" "An iterable with the filter being applied. The resulting value is a (key," " value) :class:`tuple` of the command name and the command itself." -msgstr "" -"フィルタリングされたイテラブル。" -"結果は、コマンド名とコマンド自身の、 (key, value) :class:`tuple` 形式で返されます。。" +msgstr "フィルタリングされたイテラブル。結果は、コマンド名とコマンド自身の、 (key, value) :class:`tuple` 形式で返されます。。" #: discord.ext.commands.HelpFormatter.format:1 of msgid "Handles the actual behaviour involved with formatting." -msgstr "" -"フォーマットに関わる実際の挙動を扱う関数です。" +msgstr "フォーマットに関わる実際の挙動を扱う関数です。" #: discord.ext.commands.HelpFormatter.format:3 of msgid "To change the behaviour, this method should be overridden." -msgstr "" -"フォーマットに関する挙動を変更したい場合、このメソッドをオーバーライドする必要があります。" +msgstr "フォーマットに関する挙動を変更したい場合、このメソッドをオーバーライドする必要があります。" #: discord.ext.commands.HelpFormatter.format:5 #: discord.ext.commands.HelpFormatter.format_help_for:10 of @@ -2150,20 +2304,18 @@ msgid "" "help command looks like. To change the behaviour, override the " ":meth:`~.HelpFormatter.format` method." msgstr "" -"helpページをフォーマットし、helpコマンドがどう見えるかのもっとも重要な処理を行います。" -"この挙動を変更したい場合、:meth:`~.HelpFormatter.format` をオーバーライドして下さい。" +"helpページをフォーマットし、helpコマンドがどう見えるかのもっとも重要な処理を行います。この挙動を変更したい場合、:meth:`~.HelpFormatter.format`" +" をオーバーライドして下さい。" #: discord.ext.commands.HelpFormatter.format_help_for:5 of msgid "The context of the invoked help command." -msgstr "" -"helpコマンドを起動したコンテキスト。" +msgstr "helpコマンドを起動したコンテキスト。" #: discord.ext.commands.HelpFormatter.format_help_for:7 of msgid "The bot or command that we are getting the help of." -msgstr "" -"ヘルプを取得する対象のBot、またはcommand。" +msgstr "ヘルプを取得する対象のBot、またはcommand。" -#: ../../ext/commands/api.rst:98 +#: ../../ext/commands/api.rst:109 msgid "Checks" msgstr "" @@ -2384,7 +2536,7 @@ msgstr "" msgid "A :func:`.check` that checks if the channel is a NSFW channel." msgstr "" -#: ../../ext/commands/api.rst:125 +#: ../../ext/commands/api.rst:136 msgid "Context" msgstr "" @@ -2789,7 +2941,7 @@ msgid "" ":attr:`Guild.voice_client`\\, if applicable." msgstr "" -#: ../../ext/commands/api.rst:141 +#: ../../ext/commands/api.rst:152 msgid "Converters" msgstr "" @@ -3043,34 +3195,34 @@ msgstr "" msgid ":obj:`bool` -- Whether to also escape special markdown characters." msgstr "" -#: ../../ext/commands/api.rst:184 +#: ../../ext/commands/api.rst:195 msgid "" "A special converter that greedily consumes arguments until it can't. As a" " consequence of this behaviour, most input errors are silently discarded," " since it is used as an indicator of when to stop parsing." msgstr "" -#: ../../ext/commands/api.rst:188 +#: ../../ext/commands/api.rst:199 msgid "" "When a parser error is met the greedy converter stops converting, undoes " "the internal string parsing routine, and continues parsing regularly." msgstr "" -#: ../../ext/commands/api.rst:191 +#: ../../ext/commands/api.rst:202 msgid "For example, in the following code:" msgstr "" -#: ../../ext/commands/api.rst:199 +#: ../../ext/commands/api.rst:210 msgid "" "An invocation of ``[p]test 1 2 3 4 5 6 hello`` would pass ``numbers`` " "with ``[1, 2, 3, 4, 5, 6]`` and ``reason`` with ``hello``\\." msgstr "" -#: ../../ext/commands/api.rst:202 +#: ../../ext/commands/api.rst:213 msgid "For more information, check :ref:`ext_commands_special_converters`." msgstr "" -#: ../../ext/commands/api.rst:207 +#: ../../ext/commands/api.rst:218 msgid "Errors" msgstr "エラー" @@ -3282,3 +3434,50 @@ msgstr "" #~ msgid "An argument list of names to check that the member has roles wise." #~ msgstr "" +#~ msgid "" +#~ "They are meant as a way to " +#~ "organize multiple relevant commands into " +#~ "a singular class that shares some " +#~ "state or no state at all." +#~ msgstr "" + +#~ msgid "" +#~ "The cog can also have a " +#~ "``__global_check`` member function that allows" +#~ " you to define a global check. " +#~ "See :meth:`.check` for more info. If " +#~ "the name is ``__global_check_once`` then " +#~ "it's equivalent to the :meth:`.check_once` " +#~ "decorator." +#~ msgstr "" + +#~ msgid "More information will be documented soon." +#~ msgstr "" + +#~ msgid "The name of the cog you are requesting." +#~ msgstr "" + +#~ msgid "Gets a unique set of the cog's registered commands without aliases." +#~ msgstr "" + +#~ msgid "If the cog is not found, an empty set is returned." +#~ msgstr "" + +#~ msgid "The name of the cog whose commands you are requesting." +#~ msgstr "" + +#~ msgid "A unique set of commands without aliases that belong to the cog." +#~ msgstr "" + +#~ msgid "Set[:class:`.Command`]" +#~ msgstr "" + +#~ msgid "" +#~ "If the cog defines a special " +#~ "member function named ``__unload`` then " +#~ "it is called when removal has " +#~ "completed. This function **cannot** be a" +#~ " coroutine. It must be a regular " +#~ "function." +#~ msgstr "" + diff --git a/docs/locale/ja/LC_MESSAGES/ext/commands/cogs.po b/docs/locale/ja/LC_MESSAGES/ext/commands/cogs.po new file mode 100644 index 000000000..9c7d1de8e --- /dev/null +++ b/docs/locale/ja/LC_MESSAGES/ext/commands/cogs.po @@ -0,0 +1,225 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2015-2019, Rapptz +# This file is distributed under the same license as the discord.py package. +# FIRST AUTHOR , 2019. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: discord.py 1.0.0a\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-02-24 04:09-0500\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.5.3\n" + +#: ../../ext/commands/cogs.rst:6 +msgid "Cogs" +msgstr "" + +#: ../../ext/commands/cogs.rst:8 +msgid "" +"There comes a point in your bot's development when you want to organize a" +" collection of commands, listeners, and some state into one class. Cogs " +"allow you to do just that." +msgstr "" + +#: ../../ext/commands/cogs.rst:10 +msgid "The gist:" +msgstr "" + +#: ../../ext/commands/cogs.rst:12 +msgid "Each cog is a Python class that subclasses :class:`.commands.Cog`." +msgstr "" + +#: ../../ext/commands/cogs.rst:13 +msgid "Every command is marked with the :func:`.commands.command` decorator." +msgstr "" + +#: ../../ext/commands/cogs.rst:14 +msgid "" +"Every listener is marked with the :meth:`.commands.Cog.listener` " +"decorator." +msgstr "" + +#: ../../ext/commands/cogs.rst:15 +msgid "Cogs are then registered with the :meth:`.Bot.add_cog` call." +msgstr "" + +#: ../../ext/commands/cogs.rst:16 +msgid "Cogs are subsequently removed with the :meth:`.Bot.remove_cog` call." +msgstr "" + +#: ../../ext/commands/cogs.rst:18 +msgid "" +"It should be noted that cogs are typically used alongside with " +":ref:`ext_commands_extensions`." +msgstr "" + +#: ../../ext/commands/cogs.rst:21 +msgid "Quick Example" +msgstr "" + +#: ../../ext/commands/cogs.rst:23 +msgid "" +"This example cog defines a ``Greetings`` category for your commands, with" +" a single :ref:`command ` named ``hello`` as well " +"as a listener to listen to an :ref:`Event `." +msgstr "" + +#: ../../ext/commands/cogs.rst:48 +msgid "A couple of technical notes to take into consideration:" +msgstr "" + +#: ../../ext/commands/cogs.rst:50 +msgid "" +"All listeners must be explicitly marked via decorator, " +":meth:`~.commands.Cog.listener`." +msgstr "" + +#: ../../ext/commands/cogs.rst:51 +msgid "" +"The name of the cog is automatically derived from the class name but can " +"be overridden. See :ref:`ext_commands_cogs_meta_options`." +msgstr "" + +#: ../../ext/commands/cogs.rst:52 +msgid "" +"All commands must now take a ``self`` parameter to allow usage of " +"instance attributes that can be used to maintain state." +msgstr "" + +#: ../../ext/commands/cogs.rst:55 +msgid "Cog Registration" +msgstr "" + +#: ../../ext/commands/cogs.rst:57 +msgid "" +"Once you have defined your cogs, you need to tell the bot to register the" +" cogs to be used. We do this via the :meth:`~.commands.Bot.add_cog` " +"method." +msgstr "" + +#: ../../ext/commands/cogs.rst:63 +msgid "" +"This binds the cog to the bot, adding all commands and listeners to the " +"bot automatically." +msgstr "" + +#: ../../ext/commands/cogs.rst:65 +msgid "" +"Note that we reference the cog by name, which we can override through " +":ref:`ext_commands_cogs_meta_options`. So if we ever want to remove the " +"cog eventually, we would have to do the following." +msgstr "" + +#: ../../ext/commands/cogs.rst:72 +msgid "Using Cogs" +msgstr "" + +#: ../../ext/commands/cogs.rst:74 +msgid "" +"Just as we remove a cog by its name, we can also retrieve it by its name " +"as well. This allows us to use a cog as an inter-command communication " +"protocol to share data. For example:" +msgstr "" + +#: ../../ext/commands/cogs.rst:109 +msgid "Special Methods" +msgstr "" + +#: ../../ext/commands/cogs.rst:111 +msgid "" +"As cogs get more complicated and have more commands, there comes a point " +"where we want to customise the behaviour of the entire cog or bot." +msgstr "" + +#: ../../ext/commands/cogs.rst:113 +msgid "They are as follows:" +msgstr "" + +#: ../../ext/commands/cogs.rst:115 +msgid ":meth:`.Cog.cog_unload`" +msgstr "" + +#: ../../ext/commands/cogs.rst:116 +msgid ":meth:`.Cog.cog_check`" +msgstr "" + +#: ../../ext/commands/cogs.rst:117 +msgid ":meth:`.Cog.cog_command_error`" +msgstr "" + +#: ../../ext/commands/cogs.rst:118 +msgid ":meth:`.Cog.cog_before_invoke`" +msgstr "" + +#: ../../ext/commands/cogs.rst:119 +msgid ":meth:`.Cog.cog_after_invoke`" +msgstr "" + +#: ../../ext/commands/cogs.rst:120 +msgid ":meth:`.Cog.bot_check`" +msgstr "" + +#: ../../ext/commands/cogs.rst:121 +msgid ":meth:`.Cog.bot_check_once`" +msgstr "" + +#: ../../ext/commands/cogs.rst:123 +msgid "You can visit the reference to get more detail." +msgstr "" + +#: ../../ext/commands/cogs.rst:128 +msgid "Meta Options" +msgstr "" + +#: ../../ext/commands/cogs.rst:130 +msgid "" +"At the heart of a cog resides a metaclass, :class:`.commands.CogMeta`, " +"which can take various options to customise some of the behaviour. To do " +"this, we pass keyword arguments to the class definition line. For " +"example, to change the cog name we can pass the ``name`` keyword argument" +" as follows:" +msgstr "" + +#: ../../ext/commands/cogs.rst:137 +msgid "" +"To see more options that you can set, see the documentation of " +":class:`.commands.CogMeta`." +msgstr "" + +#: ../../ext/commands/cogs.rst:140 +msgid "Inspection" +msgstr "" + +#: ../../ext/commands/cogs.rst:142 +msgid "" +"Since cogs ultimately are classes, we have some tools to help us inspect " +"certain properties of the cog." +msgstr "" + +#: ../../ext/commands/cogs.rst:145 +msgid "" +"To get a :class:`list` of commands, we can use :meth:`.Cog.get_commands`." +" ::" +msgstr "" + +#: ../../ext/commands/cogs.rst:151 +msgid "" +"If we want to get the subcommands as well, we can use the " +":meth:`.Cog.walk_commands` generator. ::" +msgstr "" + +#: ../../ext/commands/cogs.rst:155 +msgid "" +"To do the same with listeners, we can query them with " +":meth:`.Cog.get_listeners`. This returns a list of tuples -- the first " +"element being the listener name and the second one being the actual " +"function itself. ::" +msgstr "" + diff --git a/docs/locale/ja/LC_MESSAGES/ext/commands/extensions.po b/docs/locale/ja/LC_MESSAGES/ext/commands/extensions.po new file mode 100644 index 000000000..53d06b2e2 --- /dev/null +++ b/docs/locale/ja/LC_MESSAGES/ext/commands/extensions.po @@ -0,0 +1,111 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2015-2019, Rapptz +# This file is distributed under the same license as the discord.py package. +# FIRST AUTHOR , 2019. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: discord.py 1.0.0a\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-02-24 04:09-0500\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.5.3\n" + +#: ../../ext/commands/extensions.rst:6 +msgid "Extensions" +msgstr "" + +#: ../../ext/commands/extensions.rst:8 +msgid "" +"There comes a time in the bot development when you want to extend the bot" +" functionality at run-time and quickly unload and reload code (also " +"called hot-reloading). The command framework comes with this ability " +"built-in, with a concept called **extensions**." +msgstr "" + +#: ../../ext/commands/extensions.rst:11 +msgid "Primer" +msgstr "" + +#: ../../ext/commands/extensions.rst:13 +msgid "" +"An extension at its core is a python file with an entry point called " +"``setup``. This setup must be a plain Python function (not a coroutine). " +"It takes a single parameter -- the :class:`~.commands.Bot` that loads the" +" extension." +msgstr "" + +#: ../../ext/commands/extensions.rst:15 +msgid "An example extension looks like this:" +msgstr "" + +#: ../../ext/commands/extensions.rst:17 +msgid "hello.py" +msgstr "" + +#: ../../ext/commands/extensions.rst:30 +msgid "" +"In this example we define a simple command, and when the extension is " +"loaded this command is added to the bot. Now the final step to this is " +"loading the extension, which we do by calling " +":meth:`.commands.Bot.load_extension`. To load this extension we call " +"``bot.load_extension('hello')``." +msgstr "" + +#: ../../ext/commands/extensions.rst:32 +msgid "Cogs" +msgstr "" + +#: ../../ext/commands/extensions.rst:35 +msgid "" +"Extensions are usually used in conjunction with cogs. To read more about " +"them, check out the documentation, :ref:`ext_commands_cogs`." +msgstr "" + +#: ../../ext/commands/extensions.rst:39 +msgid "" +"Extension paths are ultimately similar to the import mechanism. What this" +" means is that if there is a folder, then it must be dot-qualified. For " +"example to load an extension in ``plugins/hello.py`` then we use the " +"string ``plugins.hello``." +msgstr "" + +#: ../../ext/commands/extensions.rst:42 +msgid "Reloading" +msgstr "" + +#: ../../ext/commands/extensions.rst:44 +msgid "" +"The act of reloading an extension is actually quite simple -- it is as " +"simple as unloading it and then reloading it." +msgstr "" + +#: ../../ext/commands/extensions.rst:51 +msgid "" +"Once we remove and load the extension, any changes that we did will be " +"applied upon load. This is useful if we want to add or remove " +"functionality without restarting our bot." +msgstr "" + +#: ../../ext/commands/extensions.rst:54 +msgid "Cleaning Up" +msgstr "" + +#: ../../ext/commands/extensions.rst:56 +msgid "" +"Although rare, sometimes an extension needs to clean-up or know when it's" +" being unloaded. For cases like these, there is another entry point named" +" ``teardown`` which is similar to ``setup`` except called when the " +"extension is unloaded." +msgstr "" + +#: ../../ext/commands/extensions.rst:58 +msgid "basic_ext.py" +msgstr "" + diff --git a/docs/locale/ja/LC_MESSAGES/migrating.po b/docs/locale/ja/LC_MESSAGES/migrating.po index 66f43a2c7..7e8fb0e9b 100644 --- a/docs/locale/ja/LC_MESSAGES/migrating.po +++ b/docs/locale/ja/LC_MESSAGES/migrating.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: PROJECT VERSION\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" -"POT-Creation-Date: 2019-02-18 03:50-0500\n" +"POT-Creation-Date: 2019-02-24 04:09-0500\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: Episword , 2018\n" "Language: ja_JP\n" @@ -1158,7 +1158,7 @@ msgstr "" "変更点の一つは、以前の ``Client.send_message`` と ``Client.send_file`` の機能を単一のメソッド " ":meth:`~abc.Messageable.send` に統合したことです。" -#: ../../migrating.rst:417 ../../migrating.rst:997 +#: ../../migrating.rst:417 ../../migrating.rst:1009 msgid "Basically: ::" msgstr "基本形" @@ -1344,7 +1344,7 @@ msgid "Before: ::" msgstr "更新前" #: ../../migrating.rst:529 ../../migrating.rst:541 ../../migrating.rst:553 -#: ../../migrating.rst:621 ../../migrating.rst:924 ../../migrating.rst:1077 +#: ../../migrating.rst:621 ../../migrating.rst:924 ../../migrating.rst:1091 msgid "After: ::" msgstr "更新後" @@ -2083,66 +2083,114 @@ msgid "Cog Changes" msgstr "コグの変更" #: ../../migrating.rst:942 -msgid "Cog special methods have changed slightly." -msgstr "コグの特殊なメソッドに少し変更がありました。" +msgid "" +"Cogs have completely been revamped. They are documented in " +":ref:`ext_commands_cogs` as well." +msgstr "" #: ../../migrating.rst:944 msgid "" -"The previous ``__check`` special method has been renamed to " -"``__global_check`` to make it more clear that it's a global check." +"Cogs are now required to have a base class, :class:`~.commands.Cog` for " +"future proofing purposes. This comes with special methods to customise " +"some behaviour." +msgstr "" + +#: ../../migrating.rst:946 +msgid ":meth:`.Cog.cog_unload`" msgstr "" -"以前 ``__check`` として使用されていたメソッドはグローバルチェックであることをより明確にするため、名前が " -"``__global_check`` に変更されました。" #: ../../migrating.rst:947 msgid "" -"To complement the new ``__global_check`` there is now a new " -"``__local_check`` to facilitate a check that will run on every command in" -" the cog. There is also a ``__global_check_once``, which is similar to a " -"global check instead it is only called once per :meth:`.Bot.invoke` call " -"rather than every :meth:`.Command.invoke` call. Practically, the " -"difference is only for black-listing users or channels without constantly" -" opening a database connection." +"This is called when a cog needs to do some cleanup, such as cancelling a " +"task." +msgstr "" + +#: ../../migrating.rst:948 +msgid ":meth:`.Cog.bot_check_once`" +msgstr "" + +#: ../../migrating.rst:949 +msgid "This registers a :meth:`.Bot.check_once` check." +msgstr "" + +#: ../../migrating.rst:950 +msgid ":meth:`.Cog.bot_check`" +msgstr "" + +#: ../../migrating.rst:951 +msgid "This registers a regular :meth:`.Bot.check` check." msgstr "" #: ../../migrating.rst:952 -msgid "" -"Cogs have also gained a ``__before_invoke`` and ``__after_invoke`` cog " -"local before and after invocation hook, which can be seen in " -":ref:`migrating_1_0_before_after_hook`." +msgid ":meth:`.Cog.cog_check`" +msgstr "" + +#: ../../migrating.rst:953 +msgid "This registers a check that applies to every command in the cog." +msgstr "" + +#: ../../migrating.rst:954 +msgid ":meth:`.Cog.cog_command_error`" msgstr "" #: ../../migrating.rst:955 msgid "" -"The final addition is cog-local error handler, ``__error``, that is run " -"on every command in the cog." +"This is a special error handler that is called whenever an error happens " +"inside the cog." +msgstr "" + +#: ../../migrating.rst:957 +msgid ":meth:`.Cog.cog_before_invoke` and :meth:`.Cog.cog_after_invoke`" msgstr "" #: ../../migrating.rst:957 -msgid "An example cog with every special method registered is as follows: ::" +msgid "" +"A special method that registers a cog before and after invoke hook. More " +"information can be found in :ref:`migrating_1_0_before_after_hook`." +msgstr "" + +#: ../../migrating.rst:959 +msgid "" +"Those that were using listeners, such as ``on_message`` inside a cog will" +" now have to explicitly mark them as such using the " +":meth:`.commands.Cog.listener` decorator." +msgstr "" + +#: ../../migrating.rst:961 +msgid "" +"Along with that, cogs have gained the ability to have custom names " +"through specifying it in the class definition line. More options can be " +"found in the metaclass that facilitates all this, " +":class:`.commands.CogMeta`." +msgstr "" + +#: ../../migrating.rst:963 +msgid "" +"An example cog with every special method registered and a custom name is " +"as follows:" msgstr "" -#: ../../migrating.rst:988 +#: ../../migrating.rst:1000 msgid "Before and After Invocation Hooks" msgstr "前後処理のフック" -#: ../../migrating.rst:990 +#: ../../migrating.rst:1002 msgid "" "Commands have gained new before and after invocation hooks that allow you" " to do an action before and after a command is run." msgstr "コマンドに、コマンドの実行前および実行後に処理が行えるようにするフックが新たに追加されました。" -#: ../../migrating.rst:993 +#: ../../migrating.rst:1005 msgid "" "They take a single parameter, :class:`~ext.commands.Context` and they " "must be a coroutine." msgstr "これは単一のパラメータとして :class:`~ext.commands.Context` を受け取り、かつコルーチンである必要があります。" -#: ../../migrating.rst:995 +#: ../../migrating.rst:1007 msgid "They are on a global, per-cog, or per-command basis." msgstr "また、このフックは全体、コグごと、あるいはコマンドごとに設定することが可能です。" -#: ../../migrating.rst:1012 +#: ../../migrating.rst:1024 msgid "" "The after invocation is hook always called, **regardless of an error in " "the command**. This makes it ideal for some error handling or clean up of" @@ -2151,66 +2199,67 @@ msgstr "" "後処理のフックは **コマンドのエラー発生に関わらず** " "必ず呼び出されます。そのため、データベース接続のようなリソースのクリーンアップやエラー処理に最適です。" -#: ../../migrating.rst:1015 +#: ../../migrating.rst:1027 msgid "The per-command registration is as follows: ::" msgstr "コマンドごとに設定する方法は以下のとおりです。" -#: ../../migrating.rst:1031 +#: ../../migrating.rst:1043 +#, fuzzy msgid "" -"The special cog method for these is ``__before_invoke`` and " -"``__after_invoke``, e.g.: ::" +"The special cog method for these is :meth:`.Cog.cog_before_invoke` and " +":meth:`.Cog.cog_after_invoke`, e.g.:" msgstr "特定のコグへの実装は以下の例のように ``__before_invoke`` と ``__after_invoke`` メソッドを用いてください。" -#: ../../migrating.rst:1044 +#: ../../migrating.rst:1058 msgid "" "To check if a command failed in the after invocation hook, you can use " ":attr:`.Context.command_failed`." msgstr ":attr:`.Context.command_failed` を使うことで、後処理でコマンドがエラーになったかを確認する事ができます。" -#: ../../migrating.rst:1047 +#: ../../migrating.rst:1061 msgid "The invocation order is as follows:" msgstr "呼び出される順序は以下のとおりです。" -#: ../../migrating.rst:1049 +#: ../../migrating.rst:1063 msgid "Command local before invocation hook" msgstr "コマンドごとの前処理。" -#: ../../migrating.rst:1050 +#: ../../migrating.rst:1064 msgid "Cog local before invocation hook" msgstr "コグごとの前処理。" -#: ../../migrating.rst:1051 +#: ../../migrating.rst:1065 msgid "Global before invocation hook" msgstr "全体での前処理。" -#: ../../migrating.rst:1052 +#: ../../migrating.rst:1066 msgid "The actual command" msgstr "実行されたコマンド。" -#: ../../migrating.rst:1053 +#: ../../migrating.rst:1067 msgid "Command local after invocation hook" msgstr "コマンドごとの後処理。" -#: ../../migrating.rst:1054 +#: ../../migrating.rst:1068 msgid "Cog local after invocation hook" msgstr "コグごとの後処理。" -#: ../../migrating.rst:1055 +#: ../../migrating.rst:1069 msgid "Global after invocation hook" msgstr "全体での後処理。" -#: ../../migrating.rst:1058 +#: ../../migrating.rst:1072 msgid "Converter Changes" msgstr "コンバーターの変更" -#: ../../migrating.rst:1060 +#: ../../migrating.rst:1074 msgid "" "Prior to v1.0, a converter was a type hint that could be a callable that " "could be invoked with a singular argument denoting the argument passed by" " the user as a string." msgstr "" -#: ../../migrating.rst:1063 +#: ../../migrating.rst:1077 msgid "" "This system was eventually expanded to support a " ":class:`~ext.commands.Converter` system to allow plugging in the " @@ -2218,7 +2267,7 @@ msgid "" "as the built-in \"discord\" converters." msgstr "" -#: ../../migrating.rst:1067 +#: ../../migrating.rst:1081 msgid "" "In v1.0 this converter system was revamped to allow instances of " ":class:`~ext.commands.Converter` derived classes to be passed. For " @@ -2227,35 +2276,80 @@ msgid "" "parameters." msgstr "" -#: ../../migrating.rst:1071 +#: ../../migrating.rst:1085 msgid "Essentially, before: ::" msgstr "" -#: ../../migrating.rst:1083 +#: ../../migrating.rst:1097 msgid "The command framework also got a couple new converters:" msgstr "コマンドフレームワークにも二つのコンバーターが追加されました。" -#: ../../migrating.rst:1085 +#: ../../migrating.rst:1099 msgid "" ":class:`~ext.commands.clean_content` this is akin to " ":attr:`Message.clean_content` which scrubs mentions." msgstr "" -#: ../../migrating.rst:1086 +#: ../../migrating.rst:1100 msgid "" ":class:`~ext.commands.UserConverter` will now appropriately convert " ":class:`User` only." msgstr "" -#: ../../migrating.rst:1087 +#: ../../migrating.rst:1101 msgid "``ChannelConverter`` is now split into two different converters." msgstr "``ChannelConverter`` は二つのコンバーターに分離されました。" -#: ../../migrating.rst:1089 +#: ../../migrating.rst:1103 msgid ":class:`~ext.commands.TextChannelConverter` for :class:`TextChannel`." msgstr ":class:`TextChannel` 用の :class:`~ext.commands.TextChannelConverter` 。" -#: ../../migrating.rst:1090 +#: ../../migrating.rst:1104 msgid ":class:`~ext.commands.VoiceChannelConverter` for :class:`VoiceChannel`." msgstr ":class:`VoiceChannel` 用の :class:`~ext.commands.VoiceChannelConverter` 。" +#~ msgid "Cog special methods have changed slightly." +#~ msgstr "コグの特殊なメソッドに少し変更がありました。" + +#~ msgid "" +#~ "The previous ``__check`` special method " +#~ "has been renamed to ``__global_check`` " +#~ "to make it more clear that it's" +#~ " a global check." +#~ msgstr "" +#~ "以前 ``__check`` として使用されていたメソッドはグローバルチェックであることをより明確にするため、名前が" +#~ " ``__global_check`` に変更されました。" + +#~ msgid "" +#~ "To complement the new ``__global_check`` " +#~ "there is now a new ``__local_check`` " +#~ "to facilitate a check that will " +#~ "run on every command in the cog." +#~ " There is also a ``__global_check_once``," +#~ " which is similar to a global " +#~ "check instead it is only called " +#~ "once per :meth:`.Bot.invoke` call rather " +#~ "than every :meth:`.Command.invoke` call. " +#~ "Practically, the difference is only for" +#~ " black-listing users or channels " +#~ "without constantly opening a database " +#~ "connection." +#~ msgstr "" + +#~ msgid "" +#~ "Cogs have also gained a " +#~ "``__before_invoke`` and ``__after_invoke`` cog " +#~ "local before and after invocation hook," +#~ " which can be seen in " +#~ ":ref:`migrating_1_0_before_after_hook`." +#~ msgstr "" + +#~ msgid "" +#~ "The final addition is cog-local " +#~ "error handler, ``__error``, that is run" +#~ " on every command in the cog." +#~ msgstr "" + +#~ msgid "An example cog with every special method registered is as follows: ::" +#~ msgstr "" +