Sphinx 7.1

Versão 7.1.2 (lançada em 02 ago 2023)

Erros corrigidos

  • #11542: linkcheck: Respeita adequadamente linkcheck_anchors e não relata falsamente falhas na validação de âncoras. Patch de James Addison.

Versão 7.1.1 (lançada em 27 jul 2023)

Erros corrigidos

  • #11514: Corrige SOURCE_DATE_EPOCH no rodapé de direitos autorais com várias linhas. Patch de Bénédikt Tran.

Versão 7.1.0 (lançada em 24 jul 2023)

Atualizações incompatíveis

Descontinuada

  • #11412: Emite avisos ao usar um tipo de entrada de índice específico do Python descontinuado (ou seja, module, keyword, operator, object, exception, statement e builtin) na diretiva index e define a versão de remoção como Sphinx 9. Patch de Adam Turner.

Funcionalidades adicionadas

  • #11415: Adiciona uma soma de verificação aos URIs de ativos JavaScript e CSS incluídos no HTML gerado, usando o algoritmo CRC32.

  • require_sphinx() agora permite que o requisito da versão seja especificado como (major, minor).

  • #11011: Permite configurar um limite de comprimento de linha para assinaturas de objetos, via maximum_signature_line_length e as variantes específicas do domínio. Se o comprimento da assinatura (em caracteres) for maior que o limite configurado, cada parâmetro da assinatura será dividido em sua própria linha lógica. Este comportamento também pode ser controlado por opções nas diretivas de descrição de objetos, por exemplo py:function:single-line-parameter-list. Patch de Thomas Louf, Adam Turner e Jean-François B.

  • #10983: Suporte para declarações de direitos autorais de várias linhas no bloco de rodapé. Patch de Stefanie Molin

  • sphinx.util.display.status_iterator agora limpa a linha atual com códigos de controle ANSI, em vez de imprimir vários caracteres de espaço.

  • #11431: linkcheck: Trata as falhas de SSL como links quebrados. Patch de James Addison.

  • #11157: Mantém o atributo translated nos nós traduzidos.

  • #11451: Melhora o traceback exibido ao usar sphinx-build -T em construções paralelas. Patch de Bénédikt Tran

  • #11324: linkcheck: Usa solicitações HTTP baseadas em sessão.

  • #11438: Adiciona suporte para as diretivas py:class e py:function da PEP 695 (classes genéricas e declarações de funções) e PEP 696 (parâmetros de tipo padrão). O suporte multilinha (#11011) está habilitado para lista de parâmetros de tipo e pode ser controlado localmente em diretivas de descrição de objeto, por exemplo, py:function:single-line-type-parameter-list. Patch de Bénédikt Tran.

  • #11484: linkcheck: Permite que as âncoras HTML sejam ignoradas por URL via linkcheck_anchors_ignore_for_url enquanto ainda verifica a validade da própria página. Patch de Bénédikt Tran

  • #1246: Adiciona estatísticas de progresso de tradução e suporte a inspeção, através de uma nova substituição (|translation progress|) e uma nova variável de configuração (translation_progress_classes). Estes permitem determinar a percentagem de elementos traduzidos dentro de um documento e os restantes elementos traduzidos e não traduzidos.

Erros corrigidos

  • Restaurada a classe footnote-reference que foi removida na versão mais recente (não lançada) do Docutils.

  • #11486: Usa tipos MIME de arquivo de fonte RFC 8081 no construtor EPUB. Usar o tipo MIME correto evitará avisos do epubcheck e gerará um EPUB válido.

  • #11435: Usa registros de data e hora com resolução de microssegundos para detecção de arquivos desatualizados em BuildEnvironment.get_outdated_files.

  • #11437: Títulos de nível superior começando com um papel reStructuredText agora são renderizados corretamente quando rst_prolog é definido. Anteriormente, um arquivo começando com o seguinte seria renderizado incorretamente devido ao local onde o texto do prólogo foi inserido no documento.

    :mod:`lobster` -- The lobster module
====================================

...

    Patch de Bénédikt Tran.

  • #11337: Corrige um MemoryError em sphinx.ext.intersphinx ao usar None ou typing.* como referências de tipo inline. Patch de Bénédikt Tran (picnixz)

Testes

  • #11345: Sempre exclui docutils.conf nos diretórios de teste ao executar SphinxTestApp.cleanup().