OK, first of all: The German translation of the Django documentation is not dead. While the start late last year saw some great results, the whole movement got a little slowed down over the time and right now it's still just proceeding on a more slow way right now. When the last major refactor in upstream took place (some time before PyConUK 2008) I started looking through it and it became quite clear, that it would be quite hard to save some of our work from before. The structure and most of the content was just too different to save even a single document completely. So I started building a little bit of the foundation (style-port, main menu, etc.) during my train-trip back home.
Read more about "State of the German Django documentation (IMO)" ...Archive for [<Tag: documentation>]
-
State of the German Django documentation (IMO)
-
Django Documentation Refactor has landed
A long time coming the documentation refactoring has finally landed on docs.djangoproject.com and in trunk. Compared to the previous format this one now uses Georg Brandl's Sphinx documentation system, which also finally gives you as a user a simple way to have the documentation bundled with Django itself to be converted to HTML with one command (if everything works) :-). To do this, simply go to the docs folder of your Django checkout and run
make html(naturally after installing Sphinx) and if everything works you should end up with a whole bunch of HTML files. Great work Jacob et al. :-)So far for me this isn't working yet, probably because I'm living on the bleeding edge with Sphinx for a couple of reasons, but perhaps I can find some time to dig into this.If you get a syntax error line layout.html line 10 when building the documentation, make sure that you've installed Jinja 1.2 (instead of something older like 1.1).The structure is new too and it will definitely take some time getting used too, but the separation between primary content (the one on the left side of the index page) and additional articles (in the boxes on the right side) definitely makes sense :-) For now it isn't linked yet in the main menu on the site, probably because it's still in testing stage.
