scipy: BUG: online doc returns 404 - wrong `reference` in url

The new theme seems to have introduced a duplicate reference in the URL, e.g.,

The effect was that today all SciPy search engine results I found were broken.

The search engines will update eventually. But the double /reference/reference/ in the url is unnecessary, so it might be better removed?

About this issue

  • Original URL
  • State: closed
  • Created 3 years ago
  • Reactions: 5
  • Comments: 56 (51 by maintainers)

Commits related to this issue

Most upvoted comments

It seems we’ve finally gotten this fixed in the release scripts now. The stable intersphinx link that I’d expect project to use is:

scipy': ('https://docs.scipy.org/doc/scipy', None),

This has always worked, with short hiccups after the 1.8.0 and 1.8.1 releases. It shouldn’t be happening after the next release anymore.

This broke again after the 1.8.1 release. It should finally be fixed for good by:

If anyone still sees something that’s not in the correct place, please comment.

Updated the name so we hopefully have less new issues about this. We could also pin the issue?

The announcement is merged https://github.com/scipy/scipy.org/pull/396 but apparently the site didn’t get refreshed. It will show up soon. So I’ll close this since Ralf is probably going to see this

Thanks all for your considerations.

Some link redirects are now in place, at least temporarily per changes in https://github.com/tylerjereddy/htaccess_backup/pull/1

I guess we’ll see where the dust settles, and if we can live with URLs like https://docs.scipy.org/doc/scipy/html-scipyorg/ as the redirection target, or maybe can do something cleaner.

Is https://docs.scipy.org/doc/scipy/reference/ being a 404 the same issue?

And is https://docs.scipy.org/doc/numpy/reference/ saying “moved permanently” with a broken redirect seemingly to itself related, or does that need reporting with NumPy?

I found both links from https://docs.scipy.org/doc/.

Likewise seeing 404 on links from google. For me only the ‘developer reference’ links pointing to http://scipy.github.io/devdocs/dev/ are working.

Concrete suggestions for improving /srv/docs_scipy_org/doc/.htaccess are welcome. Otherwise, I’ll probably just wait for some other core devs to make suggestions next week.

Moving to 1.8.0, let’s not mix it with the release that introduces M1 support. Best not to upload any new docs for 1.7.3 (just like we didn’t for 1.7.2).

I’ll fix that too, thanks for the suggestion.

Okay, cp -R . .. run on the server. That fixes the broken links to the API docs. I am changing the Makefile and rebuilding, to push up a clean doc build and ensure we have the proper fix in place.

The offending line is the last one here (from doc/Makefile in this repo):

doc-dist: html-scipyorg html
	test -d build/latex || make latex
	make -C build/latex all-pdf LATEXOPTS="-halt-on-error"
	-test -d build/htmlhelp || make htmlhelp-build
	-rm -rf build/dist
	mkdir -p build/dist
	cp -r build/html-scipyorg build/dist/reference

API docs are more important than tutorial though, so I’m tempted to drop the reference/ anyway, it doesn’t quite make sense. Copying things over on the server to .. will give us double copies of everything, but seems like a good band aid to fix all links. Any concerns with doing that?

@tupui is there any place where we can have a look at the doubling problem closely as it is picking up some traction? Maybe past related PRs where it might have been introduced