sphinx-doc/sphinx

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

Open

#13 181 ouverte le 16 déc. 2024

Voir sur GitHub
 (9 commentaires) (0 réactions) (0 assignés)Python (1 985 forks)batch import
builder:latexhelp wantedtype:proposal

Métriques du dépôt

Stars
 (5 625 stars)
Métriques de merge PR
 (Merge moyen 13j 10h) (8 PRs mergées en 30 j)

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?

Guide contributeur

Direction de recherche
Étudiez comment le constructeur HTML génère la sortie par fichier source et déterminez si une approche similaire peut être appliquée au constructeur LaTeX. Le fichier principal devra inclure des fichiers .tex d'unités plus petites. Consultez sphinx/builders/latex.py et sphinx/builders/html.py pour référence. Vérifiez la discussion existante dans les commentaires de l'issue pour toute approche suggérée ou blocage.
Stack technique
python
Domaine
documentation
Type d'issue
Fonctionnalité
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
Une demi journée
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Plutôt claire
Prérequis
PythonSphinxLaTeX
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
50