On Tue, Feb 10, 2009 at 4:21 PM, igorlash <igorl...@gmail.com> wrote: > > Hi everybody. > I'm java developer , and I like comparing web frameworks. > Members of django community talk a lot about easiness of django > especially comparing with java frameworks. But they have not compared > all aspects. And I want to compare one of them. > As user of good web framework I want to have documentation on my > computer and have possibility to read it offline. > Let's compare spring framework and django. > To get spring documentation I can download spring , and this zip file > contains apis , reference manuals (in PDF and HTML formats). Or I can > visit this page http://www.springsource.org/documentation and download > PDF or view HTML online (we will not take viewing HTML online into > account , I've mentioned about it only to be honest). > > And now most interesting , let take a look at django. When you > download django you have documentation in ReStructured Text format > http://docs.djangoproject.com/en/dev/faq/general/#how-can-i-download-the-django-documentation-to-read-it-offline. > This format is not very readable so I've decided to convert it to html > or something other. > I was very surprised when I found makefile in the root of doc folder. > GREAT , to read documentation offline we need to install make.But not > all python developers , especially web developers know something about > make. Ok , I've installed make. But after that I found out I need to > install one more tool Sphinx But Sphinx requires some dependencies > and the easiest way to install them all is installing easy_install. Ok > I've installed easy_install and Sphinx but after that I've got error > about absence of some module (djangodocs).On this stage I gave up. > > It's very interesting why I can't download django documentation in the > same way as I can download spring documentation or python > documentation (http://docs.python.org/download.html) ?
If I have correctly interpreted you correctly, this was an extraordinarily long-winded way to ask "Is there anywhere I can download a PDF of the Django documentation, and if not, why not?" No - we don't provide a PDF version of the documentation. This idea has been proposed a few times in Django's history, but it has been rejected in favour of providing the tools to let people build offline versions by themselves. Django's documentation is constantly improving, even for old versions. Producing (and keeping up to date) PDF versions takes time. Yes, this process could be automated, but building and maintaining the framework to allow for automated documentation builds would take time. Time is an extremely limited resource on any volunteer project, and the core developers have made the decision that having an offline PDF version of the docs is a lower priority to improving Django as a tool, and improving the documentation that ships with Django and is available as an online resource. If you are having difficulties building the docs into a standalone format, feel free to ask questions on this mailing list. We would also welcome any suggestions for improvements to the documentation for this process of building the documentation. Yours, Russ Magee %-) --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Django users" group. To post to this group, send email to django-users@googlegroups.com To unsubscribe from this group, send email to django-users+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/django-users?hl=en -~----------~----~----~----~------~----~------~--~---
