Sphinx 8.1

Versão 8.1.3 (lançada em 13 out 2024)

Erros corrigidos

  • #13013: Restaura o suporte para cut_lines() com nenhum tipo de objeto. Patch de Adam Turner.

Versão 8.1.2 (lançada em 12 out 2024)

Erros corrigidos

  • #13012: Expõe sphinx.errors.ExtensionError em sphinx.util para compatibilidade com versões anteriores. Isso será removido no Sphinx 9, pois expor a exceção em sphinx.util nunca foi intencional. ExtensionError faz parte de sphinx.errors desde o Sphinx 0.9. Patch de Adam Turner.

Versão 8.1.1 (lançada em 11 out 2024)

Erros corrigidos

  • #13006: Usa a URL https://www.cve.org/ preferida para o papel :cve:. Patch de Hugo van Kemenade.

  • #13007: LaTeX: Melhora a resiliência quando os pacotes necessários fontawesome ou fontawesome5 não estiverem instalados. Patch de Jean-François B.

Versão 8.1.0 (lançada em 10 out 2024)

Dependências

  • #12756: Adiciona limites mínimos às dependências sphinxcontrib-*. Patch de Adam Turner.

  • #12833: Atualiza o pacote LaTeX parskip de 2001 para 2018. Patch de Jean-François B.

Atualizações incompatíveis

  • #12763: Remove classe interna não utilizada sphinx.util.Tee. Patch de Adam Turner.

  • #12822: LaTeX: para mecanismos Unicode, o padrão 'fvset' é alterado para '\\fvset{fontsize=auto}' de '\\fvset{fontsize=\\small}'. Os blocos de código não foram alterados, pois o FreeMono agora é carregado com Scale=0.9. Um ajuste em projetos existentes é necessário somente se eles usaram uma configuração 'fontpkg' personalizada e não definiram 'fvset'. Patch de Jean-François B.

  • #12875: Desabilita aspas inteligentes por idiomas: zh_CN e zh_TW por padrão. Patch de A. Rafey Khan.

Descontinuada

  • #12762: Descontinua sphinx.util.import_object. Em vez disso, usa importlib.import_module(). Patch de Adam Turner.

  • #12766: Descontinua sphinx.util.FilenameUniqDict e sphinx.util.DownloadFiles. Patch de Adam Turner.

Funcionalidades adicionadas

  • #11328: Menciona a avaliação de conteúdo modelado durante a produção de arquivos de saída estáticos. Patch de James Addison.

  • #12704: LaTeX: torna as diretivas contents, topic e sidebar separadamente personalizáveis ​​para saída em PDF. Patch de Jean-François B. e Bénédikt Tran.

  • #12474: Suporte a realce de resultados de pesquisa dependentes de tipo via CSS. Patch de Tim Hoffmann.

  • #12652: LaTeX: Adiciona suporte a math_numsep ao construtor latex. Patch de Thomas Fanning e Jean-François B.

  • #12743: Não é mais encerrado no primeiro aviso quando --fail-on-warning é usado. Em vez disso, sai com um status diferente de zero se algum aviso foi gerado durante a construção. Patch de Adam Turner.

  • #12743: Adiciona sphinx-build --exception-on-warning, para levantar uma exceção quando avisos são emitidos durante a construção. Patch de Adam Turner e Jeremy Maitin-Shepard.

  • #12907: Adiciona html_last_updated_use_utc para permitir usar horário universal (GMT/UTC) em vez de horário local para a data e hora fornecida para html_last_updated_fmt. Patch de Adam Turner.

  • #12910: As entradas de direitos autorais agora oferecem suporte ao espaço reservado '%Y' para substituir o ano atual. Isso é útil para reduzir a dependência de módulos Python como time ou datetime em conf.py. Veja a documentação para mais detalhes. Patch de Adam Turner.

  • #11781: Adiciona papéis para referenciar CVEs (:cve:) e CWEs (:cwe:). Patch de Hugo van Kemenade.

  • #11809: Melhora a formatação para âncoras de seção RFC. Patch de Jakub Stasiak e Adam Turner.

  • #12852: Suporte a um atributo Builder.supported_linkcode para construtores para habilitar o uso de referências geradas por sphinx.ext.linkcode. Patch de James Knight.

  • #12949: Imprime opções de configuração que diferem do ambiente serializado com picke. Isso pode ser útil para diagnosticar a causa de uma reconstrução completa. Patch de Adam Turner.

