Broken link for downloading docs as HTML

[Jenny Duckett]

The link to download the full docs as HTML at the bottom of the sidebar on many pages on docs.djangoproject.com is given as e.g. ​https://docs.djangoproject.com/s/docs/django-docs-1.5-en.7b52b2b9085f.zip but should be ​https://docs.djangoproject.com/s/docs/django-docs-1.5-en.zip - this applies to the links for all versions of Django.

[Claude Paroz]

This is an artifact of the static template tag, introduced in ​https://github.com/django/djangoproject.com/commit/89b5cc54cbd1ad4ea512428197d1b788bfc3547a

[Baptiste Mispelon]

This issue was introduced with commit ​https://github.com/django/djangoproject.com/commit/89b5cc54cbd1ad4ea512428197d1b788bfc3547a that switched the site to using CachedStaticFilesStorage.

Unfortunately, the code that generates thoses zip files (the update_docs command) is not using the staticfiles machinery, which broke the download links.

I see two solutions:

1) Revert the download link to use {{ STATIC_ROOT }} instead of {% static %}.
2) Change the update_docs command to make use of the staticfiles infrastructure (or at least generate a compatible filename).

I think 2) might be the better option, but after looking into it a bit, I found it tricky to implement.

[Aymeric Augustin]

It could be more appropriate to treat the docs zip archives as media files.

There're a media attached to a DocumentRelease object.

[Jannis Leidel <jannis@…>]

In cbe6e5bf02563b0a9332361897f1ebd350a9fa11/djangoproject.com:

Fixed #20678 - Refer to the zip file correctly. Fixes a regression introduced in 89b5cc54cbd1ad4ea512428197d1b788bfc3547a and 89b5cc54cbd1ad4ea512428197d1b788bfc3547a.

[Jannis Leidel]

FTR I agree with aaugustin, the download is a "media" IMO.