About Majic Django Templates ============================ *Majic Django Templates* is a set of project and application templates (skeletons) for Django, which can be used in combination with ``django-admin`` commands ``startproject`` and ``startapp``. This is *not* to be confused with the templates used within Django projects and applications themselves. These templates allow you to easily create some basic boilerplate for Django projects and applications, with some added flexibility and batteries for deployments in multiple environments etc. Why were these templates created? --------------------------------- I wanted to have a set of templates I could use as a common base for deploying Django projects on my own servers. There was already a couple of templates out there, but some were not perfectly aligned with my needs, and I wanted to have a better control of with personalised templates. In particular, the project template was heavily influced by the book `Two Scoops of Django `_ (at the time I was using the book written for Django 1.5.x series), with one main difference - I did not like having the database password and secret key supplied as values of environment variables. I wanted to have those as part of a *Python* file instead. So, this was the beginning of my own project template. I kind of had one Django website deployed using this (my wiki), and the template itself was rather poorly documented. Heck, I had to traceback my steps every time I wanted to use it - which was also not very often :). Some time later, a colleague of mine and me decided to start working on a web project of our own. We decided to use Django. My colleague had no previous experience with it (although, unlike me, he is a seasoned developer), so the decision was made for me to create a complete project template for him as a starting point (during that time he concentrated on learning Python/Django). At this time I tried again to use my previous template attempt, and was semi-successful (after all, the initial template was designed for Django 1.5). I started working again, this time on a *set* of templates which would include both project and application templates, and which would also have proper documentation to help both him and me get started. What you see before you know is the fruit of that labour. If anyone decides to use it, I sure hope it will prove useful. If not, oh well, at leat it works for me :) All criticism is welcome too! Features -------- Majic Django Templates implement the following: * One project template, with support for having multiple environment configurations (development, testing, production), where each environment shares a common project configuration, and then adds its own specifics.