Sphinx 7.4

Versão 7.4.7 (lançada em 20 jul 2024)

Erros corrigidos

  • #12096: Avisa quando os arquivos são sobrescritos no diretório de construção. Patch de Adam Turner e Bénédikt Tran.

  • #12620: Certifica-se de que as opções de descrição do objeto no estilo antigo sejam respeitadas. Patch de Adam Turner.

  • #12601, #12625: Suporte a objetos chamáveis em metadados do tipo Annotated no domínio Python. Patch de Adam Turner.

  • #12601, #12622: Resolve avisos Annotated com sphinx.ext.autodoc, especialmente ao usar dataclasses como metadados de tipo. Patch de Adam Turner.

  • #12589, #12626: autosummary: Corrige avisos com autolink. Patch de Adam Turner.

Versão 7.4.6 (lançada em 18 jul 2024)

Erros corrigidos

  • #12589, #9743, #12609: autosummary: Não adiciona o prefixo do pacote ao gerar diretivas de autosummary para módulos dentro de um pacote. Patch de Adam Turner.

  • #12613: Reduz a gravidade do log para detecção de ambiguidade durante o carregamento do inventário. Patch de James Addison.

Versão 7.4.5 (lançada em 16 jul 2024)

Erros corrigidos

  • #12593, #12600: Reverte a coerção do tipo de valores html_sidebars selecionados para uma lista. Registra uma mensagem de erro quando valores de string forem detectados. Patch de Adam Turner.

  • #12594: LaTeX: desde 7.4.0, seealso e outras admonições “leves” agora quebram construções de PDF se contiverem uma diretiva figure; e também se estiverem contidos em uma célula de tabela (renderizada por tabulary). Patch de Jean-François B.

Versão 7.4.4 (lançada em 15 jul 2024)

Erros corrigidos

  • #12585, #12586: Não avisa quando um inventário intersphinx contém itens duplicados ambíguos e que não diferenciam maiúsculas de minúsculas. Patch de James Addison.

Versão 7.4.3 (lançada em 15 jul 2024)

Erros corrigidos

  • #12582: Restaura o suporte para valores source_suffix em estilo de lista com extensões que registram analisadores. Patch de Adam Turner.

Versão 7.4.2 (lançada em 15 jul 2024)

Erros corrigidos

  • #12580, #12583: Resolve falhas com o domínio C em construções incrementais com o Sphinx 7.3.7 e versões anteriores. Patch de Adam Turner.

Versão 7.4.1 (lançada em 15 jul 2024)

Erros corrigidos

  • Corrige HTML inválido quando um nó de rubric com heading-level inválido é usado. Patch de Adam Turner.

  • #12579, #12581: Restaura o suporte para typing.ParamSpec no autodoc. Patch de Adam Turner.

Versão 7.4.0 (lançada em 15 jul 2024)

Dependências

  • #12555: Descarta o suporte para Docutils 0.18.1 e Docutils 0.19. Patch de Adam Turner.

  • LaTeX: o pacote xcolor agora é necessário (mas é, por exemplo, parte do Ubuntu texlive-latex-recommended que sempre foi necessário).

  • LaTeX: o pacote LaTeX fontawesome5 é necessário para as escolhas padrão de ícones agora usados ​​em títulos de admonição na saída de PDF; mas se não estiver disponível, a construção de PDF simplesmente omitirá silenciosamente a renderização de tais ícones. Confira a documentação da chave iconpackage de ‘sphinxsetup’ para mais informações.

Descontinuada

  • LaTeX: o ambiente sphinxlightbox não é mais usado, todos os tipos de admonições usam (por padrão) apenas sphinxheavybox.

