On Tuesday, 16 July 2013 21:04:19 UTC+5:30, Olaf wrote: > > Hi, > > We have documentation for hardware modules that is written in rst and > translated to HTML with sphinx. > > We are translating about ~300000 lines of rst. Which is not small but also > not absolutely huge: > olaf@pc:~/ee/doc$ find . -name '*.rst' | xargs wc -l > [...] > 335911 total > > You can take a look at the documentation here: > http://www.tinkerforge.com/en/doc/index.html > > The building process takes about 10 minutes if i don't change anything > after the last build (i.e. everything that can be cached should be cached): > olaf@pc:~/ee/doc$ time make html > [...] > real 10m27.748s > user 9m30.036s > sys 0m6.932s > > We will be adding lots of new hardware modules soon, which will double the > amount of documentation... > > Adding stuff to the documentation has become really painful since it takes > so long before one can review it. So the question is: How can we speed this > up? > > For us it would also be helpfull if we were able to only build a part of > the documentation. Is that somehow possible? > > Thanks! > Olaf >
Hi Olaf, I am worried about: ``The building process takes about 10 minutes if i don't change anything after the last build (i.e. everything that can be cached should be cached):`` I tried to reproduce similar behaviour with my biggest book (Bible, both old and new testaments, http://www.purnank.in/books/samples/theBibleOnNTsKJV/, Lines: 112178) and reproduced similar anomaly. Incremental builds are also take long time for me. I tried to dig deeper into the issue and found the culprit at my end. For me, Nested :numbered: directives always think that the files have changed during incremental builds. (contents of root.rst) .. toctree: :numbered: <<<<<<<<<<<<<<<<<<<<<<<<< culprit >>>>>>>>>>>>>>>>>>>>>>>>> old-testaments new-testaments (contents of old-testaments.rst) .. toctree: :numbered: :glob: old-testaments/* (contents of new-testaments.rst) .. toctree: :numbered: :glob: new-testaments/* If i change my root.rst like this. (:numbered: removed) (new contents of root.rst) .. toctree: old-testaments new-testaments The incremental builds finish within seconds. I hope your build time issue is due to a similar anomaly... OTOH: I have also found that a very big global rst-pre-include / post include has a strongly negative impact on overall build times. Try to include only necessary files in each individual document. -- Purnank -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/groups/opt_out.
