The sandbox for modules of Erle

Demo

👉 Watch the ERLE demo here.

For developers

$ git clone https://github.com/JohnDSloan/erle-sandbox

Enter the base directory

$ cd erle-sandbox

Create and activate a new virtual environment (for Python 3)

$ pip install virtualenv
$ virtualenv venv
$ source venv/bin/activate

Install project dependencies:

$ pip install -r requirements.txt

Start your own Django project:

$ django-admin startproject myerlesandbox

Django will create the file structure

myerlesandbox/ manage.py myerlesandbox/ init.py settings.py urls.py wsgi.py

From the cloned erle-sandbox, copy the directories 'base' and 'saoirse' into your 'myerlesandbox' directory. Then add an empty directory at 'media/synthesisedSpeech/':

$ cp -r saoirse/ myerlesandbox/saoirse/
$ cp -r base/ myerlesandbox/base/

myerlesandbox/\n base/..\n manage.py\n media/..\n myerlesandbox/\n init.py\n settings.py\n urls.py\n wsgi.py\n saoirse/..\n

Edit 'myerlesandbox/myerlesandbox/urls.py' to look like:

from django.contrib import admin from django.urls import path, include from django.conf import settings from django.conf.urls.static import static

urlpatterns = [ path('admin/', admin.site.urls), path('', include('saoirse.urls')), ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

In 'myerlesandbox/myerlesandbox/settings.py', make the following changes:

1. add 'saoirse.apps.SaoirseConfig' to the 'INSTALLED_APPS' list
2. TEMPLATES['DIRS'] = [os.path.join(BASE_DIR, 'base/templates')]
3. the end of the file should look like:

Static files (CSS, JavaScript, Images)

https://docs.djangoproject.com/en/2.2/howto/static-files/

STATIC_URL = '/static/' STATICFILES_DIRS = [ os.path.join(BASE_DIR, 'base/static') ] STATIC_ROOT = 'static/'

MEDIA_URL = '/media/' MEDIA_ROOT = os.path.join(BASE_DIR, 'media/')

To generate synthesised speech, register for a free acoount at Cereproc

in 'saoirse/views/speech_synthesis/utils/text_to_speech.py', fill in your own accountID and password at the top of the page. Then delete:

try: accountID = settings.CEREPROC_ACC_ID password = settings.CEREPROC_PASSWORD except: pass

(all animations will still work without taking this step above)

navigate to the root myerlesandbox directory and create superuser:

$./manage.py createsuperuser

enter your own username and password.

run the server

$./manage.py runserver

go to http://127.0.0.1:8000/ in your browser

to access admin, go to: http://127.0.0.1:8000/admin

Built with

• Django
• Three.js