You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I find it annoying that if we have past doc versions, all versions need to be rebuilt with the new theme... @szkarpinski I will have to peek how you did it for nvmath and other projects 😛
all versions need to be rebuilt with the new theme...
@leofang do they? We didn't do it for DALI or nvmath. For example see the DALI docs - when you choose version <=1.38 in the switcher, you just get redirected to the docs in the old RTD theme.
Yes, but it's poor UX, because the different themes look up the version json files in different places, and the file format requirements are different too. For example, if you switch to DALI 1.38 version (the last version using the old RTD theme), there's no way to select any newer versions through the version drop-down menu (except for picking main, we might argue). If we're OK with this then it is indeed straightforward as you said.
This repo has multiple places (cuda components) that have sphinx conf.py. Be sure to update all of them.
The nvidia-sphinx-theme is derived from the pydata-sphinx-theme, so when in doubt you can look up the latter's docs. (I don't think we have the nvidia theme's docs available in the public.)
Activity
leofang commentedon Nov 14, 2024
I find it annoying that if we have past doc versions, all versions need to be rebuilt with the new theme... @szkarpinski I will have to peek how you did it for nvmath and other projects 😛
szkarpinski commentedon Nov 14, 2024
@leofang do they? We didn't do it for DALI or nvmath. For example see the DALI docs - when you choose version <=1.38 in the switcher, you just get redirected to the docs in the old RTD theme.
leofang commentedon Nov 14, 2024
Yes, but it's poor UX, because the different themes look up the version json files in different places, and the file format requirements are different too. For example, if you switch to DALI 1.38 version (the last version using the old RTD theme), there's no way to select any newer versions through the version drop-down menu (except for picking
main, we might argue). If we're OK with this then it is indeed straightforward as you said.leofang commentedon Aug 21, 2025
@copilot please work on this: