> 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?"
I've not asked "Is there anywhere I can download a PDF of the Django documentation, and if not, why not?" because I know the answer. > 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. The django community should allow to download html version of documentation to make this project more attractive , I'm sure it doesn't take a lot of time to generate it on configured environment. But a lot of time can be saved on django users' side.More over it can be critical on making decision between this or other framework. On Feb 10, 1:09 pm, Russell Keith-Magee <freakboy3...@gmail.com> wrote: > 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 pagehttp://www.springsource.org/documentationand 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-.... > > 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 -~----------~----~----~----~------~----~------~--~---
