Sphinx 6.2

Versão 6.2.1 (lançada em 25 abr 2023)

Erros corrigidos

Versão 6.2.0 (lançada em 23 abr 2023)

Dependências

  • Requer Docutils 0.18.1 ou posterior.

Atualizações incompatíveis

  • LaTeX: remoção de alguns registros internos \dimen do TeX (não documentados anteriormente publicamente) conforme comentários do código 5.1.0 em sphinx.sty: \sphinxverbatimsep, \sphinxverbatimborder, \sphinxshadowsep, \sphinxshadowsize e \sphinxshadowrule. (refs: #11105)

  • Remove suporte a .egg do pycode ModuleAnalyser; eggs do Python são agora um formato descontinuado de distribuição binário.

  • #11089: Remove código descontinuado em sphinx.builders.linkcheck. Patch de Daniel Eades

  • Remove o sphinx.locale.setlocale interno

Descontinuada

  • #11247: Descontinua o formato legado intersphinx_mapping

  • sphinx.util.osutil.cd foi descontinuado em favor de contextlib.chdir.

Funcionalidades adicionadas

  • #11277: autoproperty permite que o tipo de retorno seja especificado como um comentário de tipo (por exemplo, # type: () -> int). Patch de Bénédikt Tran

  • #10811: Autosummary: estende __all__ para membros importados para renderização de modelo quando a opção autosummary_ignore_module_all estiver definida como False. Patch de Clement Pinard

  • #11147: Adiciona um parâmetro content_offset a nested_parse_with_titles(), permitindo números de linha corretos durante a análise aninhada. Patch de Jeremy Maitin-Shepard

  • Atualização para Unicode CLDR 42

  • Adiciona um sinônimo --jobs para -j. Patch de Hugo van Kemenade

  • LaTeX: um comando \sphinxbox para estilizar elementos de texto com uma caixa (possivelmente arredondada), cor de fundo opcional e sombra, foi adicionado. Veja The \sphinxbox command. (refs: #11224)

  • LaTeX: adiciona \sphinxstylenotetitle, …, \sphinxstylewarningtitle, …, para uma camada extra de marcação, liberando \sphinxstrong para outros usos. Veja Macros. (refs: #11267)

  • LaTeX: note, hint, important e tip agora cada um pode ser estilizado como as outras advertências, ou seja, possivelmente com uma cor de fundo, larguras de borda e preenchimentos individuais, possivelmente cantos arredondados e sombra opcional. Veja Chaves adicionais de 'sphinxsetup' no estilo CSS. (refs: #11234)

  • LaTeX: admonições e diretivas topic (e contents), e não apenas code-block, dão suporte a box-decoration-break=slice.

  • LaTeX: permite que caixas arredondadas suportem até 4 larguras de borda distintas (refs: #11243)

  • LaTeX: novas opções noteTextColor, noteTeXextras e outras. Veja Chaves adicionais de 'sphinxsetup' no estilo CSS.

  • LaTeX: suporte a cantos elípticos em caixas arredondadas. (refs: #11254)

  • #11150: Inclui o local da fonte em avisos de realce, quando a lexagem falhar. Patch de Jeremy Maitin-Shepard

  • #11281: Suporte a imgmath_latex = 'tectonic' ou = 'xelatex'. Patch de Dimitar Dimitrov

  • #11109, #9643: Adiciona a opção python_display_short_literal_types para renderização condensada de tipos Literal.

Erros corrigidos

  • #11079: LaTeX: figuras com atributo align podem desaparecer e impactar estranhamente as listas seguintes

  • #11093: LaTeX: corrige avisos de construção de PDF “multiply-defined references” quando um ou mais rótulos de reST precedem diretamente uma diretiva py:module ou automodule. Patch de Bénédikt Tran (picnixz)

  • #11110: LaTeX: Figuras desaparecem do PDF do LaTeX se seus arquivos tiverem o mesmo nome base e usarem uma transformação de post. Patch de Aaron-Cooper

  • LaTeX: corrige vazamento potencial de cor da sombra para a borda de caixas arredondadas, se a cor da sombra estiver definida, mas a cor da borda não estiver

  • LaTeX: corrige deslocamento vertical não intencional de 1pt para cima dos quadros de blocos de código em relação ao conteúdo (ao usar cantos arredondados)

  • #11235: LaTeX: adicionado \color no conteúdo do tópico (ou advertência) pode causar vazamento de cor na sombra e na borda em uma quebra de página

  • #11264: LaTeX: faltando espaço antes dos dois pontos após “Voir aussi” para a diretiva seealso em francês

  • #11268: LaTeX: longtable com alinhamento à esquerda sai do contexto de recuo da lista atual em PDF. Graças a picnixz.

  • #11274: LaTeX: links externos não são escapados corretamente para compatibilidade com \sphinxupquote

  • #11147: Corrige informações de número de linha/arquivo fonte no conteúdo da descrição do objeto e em outros usos de nested_parse_with_titles. Patch de Jeremy Maitin-Shepard.

  • #11192: Restaura a construção correta do índice de pesquisa paralela. Patch de Jeremy Maitin-Shepard

  • Usa o novo cliente Transifex tx

Testes

  • Falha no teste quando quaisquer avisos do Python são emitidos

  • Migra as funções de teste restantes no estilo unittest.TestCase para o estilo pytest

  • Remove os testes que dependem de setuptools