sphinx

sphinx copied to clipboard

Improve Internationalization doc

1

### Feature or Bugfix - Refactoring ### Purpose Fix and update information ins this page. ### Detail - Documentation needs to mention the new Transifex CLI tool instead of the...

rffontenelle

Cross-reference take most of time when building large package with a probable bug in make_xref

8

### Describe the bug Building large packages takes a lot of time, most of which is cost on resolving cross-references. When building a package of 70MB and 3399 files ([azure-mgmt-containerservice](https://pypi.org/project/azure-mgmt-containerservice/)),...

junshi356

Internationalization doc mentions deprecated transifex-client

1

### Describe the bug In the [Internationalization](https://www.sphinx-doc.org/en/master/usage/advanced/intl.html) page, the [Using Transifex service for team translation](https://www.sphinx-doc.org/en/master/usage/advanced/intl.html#using-transifex-service-for-team-translation) section tells to use the Python-based transifex-client, however it is deprecated. Quoting the info on...

rffontenelle

Intersphinx lookups: log warnings for ambiguous target definitions and resolutions.

11

### Feature or Bugfix - Refactoring ### Purpose - Add a warning when intersphinx target resolution is ambiguous due to case-insensitivity. - Expands on some [discussion](https://github.com/sphinx-doc/sphinx/pull/12009#discussion_r1504731030) from pull request #12009....

jayaddison

`:loading: embed` on images does not work as expected

7

### Describe the bug Sphinx refers to docutils for all `reST` behaviour (except where it extends it), so I would expect that `:loading: embed` would work as documented by docutils...

Johnnynator

toctree, use document nesting instead of domain nesting when adding domain objects

1

### Feature or Bugfix - Bugfix ### Purpose When ``toc_object_entries = True`` the nesting of the objects in the toctree seems to done based on the scoping rules of the...

jakobandersen

Implement parts (of book)

19

Hi, I have an website/ebook I'm working on with parts, e.g.: **Part I: Basics** 1. Ch. One 2. Ch. Two **Part II: Intermediate** 3. Ch. Three 4. Ch. Four **Part...

mixmastamyk

Translated parsed-literals are incorrectly rendered

12

### Describe the bug When adding `'literal-block'` to [`gettext_additional_targets` option](https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-gettext_additional_targets), parsed-literals are allowed to be translated. However, when they are translated, they are incorrectly rendered. I noticed this while working...

n-peugnet

Rename template files in Sphinx to use preferred ``.jinja`` suffix.

3

### Feature or Bugfix - Refactoring ### Purpose - Use the more transparent (as in: easier and less ambiguous to understand) `.jinja` suffix for templated files within the Sphinx code...

jayaddison

The primary use case here is for within directives (also to a lesser extent roles). Context: To be fair to docutils, it never actually exposes directives as an extension point...

chrisjsewell