987332 - sphinx MDN theme references files that now 404

Status: RESOLVED FIXED

(developer.mozilla.org Graveyard :: General, defect)

Description

[Gregory Szorc [:gps]]

I'm using the Sphinx MDN theme (https://github.com/lmorchard/mozilla-mdn-sphinx-theme) to manage the mozilla-central documentation.

See https://ci.mozilla.org/job/mozilla-central-docs/Tree_Documentation/index.html for the output of a Jenkins job that generates things automatically.

That theme references files on https://developer.mozilla.org. Sometime in the last 5 days those files started to 404.

Failing URLs include:

https://developer.mozilla.org/media/js/init.js
https://developer.mozilla.org/media/js/gsearch.js
https://developer.mozilla.org/media/js/main.js

The Sphinx MDN theme is using the old version of MDN's layout. I suspect these old files have been removed from the deployed site.

I would prefer if this were resolved by updating the Sphinx MDN theme to use the new MDN layout. Not sure if there is a bug on that anywhere. But I'd settle for restoring the files on the server or updating the existing Sphinx theme to include copies of relevant files. Actually, I'd prefer having the theme have local copies of files so docs can be generated and used offline. I was once writing docs on a plane and was frustrated the output didn't render without internet connectivity!

Comment 1

[Gregory Szorc [:gps]]

Anyone care to comment on this?

Comment 2

[Gregory Szorc [:gps]]

Attachment: Disable MDN theme until it works

The MDN theme is currently busted. This patch reverts to the default
Sphinx theme so we have docs that are more usable.

Comment 3

[Nick Alexander :nalexander [he/him]]

Comment on attachment 8440969 [details] [diff] [review]
Disable MDN theme until it works

Review of attachment 8440969 [details] [diff] [review]:
-----------------------------------------------------------------

Rubber stamp.

Comment 4

[Gregory Szorc [:gps]]

https://hg.mozilla.org/integration/fx-team/rev/53a3842d1143

Comment 5

[Carsten Book [:Tomcat]]

https://hg.mozilla.org/mozilla-central/rev/53a3842d1143

Comment 6

[Jannis Leidel [:jezdez]]

I think we've recently updated the Sphinx theme package, :groovecoder, can you verify?

Comment 7

[Luke Crouch [:groovecoder]]

Yes, I updated it a month ago.

https://pypi.python.org/pypi/mdn-sphinx-theme/2015.1

Comment 8

[John Whitlock [:jwhitlock]]

The current theme (version 2016.0) has no 404 links. However, we're abandoning the project (bug 1361729), and the assets are not included in the theme, so they may become 404s again in the future.