On Wednesday, 7 March 2012 09:39:46 UTC-5, Viktor Haag wrote: > > Your assignment just creates a set with a single value: > (['localtoc.html']), which Sphinx will deal with unpredictably. >
It helps to remember that conf.py is, in fact, executable Python code that gets "run" as part of the Sphinx program every time you build the docs. That is, you're not just writing in configuration values that Sphinx will read and parse and digest. You are writing bits of Python, assigning things to variables, writing functions, and so on, that become "part of" the Sphinx program when it runs. Thus, it helps enormously to have even just a bit of understanding about how the Python programming language works. I'm not sure if you're in that camp or not. If you're not, then I encourage you to seek out resources on the web that cover just the basics of Python. It really helped me a lot when I realized that (a) my conf.py was actually a Python module of sorts that was part of the "running program", and then (b) Hey! I could write Python code and put it in conf.py to do various things to help my docs builds! -- V. -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To view this discussion on the web visit https://groups.google.com/d/msg/sphinx-dev/-/6LkbG3OaR_0J. To post to this group, send email to sphinx-dev@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