Erros corrigidos

  • #12514: intersphinx: corrige o significado de um valor negativo para intersphinx_cache_limit. Patch de Shengyu Zhang.

  • #12722: LaTeX: evita o TeX relatando Overfull \hbox de strings muito longas em uma linha de código quando o problema foi realmente resolvido graças a verbatimforcewraps. Patch de Jean-François B.

  • #12730: A transformação UnreferencedFootnotesDetector foi melhorada para detectar de forma mais consistente notas de rodapé não referenciadas. Observe que a prioridade da transformação foi alterada de 200 para 622, de modo que agora ela é executada após a transformação de resolução de Footnotes do docutils. Patch de Chris Sewell.

  • #12778: LaTeX: deixa a chave div.topic_box-shadow de ‘sphinxsetup’, se usada com apenas uma dimensão, definir tanto x-offset quanto y-offset, conforme documentação. Patch de Jean-François B.

  • #12587: Não avisa quando ambiguidade potencial detectada durante a resolução do Intersphinx ocorre devido a alvos duplicados que diferem sem distinção entre maiúsculas e minúsculas. Patch de James Addison.

  • #12639: Corrige texto em singular e plural de resultados de pesquisa. Patch de Hugo van Kemenade.

  • #12645: Suporte correto a modelos de saída gettext personalizados. Patch de Jeremy Bowman.

  • #12717: LaTeX: deixa a opção -q (silenciosa) para sphinx-build -M latexpdf ou make latexpdf (O=-q) ser passada para latexmk. Deixa -Q (silenciosa) aplicar-se também à fase de construção do PDF. Patch de Jean-François B.

  • #12744: LaTeX: Classes injetadas por uma função de texto interpretada personalizada agora dão origem a \DUrole aninhados, em vez de um único com classes separadas por vírgula. Patch de Jean-François B.

  • #12831: LaTeX: evita grandes vazios que às vezes ocorrem no rodapé das páginas. Patch de Jean-François B.

  • #11970, #12551: construtor singlehtml: faz com que os URIs de alvos sejam referências do mesmo documento no sentido do RFC 3986, §4.4, por exemplo, index.html#foo se torna #foo. (observação: continuação de uma correção parcial adicionada no Sphinx 7.3.0) Patch de James Addison (com referência ao trabalho anterior de Eric Norige).

  • #12735: Corrige formatação de saída LaTeX de classes genéricas PEP 695. Patch de Jean-François B. e Bénédikt Tran.

  • #12782: intersphinx: corrige barras duplas ao gerar a URL do arquivo de inventário (as URLs base definidas pelo usuário de um projeto intersphinx são deixadas intocadas mesmo se terminarem com barras duplas). Patch de Bénédikt Tran.

  • #12796: Habilita a leitura paralela se solicitado, mesmo se houver menos de 6 documentos. Patch de Matthias Geier.

  • #12844: Restaura o suporte a :noindex: para as diretivas js:module e py:module. Patch de Stephen Finucane.

  • #12916: Restaura o suporte para modelos personalizados nomeados com o sufixo legado _t durante a renderização RST apidoc (regressão em 7.4.0). Patch de James Addison.

  • #12451: Substitui apenas anos de avisos de direitos autorais por valores de SOURCE_DATE_EPOCH para entradas que correspondem ao ano do relógio do sistema atual e não permita a substituição de anos futuros. Patch de James Addison e Adam Turner.

  • #12905: intersphinx: corrige o uso invertido de intersphinx_cache_limit, que sempre mantinha o cache para valores positivos e sempre o atualizava para valores negativos. Patch de Nico Madysa.

  • #12888: Adiciona um aviso quando o documento for incluído em vários toctrees e garanta a resolução determinística do toctree global em construções paralelas escolhendo o documento pai lexicograficamente maior. Patch de A. Rafey Khan

  • #12995: Melhora significativamente o desempenho ao construir o índice de pesquisa para idiomas chineses. Patch de Adam Turner.

  • #12767: Builder.write() é tipado como final, significando que o evento write-started pode ser confiável para extensões. Um novo método Builder.write_documents() foi adicionado para controlar como os documentos são escritos. Isso é destinado a construtores que não produzem um arquivo para cada documento. Patch de Adam Turner.

Testes

  • #12141: Migra do framework de teste JavaScript descontinuado karma para o framework jasmine mantido ativamente. A cobertura de teste não é afetada. Patch de James Addison.