From 3e9427ce958e00cbd1173b4c8d59e40b24586602 Mon Sep 17 00:00:00 2001
From: Virak Oum <vo@cloudcontrol.de>
Date: Mon, 7 Sep 2015 18:04:14 +0200
Subject: [PATCH] Add information about serving static files

Due to the process of updating the guides, missing information about
serving static files on our platform needs to be added.
Therefore, add a section about serving static files and small examples
to adjust the applications.
---
 Guides/Python/Django-notes.md | 67 +++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)

diff --git a/Guides/Python/Django-notes.md b/Guides/Python/Django-notes.md
index ab6268f..f25c1d2 100644
--- a/Guides/Python/Django-notes.md
+++ b/Guides/Python/Django-notes.md
@@ -25,6 +25,70 @@ To use a database, you should choose an Add-on from [the Data Storage category][
 ## Email
 You can't use a local SMTP server, instead choose one of our [email Add-ons][messaging-addons].
 
+## Serving Static Files
+
+Since there is no webserver , i.e. Apache or Nginx running inside the container
+to serve the static files. We recommend to use[dj-static][dj-static] or [whitenoise][whitenoise] in combination with a WSGI
+server like Gunicorn. Another approach is using a CDN, e.g. Amazon S3 to serve static files for
+your application with [django-storage][django-storage].
+For further details, checkout the official package documentations.
+
+The following code snippets showing how to use dj-static or whitenoise:
+
+### dj-static
+
+- Add the following line to the requirement.txt:
+
+~~~python
+dj-static==0.0.6
+~~~
+
+- Modify your settings.py:
+
+~~~python
+STATIC_ROOT = 'staticfiles'
+STATIC_URL = '/static/'
+~~~
+
+- Update your wsgi.py with the following line:
+
+~~~python
+from django.core.wsgi import get_wsgi_application
+from dj_static import Cling
+
+application = Cling(get_wsgi_application())
+~~~
+
+Please make sure that your files getting served properly, by adding an empty
+dummy text file in the static folder of your repository, for testing purposes.
+
+
+### whitenoise
+
+- Add the following line to the requirement.txt:
+
+~~~python
+whitenoise==2.0.3
+~~~
+
+- Modify your settings.py:
+
+~~~python
+STATICFILES_STORAGE = 'whitenoise.django.GzipManifestStaticFilesStorage'
+~~~
+
+- Update your wsgi.py with the following line:
+
+~~~python
+from django.core.wsgi import get_wsgi_application
+from whitenoise.django import DjangoWhiteNoise
+
+application = get_wsgi_application()
+application = DjangoWhiteNoise(application)
+~~~
+
+
+
 [SSH-session]: https://www.cloudcontrol.com/dev-center/platform-documentation#secure-shell-(ssh)
 [python buildpack]: https://github.com/cloudControl/buildpack-python
 [pip]: http://www.pip-installer.org/
@@ -34,3 +98,6 @@ You can't use a local SMTP server, instead choose one of our [email Add-ons][mes
 [add-on-credentials]: https://www.cloudcontrol.com/dev-center/guides/python/add-on-credentials
 [cloudControl]: https://www.cloudcontrol.com/
 [worker]: https://www.cloudcontrol.com/dev-center/platform-documentation#scheduled-jobs-and-background-workers
+[dj-static]: https://github.com/kennethreitz/dj-static
+[whitenoise]: https://warehouse.python.org/project/whitenoise/
+[django-storage]: https://django-storages.readthedocs.org/en/latest/