Permalink
Switch branches/tags
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
54 lines (37 sloc) 2.19 KB

Themes

One of the nice things of django Organice is that themes are handled as separate projects. In fact, they are pluggable Django apps composed of assets and templates that you can simply install and activate.

Official Themes

Here is a list of django Organice themes officially supported by us:

  1. RSSK Theme: django-organice-theme-rssk
  2. Fullpage Theme: django-organice-theme-fullpage

If you have a nice theme and would like to include it in this list let us know by e-mail or make a pull request on this page of the documentation.

Mother Theme

django-organice-theme is the mother of all themes for django Organice. This theme is installed automatically when you install django Organice. From the development perspective all themes are derived from the mother theme, which contains a collection of static files (assets) and templates, as well as a Makefile for asset management. The mother theme is composed of:

The Makefile also supports you with updating those components on your development system.

Rolling Your Own Theme

Preparations:

  • Visit http://organice.io/themes and find a theme that is as close as it gets of what you want.
  • Go to that theme's repository page, make a copy of the whole project, and rename it (e.g. to mytheme).

Loop until you're happy:

  • Add or adapt the style sheet (.scss), JavaScript (.js), and other files in mytheme/static/.
  • Run make assets in order to compile the Sass files to CSS, and combine and minify both CSS and JavaScript.
  • Adapt the template files in mytheme/templates/, and test the results on your development system.