Opened 16 years ago
Closed 13 years ago
#9353 closed New feature (fixed)
Django documentation bundles on download page
Reported by: | Owned by: | nobody | |
---|---|---|---|
Component: | *.djangoproject.com | Version: | dev |
Severity: | Normal | Keywords: | download |
Cc: | loftarasa@… | Triage Stage: | Design decision needed |
Has patch: | no | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | no | UI/UX: | no |
Description
After needing the django documentation for offline development I suggest the following:
Provide documentation packages (html, chm) on the download page for every release.
One can argue that it is possible to build it from the restructured text format, but I believe it makes sense to be able to download the html docs from the download page, and not having to learn how to compile them, or google around to find them at some other source.
Change History (10)
comment:1 by , 16 years ago
comment:2 by , 16 years ago
Triage Stage: | Unreviewed → Design decision needed |
---|
comment:3 by , 15 years ago
Keywords: | download added |
---|---|
Version: | 1.0 → SVN |
The suggested fix does not work out of the box on platforms that don't have wget out of the box (for example mac os x). Google App Engine provides official documentation download.
comment:4 by , 14 years ago
I am a django user, fairly newbie. I did not find it easy to compile the html docs (in fact it's not pointed out that you have to do "make html" at the FAQ on how to read the documentation offline), which required me to download Sphinx. I don't see why this can't be provided at the download page.
comment:5 by , 14 years ago
+1 on this. one should also consider that developing on windows makes it just _that_ much harder to have local html copies of the documentation. do we really need makefiles for the documentation?
comment:6 by , 14 years ago
Cc: | added |
---|
comment:7 by , 14 years ago
Component: | Documentation → Django Web site |
---|
This is an issue about the website itself, not about the docs.
comment:8 by , 14 years ago
Severity: | → Normal |
---|---|
Type: | → New feature |
comment:9 by , 14 years ago
Easy pickings: | unset |
---|
+1 to this. I'm about to get on a train; I go to the Django site and look for "Download HTML documentation tarball" and I would really have liked to have found it. It would be great if it wasn't true that everyone who wants this has to mess around with Sphinx and compiling docs themselves.
Gerv
comment:10 by , 13 years ago
Resolution: | → fixed |
---|---|
Status: | new → closed |
UI/UX: | unset |
There're now links to offline versions in the sidebar on the docs site.
You can use wget to download and convert to local links:
wget -r -p -k http://docs.djangoproject.com/en/dev/