`make latex` able to rebuild only what is needed, just as `make html`? · sphinx-doc/sphinx#13181

(9 留言) (0 反應) (0 負責人)Python (5,625 star) (1,985 fork)batch import

builder:latexhelp wantedtype:proposal

描述

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?

貢獻者指南

技術棧: python
領域: documentationperformance
議題類型: feature
難度: 4
預計時間: 3-5 days
活動狀態: active
清晰度: mostly clear
前置要求: PythonSphinxLaTeX (basic)
新手友善度: 25
研究方向: Investigate how the HTML builder generates output per source file and determine if a similar approach can be applied to the LaTeX builder. The main file would need to include smaller unit .tex files. Look at sphinx/builders/latex.py and sphinx/builders/html.py for reference. Check the existing discussion in the issue comments for any suggested approaches or blockers.