Funcionalidades adicionadas

  • #11165: Suporte a .jinja officially recommended para arquivos de modelo. Patch de James Addison e Adam Turner

  • #12325: Achata Union[Literal[T], Literal[U], ...] para Literal[T, U, ...] ao transformar anotações em strings. Patch de Adam Turner.

  • #12319: sphinx.ext.extlinks: Adiciona a classe CSS extlink-{name} aos links. Patch de Hugo van Kemenade.

  • #12387: Melhora a mensagem de progresso da CLI ao copiar ativos. Patch de INADA Nakoi e Bénédikt Tran.

  • #12361: Adiciona BuildEnvironment.parser. Patch de Chris Sewell.

  • #12358: Adiciona Sphinx.fresh_env_used. Patch de Chris Sewell.

  • #12329: Adiciona detecção de referências ambíguas std:label e std:term durante o carregamento e resolução de alvos de intersphinx. Patch de James Addison.

  • #12422: Não duplica “navegação” no rótulo aria de temas embutidos. Patch de Thomas Weißschuh

  • #12421: Inclui o nome do projeto em logo_alt dos temas embutidos. Patch de Thomas Weißschuh

  • #12448: Adiciona a opção sphinx-apidoc --remove-old. Patch de Chris Sewell.

  • #12456: Adiciona a opção sphinx-autogen --remove-old. Patch de Chris Sewell.

  • #12479: Adiciona o subtipo de aviso toc.no_title. Patch de Ondřej Navrátil.

  • #12492: Adiciona métodos auxiliares para analisar o conteúdo reStructuredText em nós de dentro de uma diretiva.

    Patch de Adam Turner.

  • #12258: Suporte a typing_extensions.Unpack Patch de Bénédikt Tran e Adam Turner.

  • #12524: Adiciona uma opção class à diretiva toctree. Patch de Tim Hoffmann.

  • #12536: Adiciona a diretiva confval. Patch de Adam Turner.

  • #12537: c_id_attributes, c_paren_attributes, cpp_id_attributes e cpp_paren_attributes agora podem ser uma tupla de strings. c_extra_keywords, gettext_additional_targets, html_domain_indices, latex_domain_indices e texinfo_domain_indices agora podem ser um conjunto de strings. Patch de Adam Turner.

  • #12523: Adicionada opção de configuração, math_numsep, para definir o separador para numeração matemática. Patch de Thomas Fanning

  • #11592: Adiciona coverage_modules ao construtor de cobertura para permitir especificar explicitamente quais módulos devem ser documentados. Patch de Stephen Finucane.

  • #7896, #11989: Adiciona uma diretiva py:type para documentar apelidos de tipo e um papel py:type para vincular a eles. Patch de Ashley Whetter.

  • #12549: Adiciona o argumento opcional description a Sphinx.add_config_value(). Patch de Chris Sewell.

  • #6792: Proíbe ciclos de importação de módulos em sphinx.ext.autosummary. Patch de Trevor Bekolay.

  • #12508: LaTeX: Renovado o estilo de todas as admoniçẽos, com adição de uma linha de título com ícone. Patch de Jean-François B.

  • #11773: Exibe anotações Annotated com seus metadados no domínio Python. Patch de Adam Turner e David Stansby.

  • #12506: Adiciona a opção heading-level à diretiva rubric. Patch de Chris Sewell.

  • #12567: Adiciona o evento write-started. Patch de Chris Sewell.

Erros corrigidos

  • #12314: Formata corretamente collections.abc.Callable nas anotações. Patch de Adam Turner.

  • #12162: Correção de uma regressão de desempenho no domínio C que está presente desde a versão 3.0.0. Patch de Donald Hunter.

  • #12320: Corrige a remoção de âncoras dos resumos de pesquisa (regressão em 7.3.0). Patch de Will Lachance.

  • #12251: Corrige merge_domaindata() em sphinx.ext.duration. Patch de Matthias Geier.

  • #12224: Detecta arquivos WebP corretamente. Patch de Benjamin Cabé.

  • #12380: LaTeX: Evita marcadores de nota de rodapé Page N quando N já for o número da página atual. Patch de Jean-François B.

  • #12410: LaTeX: para francês e 'lualatex' como latex_engine, usa babel como com 'xelatex' (e não polyglossia). Patch de Jean-François B.

  • #8807, #12520: LaTeX: deixa todolist produzir hiperlinks corretos em PDF. Patch de Jean-François B.

  • #12416: Certifica-se de que os apelidos das definições de configuração estejam sempre sincronizados quando um valor ou outro for modificado. Patch de Bénédikt Tran.

  • #12220: Corrige o carregamento de traduções de modelos personalizados para a localidade en. Patch de Nicolas Peugnet.

  • #12459: Adiciona argumentos de tipo válido à configuração linkcheck_rate_limit_timeout. Patch de James Addison.

  • #12331: Resolve a regressão de extração de imagem de URI de dados da v7.3.0 que afeta construtores sem suporte nativo para URIs de dados em seu formato de saída. Patch de James Addison.

  • #12494: Corrige o arquivo genindex.html inválido produzido com documentos traduzidos (regressão em 7.1.0). Patch de Nicolas Peugnet.

  • #11961: Omite referências âncoras das entradas de títulos de documentos no índice de pesquisa, removendo a duplicação dos resultados da pesquisa. Patch de James Addison.

  • #12425: Usa o processamento SVG do Docutils no construtor HTML e remove a lógica personalizada do Sphinx. Patch de Tunç Başar Köse.

  • #12391: Ajusta a pontuação das correspondências durante a pesquisa HTML para que os títulos principais dos documentos tendam a ter uma classificação mais elevada do que os títulos das subseções. Além disso, aumenta as correspondências no nome dos objetos de domínio de programação em relação às correspondências de título/subtítulo. Patch de James Addison e Will Lachance.

  • #9634: Não adiciona um idioma substituto retirando o código do país. Patch de Alvin Wong.

  • #12352: Adiciona objetos de domínio ao índice na mesma ordem definida no documento. Anteriormente, cada domínio usava regras de aninhamento específicas do idioma, o que removia o controle dos autores dos documentos. Patch de Jakob Lykke Andersen e Adam Turner.

  • #11041: linkcheck: Ignora URLs que respondem com conteúdo não Unicode. Patch de James Addison.

  • #12543: Corrige a formatação da PEP 695 para saída LaTeX. Patch de Bénédikt Tran.

Testes

  • karma: refatora testes de pesquisa HTML para usar fixtures gerados pelo Sphinx. Patch de James Addison.