From 3e964f79681ad2c2d11ebcd8e966f62f18c549e9 Mon Sep 17 00:00:00 2001 From: sphinx-auto-update Date: Fri, 6 Oct 2023 00:48:57 +0000 Subject: [PATCH] [skip ci] by GHA https://github.com/sphinx-doc/sphinx-doc-translations/actions/runs/584 --- README.md | 892 +++ locale/ar/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- locale/ca_ES/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- locale/de/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- locale/es/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- locale/fr/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- locale/it_IT/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- locale/ja/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- locale/ko/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- locale/pl_PL/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- locale/pot/changes.pot | 9556 ++++++++++++++------------- locale/pt_BR/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- locale/ru/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- locale/sr/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- locale/sr_RS/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- locale/zh_CN/LC_MESSAGES/changes.po | 9119 ++++++++++++------------- sphinx | 2 +- 17 files changed, 69555 insertions(+), 68561 deletions(-) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000000..b2ff2d0215 --- /dev/null +++ b/README.md @@ -0,0 +1,892 @@ +# Transifex Client + +## Installation + +### Installing with a script (Linux/Mac) +You can install the latest Transifex CLI by executing: + +``` +curl -o- https://raw.githubusercontent.com/transifex/cli/master/install.sh | bash +``` + +Or you can isntall a specific version if you need by executing: + +``` +curl -o- https://raw.githubusercontent.com/transifex/cli/master/install.sh | bash -s -- yourVersion +``` + + +This script will: +* Try to find the correct version for your system. +* Download & extract the CLI to the current folder. +* Check for a profile in one of `.profile, .bashrc, .bash_profile, .zshrc` and append `export PATH=":$PATH"`, so you can call 'tx' from any path. + +**Note:** You need to restart your terminal for the `PATH` changes to be applied. + +### Download from Github Releases (Linux/Mac/Windows) + +Another way to install the Transifex CLI is to download +the latest version of the binary from GitHub +[here](https://github.com/transifex/cli/releases). + +Choose the binary according to your system, download it and unzip it. +Copy the binary into the location you want and update the `PATH` variable +of your system if necessary. + +The other way to install Transifex CLI in the system is to use the code. + +Clone the [repository](https://github.com/transifex/cli) and go into the directory + +```shell +cd /path/to/transifex/cli +``` +### Building from source + +The default way to build the binary is + + ```shell + make build + ``` +This method requires to have golang in your system. It compiles Transifex CLI and +moves it into the `./bin/` directory of the repository. + +If you don't have golang installed, but you have Docker enabled, you can use +the following command: + + ```shell + make docker-build + ``` + +This will build the binary and it will copy it at `./bin/` in the repository. + +### Running from Docker (beta) + +You can skip the installation and run the Transifex client from Docker if it is +available in your system. All you have to do is put this line: + +```sh +alias tx='touch ~/.transifexrc; docker run --rm -i -t -v `pwd`:/app -v ~/.transifexrc:/.transifexrc -v /etc/ssl/certs/ca-certificates.crt:/etc/ssl/certs/ca-certificates.crt transifex/txcli --root-config /.transifexrc' +``` + +to your `~/.bashrc` / `~/.zshrc`. (The first time you use it you will have to +wait for a ~5MB download) + + +### Running from Github actions (beta) + +You can invoke the CLI from within a Github workflow by using our Github +action. See the instructions [here](https://github.com/transifex/cli-action). + +## Migrating from older versions of the client + +The current version of the client maintains backwards compatibility for the `tx push` +and `tx pull` commands. So, if you have a CI setup that uses them, you should not have +to change anything. However, some things need to be different in the configuration files: + +The section headers in `.tx/config` need to be different to also store the organization slug. +So after the migration `.` should become `o::p::r:`. +In case something fails during this process, we will provide a message with the failed +migrated resource so that you can identify and change the section header manually. + +You will be prompted for an API token in case you are using a username/password pair in +your `~/.transifexrc` file or if you are not using one. + +If you are migrating an existing software project from an older version of the Transifex +client, you need to run: + +``` +tx migrate +``` + +This will take care of all the changes and create a back up file of the original config +in the same folder as `config_yyyymmddhhss.bak` before we start the migration process. + +### Differences With the Previous Version + +The two clients have some distinct differences when looking under the hood. +The new client is using Go instead of Python + * for speed and + * for the ability to produce binary files + for multiple platforms. + +Additionally, client is using APIv3 instead of APIv2 because + * it is faster (calls occur asynchronously and you don't have to wait + for parsing to finish) and + * APIv2 is getting deprecated. + +`Init` + +The new client's init command creates the `.tx` folder in the current path, +and the config file with the following content which is required for the configuration: + +```shell +[main] +host=https://app.transifex.com +``` + +In case there is already a `.tx/config` file in the current directory, the users +will get a prompt that informs them that, if they proceed, the contents of their +`.tx/config` file will be overridden. A `y/n` answer, is needed to proceed or abort. + +`Add` + +For the previous client, parts of functionality in `tx config` command adds resources +locally. + +In the new client, this command is responsible to add a resource in the local config file. +Note that it needs all `organization`, `project` and `resource` slugs in order to build +the resource id for the APIv3. + +It will create a new section in the `.tx/config` file for a resource like: + +```ini +[o:org_slug:p:project_slug:r:resource_slug] +... +``` + +`Push` + +The differences of the new client, are summarized here: + +* resource IDs, can be accepted without the `-r` flag +* when neither `-s/-t` are set, `-s` is assumed +* `--all` flag creates new languages on Transifex if + local files exist for them (on previous client this was the default behavior, + now it needs the `--all` flag) +* without `--all` or `--languages`, the only languages that are considered are + the intersection of local and remote languages + + +`Pull` + +* resource IDs, can be accepted without the `-r` flag +* when neither `-s/-t` are set, `-t` is assumed +* without `--all` or `--languages`, the only languages that are considered are + the intersection of local and remote languages +* `--json` download files (translations) as json files +* `--content_encoding/-e` The encoding of the file. This can be one of the following: + * text (default) + * base64 + +## Usage + +### Initialising a Project + +The first thing we need to do is run: + +``` +tx init +``` + +This will simply create an empty `.tx/config` file to mark the current folder +as a _Transifex project_. Your directory structure should now look like this: + +``` +- my_project/ + | + + .tx/ + | | + | + config + | + + locale/ + | + + en.php +``` +### Using Environment Variables +The available environment variables for the CLI: + +* `TX_TOKEN`: The api token to use +* `TX_HOSTNAME`: The API hostname +* `TX_CACERT`: Path to CA certificate bundle file + +You can either add these variables in your CI settings, your profile file or when executing the commands like: +`TX_TOKEN=myapitoken tx pull` + +### Adding Resources to Configuration + +We will add the php file as a source language file in our local configuration. The simplest way to do this is with `tx add` which will start an interactive session: + +``` +The Transifex Client syncs files between your local directory and Transifex. +The mapping configuration between the two is stored in a file called .tx/config +in your current directory. For more information, visit +https://docs.transifex.com/client/config/. + +What is the path of the source file? locale/en.php + +Next, we’ll need a path expression pointing to the location of the +translation files (whether they exist yet or not) associated with +the source file. You should include as a +wildcard for the language code. + +What is your path extension? locale/.php + +Use the arrow keys to navigate: ↓ ↑ → ← and / toggles search +? Which organization will this resource be part of?: + > Organization 1 (organization-1) + Organization 2 (organization-2) + Organization 3 (organization-3) + Organization 4 (organization-4) +↓ Organization 5 (organization-5) + + +Use the arrow keys to navigate: ↓ ↑ → ← and / toggles search +? Which project will this resource be part of?: + > Project 1 (project-1) + +Use the arrow keys to navigate: ↓ ↑ → ← and / toggles search +? Which is the resource for this file?: + > en.php (en_php) + Create a new resource () + +SUCCESS Your configuration has been saved in '.tx/config' + You can now push and pull content with 'tx push' and 'tx pull' + +``` + + +Your `.tx/config` file should look like this: + +```ini +[main] +host = https://app.transifex.com + +[o:organization-1:p:project-1:r:en_php] +source_file = locale/en.php +file_filter = locale/.php +type = PHP +resource_name = Web Application +``` + +You can skip steps from the interactive session by adding flags to the `tx add` +command. In fact, you can skip the interactive session entirely if you provide +all the flags: + +``` +→ tx add \ + --file-filter=locale/.php \ + --type=PHP \ + --organization=organization-1 \ + --project=project-1 \ + --resource=en_php \ + --resource-name='Web Application' \ + locale/en.php +``` + +#### Adding resources in bulk + +> With the old client I could add multiple resources at the same time with `tx +> config mapping-bulk`. What should I do now? + +We decided not to implement this functionality in the new client because its +usage was complicated and it couldn't satisfy every user's need anyway. You can +add multiple resources with a relatively simple shell script. For example: + +1. Add every subfolder of a `locale` folder as a resource: + + ```sh + for FOLDER in $(ls locale); do + # Exclusion list + if echo "excluded_a excluded_b" | grep -w -q $FOLDER; then + continue + fi + + tx add \ + --organization org \ + --project proj \ + --resource $FOLDER \ + --file-filter "locale/$FOLDER/.po" \ + --type PO \ + "locale/$FOLDER/en.po" + done + ``` + +2. Add specific folders as resources: + + ```sh + for FOLDER in $(echo path/to/folder_a path/to/folder_b path/to/folder_c); do + + # path/to/folder_a => path_to_folder_a + RESOURCE_SLUG=$(echo $FOLDER | tr '/' '_') + + tx add \ + --organization org \ + --project proj \ + --resource $RESOURCE_SLUG \ + --file-filter "$FOLDER/.po" \ + --type PO \ + "$FOLDER/en.po" + done + ``` + +3. Turn every `.po` file into a configured resource: + + ```sh + for FILEPATH in $(find . -name '*.po'); do + + # ./examples/locale/en.po => examples/locale/en.po + FILEPATH=$(echo $FILEPATH | sed 's/^\.\///') + + # examples/locale/en.po => examples_locale + RESOURCE_SLUG=$(echo $FILEPATH | sed 's/\/[^\/]*$//' | tr '/' '_') + + # examples/locale/en.po => examples/locale/.po + FILE_FILTER=$(echo $FILEPATH | sed 's/[^\/]*$/.po/') + + tx add \ + --organization org \ + --project proj \ + --resource $RESOURCE_SLUG \ + --file-filter "$FILE_FILTER" \ + --type PO \ + $FILEPATH + done + ``` + +#### Adding remote resources in bulk + +If you have content already setup in Transifex, you may want to setup local +resources in order to pull the language files on your system. In order to do +that, you can run the following command with Linux or Mac OS: + +```sh +tx add remote \ + --file-filter 'translations/./.' + https://app.transifex.com/myorganization/myproject/dashboard/ +``` + +> The use of tx add remote appends the content in the .tx/config file and does not overwrite it. However, if the project and resource exist in the .tx/config file, then it will overwrite the previous information for the specific project & resource. + +For Windows OS, please use double quotes instead of single quotes in the following example. + +This will create entries in your configuration file for each resource in your +remote project. ie the configuration file may look like this: + +```ini +[main] +host = https://app.transifex.com + +[o:myorganization:p:myproject:r:resource1] +file_filter = translations/myproject.resource1/.po +source_file = translations/myproject.resource1/en.po +type = PO +minimum_perc = 0 +resource_name = Resource 1 + +[o:myorganization:p:myproject:r:resource2] +file_filter = translations/myproject.resource2/.json +source_file = translations/myproject.resource2/en.json +type = KEYVALUEJSON +minimum_perc = 0 +resource_name = Resource 2 + +[o:myorganization:p:myproject:r:resource3] +file_filter = translations/myproject.resource3/.html +source_file = translations/myproject.resource3/en.html +type = HTML +minimum_perc = 0 +resource_name = Resource 3 +``` + +The options for this command are: + +- `--file-filter`: What to use as the file_filter and source_file options in + the resulting configuration. This is a pattern that accepts the following + parameters: + + - `` + - `` _(required)_ + - `` _(required)_ - can be used multiple times in the filter path + - `` + + The default value for this option is + `translations/./.` (the one we showed + in our example) + +- `--minimum-perc`: What to use as the minimum_perc option in the resulting configuration + +- One or more project URLs. + +After setting things up, you can pull the source files with `tx pull --source`. + +### Pushing Files to Transifex + +`tx push` is used to push language files (usually source language files) from +your machine to Transifex. You will most likely want to do that frequently +during the lifetime of you project when new source strings are introduced or +existing ones are changed. This will make the new strings available to +translators as soon as possible. + +The simplest invocation of `tx push` is simply: + +```sh +→ tx push +``` + +This will attempt to push the source file of all local resources that have been +configured with `tx add`. + +**Limiting resources:** + +You can limit the resources you want to push with: + +```sh +→ tx push [RESOURCE_ID]... +``` + +A resource ID must refer to a resource that has already been configured with +`tx add` and has the form `.`. So, if the URL of your +resource in Transifex is +`https://app.transifex.com/myorganization/myproject/myresource`, then the +resource ID will be `myproject.myresource`. + +You can also use the `*` character to select multiple resources with the same +pattern. So, for instance, if you have the `abc.def` resource ID in your +configuration, you can select it with either `abc.*`, `*.def`, `ab*ef` or even +`a*.d*f`. + +> Note: for backwards compatibility with previous versions of the client, you +> can also use the `-r/--resources` flag. You can also use both at the same +> time: +> +> ```sh +> → tx push p1.r1 p1.r2 -r p1.r3,p1.r4 +> # Equivalent to +> → tx push p1.r1 p1.r2 p1.r3 p1.r4 +> ``` + +`tx push` will create the resources on Transifex if they are missing. + +**Language management:** + +By default, the client will push the source file (the file that's being pointed +to by the `source_file` configuration option from `tx add`). If you use the +`-t/--translation` flag, `tx push` will push translation files. This may be +desirable if, for example, you previously pulled translation files with the +`--mode translator` option, translated using an offline translation tool and +now you want to push your work to Transifex, or if you are migrating from +another localization management service to Transifex. If you use both the `-t` +_and_ the `-s/--source` flags, then you will push both the source file and the +translation files. + +When you use `-t`, the client will find all local files that match the +`file-filter` configuration option. The files that are found, and their language +codes constitute the _local_ languages. By default, the client will ask the +Transifex API for the languages that are supported by the project you are +pushing to (the _remote_ languages) and will only push languages that are both +_local_ and _remote_ (aka the **intersection** of _local_ and _remote_ +languages). + +You can use the `-l/--languages` flag to handpick which languages you want to +push. It only makes sense to include _local_ languages with the `-l` flag, ie +languages for which a file exists according to the `file-filter` configuration +option. The client will then push **only** the language files you have +specified. If you specify _local_ languages that are not yet supported by the +remote Transifex project, the client will attempt to add these languages to the +project first. Be careful of this since it may affect your pricing if you are a +paying customer. + +```sh +→ tx push -t -l fr,de,pt_BR +``` + +The `-a/--all` flag will attempt to push **all** _local_ languages to the +remote Transifex project, adding them if necessary. Essentially, `-a` is +equivalent to using `-l` with all the _local_ language codes. + +Transifex uses the _ISO/IEC 15897_ standard for language codes (for example +`en_US`). If you use a different format for the _local_ language codes, you can +define a mapping in your configuration file `.tx/config`. You +can specify these mappings for all configured resources by adding them to the +`[main]` section or you can specify mappings per resource. The "per-resource" +mappings take precendence. Configuring a language mapping looks like this: + +```ini +# ... +[o:myorganization:p:myproject:r:myresource] +source-file = ... +# ... +lang_map = pt_PT: pt-pt, pt_BR: pt-br +``` + +This means that the _remote_ `pt_PT` language code maps to the _local_ `pt-pt` +language code and the _remote_ `pt_BR` language code maps to the _local_ +`pt-br` language code. + +The REMOTE_CODE is the language code supported by Transifex. And the LOCAL_CODE is your +language code. + +The `-l` flag works with both _local_ and _remote_ language codes. + +**Skipping pushing older files:** + +The default behavior of the `tx push` command is to skip pushing a file when +the remote resource on Transifex has had a change more recently than when the +local file was last edited. To make sure that the local files are pushed even +if they are older than the remote resource, use the `-f/--force` flag. + +You can use the `--use-git-timestamps` flag to compare against the last time +the local files were *committed* to the local git repository instead of the +last modification time in the filesystem. This can be useful in cases where you +have just cloned a repository or pulled a branch. In this case, the filesystem +modification time will reflect the time you pulled and not the time the file +was edited by an actual person. If you use the `--use-git-timestamps` flag and +no information about a local git repository can be found, then the client will +fall back to taking the filesystem timestamp into account. + +**Other flags:** + +- `--xliff`: Push xliff files instead of regular ones. The files must be + located **in the same place** as indicated by the `file-filter` configuration + option, but with the added `.xlf` suffix (`tx pull`ing with the `--xliff` + option will put xliff files in the correct positions so you will probably not + have to do this by hand) + +- `--branch`: Using this flag, you can access copies of the regular remote + resource that are tied to the provided branch. So if `tx push proj.res` + pushes to the `https://app.transifex.com/org/proj/res` resource, then `tx + push --branch foo proj.res` will push to the + `https://app.transifex.com/org/proj/foo--res` resource. This way you can + separate the localization effort across different branches. If you supply an + empty string as the branch (`--branch ''`), then the client will attempt to + figure out the currently active branch in the local git repository. For + example: + + ```sh + → git checkout -b new_feature + → # Edit some source code files + → # Extract source strings into language file + → tx push --branch 'new_feature' myproject.myresource + → # Or + → tx push --branch '' myproject.myresource + ``` + + This way, the "regular" + `https://app.transifex.com/myorganization/myproject/myresource` resource will + not be affected by the changes you did to the source strings and the + localization effort can be done in parallel on the + `https://app.transifex.com/myorganization/myproject/new_feature--myresource` + resource. + + > Note: Starting from version 1.5.0 resources created using the `--branch` flag, + will have an enhanced functionality in transifex and will be able to automatically + be merged into their bases. Resources created using the `--branch` prior to this + version, need to be pushed again in order for the new functionality to be available. + + ```sh + → tx push --branch 'new_feature' --base '' myproject.myresource + ``` + +- `--base`: Define the base branch when pushing a branch. + +- `--skip`: Normally, if an upload fails, the client will abort. This may not + be desirable if most uploads are expected to succeed. For example, the reason + of the failed upload may be a syntax error in _one_ of the language files. If + you set the `--skip` flag and an upload fails, then the client will simply + print a warning and move on to the next language file. + +- `--workers/-w` (default 5, max 30): The client will push files in parallel to improve + speed. The `--workers` flag sets the number of concurrent uploads possible at + any time. +- `--silent`: Reduce verbosity of the output. + +- `--replace-edited-strings`: If present, source strings that have been edited + (in the editor UI or via the API) will not be protected from this source + file push and will instead be replaced. This can also be set on a + per-resource level in the configuration file. + +- `--keep-transations`: If present, translations of source strings with the + same key whose content changes will not be discarded. This can also be set on + a per-resource level in the configuration file. + +### Pulling Files from Transifex + +`tx pull` is used to pull language files (usually translation language files) from +Transifex to your machine. Most likely, you will do this regularly when you want to +incorporate newly available translations from Transifex into it. + +The simplest invocation of `tx pull` is simply: + +```shell +→ tx pull +``` + +This will attempt to pull the translation files of all local resources that have been +configured with `tx add`. + +**Limiting resources:** + +You can limit the resources you want to pull with: + +```shell +→ tx pull [RESOURCE_ID]... +``` + +As stated in the `tx push` section, a resource ID must refer to a resource that has +already been configured with `tx add` and has the form `.`. + +You can also use the `*` character to select multiple resources with the same +pattern. So, for instance, if you have the `abc.def` resource ID in your +configuration, you can select it with either `abc.*`, `*.def`, `ab*ef` or even +`a*.d*f`. + +> Note: for backwards compatibility with previous versions of the client, you +> can also use the `-r/--resources` flag. You can also use both at the same +> time: +> +> ```sh +> → tx pull p1.r1 p1.r2 -r p1.r3,p1.r4 +> # Equivalent to +> → tx pull p1.r1 p1.r2 p1.r3 p1.r4 +> ``` + +**Language management:** + +By default, the client will pull the translation files of the existing files in the paths +that are defined in the `file_filter` configuration option from `tx add`. + +For instance, if the directory structure looks like this: + +``` +- my_project/ + | + + .tx/ + | | + | + config + | + + locale/ + | + + en.php +``` + +and the `.tx/config` contains: + +```ini +source_file = locale/en.php +file_filter = locale/.php +``` + +If you use the `-s/--source` flag, `tx pull` will pull the source file that is +pointed from the `source_file` option of the config file. + +If you use both the `-t/--translation` _and_ the `-s/--source` flags, +then you will pull both the source file, and the translation files. + +Then the client will try to search for any existing language file located +at the `locale/` path (where `` is the language code) and will +try to update it, for example `locale/el.php`, `locale/fr.php`, etc. + +In case that there aren't any translation files, like in the structure above, +then you must either use the `-l/--language` or the `-a/--all` flag. + +Use the `-l/--languages` flag to handpick which languages you want to +pull. It only makes sense to include _remote_ languages with the `-l` flag, ie +languages for which a file does not exist according to the `file_filter` +configuration option. The client will then pull **only** the language +files you have specified: + +```shell +tx pull -l el,fr,nl +``` + +> Note: +> The languages that are defined with the -l/--language flag +> should belong to the project for the client to download them. + +The `-a/--all` flag will attempt to pull **all** languages from the +remote Transifex project. Essentially, `-a` is equivalent to using +`-l` with all the project language codes. + +As stated before, Transifex uses the _ISO/IEC 15897_ standard for +language codes. If you use a different format for the _local_ language +codes, you can define a mapping in your configuration file `.tx/config`. +You can specify these mappings for all configured resources by adding them +to the `[main]` section or you can specify mappings per resource. +The "per-resource" mappings take precendence. Configuring a language mapping +looks like this: + +```ini +# ... +[o:myorganization:p:myproject:r:myresource] +source-file = ... +# ... +lang_map = pt_PT: pt-pt, pt_BR: pt-br +``` + +This means that the _remote_ `pt_PT` language code maps to the _local_ `pt-pt` +language code and the _remote_ `pt_BR` language code maps to the _local_ +`pt-br` language code. + +The `-l` flag works with _remote_ language codes. + +**Skipping pulling older files:** + +The default behavior of the `tx pull` command is to skip pulling a file when +a local file on a machine has had a change more recently than when the +remote resource was last edited. To make sure that the remote resources +are pulled even if they are older than the local files, use the `-f/--force` flag. + +You can use the `--use-git-timestamps` flag to compare against the last time +the local files were *committed* to the local git repository instead of the +last modification time in the filesystem. This can be useful in cases where you +have just cloned a repository or pulled a branch. In this case, the filesystem +modification time will reflect the time you pulled and not the time the file +was edited by an actual person. If you use the `--use-git-timestamps` flag and +no information about a local git repository can be found, then the client will +default to taking the filesystem timestamp into account. + +**Other flags:** + +- `--xliff`: Pull xliff files instead of regular ones. The files will be + placed **in the same place** as indicated by the `source-file` and + `file-filter` configuration options, but with the added `.xlf` suffix. + +- `--json`: Pull translation files as json instead of regular ones. As above, + the files will be placed **in the same place** as indicated by the `file-filter` + configuration options, but with the added `.json` suffix. Currently, source + files are not supporting json format. + +- `--disable-overwrite`: If a file exists do not update it. This is useful + when using `-a/--all` flag and you don't want to change the existing files + but only download other language files. + +- `--keep-new-files`: Used with `--disable-ovewrite` to create new files + if file already exists locally with a '.new' extension. + +- `--mode/-m`: The translation mode of the downloaded file. This can be one of the +following: `'default', 'reviewed'`, `'proofread'`, `'translator'`, `'untranslated'`, + `'onlytranslated'`, `'onlyreviewed'`, `'onlyproofread'`, `'sourceastranslation'` **(default + mode is: **`'default'`). Use like` 'tx pull -m proofread'` to download only proofread + translations. + +- `--branch`: Using this flag, you can access copies of the regular remote + resource that are tied to the provided branch. So if `tx pull proj.res` + pulls from the `https://app.transifex.com/org/proj/res` resource, then `tx + pull --branch foo proj.res` will pull from the + `https://app.transifex.com/org/proj/foo--res` resource. This way you can + separate the localization effort across different branches. If you supply an + empty string as the branch (`--branch ''`), then the client will attempt to + figure out the currently active branch in the local git repository. For + example: + + ```sh + → git checkout new_feature + → # Get updated files for this branch + → tx pull --branch 'new_feature' myproject.myresource + → # Or + → tx pull --branch '' myproject.myresource + ``` + + This way, the "regular" + `https://app.transifex.com/myorganization/myproject/myresource` resource will + not be affected by the changes one did, and the localization effort can be done + in parallel on the + `https://app.transifex.com/myorganization/myproject/new_feature--myresource` + resource. + +- `--skip`: Normally, if a download fails, the client will abort. This may not + be desirable if most downloads are expected to succeed. For example, the reason + of the failed download may be a syntax error in _one_ of the language files. If + you set the `--skip` flag and an upload fails, then the client will simply + print a warning and move on to the next language file. + +- `--minimum-perc=MINIMUM_PERC` Specify the minimum translation completion + threshold required in order for a file to be downloaded. + +- `--workers/-w` (default 5, max 30): The client will pull files in parallel to improve + speed. The `--workers` flag sets the number of concurrent downloads possible at + any time. + +- `--pseudo`: Generate mock string translations with a ~20% default length increase in characters. + +- `--silent`: Reduce verbosity of the output. + +### Removing resources from Transifex +The tx delete command lets you delete a resource that's in your `config` file and on Transifex. + +To delete a resource, use the following command: +``` +tx delete . +``` + +To delete all resources in a specific project at once, instead of referring to a specific resource_slug, you can use the asterisk character as follows: +``` +tx delete project_slug.* +or +tx delete project_slug.\* +``` + +> Note: for backwards compatibility with previous versions of the client, you +> can also use the `-r/--resources` flag. You can also use both at the same +> time: +> +> ```sh +> tx delete -r . .... +> ``` + +**Other flags:** +- `--skip`: Normally, if a delete fails, the client will abort. This may not + be desirable if most deletes are expected to succeed. For example, the reason + of the failed delete may be a a resource that has translated content. If + you set the `-s/--skip` flag and an delete fails, then the client will simply + print a warning and move on to the next resource. +- `--force`: In case you want to proceed to a deletion even if resources have + translations use the `-f/--force` flag. +- `--branch`: In case you want to delete a resource's branch that is on Transifex. + If you supply an empty string as the branch (`--branch ''`), then the client + will attempt to figure out the currently active branch in the local git repository. + +### Merging Resource +The tx merge command lets you merge a branch resource with its base resource (applies only to resources created with the `--branch` flag) + +To merge a resource to its base resource, use the following command: +``` +tx merge --branch branch_name project_slug.resource_slug +``` +**Other flags:** +- `--conflict-resolution`: Set the conflict resolution strategy. Acceptable options are `USE_HEAD` (changes in the HEAD resource will be used) and `USE_BASE` (changes in the BASE resource will be used) +- `--force`: In case you want to proceed with the merge even if the source strings are diverged, use the `-f/--force` flag. + +### Getting the local status of the project +The status command displays the existing configuration in a human readable format. It lists all resources that have been initialized under the local repo/directory and all their associated translation files: + +``` +tx status +myproject -> default (1 of 1) +Translation Files: + - en: po/smolt.pot (source) + - ar: po/ar.po + - as: po/as.po + - bg: po/bg.po + - bn_IN: po/bn_IN.p + ... + ``` + + To get the status of specific resources just add the resources you want in your command: + + ``` + tx status . .... + ``` + +> Note: for backwards compatibility with previous versions of the client, you +> can also use the `-r/--resources` flag. You can also use both at the same +> time: +> +> ```sh +> tx status -r . .... +> ``` + +### Updating the CLI app +The `tx update` command provides a way to self update the application without going to Github releases page. + + ``` + tx update + ``` + + **Flags:** +- `--check`: Check if there is a new release. Nothing gets updated. +- `--no-interactive`: Proceed to update if there is a newer version without seeing the confirmation prompt. +- `--debug`: Enable logging for the binary update process. +# License + +Licensed under Apache License 2.0, see [LICENSE](LICENSE) file. diff --git a/locale/ar/LC_MESSAGES/changes.po b/locale/ar/LC_MESSAGES/changes.po index e21f9be9cf..bae72190bd 100644 --- a/locale/ar/LC_MESSAGES/changes.po +++ b/locale/ar/LC_MESSAGES/changes.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Sphinx 7.3.0\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-10-05 00:35+0000\n" +"POT-Creation-Date: 2023-10-06 00:35+0000\n" "PO-Revision-Date: 2018-02-12 13:46+0000\n" "Language-Team: Arabic (https://app.transifex.com/sphinx-doc/teams/15434/ar/)\n" "MIME-Version: 1.0\n" @@ -25,65 +25,65 @@ msgstr "" msgid "Release 7.3.0 (in development)" msgstr "" -#: ../../sphinx/doc/changes.rst:26 ../../sphinx/doc/changes.rst:122 -#: ../../sphinx/doc/changes.rst:172 ../../sphinx/doc/changes.rst:386 -#: ../../sphinx/doc/changes.rst:443 ../../sphinx/doc/changes.rst:577 -#: ../../sphinx/doc/changes.rst:644 ../../sphinx/doc/changes.rst:657 -#: ../../sphinx/doc/changes.rst:762 ../../sphinx/doc/changes.rst:818 -#: ../../sphinx/doc/changes.rst:925 ../../sphinx/doc/changes.rst:1141 -#: ../../sphinx/doc/changes.rst:1255 ../../sphinx/doc/changes.rst:1429 -#: ../../sphinx/doc/changes.rst:1443 ../../sphinx/doc/changes.rst:1578 -#: ../../sphinx/doc/changes.rst:1616 ../../sphinx/doc/changes.rst:1799 -#: ../../sphinx/doc/changes.rst:1850 ../../sphinx/doc/changes.rst:2442 -#: ../../sphinx/doc/changes.rst:2673 ../../sphinx/doc/changes.rst:2864 -#: ../../sphinx/doc/changes.rst:3422 ../../sphinx/doc/changes.rst:3708 -#: ../../sphinx/doc/changes.rst:3867 ../../sphinx/doc/changes.rst:4408 -#: ../../sphinx/doc/changes.rst:4822 +#: ../../sphinx/doc/changes.rst:26 ../../sphinx/doc/changes.rst:124 +#: ../../sphinx/doc/changes.rst:174 ../../sphinx/doc/changes.rst:388 +#: ../../sphinx/doc/changes.rst:445 ../../sphinx/doc/changes.rst:579 +#: ../../sphinx/doc/changes.rst:646 ../../sphinx/doc/changes.rst:659 +#: ../../sphinx/doc/changes.rst:764 ../../sphinx/doc/changes.rst:820 +#: ../../sphinx/doc/changes.rst:927 ../../sphinx/doc/changes.rst:1143 +#: ../../sphinx/doc/changes.rst:1257 ../../sphinx/doc/changes.rst:1431 +#: ../../sphinx/doc/changes.rst:1445 ../../sphinx/doc/changes.rst:1580 +#: ../../sphinx/doc/changes.rst:1618 ../../sphinx/doc/changes.rst:1801 +#: ../../sphinx/doc/changes.rst:1852 ../../sphinx/doc/changes.rst:2444 +#: ../../sphinx/doc/changes.rst:2675 ../../sphinx/doc/changes.rst:2866 +#: ../../sphinx/doc/changes.rst:3424 ../../sphinx/doc/changes.rst:3710 +#: ../../sphinx/doc/changes.rst:3869 ../../sphinx/doc/changes.rst:4410 +#: ../../sphinx/doc/changes.rst:4824 msgid "Dependencies" msgstr "" -#: ../../sphinx/doc/changes.rst:29 ../../sphinx/doc/changes.rst:295 -#: ../../sphinx/doc/changes.rst:403 ../../sphinx/doc/changes.rst:448 -#: ../../sphinx/doc/changes.rst:584 ../../sphinx/doc/changes.rst:664 -#: ../../sphinx/doc/changes.rst:934 ../../sphinx/doc/changes.rst:1079 -#: ../../sphinx/doc/changes.rst:1260 ../../sphinx/doc/changes.rst:1408 -#: ../../sphinx/doc/changes.rst:1583 ../../sphinx/doc/changes.rst:1631 -#: ../../sphinx/doc/changes.rst:1856 ../../sphinx/doc/changes.rst:2057 -#: ../../sphinx/doc/changes.rst:2388 ../../sphinx/doc/changes.rst:2415 -#: ../../sphinx/doc/changes.rst:2447 ../../sphinx/doc/changes.rst:2648 -#: ../../sphinx/doc/changes.rst:2683 ../../sphinx/doc/changes.rst:3032 -#: ../../sphinx/doc/changes.rst:3126 ../../sphinx/doc/changes.rst:3154 -#: ../../sphinx/doc/changes.rst:3236 ../../sphinx/doc/changes.rst:3257 -#: ../../sphinx/doc/changes.rst:3451 ../../sphinx/doc/changes.rst:3801 -#: ../../sphinx/doc/changes.rst:3838 ../../sphinx/doc/changes.rst:3878 -#: ../../sphinx/doc/changes.rst:4184 ../../sphinx/doc/changes.rst:4338 -#: ../../sphinx/doc/changes.rst:4415 ../../sphinx/doc/changes.rst:4788 -#: ../../sphinx/doc/changes.rst:4833 ../../sphinx/doc/changes.rst:5196 -#: ../../sphinx/doc/changes.rst:5282 ../../sphinx/doc/changes.rst:5640 -#: ../../sphinx/doc/changes.rst:5676 ../../sphinx/doc/changes.rst:5869 -#: ../../sphinx/doc/changes.rst:5907 ../../sphinx/doc/changes.rst:6316 -#: ../../sphinx/doc/changes.rst:6366 ../../sphinx/doc/changes.rst:6439 -#: ../../sphinx/doc/changes.rst:6471 ../../sphinx/doc/changes.rst:6837 -#: ../../sphinx/doc/changes.rst:6880 ../../sphinx/doc/changes.rst:6926 -#: ../../sphinx/doc/changes.rst:6982 ../../sphinx/doc/changes.rst:7288 -#: ../../sphinx/doc/changes.rst:7681 ../../sphinx/doc/changes.rst:8896 +#: ../../sphinx/doc/changes.rst:29 ../../sphinx/doc/changes.rst:297 +#: ../../sphinx/doc/changes.rst:405 ../../sphinx/doc/changes.rst:450 +#: ../../sphinx/doc/changes.rst:586 ../../sphinx/doc/changes.rst:666 +#: ../../sphinx/doc/changes.rst:936 ../../sphinx/doc/changes.rst:1081 +#: ../../sphinx/doc/changes.rst:1262 ../../sphinx/doc/changes.rst:1410 +#: ../../sphinx/doc/changes.rst:1585 ../../sphinx/doc/changes.rst:1633 +#: ../../sphinx/doc/changes.rst:1858 ../../sphinx/doc/changes.rst:2059 +#: ../../sphinx/doc/changes.rst:2390 ../../sphinx/doc/changes.rst:2417 +#: ../../sphinx/doc/changes.rst:2449 ../../sphinx/doc/changes.rst:2650 +#: ../../sphinx/doc/changes.rst:2685 ../../sphinx/doc/changes.rst:3034 +#: ../../sphinx/doc/changes.rst:3128 ../../sphinx/doc/changes.rst:3156 +#: ../../sphinx/doc/changes.rst:3238 ../../sphinx/doc/changes.rst:3259 +#: ../../sphinx/doc/changes.rst:3453 ../../sphinx/doc/changes.rst:3803 +#: ../../sphinx/doc/changes.rst:3840 ../../sphinx/doc/changes.rst:3880 +#: ../../sphinx/doc/changes.rst:4186 ../../sphinx/doc/changes.rst:4340 +#: ../../sphinx/doc/changes.rst:4417 ../../sphinx/doc/changes.rst:4790 +#: ../../sphinx/doc/changes.rst:4835 ../../sphinx/doc/changes.rst:5198 +#: ../../sphinx/doc/changes.rst:5284 ../../sphinx/doc/changes.rst:5642 +#: ../../sphinx/doc/changes.rst:5678 ../../sphinx/doc/changes.rst:5871 +#: ../../sphinx/doc/changes.rst:5909 ../../sphinx/doc/changes.rst:6318 +#: ../../sphinx/doc/changes.rst:6368 ../../sphinx/doc/changes.rst:6441 +#: ../../sphinx/doc/changes.rst:6473 ../../sphinx/doc/changes.rst:6839 +#: ../../sphinx/doc/changes.rst:6882 ../../sphinx/doc/changes.rst:6928 +#: ../../sphinx/doc/changes.rst:6984 ../../sphinx/doc/changes.rst:7290 +#: ../../sphinx/doc/changes.rst:7683 ../../sphinx/doc/changes.rst:8898 msgid "Incompatible changes" msgstr "" -#: ../../sphinx/doc/changes.rst:32 ../../sphinx/doc/changes.rst:178 -#: ../../sphinx/doc/changes.rst:302 ../../sphinx/doc/changes.rst:461 -#: ../../sphinx/doc/changes.rst:590 ../../sphinx/doc/changes.rst:769 -#: ../../sphinx/doc/changes.rst:825 ../../sphinx/doc/changes.rst:963 -#: ../../sphinx/doc/changes.rst:1086 ../../sphinx/doc/changes.rst:1279 -#: ../../sphinx/doc/changes.rst:1448 ../../sphinx/doc/changes.rst:1677 -#: ../../sphinx/doc/changes.rst:1863 ../../sphinx/doc/changes.rst:2063 -#: ../../sphinx/doc/changes.rst:2168 ../../sphinx/doc/changes.rst:2278 -#: ../../sphinx/doc/changes.rst:2452 ../../sphinx/doc/changes.rst:2726 -#: ../../sphinx/doc/changes.rst:2919 ../../sphinx/doc/changes.rst:3041 -#: ../../sphinx/doc/changes.rst:3160 ../../sphinx/doc/changes.rst:3269 -#: ../../sphinx/doc/changes.rst:3503 ../../sphinx/doc/changes.rst:3938 -#: ../../sphinx/doc/changes.rst:4370 ../../sphinx/doc/changes.rst:4447 -#: ../../sphinx/doc/changes.rst:5034 ../../sphinx/doc/changes.rst:5361 +#: ../../sphinx/doc/changes.rst:32 ../../sphinx/doc/changes.rst:180 +#: ../../sphinx/doc/changes.rst:304 ../../sphinx/doc/changes.rst:463 +#: ../../sphinx/doc/changes.rst:592 ../../sphinx/doc/changes.rst:771 +#: ../../sphinx/doc/changes.rst:827 ../../sphinx/doc/changes.rst:965 +#: ../../sphinx/doc/changes.rst:1088 ../../sphinx/doc/changes.rst:1281 +#: ../../sphinx/doc/changes.rst:1450 ../../sphinx/doc/changes.rst:1679 +#: ../../sphinx/doc/changes.rst:1865 ../../sphinx/doc/changes.rst:2065 +#: ../../sphinx/doc/changes.rst:2170 ../../sphinx/doc/changes.rst:2280 +#: ../../sphinx/doc/changes.rst:2454 ../../sphinx/doc/changes.rst:2728 +#: ../../sphinx/doc/changes.rst:2921 ../../sphinx/doc/changes.rst:3043 +#: ../../sphinx/doc/changes.rst:3162 ../../sphinx/doc/changes.rst:3271 +#: ../../sphinx/doc/changes.rst:3505 ../../sphinx/doc/changes.rst:3940 +#: ../../sphinx/doc/changes.rst:4372 ../../sphinx/doc/changes.rst:4449 +#: ../../sphinx/doc/changes.rst:5036 ../../sphinx/doc/changes.rst:5363 msgid "Deprecated" msgstr "" @@ -95,39 +95,39 @@ msgid "" ":option:`!--no-use-make-mode`, and :option:`!--use-make-mode`." msgstr "" -#: ../../sphinx/doc/changes.rst:39 ../../sphinx/doc/changes.rst:198 -#: ../../sphinx/doc/changes.rst:310 ../../sphinx/doc/changes.rst:467 -#: ../../sphinx/doc/changes.rst:617 ../../sphinx/doc/changes.rst:702 -#: ../../sphinx/doc/changes.rst:774 ../../sphinx/doc/changes.rst:832 -#: ../../sphinx/doc/changes.rst:892 ../../sphinx/doc/changes.rst:999 -#: ../../sphinx/doc/changes.rst:1091 ../../sphinx/doc/changes.rst:1147 -#: ../../sphinx/doc/changes.rst:1231 ../../sphinx/doc/changes.rst:1288 -#: ../../sphinx/doc/changes.rst:1356 ../../sphinx/doc/changes.rst:1457 -#: ../../sphinx/doc/changes.rst:1554 ../../sphinx/doc/changes.rst:1695 -#: ../../sphinx/doc/changes.rst:1818 ../../sphinx/doc/changes.rst:1885 -#: ../../sphinx/doc/changes.rst:2081 ../../sphinx/doc/changes.rst:2176 -#: ../../sphinx/doc/changes.rst:2255 ../../sphinx/doc/changes.rst:2287 -#: ../../sphinx/doc/changes.rst:2420 ../../sphinx/doc/changes.rst:2472 -#: ../../sphinx/doc/changes.rst:2612 ../../sphinx/doc/changes.rst:2626 -#: ../../sphinx/doc/changes.rst:2743 ../../sphinx/doc/changes.rst:2949 -#: ../../sphinx/doc/changes.rst:3051 ../../sphinx/doc/changes.rst:3174 -#: ../../sphinx/doc/changes.rst:3318 ../../sphinx/doc/changes.rst:3592 -#: ../../sphinx/doc/changes.rst:3768 ../../sphinx/doc/changes.rst:3806 -#: ../../sphinx/doc/changes.rst:4030 ../../sphinx/doc/changes.rst:4171 -#: ../../sphinx/doc/changes.rst:4463 ../../sphinx/doc/changes.rst:4641 -#: ../../sphinx/doc/changes.rst:4680 ../../sphinx/doc/changes.rst:4714 -#: ../../sphinx/doc/changes.rst:4747 ../../sphinx/doc/changes.rst:4916 -#: ../../sphinx/doc/changes.rst:5127 ../../sphinx/doc/changes.rst:5161 -#: ../../sphinx/doc/changes.rst:5201 ../../sphinx/doc/changes.rst:5255 -#: ../../sphinx/doc/changes.rst:5376 ../../sphinx/doc/changes.rst:5686 -#: ../../sphinx/doc/changes.rst:5782 ../../sphinx/doc/changes.rst:5950 -#: ../../sphinx/doc/changes.rst:6088 ../../sphinx/doc/changes.rst:6212 -#: ../../sphinx/doc/changes.rst:6324 ../../sphinx/doc/changes.rst:6375 -#: ../../sphinx/doc/changes.rst:6445 ../../sphinx/doc/changes.rst:6498 -#: ../../sphinx/doc/changes.rst:6661 ../../sphinx/doc/changes.rst:6831 -#: ../../sphinx/doc/changes.rst:6874 ../../sphinx/doc/changes.rst:6902 -#: ../../sphinx/doc/changes.rst:6996 ../../sphinx/doc/changes.rst:7301 -#: ../../sphinx/doc/changes.rst:7710 +#: ../../sphinx/doc/changes.rst:39 ../../sphinx/doc/changes.rst:200 +#: ../../sphinx/doc/changes.rst:312 ../../sphinx/doc/changes.rst:469 +#: ../../sphinx/doc/changes.rst:619 ../../sphinx/doc/changes.rst:704 +#: ../../sphinx/doc/changes.rst:776 ../../sphinx/doc/changes.rst:834 +#: ../../sphinx/doc/changes.rst:894 ../../sphinx/doc/changes.rst:1001 +#: ../../sphinx/doc/changes.rst:1093 ../../sphinx/doc/changes.rst:1149 +#: ../../sphinx/doc/changes.rst:1233 ../../sphinx/doc/changes.rst:1290 +#: ../../sphinx/doc/changes.rst:1358 ../../sphinx/doc/changes.rst:1459 +#: ../../sphinx/doc/changes.rst:1556 ../../sphinx/doc/changes.rst:1697 +#: ../../sphinx/doc/changes.rst:1820 ../../sphinx/doc/changes.rst:1887 +#: ../../sphinx/doc/changes.rst:2083 ../../sphinx/doc/changes.rst:2178 +#: ../../sphinx/doc/changes.rst:2257 ../../sphinx/doc/changes.rst:2289 +#: ../../sphinx/doc/changes.rst:2422 ../../sphinx/doc/changes.rst:2474 +#: ../../sphinx/doc/changes.rst:2614 ../../sphinx/doc/changes.rst:2628 +#: ../../sphinx/doc/changes.rst:2745 ../../sphinx/doc/changes.rst:2951 +#: ../../sphinx/doc/changes.rst:3053 ../../sphinx/doc/changes.rst:3176 +#: ../../sphinx/doc/changes.rst:3320 ../../sphinx/doc/changes.rst:3594 +#: ../../sphinx/doc/changes.rst:3770 ../../sphinx/doc/changes.rst:3808 +#: ../../sphinx/doc/changes.rst:4032 ../../sphinx/doc/changes.rst:4173 +#: ../../sphinx/doc/changes.rst:4465 ../../sphinx/doc/changes.rst:4643 +#: ../../sphinx/doc/changes.rst:4682 ../../sphinx/doc/changes.rst:4716 +#: ../../sphinx/doc/changes.rst:4749 ../../sphinx/doc/changes.rst:4918 +#: ../../sphinx/doc/changes.rst:5129 ../../sphinx/doc/changes.rst:5163 +#: ../../sphinx/doc/changes.rst:5203 ../../sphinx/doc/changes.rst:5257 +#: ../../sphinx/doc/changes.rst:5378 ../../sphinx/doc/changes.rst:5688 +#: ../../sphinx/doc/changes.rst:5784 ../../sphinx/doc/changes.rst:5952 +#: ../../sphinx/doc/changes.rst:6090 ../../sphinx/doc/changes.rst:6214 +#: ../../sphinx/doc/changes.rst:6326 ../../sphinx/doc/changes.rst:6377 +#: ../../sphinx/doc/changes.rst:6447 ../../sphinx/doc/changes.rst:6500 +#: ../../sphinx/doc/changes.rst:6663 ../../sphinx/doc/changes.rst:6833 +#: ../../sphinx/doc/changes.rst:6876 ../../sphinx/doc/changes.rst:6904 +#: ../../sphinx/doc/changes.rst:6998 ../../sphinx/doc/changes.rst:7303 +#: ../../sphinx/doc/changes.rst:7712 msgid "Features added" msgstr "" @@ -137,74 +137,74 @@ msgid "" "Adopt the new ``_ element. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/doc/changes.rst:47 ../../sphinx/doc/changes.rst:73 -#: ../../sphinx/doc/changes.rst:85 ../../sphinx/doc/changes.rst:110 -#: ../../sphinx/doc/changes.rst:127 ../../sphinx/doc/changes.rst:142 -#: ../../sphinx/doc/changes.rst:157 ../../sphinx/doc/changes.rst:230 -#: ../../sphinx/doc/changes.rst:276 ../../sphinx/doc/changes.rst:286 -#: ../../sphinx/doc/changes.rst:350 ../../sphinx/doc/changes.rst:393 -#: ../../sphinx/doc/changes.rst:434 ../../sphinx/doc/changes.rst:504 -#: ../../sphinx/doc/changes.rst:542 ../../sphinx/doc/changes.rst:552 -#: ../../sphinx/doc/changes.rst:568 ../../sphinx/doc/changes.rst:628 -#: ../../sphinx/doc/changes.rst:649 ../../sphinx/doc/changes.rst:710 -#: ../../sphinx/doc/changes.rst:747 ../../sphinx/doc/changes.rst:795 -#: ../../sphinx/doc/changes.rst:808 ../../sphinx/doc/changes.rst:856 -#: ../../sphinx/doc/changes.rst:898 ../../sphinx/doc/changes.rst:912 -#: ../../sphinx/doc/changes.rst:1026 ../../sphinx/doc/changes.rst:1110 -#: ../../sphinx/doc/changes.rst:1184 ../../sphinx/doc/changes.rst:1222 -#: ../../sphinx/doc/changes.rst:1237 ../../sphinx/doc/changes.rst:1311 -#: ../../sphinx/doc/changes.rst:1371 ../../sphinx/doc/changes.rst:1414 -#: ../../sphinx/doc/changes.rst:1435 ../../sphinx/doc/changes.rst:1517 -#: ../../sphinx/doc/changes.rst:1563 ../../sphinx/doc/changes.rst:1590 -#: ../../sphinx/doc/changes.rst:1600 ../../sphinx/doc/changes.rst:1744 -#: ../../sphinx/doc/changes.rst:1804 ../../sphinx/doc/changes.rst:1826 -#: ../../sphinx/doc/changes.rst:1836 ../../sphinx/doc/changes.rst:1937 -#: ../../sphinx/doc/changes.rst:2020 ../../sphinx/doc/changes.rst:2029 -#: ../../sphinx/doc/changes.rst:2041 ../../sphinx/doc/changes.rst:2104 -#: ../../sphinx/doc/changes.rst:2155 ../../sphinx/doc/changes.rst:2197 -#: ../../sphinx/doc/changes.rst:2262 ../../sphinx/doc/changes.rst:2329 -#: ../../sphinx/doc/changes.rst:2394 ../../sphinx/doc/changes.rst:2426 -#: ../../sphinx/doc/changes.rst:2537 ../../sphinx/doc/changes.rst:2600 -#: ../../sphinx/doc/changes.rst:2617 ../../sphinx/doc/changes.rst:2632 -#: ../../sphinx/doc/changes.rst:2653 ../../sphinx/doc/changes.rst:2807 -#: ../../sphinx/doc/changes.rst:2872 ../../sphinx/doc/changes.rst:2881 -#: ../../sphinx/doc/changes.rst:2894 ../../sphinx/doc/changes.rst:2910 -#: ../../sphinx/doc/changes.rst:2981 ../../sphinx/doc/changes.rst:3024 -#: ../../sphinx/doc/changes.rst:3077 ../../sphinx/doc/changes.rst:3132 -#: ../../sphinx/doc/changes.rst:3143 ../../sphinx/doc/changes.rst:3190 -#: ../../sphinx/doc/changes.rst:3227 ../../sphinx/doc/changes.rst:3241 -#: ../../sphinx/doc/changes.rst:3368 ../../sphinx/doc/changes.rst:3398 -#: ../../sphinx/doc/changes.rst:3643 ../../sphinx/doc/changes.rst:3716 -#: ../../sphinx/doc/changes.rst:3739 ../../sphinx/doc/changes.rst:3775 -#: ../../sphinx/doc/changes.rst:3811 ../../sphinx/doc/changes.rst:3845 -#: ../../sphinx/doc/changes.rst:4114 ../../sphinx/doc/changes.rst:4176 -#: ../../sphinx/doc/changes.rst:4189 ../../sphinx/doc/changes.rst:4202 -#: ../../sphinx/doc/changes.rst:4226 ../../sphinx/doc/changes.rst:4268 -#: ../../sphinx/doc/changes.rst:4304 ../../sphinx/doc/changes.rst:4313 -#: ../../sphinx/doc/changes.rst:4343 ../../sphinx/doc/changes.rst:4380 -#: ../../sphinx/doc/changes.rst:4558 ../../sphinx/doc/changes.rst:4619 -#: ../../sphinx/doc/changes.rst:4654 ../../sphinx/doc/changes.rst:4689 -#: ../../sphinx/doc/changes.rst:4720 ../../sphinx/doc/changes.rst:4752 -#: ../../sphinx/doc/changes.rst:4793 ../../sphinx/doc/changes.rst:4979 -#: ../../sphinx/doc/changes.rst:5098 ../../sphinx/doc/changes.rst:5118 -#: ../../sphinx/doc/changes.rst:5132 ../../sphinx/doc/changes.rst:5170 -#: ../../sphinx/doc/changes.rst:5211 ../../sphinx/doc/changes.rst:5261 -#: ../../sphinx/doc/changes.rst:5493 ../../sphinx/doc/changes.rst:5582 -#: ../../sphinx/doc/changes.rst:5602 ../../sphinx/doc/changes.rst:5610 -#: ../../sphinx/doc/changes.rst:5646 ../../sphinx/doc/changes.rst:5696 -#: ../../sphinx/doc/changes.rst:5733 ../../sphinx/doc/changes.rst:5758 -#: ../../sphinx/doc/changes.rst:5807 ../../sphinx/doc/changes.rst:5885 -#: ../../sphinx/doc/changes.rst:6023 ../../sphinx/doc/changes.rst:6096 -#: ../../sphinx/doc/changes.rst:6118 ../../sphinx/doc/changes.rst:6140 -#: ../../sphinx/doc/changes.rst:6199 ../../sphinx/doc/changes.rst:6217 -#: ../../sphinx/doc/changes.rst:6294 ../../sphinx/doc/changes.rst:6338 -#: ../../sphinx/doc/changes.rst:6409 ../../sphinx/doc/changes.rst:6454 -#: ../../sphinx/doc/changes.rst:6576 ../../sphinx/doc/changes.rst:6668 -#: ../../sphinx/doc/changes.rst:6709 ../../sphinx/doc/changes.rst:6741 -#: ../../sphinx/doc/changes.rst:6843 ../../sphinx/doc/changes.rst:6887 -#: ../../sphinx/doc/changes.rst:6932 ../../sphinx/doc/changes.rst:7135 -#: ../../sphinx/doc/changes.rst:8567 ../../sphinx/doc/changes.rst:8791 -#: ../../sphinx/doc/changes.rst:8872 ../../sphinx/doc/changes.rst:8978 +#: ../../sphinx/doc/changes.rst:47 ../../sphinx/doc/changes.rst:75 +#: ../../sphinx/doc/changes.rst:87 ../../sphinx/doc/changes.rst:112 +#: ../../sphinx/doc/changes.rst:129 ../../sphinx/doc/changes.rst:144 +#: ../../sphinx/doc/changes.rst:159 ../../sphinx/doc/changes.rst:232 +#: ../../sphinx/doc/changes.rst:278 ../../sphinx/doc/changes.rst:288 +#: ../../sphinx/doc/changes.rst:352 ../../sphinx/doc/changes.rst:395 +#: ../../sphinx/doc/changes.rst:436 ../../sphinx/doc/changes.rst:506 +#: ../../sphinx/doc/changes.rst:544 ../../sphinx/doc/changes.rst:554 +#: ../../sphinx/doc/changes.rst:570 ../../sphinx/doc/changes.rst:630 +#: ../../sphinx/doc/changes.rst:651 ../../sphinx/doc/changes.rst:712 +#: ../../sphinx/doc/changes.rst:749 ../../sphinx/doc/changes.rst:797 +#: ../../sphinx/doc/changes.rst:810 ../../sphinx/doc/changes.rst:858 +#: ../../sphinx/doc/changes.rst:900 ../../sphinx/doc/changes.rst:914 +#: ../../sphinx/doc/changes.rst:1028 ../../sphinx/doc/changes.rst:1112 +#: ../../sphinx/doc/changes.rst:1186 ../../sphinx/doc/changes.rst:1224 +#: ../../sphinx/doc/changes.rst:1239 ../../sphinx/doc/changes.rst:1313 +#: ../../sphinx/doc/changes.rst:1373 ../../sphinx/doc/changes.rst:1416 +#: ../../sphinx/doc/changes.rst:1437 ../../sphinx/doc/changes.rst:1519 +#: ../../sphinx/doc/changes.rst:1565 ../../sphinx/doc/changes.rst:1592 +#: ../../sphinx/doc/changes.rst:1602 ../../sphinx/doc/changes.rst:1746 +#: ../../sphinx/doc/changes.rst:1806 ../../sphinx/doc/changes.rst:1828 +#: ../../sphinx/doc/changes.rst:1838 ../../sphinx/doc/changes.rst:1939 +#: ../../sphinx/doc/changes.rst:2022 ../../sphinx/doc/changes.rst:2031 +#: ../../sphinx/doc/changes.rst:2043 ../../sphinx/doc/changes.rst:2106 +#: ../../sphinx/doc/changes.rst:2157 ../../sphinx/doc/changes.rst:2199 +#: ../../sphinx/doc/changes.rst:2264 ../../sphinx/doc/changes.rst:2331 +#: ../../sphinx/doc/changes.rst:2396 ../../sphinx/doc/changes.rst:2428 +#: ../../sphinx/doc/changes.rst:2539 ../../sphinx/doc/changes.rst:2602 +#: ../../sphinx/doc/changes.rst:2619 ../../sphinx/doc/changes.rst:2634 +#: ../../sphinx/doc/changes.rst:2655 ../../sphinx/doc/changes.rst:2809 +#: ../../sphinx/doc/changes.rst:2874 ../../sphinx/doc/changes.rst:2883 +#: ../../sphinx/doc/changes.rst:2896 ../../sphinx/doc/changes.rst:2912 +#: ../../sphinx/doc/changes.rst:2983 ../../sphinx/doc/changes.rst:3026 +#: ../../sphinx/doc/changes.rst:3079 ../../sphinx/doc/changes.rst:3134 +#: ../../sphinx/doc/changes.rst:3145 ../../sphinx/doc/changes.rst:3192 +#: ../../sphinx/doc/changes.rst:3229 ../../sphinx/doc/changes.rst:3243 +#: ../../sphinx/doc/changes.rst:3370 ../../sphinx/doc/changes.rst:3400 +#: ../../sphinx/doc/changes.rst:3645 ../../sphinx/doc/changes.rst:3718 +#: ../../sphinx/doc/changes.rst:3741 ../../sphinx/doc/changes.rst:3777 +#: ../../sphinx/doc/changes.rst:3813 ../../sphinx/doc/changes.rst:3847 +#: ../../sphinx/doc/changes.rst:4116 ../../sphinx/doc/changes.rst:4178 +#: ../../sphinx/doc/changes.rst:4191 ../../sphinx/doc/changes.rst:4204 +#: ../../sphinx/doc/changes.rst:4228 ../../sphinx/doc/changes.rst:4270 +#: ../../sphinx/doc/changes.rst:4306 ../../sphinx/doc/changes.rst:4315 +#: ../../sphinx/doc/changes.rst:4345 ../../sphinx/doc/changes.rst:4382 +#: ../../sphinx/doc/changes.rst:4560 ../../sphinx/doc/changes.rst:4621 +#: ../../sphinx/doc/changes.rst:4656 ../../sphinx/doc/changes.rst:4691 +#: ../../sphinx/doc/changes.rst:4722 ../../sphinx/doc/changes.rst:4754 +#: ../../sphinx/doc/changes.rst:4795 ../../sphinx/doc/changes.rst:4981 +#: ../../sphinx/doc/changes.rst:5100 ../../sphinx/doc/changes.rst:5120 +#: ../../sphinx/doc/changes.rst:5134 ../../sphinx/doc/changes.rst:5172 +#: ../../sphinx/doc/changes.rst:5213 ../../sphinx/doc/changes.rst:5263 +#: ../../sphinx/doc/changes.rst:5495 ../../sphinx/doc/changes.rst:5584 +#: ../../sphinx/doc/changes.rst:5604 ../../sphinx/doc/changes.rst:5612 +#: ../../sphinx/doc/changes.rst:5648 ../../sphinx/doc/changes.rst:5698 +#: ../../sphinx/doc/changes.rst:5735 ../../sphinx/doc/changes.rst:5760 +#: ../../sphinx/doc/changes.rst:5809 ../../sphinx/doc/changes.rst:5887 +#: ../../sphinx/doc/changes.rst:6025 ../../sphinx/doc/changes.rst:6098 +#: ../../sphinx/doc/changes.rst:6120 ../../sphinx/doc/changes.rst:6142 +#: ../../sphinx/doc/changes.rst:6201 ../../sphinx/doc/changes.rst:6219 +#: ../../sphinx/doc/changes.rst:6296 ../../sphinx/doc/changes.rst:6340 +#: ../../sphinx/doc/changes.rst:6411 ../../sphinx/doc/changes.rst:6456 +#: ../../sphinx/doc/changes.rst:6578 ../../sphinx/doc/changes.rst:6670 +#: ../../sphinx/doc/changes.rst:6711 ../../sphinx/doc/changes.rst:6743 +#: ../../sphinx/doc/changes.rst:6845 ../../sphinx/doc/changes.rst:6889 +#: ../../sphinx/doc/changes.rst:6934 ../../sphinx/doc/changes.rst:7137 +#: ../../sphinx/doc/changes.rst:8569 ../../sphinx/doc/changes.rst:8793 +#: ../../sphinx/doc/changes.rst:8874 ../../sphinx/doc/changes.rst:8980 msgid "Bugs fixed" msgstr "" @@ -254,19 +254,26 @@ msgid "" "add 'noindex' meta robots tag. Patch by James Addison." msgstr "" -#: ../../sphinx/doc/changes.rst:67 ../../sphinx/doc/changes.rst:265 -#: ../../sphinx/doc/changes.rst:377 ../../sphinx/doc/changes.rst:532 -#: ../../sphinx/doc/changes.rst:2247 ../../sphinx/doc/changes.rst:3694 -#: ../../sphinx/doc/changes.rst:4608 ../../sphinx/doc/changes.rst:5083 -#: ../../sphinx/doc/changes.rst:5573 +#: ../../sphinx/doc/changes.rst:65 +msgid "" +"`#11678 `_: Fix a " +"possible ``ZeroDivisionError`` in ``sphinx.ext.coverage``. Patch by Stephen " +"Finucane." +msgstr "" + +#: ../../sphinx/doc/changes.rst:69 ../../sphinx/doc/changes.rst:267 +#: ../../sphinx/doc/changes.rst:379 ../../sphinx/doc/changes.rst:534 +#: ../../sphinx/doc/changes.rst:2249 ../../sphinx/doc/changes.rst:3696 +#: ../../sphinx/doc/changes.rst:4610 ../../sphinx/doc/changes.rst:5085 +#: ../../sphinx/doc/changes.rst:5575 msgid "Testing" msgstr "" -#: ../../sphinx/doc/changes.rst:70 +#: ../../sphinx/doc/changes.rst:72 msgid "Release 7.2.6 (released Sep 13, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:75 +#: ../../sphinx/doc/changes.rst:77 msgid "" "`#11679 `_: Add the " ":envvar:`!SPHINX_AUTODOC_RELOAD_MODULES` environment variable, which if set " @@ -274,18 +281,18 @@ msgid "" "Matt Wozniski and Adam Turner." msgstr "" -#: ../../sphinx/doc/changes.rst:78 +#: ../../sphinx/doc/changes.rst:80 msgid "" "`#11679 `_: Use " ":py:func:`importlib.reload` to reload modules in autodoc. Patch by Matt " "Wozniski and Adam Turner." msgstr "" -#: ../../sphinx/doc/changes.rst:82 +#: ../../sphinx/doc/changes.rst:84 msgid "Release 7.2.5 (released Aug 30, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:87 +#: ../../sphinx/doc/changes.rst:89 msgid "" "`#11645 `_: Fix a " "regression preventing autodoc from importing modules within packages that " @@ -293,50 +300,50 @@ msgid "" " type checkers. Patch by Matt Wozniski." msgstr "" -#: ../../sphinx/doc/changes.rst:91 +#: ../../sphinx/doc/changes.rst:93 msgid "" "`#11634 `_: Fixed " "inheritance diagram relative link resolution for sibling files in a " "subdirectory. Patch by Albert Shih." msgstr "" -#: ../../sphinx/doc/changes.rst:94 +#: ../../sphinx/doc/changes.rst:96 msgid "" "`#11659 `_: Allow " "``?config=...`` in :confval:`mathjax_path`." msgstr "" -#: ../../sphinx/doc/changes.rst:95 +#: ../../sphinx/doc/changes.rst:97 msgid "" "`#11654 `_: autodoc: Fail" " with a more descriptive error message when an object claims to be an " "instance of ``type``, but is not a class. Patch by James Braza." msgstr "" -#: ../../sphinx/doc/changes.rst:99 +#: ../../sphinx/doc/changes.rst:101 msgid "" "11620: Cease emitting :event:`source-read` events for files read via the " ":dudir:`include` directive." msgstr "" -#: ../../sphinx/doc/changes.rst:101 +#: ../../sphinx/doc/changes.rst:103 msgid "" "11620: Add a new :event:`include-read` for observing and transforming the " "content of included files via the :dudir:`include` directive." msgstr "" -#: ../../sphinx/doc/changes.rst:103 +#: ../../sphinx/doc/changes.rst:105 msgid "" "`#11627 `_: Restore " "support for copyright lines of the form ``YYYY`` when ``SOURCE_DATE_EPOCH`` " "is set." msgstr "" -#: ../../sphinx/doc/changes.rst:107 +#: ../../sphinx/doc/changes.rst:109 msgid "Release 7.2.4 (released Aug 28, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:112 +#: ../../sphinx/doc/changes.rst:114 msgid "" "`#11618 `_: Fix a " "regression in the MoveModuleTargets transform, introduced in `#10478 " @@ -344,7 +351,7 @@ msgid "" "`_)." msgstr "" -#: ../../sphinx/doc/changes.rst:114 +#: ../../sphinx/doc/changes.rst:116 msgid "" "`#11649 `_: linkcheck: " "Resolve hanging tests for timezones west of London and incorrect conversion " @@ -352,32 +359,32 @@ msgid "" "Turner." msgstr "" -#: ../../sphinx/doc/changes.rst:119 +#: ../../sphinx/doc/changes.rst:121 msgid "Release 7.2.3 (released Aug 23, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:124 +#: ../../sphinx/doc/changes.rst:126 msgid "" "`#11576 `_: Require " "sphinxcontrib-serializinghtml 1.1.9." msgstr "" -#: ../../sphinx/doc/changes.rst:129 +#: ../../sphinx/doc/changes.rst:131 msgid "Fix regression in ``autodoc.Documenter.parse_name()``." msgstr "" -#: ../../sphinx/doc/changes.rst:130 +#: ../../sphinx/doc/changes.rst:132 msgid "Fix regression in JSON serialisation." msgstr "" -#: ../../sphinx/doc/changes.rst:131 +#: ../../sphinx/doc/changes.rst:133 msgid "" "`#11543 `_: autodoc: " "Support positional-only parameters in ``classmethod`` methods when " "``autodoc_preserve_defaults`` is ``True``." msgstr "" -#: ../../sphinx/doc/changes.rst:133 +#: ../../sphinx/doc/changes.rst:135 msgid "" "Restore support string methods on path objects. This is deprecated and will " "be removed in Sphinx 8. Use :py:func:`os.fspath` to convert " @@ -385,92 +392,92 @@ msgid "" " methods to work with path objects." msgstr "" -#: ../../sphinx/doc/changes.rst:139 +#: ../../sphinx/doc/changes.rst:141 msgid "Release 7.2.2 (released Aug 17, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:144 +#: ../../sphinx/doc/changes.rst:146 msgid "" "Fix the signature of the ``StateMachine.insert_input()`` patch, for when " "calling with keyword arguments." msgstr "" -#: ../../sphinx/doc/changes.rst:146 +#: ../../sphinx/doc/changes.rst:148 msgid "" "Fixed membership testing (``in``) for the :py:class:`str` interface of the " "asset classes (``_CascadingStyleSheet`` and ``_JavaScript``), which several " "extensions relied upon." msgstr "" -#: ../../sphinx/doc/changes.rst:149 +#: ../../sphinx/doc/changes.rst:151 msgid "" "Fixed a type error in ``SingleFileHTMLBuilder._get_local_toctree``, " "``includehidden`` may be passed as a string or a boolean." msgstr "" -#: ../../sphinx/doc/changes.rst:151 +#: ../../sphinx/doc/changes.rst:153 msgid "Fix ``:noindex:`` for ``PyModule`` and ``JSModule``." msgstr "" -#: ../../sphinx/doc/changes.rst:154 +#: ../../sphinx/doc/changes.rst:156 msgid "Release 7.2.1 (released Aug 17, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:159 +#: ../../sphinx/doc/changes.rst:161 msgid "" "Restored the the :py:class:`str` interface of the asset classes " "(``_CascadingStyleSheet`` and ``_JavaScript``), which several extensions " "relied upon. This will be removed in Sphinx 9." msgstr "" -#: ../../sphinx/doc/changes.rst:163 +#: ../../sphinx/doc/changes.rst:165 msgid "" "Restored calls to ``Builder.add_{css,js}_file()``, which several extensions " "relied upon." msgstr "" -#: ../../sphinx/doc/changes.rst:165 +#: ../../sphinx/doc/changes.rst:167 msgid "" "Restored the private API ``TocTree.get_toctree_ancestors()``, which several " "extensions relied upon." msgstr "" -#: ../../sphinx/doc/changes.rst:169 +#: ../../sphinx/doc/changes.rst:171 msgid "Release 7.2.0 (released Aug 17, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:174 +#: ../../sphinx/doc/changes.rst:176 msgid "" "`#11511 `_: Drop Python " "3.8 support." msgstr "" -#: ../../sphinx/doc/changes.rst:175 +#: ../../sphinx/doc/changes.rst:177 msgid "" "`#11576 `_: Require " "Pygments 2.14 or later." msgstr "" -#: ../../sphinx/doc/changes.rst:180 +#: ../../sphinx/doc/changes.rst:182 msgid "" "`#11512 `_: Deprecate " "``sphinx.util.md5`` and ``sphinx.util.sha1``. Use ``hashlib`` instead." msgstr "" -#: ../../sphinx/doc/changes.rst:182 +#: ../../sphinx/doc/changes.rst:184 msgid "" "`#11526 `_: Deprecate " "``sphinx.testing.path``. Use ``os.path`` or ``pathlib`` instead." msgstr "" -#: ../../sphinx/doc/changes.rst:184 +#: ../../sphinx/doc/changes.rst:186 msgid "" "`#11528 `_: Deprecate " "``sphinx.util.split_index_msg`` and ``sphinx.util.split_into``. Use " "``sphinx.util.index_entries.split_index_msg`` instead." msgstr "" -#: ../../sphinx/doc/changes.rst:186 +#: ../../sphinx/doc/changes.rst:188 msgid "" "Deprecate ``sphinx.builders.html.Stylesheet`` and " "``sphinx.builders.html.Javascript``. Use " @@ -478,7 +485,7 @@ msgid "" "``sphinx.application.Sphinx.add_js_file()`` instead." msgstr "" -#: ../../sphinx/doc/changes.rst:190 +#: ../../sphinx/doc/changes.rst:192 msgid "" "`#11582 `_: Deprecate " "``sphinx.builders.html.StandaloneHTMLBuilder.css_files`` and " @@ -487,78 +494,78 @@ msgid "" "``sphinx.application.Sphinx.add_js_file()`` instead." msgstr "" -#: ../../sphinx/doc/changes.rst:194 +#: ../../sphinx/doc/changes.rst:196 msgid "" "`#11459 `_: Deprecate " "``sphinx.ext.autodoc.preserve_defaults.get_function_def()``. Patch by " "Bénédikt Tran." msgstr "" -#: ../../sphinx/doc/changes.rst:200 +#: ../../sphinx/doc/changes.rst:202 msgid "" "`#11526 `_: Support " "``os.PathLike`` types and ``pathlib.Path`` objects in many more places." msgstr "" -#: ../../sphinx/doc/changes.rst:202 +#: ../../sphinx/doc/changes.rst:204 msgid "" "`#5474 `_: coverage: Print" " summary statistics tables. Patch by Jorge Leitao." msgstr "" -#: ../../sphinx/doc/changes.rst:204 +#: ../../sphinx/doc/changes.rst:206 msgid "" "`#6319 `_: viewcode: Add " ":confval:`viewcode_line_numbers` to control whether line numbers are added " "to rendered source code. Patch by Ben Krikler." msgstr "" -#: ../../sphinx/doc/changes.rst:207 +#: ../../sphinx/doc/changes.rst:209 msgid "" "`#9662 `_: Add the ``:no-" "typesetting:`` option to suppress textual output and only create a linkable " "anchor. Patch by Latosha Maltba." msgstr "" -#: ../../sphinx/doc/changes.rst:210 +#: ../../sphinx/doc/changes.rst:212 msgid "" "`#11221 `_: C++: Support " "domain objects in the table of contents. Patch by Rouslan Korneychuk." msgstr "" -#: ../../sphinx/doc/changes.rst:212 +#: ../../sphinx/doc/changes.rst:214 msgid "" "`#10938 `_: doctest: Add " ":confval:`doctest_show_successes` option. Patch by Trey Hunner." msgstr "" -#: ../../sphinx/doc/changes.rst:214 +#: ../../sphinx/doc/changes.rst:216 msgid "" "`#11533 `_: Add ``:no-" "index:``, ``:no-index-entry:``, and ``:no-contents-entry:``." msgstr "" -#: ../../sphinx/doc/changes.rst:215 +#: ../../sphinx/doc/changes.rst:217 msgid "" "`#11572 `_: Improve " "``debug`` logging of reasons why files are detected as out of date. Patch by" " Eric Larson." msgstr "" -#: ../../sphinx/doc/changes.rst:218 +#: ../../sphinx/doc/changes.rst:220 msgid "" "`#10678 `_: Emit " ":event:`source-read` events for files read via the :dudir:`include` " "directive. Patch by Halldor Fannar." msgstr "" -#: ../../sphinx/doc/changes.rst:221 +#: ../../sphinx/doc/changes.rst:223 msgid "" "`#11570 `_: Use short " "names when using :pep:`585` built-in generics. Patch by Riccardo Mori." msgstr "" -#: ../../sphinx/doc/changes.rst:223 +#: ../../sphinx/doc/changes.rst:225 msgid "" "`#11300 `_: Improve " "``SigElementFallbackTransform`` fallback logic and signature text elements " @@ -566,163 +573,163 @@ msgid "" "by Bénédikt Tran." msgstr "" -#: ../../sphinx/doc/changes.rst:227 +#: ../../sphinx/doc/changes.rst:229 msgid "Allow running Sphinx with ``python -m sphinx build ...``." msgstr "" -#: ../../sphinx/doc/changes.rst:232 +#: ../../sphinx/doc/changes.rst:234 msgid "" "`#11077 `_: graphviz: Fix" " relative links from within the graph. Patch by Ralf Grubenmann." msgstr "" -#: ../../sphinx/doc/changes.rst:234 +#: ../../sphinx/doc/changes.rst:236 msgid "" "`#11529 `_: Line Block in" " LaTeX builder outputs spurious empty token. Patch by Adrian Vollmer." msgstr "" -#: ../../sphinx/doc/changes.rst:236 +#: ../../sphinx/doc/changes.rst:238 msgid "" "`#11196 `_: autosummary: " "Summary line extraction failed with \"e.g.\"" msgstr "" -#: ../../sphinx/doc/changes.rst:237 +#: ../../sphinx/doc/changes.rst:239 msgid "" "`#10614 `_: Fixed a " "number of bugs in inheritance diagrams that resulted in missing or broken " "links. Patch by Albert Shih." msgstr "" -#: ../../sphinx/doc/changes.rst:240 +#: ../../sphinx/doc/changes.rst:242 msgid "" "`#9428 `_: Exclude " "substitution definitions when running the ``gettext`` builder. Patch by " "Alvin Wong." msgstr "" -#: ../../sphinx/doc/changes.rst:242 +#: ../../sphinx/doc/changes.rst:244 msgid "" "`#10795 `_: Raise a " "descriptive error if ``graphviz_dot`` is falsy." msgstr "" -#: ../../sphinx/doc/changes.rst:243 +#: ../../sphinx/doc/changes.rst:245 msgid "" "`#11546 `_: Translated " "nodes identical to their original text are now marked with the " "``translated=True`` attribute." msgstr "" -#: ../../sphinx/doc/changes.rst:245 +#: ../../sphinx/doc/changes.rst:247 msgid "" "`#10049 `_: html: Change " "\"Permalink\" to \"Link\" for title text in link anchors." msgstr "" -#: ../../sphinx/doc/changes.rst:246 +#: ../../sphinx/doc/changes.rst:248 msgid "" "`#4225 `_: Relax Pygments " "parsing on lexing failures." msgstr "" -#: ../../sphinx/doc/changes.rst:247 +#: ../../sphinx/doc/changes.rst:249 msgid "" "`#11246 `_: Allow inline " "links in the first line of a docstring and one-line type comments ``#: :meta" " ...:`` when using :mod:`sphinx.ext.napoleon`. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/doc/changes.rst:250 +#: ../../sphinx/doc/changes.rst:252 msgid "" "`#10930 `_: Highlight all" " search terms on the search results page. Patch by Dmitry Shachnev." msgstr "" -#: ../../sphinx/doc/changes.rst:252 +#: ../../sphinx/doc/changes.rst:254 msgid "" "`#11473 `_: Type " "annotations containing :py:data:`~typing.Literal` enumeration values now " "render correctly. Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/doc/changes.rst:255 +#: ../../sphinx/doc/changes.rst:257 msgid "" "`#11591 `_: Fix support " "for C coverage in ``sphinx.ext.coverage`` extension. Patch by Stephen " "Finucane." msgstr "" -#: ../../sphinx/doc/changes.rst:257 +#: ../../sphinx/doc/changes.rst:259 msgid "" "`#11594 `_: HTML Theme: " "Enhancements to horizontal scrolling on smaller devices in the ``agogo`` " "theme. Patch by Lukas Engelter." msgstr "" -#: ../../sphinx/doc/changes.rst:260 +#: ../../sphinx/doc/changes.rst:262 msgid "" "`#11459 `_: Fix support " "for async and lambda functions in ``sphinx.ext.autodoc.preserve_defaults``. " "Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/doc/changes.rst:267 +#: ../../sphinx/doc/changes.rst:269 msgid "" "`#11577 `_: pytest: Fail " "tests on \"XPASS\"." msgstr "" -#: ../../sphinx/doc/changes.rst:268 +#: ../../sphinx/doc/changes.rst:270 msgid "" "`#11577 `_: pytest: Use " "\"importlib\" import mode." msgstr "" -#: ../../sphinx/doc/changes.rst:269 +#: ../../sphinx/doc/changes.rst:271 msgid "" "`#11577 `_: pytest: Set " "PYTHONWARNINGS=error." msgstr "" -#: ../../sphinx/doc/changes.rst:270 +#: ../../sphinx/doc/changes.rst:272 msgid "" "`#11577 `_: pytest: Set " "strict config and strict markers." msgstr "" -#: ../../sphinx/doc/changes.rst:273 +#: ../../sphinx/doc/changes.rst:275 msgid "Release 7.1.2 (released Aug 02, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:278 +#: ../../sphinx/doc/changes.rst:280 msgid "" "`#11542 `_: linkcheck: " "Properly respect :confval:`linkcheck_anchors` and do not spuriously report " "failures to validate anchors. Patch by James Addison." msgstr "" -#: ../../sphinx/doc/changes.rst:283 +#: ../../sphinx/doc/changes.rst:285 msgid "Release 7.1.1 (released Jul 27, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:288 +#: ../../sphinx/doc/changes.rst:290 msgid "" "`#11514 `_: Fix " "``SOURCE_DATE_EPOCH`` in multi-line copyright footer. Patch by Bénédikt " "Tran." msgstr "" -#: ../../sphinx/doc/changes.rst:292 +#: ../../sphinx/doc/changes.rst:294 msgid "Release 7.1.0 (released Jul 24, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:297 +#: ../../sphinx/doc/changes.rst:299 msgid "Releases are no longer signed, given the `change in PyPI policy`_." msgstr "" -#: ../../sphinx/doc/changes.rst:304 +#: ../../sphinx/doc/changes.rst:306 msgid "" "`#11412 `_: Emit warnings" " on using a deprecated Python-specific index entry type (namely, ``module``," @@ -731,20 +738,20 @@ msgid "" "to Sphinx 9. Patch by Adam Turner." msgstr "" -#: ../../sphinx/doc/changes.rst:312 +#: ../../sphinx/doc/changes.rst:314 msgid "" "`#11415 `_: Add a " "checksum to JavaScript and CSS asset URIs included within generated HTML, " "using the CRC32 algorithm." msgstr "" -#: ../../sphinx/doc/changes.rst:314 +#: ../../sphinx/doc/changes.rst:316 msgid "" ":meth:`~sphinx.application.Sphinx.require_sphinx` now allows the version " "requirement to be specified as ``(major, minor)``." msgstr "" -#: ../../sphinx/doc/changes.rst:316 +#: ../../sphinx/doc/changes.rst:318 msgid "" "`#11011 `_: Allow " "configuring a line-length limit for object signatures, via " @@ -756,44 +763,44 @@ msgid "" "parameter-list`. Patch by Thomas Louf, Adam Turner, and Jean-François B." msgstr "" -#: ../../sphinx/doc/changes.rst:323 +#: ../../sphinx/doc/changes.rst:325 msgid "" "`#10983 `_: Support for " "multiline copyright statements in the footer block. Patch by Stefanie Molin" msgstr "" -#: ../../sphinx/doc/changes.rst:325 +#: ../../sphinx/doc/changes.rst:327 msgid "" "``sphinx.util.display.status_iterator`` now clears the current line with " "ANSI control codes, rather than overprinting with space characters." msgstr "" -#: ../../sphinx/doc/changes.rst:327 +#: ../../sphinx/doc/changes.rst:329 msgid "" "`#11431 `_: linkcheck: " "Treat SSL failures as broken links. Patch by James Addison." msgstr "" -#: ../../sphinx/doc/changes.rst:329 +#: ../../sphinx/doc/changes.rst:331 msgid "" "`#11157 `_: Keep the " "``translated`` attribute on translated nodes." msgstr "" -#: ../../sphinx/doc/changes.rst:330 +#: ../../sphinx/doc/changes.rst:332 msgid "" "`#11451 `_: Improve the " "traceback displayed when using :option:`sphinx-build -T` in parallel builds." " Patch by Bénédikt Tran" msgstr "" -#: ../../sphinx/doc/changes.rst:332 +#: ../../sphinx/doc/changes.rst:334 msgid "" "`#11324 `_: linkcheck: " "Use session-basd HTTP requests." msgstr "" -#: ../../sphinx/doc/changes.rst:333 +#: ../../sphinx/doc/changes.rst:335 msgid "" "`#11438 `_: Add support " "for the :rst:dir:`py:class` and :rst:dir:`py:function` directives for PEP " @@ -805,7 +812,7 @@ msgid "" "Tran." msgstr "" -#: ../../sphinx/doc/changes.rst:339 +#: ../../sphinx/doc/changes.rst:341 msgid "" "`#11484 `_: linkcheck: " "Allow HTML anchors to be ignored on a per-URL basis via " @@ -813,7 +820,7 @@ msgid "" "validity of the page itself. Patch by Bénédikt Tran" msgstr "" -#: ../../sphinx/doc/changes.rst:343 +#: ../../sphinx/doc/changes.rst:345 msgid "" "`#1246 `_: Add translation" " progress statistics and inspection support, via a new substitution " @@ -823,13 +830,13 @@ msgid "" "translated and untranslated elements." msgstr "" -#: ../../sphinx/doc/changes.rst:352 +#: ../../sphinx/doc/changes.rst:354 msgid "" "Restored the ``footnote-reference`` class that has been removed in the " "latest (unreleased) version of Docutils." msgstr "" -#: ../../sphinx/doc/changes.rst:354 +#: ../../sphinx/doc/changes.rst:356 msgid "" "`#11486 `_: Use " ":rfc:`8081` font file MIME types in the EPUB builder. Using the correct MIME" @@ -837,14 +844,14 @@ msgid "" "EPUB." msgstr "" -#: ../../sphinx/doc/changes.rst:357 +#: ../../sphinx/doc/changes.rst:359 msgid "" "`#11435 `_: Use " "microsecond-resolution timestamps for outdated file detection in " "``BuildEnvironment.get_outdated_files``." msgstr "" -#: ../../sphinx/doc/changes.rst:359 +#: ../../sphinx/doc/changes.rst:361 msgid "" "`#11437 `_: Top-level " "headings starting with a reStructuredText role now render properly when " @@ -853,169 +860,169 @@ msgid "" "into the document." msgstr "" -#: ../../sphinx/doc/changes.rst:372 +#: ../../sphinx/doc/changes.rst:374 msgid "Patch by Bénédikt Tran." msgstr "" -#: ../../sphinx/doc/changes.rst:373 +#: ../../sphinx/doc/changes.rst:375 msgid "" "`#11337 `_: Fix a " "``MemoryError`` in ``sphinx.ext.intersphinx`` when using ``None`` or " "``typing.*`` as inline type references. Patch by Bénédikt Tran (picnixz)" msgstr "" -#: ../../sphinx/doc/changes.rst:379 +#: ../../sphinx/doc/changes.rst:381 msgid "" "`#11345 `_: Always delete" " ``docutils.conf`` in test directories when running " "``SphinxTestApp.cleanup()``." msgstr "" -#: ../../sphinx/doc/changes.rst:383 +#: ../../sphinx/doc/changes.rst:385 msgid "Release 7.0.1 (released May 12, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:388 +#: ../../sphinx/doc/changes.rst:390 msgid "" "`#11411 `_: Support " "`Docutils 0.20`_. Patch by Adam Turner." msgstr "" -#: ../../sphinx/doc/changes.rst:395 +#: ../../sphinx/doc/changes.rst:397 msgid "" "`#11418 `_: Clean up " "remaining references to ``sphinx.setup_command`` following the removal of " "support for setuptools. Patch by Willem Mulder." msgstr "" -#: ../../sphinx/doc/changes.rst:400 +#: ../../sphinx/doc/changes.rst:402 msgid "Release 7.0.0 (released Apr 29, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:405 +#: ../../sphinx/doc/changes.rst:407 msgid "" "`#11359 `_: Remove long-" "deprecated aliases for ``MecabSplitter`` and ``DefaultSplitter`` in " "``sphinx.search.ja``." msgstr "" -#: ../../sphinx/doc/changes.rst:407 +#: ../../sphinx/doc/changes.rst:409 msgid "" "`#11360 `_: Remove " "deprecated ``make_old_id`` functions in domain object description classes." msgstr "" -#: ../../sphinx/doc/changes.rst:409 +#: ../../sphinx/doc/changes.rst:411 msgid "" "`#11363 `_: Remove the " "Setuptools integration (``build_sphinx`` hook in ``setup.py``)." msgstr "" -#: ../../sphinx/doc/changes.rst:411 +#: ../../sphinx/doc/changes.rst:413 msgid "" "`#11364 `_: Remove " "deprecated ``sphinx.ext.napoleon.iterators`` module." msgstr "" -#: ../../sphinx/doc/changes.rst:412 +#: ../../sphinx/doc/changes.rst:414 msgid "" "`#11365 `_: Remove " "support for the ``jsdump`` format in ``sphinx.search``." msgstr "" -#: ../../sphinx/doc/changes.rst:413 +#: ../../sphinx/doc/changes.rst:415 msgid "" "`#11366 `_: Make " "``locale`` a required argument to ``sphinx.util.i18n.format_date()``." msgstr "" -#: ../../sphinx/doc/changes.rst:415 +#: ../../sphinx/doc/changes.rst:417 msgid "" "`#11370 `_: Remove " "deprecated ``sphinx.util.stemmer`` module." msgstr "" -#: ../../sphinx/doc/changes.rst:416 +#: ../../sphinx/doc/changes.rst:418 msgid "" "`#11371 `_: Remove " "deprecated ``sphinx.pycode.ast.parse()`` function." msgstr "" -#: ../../sphinx/doc/changes.rst:417 +#: ../../sphinx/doc/changes.rst:419 msgid "" "`#11372 `_: Remove " "deprecated ``sphinx.io.read_doc()`` function." msgstr "" -#: ../../sphinx/doc/changes.rst:418 +#: ../../sphinx/doc/changes.rst:420 msgid "" "`#11373 `_: Removed " "deprecated ``sphinx.util.get_matching_files()`` function." msgstr "" -#: ../../sphinx/doc/changes.rst:419 +#: ../../sphinx/doc/changes.rst:421 msgid "" "`#11378 `_: Remove " "deprecated ``sphinx.util.docutils.is_html5_writer_available()`` function." msgstr "" -#: ../../sphinx/doc/changes.rst:421 +#: ../../sphinx/doc/changes.rst:423 msgid "" "`#11379 `_: Make the " "``env`` argument to ``Builder`` subclasses required." msgstr "" -#: ../../sphinx/doc/changes.rst:422 +#: ../../sphinx/doc/changes.rst:424 msgid "" "`#11380 `_: autosummary: " "Always emit grouped import exceptions." msgstr "" -#: ../../sphinx/doc/changes.rst:423 +#: ../../sphinx/doc/changes.rst:425 msgid "" "`#11381 `_: Remove " "deprecated ``style`` key for HTML templates." msgstr "" -#: ../../sphinx/doc/changes.rst:424 +#: ../../sphinx/doc/changes.rst:426 msgid "" "`#11382 `_: Remove " "deprecated ``sphinx.writers.latex.LaTeXTranslator.docclasses`` attribute." msgstr "" -#: ../../sphinx/doc/changes.rst:426 +#: ../../sphinx/doc/changes.rst:428 msgid "" "`#11383 `_: Remove " "deprecated ``sphinx.builders.html.html5_ready`` and " "``sphinx.builders.html.HTMLTranslator`` attributes." msgstr "" -#: ../../sphinx/doc/changes.rst:428 +#: ../../sphinx/doc/changes.rst:430 msgid "" "`#11385 `_: Remove " "support for HTML 4 output." msgstr "" -#: ../../sphinx/doc/changes.rst:431 +#: ../../sphinx/doc/changes.rst:433 msgid "Release 6.2.1 (released Apr 25, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:436 +#: ../../sphinx/doc/changes.rst:438 msgid "" "`#11355 `_: Revert the " "default type of :confval:`nitpick_ignore` and " ":confval:`nitpick_ignore_regex` to ``list``." msgstr "" -#: ../../sphinx/doc/changes.rst:440 +#: ../../sphinx/doc/changes.rst:442 msgid "Release 6.2.0 (released Apr 23, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:445 +#: ../../sphinx/doc/changes.rst:447 msgid "Require Docutils 0.18.1 or greater." msgstr "" -#: ../../sphinx/doc/changes.rst:450 +#: ../../sphinx/doc/changes.rst:452 msgid "" "LaTeX: removal of some internal TeX ``\\dimen`` registers (not previously " "publicly documented) as per 5.1.0 code comments in ``sphinx.sty``: " @@ -1024,41 +1031,41 @@ msgid "" "`_)" msgstr "" -#: ../../sphinx/doc/changes.rst:454 +#: ../../sphinx/doc/changes.rst:456 msgid "" "Remove ``.egg`` support from pycode ``ModuleAnalyser``; Python eggs are a " "now-obsolete binary distribution format" msgstr "" -#: ../../sphinx/doc/changes.rst:456 +#: ../../sphinx/doc/changes.rst:458 msgid "" "`#11089 `_: Remove " "deprecated code in ``sphinx.builders.linkcheck``. Patch by Daniel Eades" msgstr "" -#: ../../sphinx/doc/changes.rst:458 +#: ../../sphinx/doc/changes.rst:460 msgid "Remove internal-only ``sphinx.locale.setlocale``" msgstr "" -#: ../../sphinx/doc/changes.rst:463 +#: ../../sphinx/doc/changes.rst:465 msgid "" "`#11247 `_: Deprecate the" " legacy ``intersphinx_mapping`` format" msgstr "" -#: ../../sphinx/doc/changes.rst:464 +#: ../../sphinx/doc/changes.rst:466 msgid "" "``sphinx.util.osutil.cd`` is deprecated in favour of ``contextlib.chdir``." msgstr "" -#: ../../sphinx/doc/changes.rst:469 +#: ../../sphinx/doc/changes.rst:471 msgid "" "`#11277 `_: " ":rst:dir:`autoproperty` allows the return type to be specified as a type " "comment (e.g., ``# type: () -> int``). Patch by Bénédikt Tran" msgstr "" -#: ../../sphinx/doc/changes.rst:471 +#: ../../sphinx/doc/changes.rst:473 msgid "" "`#10811 `_: Autosummary: " "extend ``__all__`` to imported members for template rendering when option " @@ -1066,22 +1073,22 @@ msgid "" "Pinard" msgstr "" -#: ../../sphinx/doc/changes.rst:474 +#: ../../sphinx/doc/changes.rst:476 msgid "" "`#11147 `_: Add a " "``content_offset`` parameter to ``nested_parse_with_titles()``, allowing for" " correct line numbers during nested parsing. Patch by Jeremy Maitin-Shepard" msgstr "" -#: ../../sphinx/doc/changes.rst:477 +#: ../../sphinx/doc/changes.rst:479 msgid "Update to Unicode CLDR 42" msgstr "" -#: ../../sphinx/doc/changes.rst:478 +#: ../../sphinx/doc/changes.rst:480 msgid "Add a ``--jobs`` synonym for ``-j``. Patch by Hugo van Kemenade" msgstr "" -#: ../../sphinx/doc/changes.rst:479 +#: ../../sphinx/doc/changes.rst:481 msgid "" "LaTeX: a command ``\\sphinxbox`` for styling text elements with a (possibly " "rounded) box, optional background color and shadow, has been added. See " @@ -1089,7 +1096,7 @@ msgid "" "doc/sphinx/issues/11224>`_)" msgstr "" -#: ../../sphinx/doc/changes.rst:482 +#: ../../sphinx/doc/changes.rst:484 msgid "" "LaTeX: add ``\\sphinxstylenotetitle``, ..., ``\\sphinxstylewarningtitle``, " "..., for an extra layer of mark-up freeing up ``\\sphinxstrong`` for other " @@ -1097,7 +1104,7 @@ msgid "" "doc/sphinx/issues/11267>`_)" msgstr "" -#: ../../sphinx/doc/changes.rst:485 +#: ../../sphinx/doc/changes.rst:487 msgid "" "LaTeX: :dudir:`note`, :dudir:`hint`, :dudir:`important` and :dudir:`tip` can" " now each be styled as the other admonitions, i.e. possibly with a " @@ -1106,46 +1113,46 @@ msgid "" "`_)" msgstr "" -#: ../../sphinx/doc/changes.rst:489 +#: ../../sphinx/doc/changes.rst:491 msgid "" "LaTeX: admonitions and :dudir:`topic` (and :dudir:`contents `) directives, and not only :rst:dir:`code-block`, support ``box-" "decoration-break=slice``." msgstr "" -#: ../../sphinx/doc/changes.rst:492 +#: ../../sphinx/doc/changes.rst:494 msgid "" "LaTeX: let rounded boxes support up to 4 distinct border-widths (refs: " "`#11243 `_)" msgstr "" -#: ../../sphinx/doc/changes.rst:493 +#: ../../sphinx/doc/changes.rst:495 msgid "" "LaTeX: new options ``noteTextColor``, ``noteTeXextras`` et al. See " ":ref:`additionalcss`." msgstr "" -#: ../../sphinx/doc/changes.rst:495 +#: ../../sphinx/doc/changes.rst:497 msgid "" "LaTeX: support elliptical corners in rounded boxes. (refs: `#11254 " "`_)" msgstr "" -#: ../../sphinx/doc/changes.rst:496 +#: ../../sphinx/doc/changes.rst:498 msgid "" "`#11150 `_: Include " "source location in highlighting warnings, when lexing fails. Patch by Jeremy" " Maitin-Shepard" msgstr "" -#: ../../sphinx/doc/changes.rst:498 +#: ../../sphinx/doc/changes.rst:500 msgid "" "`#11281 `_: Support for " ":confval:`imgmath_latex` ``= 'tectonic'`` or ``= 'xelatex'``. Patch by " "Dimitar Dimitrov" msgstr "" -#: ../../sphinx/doc/changes.rst:500 +#: ../../sphinx/doc/changes.rst:502 msgid "" "`#11109 `_, `#9643 " "`_: Add " @@ -1153,14 +1160,14 @@ msgid "" " of ``Literal`` types." msgstr "" -#: ../../sphinx/doc/changes.rst:506 +#: ../../sphinx/doc/changes.rst:508 msgid "" "`#11079 `_: LaTeX: " "figures with align attribute may disappear and strangely impact following " "lists" msgstr "" -#: ../../sphinx/doc/changes.rst:508 +#: ../../sphinx/doc/changes.rst:510 msgid "" "`#11093 `_: LaTeX: fix " "\"multiply-defined references\" PDF build warnings when one or more reST " @@ -1168,333 +1175,333 @@ msgid "" "directive. Patch by Bénédikt Tran (picnixz)" msgstr "" -#: ../../sphinx/doc/changes.rst:511 +#: ../../sphinx/doc/changes.rst:513 msgid "" "`#11110 `_: LaTeX: " "Figures go missing from latex pdf if their files have the same base name and" " they use a post transform. Patch by aaron-cooper" msgstr "" -#: ../../sphinx/doc/changes.rst:513 +#: ../../sphinx/doc/changes.rst:515 msgid "" "LaTeX: fix potential color leak from shadow to border of rounded boxes, if " "shadow color is set but border color is not" msgstr "" -#: ../../sphinx/doc/changes.rst:515 +#: ../../sphinx/doc/changes.rst:517 msgid "" "LaTeX: fix unintended 1pt upwards vertical shift of code blocks frames " "respective to contents (when using rounded corners)" msgstr "" -#: ../../sphinx/doc/changes.rst:517 +#: ../../sphinx/doc/changes.rst:519 msgid "" "`#11235 `_: LaTeX: added " "``\\color`` in topic (or admonition) contents may cause color leak to the " "shadow and border at a page break" msgstr "" -#: ../../sphinx/doc/changes.rst:519 +#: ../../sphinx/doc/changes.rst:521 msgid "" "`#11264 `_: LaTeX: " "missing space before colon after \"Voir aussi\" for :rst:dir:`seealso` " "directive in French" msgstr "" -#: ../../sphinx/doc/changes.rst:521 +#: ../../sphinx/doc/changes.rst:523 msgid "" "`#11268 `_: LaTeX: " "longtable with left alignment breaks out of current list indentation context" " in PDF. Thanks to picnixz." msgstr "" -#: ../../sphinx/doc/changes.rst:523 +#: ../../sphinx/doc/changes.rst:525 msgid "" "`#11274 `_: LaTeX: " "external links are not properly escaped for ``\\sphinxupquote`` " "compatibility" msgstr "" -#: ../../sphinx/doc/changes.rst:525 +#: ../../sphinx/doc/changes.rst:527 msgid "" "`#11147 `_: Fix source " "file/line number info in object description content and in other uses of " "``nested_parse_with_titles``. Patch by Jeremy Maitin-Shepard." msgstr "" -#: ../../sphinx/doc/changes.rst:527 +#: ../../sphinx/doc/changes.rst:529 msgid "" "`#11192 `_: Restore " "correct parallel search index building. Patch by Jeremy Maitin-Shepard" msgstr "" -#: ../../sphinx/doc/changes.rst:529 +#: ../../sphinx/doc/changes.rst:531 msgid "Use the new Transifex ``tx`` client" msgstr "" -#: ../../sphinx/doc/changes.rst:534 +#: ../../sphinx/doc/changes.rst:536 msgid "Fail testing when any Python warnings are emitted" msgstr "" -#: ../../sphinx/doc/changes.rst:535 +#: ../../sphinx/doc/changes.rst:537 msgid "" "Migrate remaining ``unittest.TestCase`` style test functions to pytest style" msgstr "" -#: ../../sphinx/doc/changes.rst:536 +#: ../../sphinx/doc/changes.rst:538 msgid "Remove tests that rely on setuptools" msgstr "" -#: ../../sphinx/doc/changes.rst:539 +#: ../../sphinx/doc/changes.rst:541 msgid "Release 6.1.3 (released Jan 10, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:544 +#: ../../sphinx/doc/changes.rst:546 msgid "" "`#11116 `_: Reverted to " "previous Sphinx 5 node copying method" msgstr "" -#: ../../sphinx/doc/changes.rst:545 +#: ../../sphinx/doc/changes.rst:547 msgid "" "`#11117 `_: Reverted " "changes to parallel image processing from Sphinx 6.1.0" msgstr "" -#: ../../sphinx/doc/changes.rst:546 +#: ../../sphinx/doc/changes.rst:548 msgid "" "`#11119 `_: Supress " "``ValueError`` in the ``linkcheck`` builder" msgstr "" -#: ../../sphinx/doc/changes.rst:549 +#: ../../sphinx/doc/changes.rst:551 msgid "Release 6.1.2 (released Jan 07, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:554 +#: ../../sphinx/doc/changes.rst:556 msgid "" "`#11101 `_: LaTeX: " "``div.topic_padding`` key of sphinxsetup documented at 5.1.0 was implemented" " with name ``topic_padding``" msgstr "" -#: ../../sphinx/doc/changes.rst:556 +#: ../../sphinx/doc/changes.rst:558 msgid "" "`#11099 `_: LaTeX: " "``shadowrule`` key of sphinxsetup causes PDF build to crash since Sphinx " "5.1.0" msgstr "" -#: ../../sphinx/doc/changes.rst:558 +#: ../../sphinx/doc/changes.rst:560 msgid "" "`#11096 `_: LaTeX: " "``shadowsize`` key of sphinxsetup causes PDF build to crash since Sphinx " "5.1.0" msgstr "" -#: ../../sphinx/doc/changes.rst:560 +#: ../../sphinx/doc/changes.rst:562 msgid "" "`#11095 `_: LaTeX: shadow" " of :dudir:`topic` and :dudir:`contents ` boxes not in " "page margin since Sphinx 5.1.0" msgstr "" -#: ../../sphinx/doc/changes.rst:562 +#: ../../sphinx/doc/changes.rst:564 msgid "" "`#11100 `_: Fix copying " "images when running under parallel mode." msgstr "" -#: ../../sphinx/doc/changes.rst:565 +#: ../../sphinx/doc/changes.rst:567 msgid "Release 6.1.1 (released Jan 05, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:570 +#: ../../sphinx/doc/changes.rst:572 msgid "" "`#11091 `_: Fix " "``util.nodes.apply_source_workaround`` for ``literal_block`` nodes with no " "source information in the node or the node's parents." msgstr "" -#: ../../sphinx/doc/changes.rst:574 +#: ../../sphinx/doc/changes.rst:576 msgid "Release 6.1.0 (released Jan 05, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:579 +#: ../../sphinx/doc/changes.rst:581 msgid "Adopted the `Ruff`_ code linter." msgstr "" -#: ../../sphinx/doc/changes.rst:586 +#: ../../sphinx/doc/changes.rst:588 msgid "" "`#10979 `_: gettext: " "Removed support for pluralisation in ``get_translation``. This was unused " "and complicated other changes to ``sphinx.locale``." msgstr "" -#: ../../sphinx/doc/changes.rst:592 +#: ../../sphinx/doc/changes.rst:594 msgid "``sphinx.util`` functions:" msgstr "" -#: ../../sphinx/doc/changes.rst:594 +#: ../../sphinx/doc/changes.rst:596 msgid "" "Renamed ``sphinx.util.typing.stringify()`` to " "``sphinx.util.typing.stringify_annotation()``" msgstr "" -#: ../../sphinx/doc/changes.rst:596 +#: ../../sphinx/doc/changes.rst:598 msgid "" "Moved ``sphinx.util.xmlname_checker()`` to " "``sphinx.builders.epub3._XML_NAME_PATTERN``" msgstr "" -#: ../../sphinx/doc/changes.rst:599 +#: ../../sphinx/doc/changes.rst:601 msgid "Moved to ``sphinx.util.display``:" msgstr "" -#: ../../sphinx/doc/changes.rst:601 +#: ../../sphinx/doc/changes.rst:603 msgid "``sphinx.util.status_iterator``" msgstr "" -#: ../../sphinx/doc/changes.rst:602 +#: ../../sphinx/doc/changes.rst:604 msgid "``sphinx.util.display_chunk``" msgstr "" -#: ../../sphinx/doc/changes.rst:603 +#: ../../sphinx/doc/changes.rst:605 msgid "``sphinx.util.SkipProgressMessage``" msgstr "" -#: ../../sphinx/doc/changes.rst:604 +#: ../../sphinx/doc/changes.rst:606 msgid "``sphinx.util.progress_message``" msgstr "" -#: ../../sphinx/doc/changes.rst:606 +#: ../../sphinx/doc/changes.rst:608 msgid "Moved to ``sphinx.util.http_date``:" msgstr "" -#: ../../sphinx/doc/changes.rst:608 +#: ../../sphinx/doc/changes.rst:610 msgid "``sphinx.util.epoch_to_rfc1123``" msgstr "" -#: ../../sphinx/doc/changes.rst:609 +#: ../../sphinx/doc/changes.rst:611 msgid "``sphinx.util.rfc1123_to_epoch``" msgstr "" -#: ../../sphinx/doc/changes.rst:611 +#: ../../sphinx/doc/changes.rst:613 msgid "Moved to ``sphinx.util.exceptions``:" msgstr "" -#: ../../sphinx/doc/changes.rst:613 +#: ../../sphinx/doc/changes.rst:615 msgid "``sphinx.util.save_traceback``" msgstr "" -#: ../../sphinx/doc/changes.rst:614 +#: ../../sphinx/doc/changes.rst:616 msgid "``sphinx.util.format_exception_cut_frames``" msgstr "" -#: ../../sphinx/doc/changes.rst:619 +#: ../../sphinx/doc/changes.rst:621 msgid "Cache doctrees in the build environment during the writing phase." msgstr "" -#: ../../sphinx/doc/changes.rst:620 +#: ../../sphinx/doc/changes.rst:622 msgid "Make all writing phase tasks support parallel execution." msgstr "" -#: ../../sphinx/doc/changes.rst:621 +#: ../../sphinx/doc/changes.rst:623 msgid "" "`#11072 `_: Use PEP 604 " "(``X | Y``) display conventions for ``typing.Optional`` and " "``typing.Optional`` types within the Python domain and autodoc." msgstr "" -#: ../../sphinx/doc/changes.rst:623 +#: ../../sphinx/doc/changes.rst:625 msgid "" "`#10700 `_: autodoc: " "Document ``typing.NewType()`` types as classes rather than 'data'." msgstr "" -#: ../../sphinx/doc/changes.rst:625 +#: ../../sphinx/doc/changes.rst:627 msgid "Cache doctrees between the reading and writing phases." msgstr "" -#: ../../sphinx/doc/changes.rst:630 +#: ../../sphinx/doc/changes.rst:632 msgid "" "`#10962 `_: HTML: Fix the" " multi-word key name lookup table." msgstr "" -#: ../../sphinx/doc/changes.rst:631 +#: ../../sphinx/doc/changes.rst:633 msgid "" "Fixed support for Python 3.12 alpha 3 (changes in the ``enum`` module)." msgstr "" -#: ../../sphinx/doc/changes.rst:632 +#: ../../sphinx/doc/changes.rst:634 msgid "" "`#11069 `_: HTML Theme: " "Removed outdated \"shortcut\" link relation keyword." msgstr "" -#: ../../sphinx/doc/changes.rst:633 +#: ../../sphinx/doc/changes.rst:635 msgid "" "`#10952 `_: Properly " "terminate parallel processes on programme interuption." msgstr "" -#: ../../sphinx/doc/changes.rst:634 +#: ../../sphinx/doc/changes.rst:636 msgid "" "`#10988 `_: Speed up " "``TocTree.resolve()`` through more efficient copying." msgstr "" -#: ../../sphinx/doc/changes.rst:635 +#: ../../sphinx/doc/changes.rst:637 msgid "" "`#6744 `_: LaTeX: support " "for seealso directive should be via an environment to allow styling." msgstr "" -#: ../../sphinx/doc/changes.rst:637 +#: ../../sphinx/doc/changes.rst:639 msgid "" "`#11074 `_: LaTeX: Can't " "change sphinxnote to use sphinxheavybox starting with 5.1.0" msgstr "" -#: ../../sphinx/doc/changes.rst:641 +#: ../../sphinx/doc/changes.rst:643 msgid "Release 6.0.1 (released Jan 05, 2023)" msgstr "" -#: ../../sphinx/doc/changes.rst:646 +#: ../../sphinx/doc/changes.rst:648 msgid "Require Pygments 2.13 or later." msgstr "" -#: ../../sphinx/doc/changes.rst:651 +#: ../../sphinx/doc/changes.rst:653 msgid "" "`#10944 `_: imgmath: Fix " "resolving image paths for files in nested folders." msgstr "" -#: ../../sphinx/doc/changes.rst:654 +#: ../../sphinx/doc/changes.rst:656 msgid "Release 6.0.0 (released Dec 29, 2022)" msgstr "" -#: ../../sphinx/doc/changes.rst:659 +#: ../../sphinx/doc/changes.rst:661 msgid "" "`#10468 `_: Drop Python " "3.6 support" msgstr "" -#: ../../sphinx/doc/changes.rst:660 +#: ../../sphinx/doc/changes.rst:662 msgid "" "`#10470 `_: Drop Python " "3.7, Docutils 0.14, Docutils 0.15, Docutils 0.16, and Docutils 0.17 support." " Patch by Adam Turner" msgstr "" -#: ../../sphinx/doc/changes.rst:666 +#: ../../sphinx/doc/changes.rst:668 msgid "" "`#7405 `_: Removed the " "jQuery and underscore.js JavaScript frameworks." msgstr "" -#: ../../sphinx/doc/changes.rst:668 +#: ../../sphinx/doc/changes.rst:670 msgid "" "These frameworks are no longer be automatically injected into themes from " "Sphinx 6.0. If you develop a theme or extension that uses the ``jQuery``, " @@ -1502,7 +1509,7 @@ msgid "" "modern standards, or use the mitigation below." msgstr "" -#: ../../sphinx/doc/changes.rst:673 +#: ../../sphinx/doc/changes.rst:675 msgid "" "The first option is to use the sphinxcontrib.jquery_ extension, which has " "been developed by the Sphinx team and contributors. To use this, add " @@ -1511,7 +1518,7 @@ msgid "" "theme or extension." msgstr "" -#: ../../sphinx/doc/changes.rst:679 +#: ../../sphinx/doc/changes.rst:681 msgid "" "The second option is to manually ensure that the frameworks are present. To " "re-add jQuery and underscore.js, you will need to copy ``jquery.js`` and " @@ -1519,11 +1526,11 @@ msgid "" "directory, and add the following to your ``layout.html``:" msgstr "" -#: ../../sphinx/doc/changes.rst:694 ../../sphinx/doc/changes.rst:985 +#: ../../sphinx/doc/changes.rst:696 ../../sphinx/doc/changes.rst:987 msgid "Patch by Adam Turner." msgstr "" -#: ../../sphinx/doc/changes.rst:695 +#: ../../sphinx/doc/changes.rst:697 msgid "" "`#10471 `_, `#10565 " "`_: Removed deprecated " @@ -1531,7 +1538,7 @@ msgid "" " details. Patch by Adam Turner." msgstr "" -#: ../../sphinx/doc/changes.rst:697 +#: ../../sphinx/doc/changes.rst:699 msgid "" "`#10901 `_: C Domain: " "Remove support for parsing pre-v3 style type directives and roles. Also " @@ -1539,7 +1546,7 @@ msgid "" "``c_warn_on_allowed_pre_v3``. Patch by Adam Turner." msgstr "" -#: ../../sphinx/doc/changes.rst:704 +#: ../../sphinx/doc/changes.rst:706 msgid "" "`#10924 `_: LaTeX: adopt " "better looking defaults for tables and code-blocks. See " @@ -1548,18 +1555,18 @@ msgid "" " how to re-enact them if desired." msgstr "" -#: ../../sphinx/doc/changes.rst:712 +#: ../../sphinx/doc/changes.rst:714 msgid "" "`#10984 `_: LaTeX: " "Document :confval:`latex_additional_files` behavior for files with ``.tex`` " "extension." msgstr "" -#: ../../sphinx/doc/changes.rst:716 +#: ../../sphinx/doc/changes.rst:718 msgid "Release 5.3.0 (released Oct 16, 2022)" msgstr "" -#: ../../sphinx/doc/changes.rst:718 +#: ../../sphinx/doc/changes.rst:720 msgid "" "`#10759 `_: LaTeX: add " ":confval:`latex_table_style` and support the ``'booktabs'``, " @@ -1569,7 +1576,7 @@ msgid "" "doc/sphinx/issues/6671>`_)" msgstr "" -#: ../../sphinx/doc/changes.rst:721 +#: ../../sphinx/doc/changes.rst:723 msgid "" "`#10840 `_: One can " "cross-reference including an option value like " @@ -1577,259 +1584,259 @@ msgid "" "``:option:`--module foobar```. Patch by Martin Liska." msgstr "" -#: ../../sphinx/doc/changes.rst:725 +#: ../../sphinx/doc/changes.rst:727 msgid "" "`#10881 `_: " "autosectionlabel: Record the generated section label to the debug log." msgstr "" -#: ../../sphinx/doc/changes.rst:726 +#: ../../sphinx/doc/changes.rst:728 msgid "" "`#10268 `_: Correctly " "URI-escape image filenames." msgstr "" -#: ../../sphinx/doc/changes.rst:727 +#: ../../sphinx/doc/changes.rst:729 msgid "" "`#10887 `_: domains: " "Allow sections in all the content of all object description directives (e.g." " :rst:dir:`py:function`). Patch by Adam Turner" msgstr "" -#: ../../sphinx/doc/changes.rst:731 +#: ../../sphinx/doc/changes.rst:733 msgid "Release 5.2.3 (released Sep 30, 2022)" msgstr "" -#: ../../sphinx/doc/changes.rst:733 +#: ../../sphinx/doc/changes.rst:735 msgid "" "`#10878 `_: Fix base64 " "image embedding in ``sphinx.ext.imgmath``" msgstr "" -#: ../../sphinx/doc/changes.rst:734 +#: ../../sphinx/doc/changes.rst:736 msgid "" "`#10886 `_: Add " "``:nocontentsentry:`` flag and global domain table of contents entry control" " option. Patch by Adam Turner" msgstr "" -#: ../../sphinx/doc/changes.rst:738 +#: ../../sphinx/doc/changes.rst:740 msgid "Release 5.2.2 (released Sep 27, 2022)" msgstr "" -#: ../../sphinx/doc/changes.rst:740 +#: ../../sphinx/doc/changes.rst:742 msgid "" "`#10872 `_: Restore link " "targets for autodoc modules to the top of content. Patch by Dominic Davis-" "Foster." msgstr "" -#: ../../sphinx/doc/changes.rst:744 +#: ../../sphinx/doc/changes.rst:746 msgid "Release 5.2.1 (released Sep 25, 2022)" msgstr "" -#: ../../sphinx/doc/changes.rst:749 +#: ../../sphinx/doc/changes.rst:751 msgid "" "`#10861 `_: Always " "normalise the ``pycon3`` lexer to ``pycon``." msgstr "" -#: ../../sphinx/doc/changes.rst:750 +#: ../../sphinx/doc/changes.rst:752 msgid "" "Fix using ``sphinx.ext.autosummary`` with modules containing titles in the " "module-level docstring." msgstr "" -#: ../../sphinx/doc/changes.rst:754 +#: ../../sphinx/doc/changes.rst:756 msgid "Release 5.2.0.post0 (released Sep 24, 2022)" msgstr "" -#: ../../sphinx/doc/changes.rst:756 +#: ../../sphinx/doc/changes.rst:758 msgid "Recreated source tarballs for Debian maintainers." msgstr "" -#: ../../sphinx/doc/changes.rst:759 +#: ../../sphinx/doc/changes.rst:761 msgid "Release 5.2.0 (released Sep 24, 2022)" msgstr "" -#: ../../sphinx/doc/changes.rst:764 +#: ../../sphinx/doc/changes.rst:766 msgid "" "`#10356 `_: Sphinx now " "uses declarative metadata with ``pyproject.toml`` to create packages, using " "PyPA's ``flit`` project as a build backend. Patch by Adam Turner." msgstr "" -#: ../../sphinx/doc/changes.rst:771 +#: ../../sphinx/doc/changes.rst:773 msgid "" "`#10843 `_: Support for " "HTML 4 output. Patch by Adam Turner." msgstr "" -#: ../../sphinx/doc/changes.rst:776 +#: ../../sphinx/doc/changes.rst:778 msgid "" "`#10738 `_: napoleon: Add" " support for docstring types using 'of', like ``type of type``. Example: " "``tuple of int``." msgstr "" -#: ../../sphinx/doc/changes.rst:778 +#: ../../sphinx/doc/changes.rst:780 msgid "" "`#10286 `_: C++, support " "requires clauses not just between the template parameter lists and the " "declaration." msgstr "" -#: ../../sphinx/doc/changes.rst:780 +#: ../../sphinx/doc/changes.rst:782 msgid "" "`#10755 `_: linkcheck: " "Check the source URL of raw directives that use the ``url`` option." msgstr "" -#: ../../sphinx/doc/changes.rst:782 +#: ../../sphinx/doc/changes.rst:784 msgid "" "`#10781 `_: Allow " ":rst:role:`ref` role to be used with definitions and fields." msgstr "" -#: ../../sphinx/doc/changes.rst:783 +#: ../../sphinx/doc/changes.rst:785 msgid "" "`#10717 `_: HTML Search: " "Increase priority for full title and subtitle matches in search results" msgstr "" -#: ../../sphinx/doc/changes.rst:785 +#: ../../sphinx/doc/changes.rst:787 msgid "" "`#10718 `_: HTML Search: " "Save search result score to the HTML element for debugging" msgstr "" -#: ../../sphinx/doc/changes.rst:786 +#: ../../sphinx/doc/changes.rst:788 msgid "" "`#10673 `_: Make toctree " "accept 'genindex', 'modindex' and 'search' docnames" msgstr "" -#: ../../sphinx/doc/changes.rst:787 +#: ../../sphinx/doc/changes.rst:789 msgid "" "`#6316 `_, `#10804 " "`_: Add domain objects to" " the table of contents. Patch by Adam Turner" msgstr "" -#: ../../sphinx/doc/changes.rst:788 +#: ../../sphinx/doc/changes.rst:790 msgid "" "`#6692 `_: HTML Search: " "Include explicit :rst:dir:`index` directive index entries in the search " "index and search results. Patch by Adam Turner" msgstr "" -#: ../../sphinx/doc/changes.rst:790 +#: ../../sphinx/doc/changes.rst:792 msgid "" "`#10816 `_: imgmath: " "Allow embedding images in HTML as base64" msgstr "" -#: ../../sphinx/doc/changes.rst:791 +#: ../../sphinx/doc/changes.rst:793 msgid "" "`#10854 `_: HTML Search: " "Use browser localstorage for highlight control, stop storing highlight " "parameters in URL query strings. Patch by Adam Turner." msgstr "" -#: ../../sphinx/doc/changes.rst:797 +#: ../../sphinx/doc/changes.rst:799 msgid "" "`#10723 `_: LaTeX: 5.1.0 " "has made the 'sphinxsetup' ``verbatimwithframe=false`` become without " "effect." msgstr "" -#: ../../sphinx/doc/changes.rst:799 +#: ../../sphinx/doc/changes.rst:801 msgid "" "`#10257 `_: C++, ensure " "consistent non-specialization template argument representation." msgstr "" -#: ../../sphinx/doc/changes.rst:801 +#: ../../sphinx/doc/changes.rst:803 msgid "" "`#10729 `_: C++, fix " "parsing of certain non-type template parameter packs." msgstr "" -#: ../../sphinx/doc/changes.rst:802 +#: ../../sphinx/doc/changes.rst:804 msgid "" "`#10715 `_: Revert " "`#10520 `_: \"Fix\" use " "of sidebar classes in ``agogo.css_t``" msgstr "" -#: ../../sphinx/doc/changes.rst:805 +#: ../../sphinx/doc/changes.rst:807 msgid "Release 5.1.1 (released Jul 26, 2022)" msgstr "" -#: ../../sphinx/doc/changes.rst:810 +#: ../../sphinx/doc/changes.rst:812 msgid "" "`#10701 `_: Fix " "ValueError in the new ``deque`` based ``sphinx.ext.napolean`` iterator " "implementation." msgstr "" -#: ../../sphinx/doc/changes.rst:812 +#: ../../sphinx/doc/changes.rst:814 msgid "" "`#10702 `_: Restore " "compatability with third-party builders." msgstr "" -#: ../../sphinx/doc/changes.rst:815 +#: ../../sphinx/doc/changes.rst:817 msgid "Release 5.1.0 (released Jul 24, 2022)" msgstr "" -#: ../../sphinx/doc/changes.rst:820 +#: ../../sphinx/doc/changes.rst:822 msgid "" "`#10656 `_: Support " "`Docutils 0.19`_. Patch by Adam Turner." msgstr "" -#: ../../sphinx/doc/changes.rst:827 +#: ../../sphinx/doc/changes.rst:829 msgid "" "`#10467 `_: Deprecated " "``sphinx.util.stemmer`` in favour of ``snowballstemmer``. Patch by Adam " "Turner." msgstr "" -#: ../../sphinx/doc/changes.rst:829 +#: ../../sphinx/doc/changes.rst:831 msgid "" "`#9856 `_: Deprecated " "``sphinx.ext.napoleon.iterators``." msgstr "" -#: ../../sphinx/doc/changes.rst:834 +#: ../../sphinx/doc/changes.rst:836 msgid "" "`#10444 `_: html theme: " "Allow specifying multiple CSS files through the ``stylesheet`` setting in " "``theme.conf`` or by setting ``html_style`` to an iterable of strings." msgstr "" -#: ../../sphinx/doc/changes.rst:836 +#: ../../sphinx/doc/changes.rst:838 msgid "" "`#10366 `_: std domain: " "Add support for emphasising placeholders in :rst:dir:`option` directives " "through a new :confval:`option_emphasise_placeholders` configuration option." msgstr "" -#: ../../sphinx/doc/changes.rst:839 +#: ../../sphinx/doc/changes.rst:841 msgid "" "`#10439 `_: std domain: " "Use the repr of some variables when displaying warnings, making whitespace " "issues easier to identify." msgstr "" -#: ../../sphinx/doc/changes.rst:841 +#: ../../sphinx/doc/changes.rst:843 msgid "" "`#10571 `_: quickstart: " "Reduce content in the generated ``conf.py`` file. Patch by Pradyun Gedam." msgstr "" -#: ../../sphinx/doc/changes.rst:843 +#: ../../sphinx/doc/changes.rst:845 msgid "" "`#10648 `_: LaTeX: CSS-" "named-alike additional :ref:`'sphinxsetup' ` keys allow to" @@ -1839,13 +1846,13 @@ msgid "" "directives." msgstr "" -#: ../../sphinx/doc/changes.rst:848 +#: ../../sphinx/doc/changes.rst:850 msgid "" "`#10655 `_: LaTeX: " "Explain non-standard encoding in LatinRules.xdy" msgstr "" -#: ../../sphinx/doc/changes.rst:849 +#: ../../sphinx/doc/changes.rst:851 msgid "" "`#10599 `_: HTML Theme: " "Wrap consecutive footnotes in an ``