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) ?

--~--~---------~--~----~------------~-------~--~----~
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
-~----------~----~----~----~------~----~------~--~---

Reply via email to