Hi all, We just released 1.8.0b1. It includes much of improvements. And we believe it will help you. In detail, please see CHANGES: https://github.com/sphinx-doc/sphinx/blob/1.8.0b1/CHANGES You can use it with: pip install --pre Sphinx Since this is a beta release, we expect that you may encounter bugs. If you find a bug, please report it on github issues: https://github.com/sphinx-doc/sphinx/issues Thanks, Takeshi KOMIYA