sphinx-doc/sphinx

`make latex` able to rebuild only what is needed, just as `make html`?

Open

#13.181 aberto em 16 de dez. de 2024

Ver no GitHub
 (9 comments) (0 reactions) (0 assignees)Python (1.985 forks)batch import
builder:latexhelp wantedtype:proposal

Métricas do repositório

Stars
 (5.625 stars)
Métricas de merge de PR
 (Mesclagem média 13d 10h) (8 fundiu PRs em 30d)

Description

Is your feature request related to a problem? Please describe. I'm always frustrated when I have to recompile the whole PDF of my project, even though only one of its many source files has changed, whereas, for HTML output, only the corresponding HTML file is rebuilt.

Describe the solution you'd like It would be nice to have make latex as make html able to rebuild only what is needed. For this, make latex would have to copy the HTML builder but it looks needed then for its mechanism to produce in build repertory as many .tex files as there are source files. Hopefully it should be possible from one extra "main" file to "input" all the small "unit files". Is this possible?

Guia do colaborador

Direção de pesquisa
Investigue como o construtor HTML gera a saída por arquivo de origem e determine se uma abordagem similar pode ser aplicada ao construtor LaTeX. O arquivo principal precisaria incluir arquivos .tex de unidades menores. Consulte sphinx/builders/latex.py e sphinx/builders/html.py para referência. Verifique a discussão existente nos comentários da issue para quaisquer abordagens sugeridas ou bloqueadores.
Pilha de tecnologia
python
Domain
documentation
Tipo Issue
Funcionalidade
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
Meio dia
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Principalmente claro
Prerequisites
PythonSphinxLaTeX
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
50