This is one of the most impactful configuration options and shouldn't require user-provided templates just to change that to something else.
Describe the solution you'd like
Use alabaster as a default when rendering the template, but expose a command-line option (for e.g. sphinx-apidoc) or an interactive prompt for sphinx-quickstart to set the theme.
Describe alternatives you've considered
Expose a simpler, non-code configuration interface some other way. It seems like there's discussion about this in some other issues:
It's possible to use sphinx-apidoc and sphinx-build for a truly zero-configuration documentation-generation experience, except for being able to set the theme (in my case, sphinx_book_theme).
Is your feature request related to a problem? Please describe.
With sphinx-apidoc, it's possible to generate a
conf.py
with the -F, --full option.There are some command-line options for controlling data that is passed to the conf.py template.
It's not possible to change the theme because it's hard-coded in the template:
This is one of the most impactful configuration options and shouldn't require user-provided templates just to change that to something else.
Describe the solution you'd like
Use
alabaster
as a default when rendering the template, but expose a command-line option (for e.g.sphinx-apidoc
) or an interactive prompt forsphinx-quickstart
to set the theme.Describe alternatives you've considered
Expose a simpler, non-code configuration interface some other way. It seems like there's discussion about this in some other issues:
Additional context
Here is the template I use and how I'm invoking the command-line tools.
It's possible to use
sphinx-apidoc
andsphinx-build
for a truly zero-configuration documentation-generation experience, except for being able to set the theme (in my case,sphinx_book_theme
).