diff --git a/sphinx/application.py b/sphinx/application.py index 5342730fd..9fdc240de 100644 --- a/sphinx/application.py +++ b/sphinx/application.py @@ -197,7 +197,7 @@ class Sphinx: # notice for parallel build on macOS and py38+ if sys.version_info > (3, 8) and platform.system() == 'Darwin' and parallel > 1: - logger.info(bold(__("For security reason, parallel mode is disabled on macOS and " + logger.info(bold(__("For security reasons, parallel mode is disabled on macOS and " "python3.8 and above. For more details, please read " "https://github.com/sphinx-doc/sphinx/issues/6803"))) @@ -415,7 +415,7 @@ class Sphinx: :param event: The name of target event :param callback: Callback function for the event :param priority: The priority of the callback. The callbacks will be invoked - in the order of *priority* in asending. + in order of *priority* (ascending). :return: A listener ID. It can be used for :meth:`disconnect`. .. versionchanged:: 3.0 @@ -493,7 +493,7 @@ class Sphinx: values accordingly. - :param name: The name of configuration value. It is recommended to be prefixed + :param name: The name of the configuration value. It is recommended to be prefixed with the extension name (ex. ``html_logo``, ``epub_title``) :param default: The default value of the configuration. :param rebuild: The condition of rebuild. It must be one of those values: @@ -539,10 +539,10 @@ class Sphinx: """Register or override a Docutils translator class. This is used to register a custom output translator or to replace a - builtin translator. This allows extensions to use custom translator + builtin translator. This allows extensions to use a custom translator and define custom nodes for the translator (see :meth:`add_node`). - :param name: The name of builder for the translator + :param name: The name of the builder for the translator :param translator_class: A translator class :param override: If true, install the translator forcedly even if another translator is already installed as the same name @@ -606,11 +606,11 @@ class Sphinx: using :rst:role:`numref`. :param node: A node class - :param figtype: The type of enumerable nodes. Each figtypes have individual numbering - sequences. As a system figtypes, ``figure``, ``table`` and - ``code-block`` are defined. It is able to add custom nodes to these - default figtypes. It is also able to define new custom figtype if new - figtype is given. + :param figtype: The type of enumerable nodes. Each figtype has individual numbering + sequences. As system figtypes, ``figure``, ``table`` and + ``code-block`` are defined. It is possible to add custom nodes to these + default figtypes. It is also possible to define new custom figtype if + a new figtype is given. :param title_getter: A getter function to obtain the title of node. It takes an instance of the enumerable node, and it must return its title as string. The title is used to the default title of references for @@ -629,7 +629,7 @@ class Sphinx: def add_directive(self, name: str, cls: Type[Directive], override: bool = False) -> None: """Register a Docutils directive. - :param name: The name of directive + :param name: The name of the directive :param cls: A directive class :param override: If true, install the directive forcedly even if another directive is already installed as the same name @@ -755,9 +755,9 @@ class Sphinx: Like :meth:`add_role`, but the role is added to the domain named *domain*. - :param domain: The name of target domain - :param name: A name of role - :param role: A role function + :param domain: The name of the target domain + :param name: The name of the role + :param role: The role function :param override: If true, install the role forcedly even if another role is already installed as the same name @@ -773,8 +773,8 @@ class Sphinx: Add a custom *index* class to the domain named *domain*. - :param domain: The name of target domain - :param index: A index class + :param domain: The name of the target domain + :param index: The index class :param override: If true, install the index forcedly even if another index is already installed as the same name @@ -942,8 +942,8 @@ class Sphinx: Add *filename* to the list of JavaScript files that the default HTML template will include in order of *priority* (ascending). The filename must be relative to the HTML static path , or a full URI with scheme. - If the priority of JavaScript file is the same as others, the JavaScript - files will be included in order of the registration. If the keyword + If the priority of the JavaScript file is the same as others, the JavaScript + files will be included in order of registration. If the keyword argument ``body`` is given, its value will be added between the ``