-
Notifications
You must be signed in to change notification settings - Fork 5.8k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[docs] sphinx design 1/n #34625
[docs] sphinx design 1/n #34625
Conversation
Signed-off-by: Max Pumperla <[email protected]>
Signed-off-by: Max Pumperla <[email protected]>
Signed-off-by: Max Pumperla <[email protected]>
Signed-off-by: Max Pumperla <[email protected]>
Signed-off-by: Max Pumperla <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Excited!!
Signed-off-by: Max Pumperla <[email protected]>
@@ -308,7 +308,7 @@ build_sphinx_docs() { | |||
if [ "${OSTYPE}" = msys ]; then | |||
echo "WARNING: Documentation not built on Windows due to currently-unresolved issues" | |||
else | |||
FAST=True make html | |||
FAST=True make develop |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
this is slightly risky, will revert this after N/N for this migration. the two plugins in question currently clash and throw a warning. Note that this only suppresses warnings, not errors.
Signed-off-by: Max Pumperla <[email protected]>
doctest and linkcheck failures are unrelated |
Signed-off-by: elliottower <[email protected]>
Signed-off-by: Jack He <[email protected]>
First PR of many to replace the old and unmaintained
spinx-panels
by the newer plugin with LTS (by the same authors) calledsphinx-design
. Slightly different syntax, but same functionality. Stylistically slightly different, but more powerful later on. We need to take care of 3 things (the latter 2 always go together):tabbed
by eithertabs
ortab-set
link-button
bybutton-ref
andbutton-link
panels
bygrid
Important: once fully removing
sphinx-panels
from dependencies, we can finally upgrade our theme and the base sphinx version to.