Switch between docs versions not built on readthedocs #1013
Replies: 5 comments 2 replies
-
It seems Numpy is build the docs as Circle CI jobs: https://github.com/numpy/numpy/blob/main/.circleci/config.yml |
Beta Was this translation helpful? Give feedback.
-
Yes NumPy and SciPy (which I know better since I've done the switcher here) are both using CircleCI. And CircleCI is building on each PRs and allow to store artifacts (so the website). To answer the question: I am actually changing the version name to match the PR number. It does not match any version in the json but still prints the version in the selector and use default CSS. It has the same effect as you have with the warning on RTD saying this doc is for a PR. I also have some specific CSS for the colors of current, old and dev versions (soon we can have CSS for the default since we merged my PR here, next version then). Not much more. You can have a look at the config and CSS of SciPy. Let me know if you have specific questions 😃 |
Beta Was this translation helpful? Give feedback.
-
@HealthyPear is @tupui answer solved your issue ? |
Beta Was this translation helpful? Give feedback.
-
oh right sorry @12rambau , I got lost with other work and I totally forgot about this issue that was months ago.... I guess circle CI is OK, but I was referring to an "artisanal" solution, without using external software: meaning, I have a server and I deploy there, so I need something that checks out e.g. each tagged release and stores the build docs in a directory tree which complies with what this sphinx theme expects. But of course, getting a list of PRs might be more complicated... |
Beta Was this translation helpful? Give feedback.
-
If it helps, my blog is hosted on github pages and uses the switcher to have two languages. The look is quite different but it is built with sphinx using a custom theme that depends on pydata-sphinx-theme. Source (for sphinx): https://github.com/OriolAbril/oriol_unraveled |
Beta Was this translation helpful? Give feedback.
-
This is more of a question/curiosity than an actual issue.
In your docs example you show what happens for your repository, whose documentation is stored on readthedocs where each version (at least the ones one decides to activate) is built separately.
If a project doesn't use readthedocs (for example GitHub Pages or the equivalent for GitLab), I guess there is always the need to have something that builds each version and deploys the associated documentation to a well defined URL that then is defined in the switcher.json file.
What would be some nice implementations of this?
Do you know any open-source project that falls into this use-case and implemented something that works?
Beta Was this translation helpful? Give feedback.
All reactions