django-fluent.org

This is the source code of www.django-fluent.org You can use this freely as example how to use and run a django-fluent CMS site.

Django Fluent CMS modules

The following modules are used in this site:

• django-fluent-pages <https://github.com/edoburu/django-fluent-pages>_
• django-fluent-contents <https://github.com/edoburu/django-fluent-contents>_
• django-fluent-blogs <https://github.com/edoburu/django-fluent-blogs>_
• django-fluent-comments <https://github.com/edoburu/django-fluent-comments>_
• django-fluent-dashboard <https://github.com/edoburu/django-fluent-dashboard>_
• django-any-urlfield <https://github.com/edoburu/django-any-urlfield>_
• django-any-imagefield <https://github.com/edoburu/django-any-imagefield>_
• django-staff-toolbar <https://github.com/edoburu/django-staff-toolbar>_

To create your own Django-Fluent project, use our template at:

https://github.com/edoburu/django-project-template

Project layout

This project uses the following layout:

• design/ design source files
• src/ all source code
• src/manage.py Django management tool
• src/Guardfile Guard configuration
• src/config.rb Compass configuration
• src/requirements/*.txt PIP requirements files
• src/apps/ the Django apps.
• src/frontend/ all frontend templates/JS/CSS code.
• src/djangofluent/ The project folder with settings, WSGI hook and URLconf.
• src/djangofluent/settings/default.py configures default Django settings (same of all projects).
• src/djangofluent/settings/project.py the settings for this project.
• src/djangofluent/settings/local.py developer settings.
• src/djangofluent/settings/env/*.py settings per host (beta/production) and production DB credentials.
• src/djangofluent/wsgi/*.py WSGI start scripts per environment.
• src/djangofluent/urls.py top level URLconf.
• web/ The public files exposed by the webserver.
• web/static/ Static files by Django apps.
• web/media/ Uploaded media files (JPG/PNG, etc..)

Local development

Prerequisites

- Python >= 2.6
- pip
- virtualenv (virtualenvwrapper is recommended)

Installation

To setup a local development environment::

# Clone the repository
git clone https://github.com/edoburu/django-fluent.org.git

# Create the environment:
mkvirtualenv django-fluent.org
cd src
pip install -r requirements/dev.txt

# Configure MySQL:
mysql -u root -p
  create database `django-fluent.org`;
  grant all privileges on `django-fluent.org`.* to djangofluent@localhost identified by 'testtest';

./manage.py syncdb
./manage.py migrate

# Start Django
./manage.py runserver

Compiling CSS files

To compile SASS_ files::

    gem install compass oily_png guard-livereload guard-compass

    guard

To enable LiveReload_ of ``*.css`` files during development, install a browser plugin:

* Firefox (2.0.9 dev release): https://github.com/siasia/livereload-extensions/downloads
* Everyone else: http://help.livereload.com/kb/general-use/browser-extensions

And toggle the "LiveReload" button in the browser at the desired page.

License
-------

Feel free to use parts of this code in your projects.

.. image::  http://i.creativecommons.org/l/by/3.0/88x31.png
   :target: http://creativecommons.org/licenses/by/3.0/
   :alt: Creative Commons License

Except otherwise noted, this project is © 2012-2013 Edoburu, under a `Creative Commons Attribution 3.0 Unported License <http://creativecommons.org/licenses/by/3.0/>`_.

The django-fluent modules are licensed under the Apache License Version 2.0.

The design is licensed from templatemo.com under a `Creative Commons Attribution 3.0 United States License <http://creativecommons.org/licenses/by/3.0/us/>`_.

Contributing
------------

Patches are welcome and gratefully accepted, for this site and everything else on our `GitHub page <https://github.com/edoburu>`_.

.. Add links here:

.. _Compass: http://compass-style.org/
.. _LiveReload: http://livereload.com/
.. _guard-livereload: https://github.com/guard/guard-livereload
.. _SASS: http://sass-lang.com/