Hi Markus, Em Wed, 24 Aug 2016 17:36:13 +0200 Markus Heiser <markus.heiser@xxxxxxxxxxx> escreveu: > From: Markus Heiser <markus.heiser@xxxxxxxxxxx> > > Hi Mauro, > > here is a small patch series which extends the method to build only sub-folders > to the targets "latexdocs" and "pdfdocs". > > If you think, that the two first patches works for you, path them with your next > merge to Jon's doc-next. > > The last patch in this series is just for you. It is a small example to > illustrate how we can build small books and link them with intersphinx. Didn't actually review the patches (I'm about to take a short trip). Just tested the results of those 3 patches. It worked. However, I saw two issues there: 1) Now, the documentation, when using SPHINXDIRS=media is not output at the Documentation/output/latex anymore, but, instead it created a Documentation/output/media/latex and wrote the books there. 2) If built without SPHINXDIRS, it is producing just one document and storing it at Documentation/output. I would expect it to do the same on both cases. Btw, I'm planning to split the media documentation on 4 books even when building without SPHINXDIRS. There are two reasons for that: 1) the uAPI book has a different licence than the other books; 2) the uAPI book should be split into 5 parts, and each part should reset the chapter numberation to 1, in order to produce the same chapter numbering as the HTML book. >From what I saw, the control if LaTeX will use parts/chapter/section or just chapter section is controlled per conf.py file. It means that we'll need to have a separate conf.py for the uAPI book - or to have an Sphinx extension that would allow adjusting the LaTeX layout via some meta-tags at the book's index.rst. Regards, Mauro -- To unsubscribe from this list: send the line "unsubscribe linux-media" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
