Infra: errors blocking migration towards docutils 0.22+
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 3/5
- Tempo estimado
- 1-2 dias
- Facilidade para iniciantes
- 55/100
- Tipo de issue
- Bug
- Clareza
- Razoavelmente clara
- Status de atividade
- Ativa
- Domínio
- build-system, documentation
Direção de pesquisa
Comece reproduzindo o build paralelo do Sphinx com Sphinx 9.1.0 e docutils 0.22.4 e, em seguida, inspecione os locais relatados em peps/pep-0554.rst, peps/pep-0683.rst, peps/pep-0426.rst, peps/pep-0653.rst, peps/pep-0827.rst, peps/pep-0697.rst e peps/pep-0791.rst. O trabalho estará concluído quando os erros e avisos listados do docutils não fizerem mais o build falhar de forma impeditiva, preservando o conteúdo dos PEPs.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
Following the work in #4087, I have decided to investigate possible issues with going further, towards docutils 0.22+. The following are extracts from the errors failing the build process (tested on Sphinx 9.1.0 and docutils 0.22.4). I have error logs with full tracebacks and more details available if needed.
Errors
peps/pep-0554.rst:29: (ERROR/3) Indirect hyperlink target (id="concurrency") refers to target "concurrency", which is a duplicate, and cannot be used as a unique reference.peps/pep-0683.rst:476: (ERROR/3) Indirect hyperlink target (id="documentation") refers to target "documentation", which is a duplicate, and cannot be used as a unique reference.peps/pep-0426.rst:748: (ERROR/3) Duplicate target name, cannot be used as a unique reference: "extras".peps/pep-0653.rst:722: (WARNING/2) Footnote content expected.peps/pep-0827.rst:1963: (WARNING/2) Footnote content expected.peps/pep-0697.rst:250: (ERROR/3) Indirect hyperlink target (id="reference-implementation") refers to target "reference implementation", which is a duplicate, and cannot be used as a unique reference.peps/pep-0791.rst:163: (ERROR/3) Indirect hyperlink target (id="id1") refers to target "motivation", which is a duplicate, and cannot be used as a unique reference.
All of those errors are coming from docutils, not from Sphinx, but they are hard-failing the parallel Sphinx builds.
CC @hugovk
EDIT: After investigation, only docutils is blocked. Sphinx 9 works fine.
- Linguagem predominante
- reStructuredText
- Estrelas
- 5k
- Forks
- 1.8k
- Merge médio
- 2d 4h
- PRs com merge (30d)
- 25
Guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de python/peps
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 65/100
-
New PEP Editors? Abertameta
Dificuldade 5/5 Mais de uma semana Facilidade para iniciantes 25/100
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 48/100
-
Mark 3.14 PEPs as Final Abertameta
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 35/100
Todas as issues de python/peps
Issues semelhantes
-
type/automation type/tech-debt
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
-
priority: p3
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
googleapis/librarian#7636 ·
-
Update gh-dash to 4.26.0 Abertapackage-update
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
oSoWoSo/vOid_Community_repOsitory#147 · 1 comentário ·
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 88/100
-
agentic-workflows cascade-suspected
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 88/100