diff --git a/docs/developing-locally-docker.rst b/docs/developing-locally-docker.rst index 7a11c7a4..4c9ccac8 100644 --- a/docs/developing-locally-docker.rst +++ b/docs/developing-locally-docker.rst @@ -183,4 +183,12 @@ You may need to add the following to your css in order for the django-debug-tool } +Setup your email backend +~~~~~~~~~~~~~~~~~~~~~~~~ +In development you can (optionally) use MailHog_ for email testing. MailHog is added as docker-container. To use MailHog: + +1. Make sure, that ``mailhog`` docker container is up and running +2. Open your browser and go to ``http://127.0.0.1:8025`` + +.. _Mailhog: https://github.com/mailhog/MailHog/ diff --git a/docs/developing-locally.rst b/docs/developing-locally.rst index 02c9baf4..6c84ca3c 100644 --- a/docs/developing-locally.rst +++ b/docs/developing-locally.rst @@ -51,15 +51,8 @@ Setup your email backend django-allauth sends an email to verify users (and superusers) after signup and login (if they are still not verified). To send email you need to `configure your email backend`_ .. _configure your email backend: http://docs.djangoproject.com/en/1.9/topics/email/#smtp-backend -{% if cookiecutter.use_docker == 'y' %} -In development you can (optionally) use MailHog_ for email testing. MailHog is added as docker-container. To use MailHog:: -1. Make sure, that ``mailhog`` docker container is up and running -2. Open your browser and go to ``http://127.0.0.1:8025`` - -.. _Mailhog: https://github.com/mailhog/MailHog/ -{% else %} -In development you can (optionally) use MailHog_ for email testing. MailHog is built with Go so there are no dependencies. To use MailHog:: +In development you can (optionally) use MailHog_ for email testing. MailHog is built with Go so there are no dependencies. To use MailHog: 1. `Download the latest release`_ for your operating system 2. Rename the executable to ``mailhog`` and copy it to the root of your project directory @@ -69,7 +62,7 @@ In development you can (optionally) use MailHog_ for email testing. MailHog is b .. _Mailhog: https://github.com/mailhog/MailHog/ .. _Download the latest release: https://github.com/mailhog/MailHog/releases -{% endif %} + Alternatively simply output emails to the console via: ``EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'`` In production basic email configuration is setup to send emails with Mailgun_ @@ -78,20 +71,6 @@ In production basic email configuration is setup to send emails with Mailgun_ **Live reloading and Sass CSS compilation** -If you'd like to take advantage of live reloading and Sass / Compass CSS compilation you can do so with the included Grunt task. +If you’d like to take advantage of live reloading and Sass / Compass CSS compilation you can do so with a little bit of `prep work`_. -Make sure that nodejs_ is installed. Then in the project root run:: - - $ npm install - -.. _nodejs: http://nodejs.org/download/ - -Now you just need:: - - $ grunt serve - -The base app will now run as it would with the usual ``manage.py runserver`` but with live reloading and Sass compilation enabled. - -To get live reloading to work you'll probably need to install an `appropriate browser extension`_ - -.. _appropriate browser extension: http://feedback.livereload.com/knowledgebase/articles/86242-how-do-i-install-and-use-the-browser-extensions- +.. _prep work: https://cookiecutter-django.readthedocs.io/en/latest/live-reloading-and-sass-compilation.html