25 ms·
Django Offline Docs
- ujjvala 15y agoGreat Name.
- insraq 15y agoWow! Good job. I think Django should make this official. I like reading PDF but I believe ePub seems better for portable reading devices.
- masklinn 15y ago> I think Django should make this official. Django uses Sphinx for its documentation system, you can just build the doc from the source tree, in whatever format you prefer.
- insraq 15y agoIt's true. But building from source might be a pain for some people, especially newbies like me.
- awj 15y agoIf Django makes too many things official, installing it will become a pain for some people, especially newbies. They have to walk a careful line in that regard, and I think they made the right call on offline docs.
- deleted 15y ago[deleted]
- ludwigvan 15y agoI don't get it, what does providing a pdf or zipped html files have to do with installing? Flask does this[0], and so does ReadTheDocs. It isn't clear to me what is stopping Django from providing precompiled docs, bandwidth costs? [0] http://flask.pocoo.org/docs/ http://flask.pocoo.org/docs/
- awj 15y agoYou know, I'm not sure what I was thinking when I wrote that. There's no real great reason to avoid doing it other than download size, and I doubt that's a huge issue. Right now I think they're just doing releases as a .tar.gz archive of the checkout files. That'd mean an extra "build" step at release time, but that's probably trivial to automate. That said, the source text files for the documentation are included, and whatever markup format they use (reStructuredText?) is relatively legible. HTML docs would be better, though.
- masklinn 15y ago> But building from source might be a pain for some people, especially newbies like me. It's really not hard, and it's using a tool you should start using as soon as you start "serious" Python projects: Sphinx. Building the doc from source is pretty much trivial on Unix-type systems (OSX, Linux, BSD, whatever) * Get the django source, either tarball or source control * Install sphinx * Go to the root of your Django install * `make -C docs [format...]` where format is any set of valid sphinx output formats: html, dirhtml, singlehtml, htmlhelp, qthelp, devhelp, epub, latex, latexpdf, text or man You compiled documentation will be in the `_build/$format` directory, for each format you're building (you can build all of them). The latexpdf target requires that `pdflatex` be installed and available.
- jacobian 15y ago> I think Django should make this official. Good call - I just did. There's a "download" link in the sidebar now.
- voyvf 15y agoNice! I do remember having to install a crapload of packages in order to generate PDF docs, though if one uses a lot of software with Sphinx docs, it's more than worth it, IMHO.
- phatbyte 15y agoVery nice job, this will be very helpful . Congrats.
- dits59 15y agoAs u said, when there is less connectivity it really makes sense.
- sramana9 15y agoThanks everyone. I created this page long back, but later ReadtheDocs.org started offering PDF downloads of docs, making it redundant. Django is available at http://media.readthedocs.org/pdf/django/latest/django.pdf http://media.readthedocs.org/pdf/django/latest/django.pdf
- jacobian 15y agoAlso see http://readthedocs.org/projects/django/ http://readthedocs.org/projects/django/ for a couple of other formats: ePub and manpage (that's a long manpage...)
- jerryr 15y agoThank you! I appreciated the thoughtful "Why?" column as much as the offline docs themselves.
- Mizza 15y agoThanks sramana! I can't wait for the Indian and western programming cultures to become more intertwined. I feel like we have a lot to gain from each other.
- forsaken 15y ago1.2.4 and all the other versions that are built are also available. They aren't linked from the site, but are get-able with a little URL munging: http://media.readthedocs.org/pdf/django/1.2.4/django.pdf http://media.readthedocs.org/pdf/django/1.2.4/django.pdf
- forsaken 15y agoWould people be interested in a Downloadable HTML version as well? RTD only offers PDF for the moment, but supporting a downloadable HTML zip would be pretty simple to do as well. I note that it's the other part of the OP that isn't supported.
- albertsun 15y agoThis is great. I was just thinking about how much more productive I am while without internet (like at a cafe without wifi), except that I can't refer to documentation easily.
- mnazim 15y agoDjango Docs are already available offline (for those who look)
- r4vik 15y agoIf you want the django docs locally just fire up a terminal cd to the docs/ directory of your django installation then run python -m SimpleHttpServer 8880 and then visit http://localhost:8880 http://localhost:8880
- mace 15y agoI've always used (Sphinx and other deps required): git clone git://github.com/django/django && cd django/docs && make html The Python docs can similarly be built for offline reading.
- tvon 15y agoThere are also some other sphinx templates that look a bit better than what Django ships with, IMO.