Skip to content
This repository has been archived by the owner on Oct 4, 2019. It is now read-only.

Setup_FR

DrClockwork edited this page Jul 11, 2017 · 2 revisions

Installer H5PP

Ce guide d'installation est divisé en deux parties : A partir de rien, avec un nouveau projet Django, ou depuis un projet Django existant.

A partir d'un nouveau projet

I. Prérequis

A. Python

Vous devez avoir Python installé sur votre système. H5PP utilise la version 2.7.x.

Vous pouvez obtenir Python à cette adresse: Python 2.7.9

Il existe un installateur pour Windows (MSI Installer) ou Mac. Si vous avez un Linux vous pouvez utiliser apt :

sudo apt-get install python2.7

Vous pouvez utiliser Python 3.X si vous voulez. Cependant il est possible que vous rencontriez d'éventuels bugs. Nous faisons en sorte de rendre le code le plus compatible possible avec la dernière version de Python.

B. Django

H5PP utilise la dernière version majeur de Django (1.8.x).

Vous êtes libre d'installer n'importe quelle version de Django si celle-ci est >= 1.8.0 : Installation tutorial for Django.

II. Commencer un nouveau projet

Quand vous avez Django installé, créér un nouveau projet à l'endroit de votre choix :

django-admin startproject myproject

Vous avez désormais un projet avec cette structure de fichiers :

myproject/
    manage.py
    myproject/
        __init__.py
        settings.py
        urls.py
        wsgi.py

Pour tester votre serveur lancer cette commande et essayer d'accéder à http://localhost:8000 :

python manage.py runserver

Si vous avez installé correctement Django et votre projet vous devriez tomber sur la page d'acceuil d'exemple de Django. On peut désormais commencer à installer le plugin.

Sur un projet existant

I. Prérequis

Vous devez avoir Python 2.7.x (ou Python 3+ mais avec aucune garanties de stabilité pour le moment), pip pour Python et Django 1.8.x.

Vous pouvez ensuite procéder par trois chemins :

A. Créer le paquet distribuable manuellement

  • Télécharger le dépôt H5PP (.zip) depuis github.
  • Décompresser le à l'endroit que vous voulez.
  • Rendez vous à la racine du plugin (où se situe le fichier setup.py).
  • Avec un terminal lancer cette commande :
python setup.py sdist
  • Un dossier 'dist' a été créé. Dans ce dossier se trouve le paquet prêt à l'emploi H5PP.
  • Allez à la racine de votre projet Django (où se situe le fichier manage.py).
  • Avec un terminal lancer cette commande :
pip install <path/to/the/H5PP/Package>
  • Si vous n'avez aucun messages d'erreur de la part de Pip, le plugin est installé !

B. Installer depuis github

  • Rendez vous à la racine de votre projet Django (où se situe le fichier manage.py).
  • Avec un terminal lancer cette commande :
pip install git+git://github.com/drclockwork/H5PP@0.1.8#egg=H5PP

@0.1.8 correspond à la dernière version du plugin. Vous pouvez facilement la trouver en consultant la liste des releases : Releases list.

Remplacer le nombre par la version de la release de votre choix.

  • Si vous n'avez aucun messages d'erreur de la part de Pip, le plugin est installé !

C. Installer depuis pip

Bientôt !

II. Configuration du plugin

A. Paramêtres du projet

Dans votre fichier de configuration (par défaut settings.py) allez à la section INSTALLED_APPS et ajoutez cette line :

INSTALLED_APPS = [
    ...,
    'h5pp',
]

Ensuite, ajoutez ces variables (de préférence à la fin de votre fichier, mais vous pouvez les grouper où vous voulez dans le fichier :

H5P_DEV_MODE = 0
H5P_URL = '/h5p/'
H5P_SAVE = 30
H5P_EXPORT = '/exports/'
H5P_LANGUAGE = 'en'
BASE_URL = 'http://localhost:8000' # Hostname of your server

L'explication concernant ces différentes variables se trouvent ailleurs dans la documentation si nécessaire : Variables.

Les variables initialisés comme ci-dessus permet de faire fonctionner H5PP sur un serveur en local par le port 8000.

Dans votre fichier d'url (par défaut urls.py) ajoutez cette ligne à votre liste d'urls :

urlpatterns = [
    ...,
    url(r'^h5p/', include('h5pp.urls')),
]

Vous pouvez configurer le chemin pour accéder aux diverses pages relatives à H5PP. Par défaut j'ai choisi h5p/.

Si ce n'est déjà fait, crééz un dossier intitulé 'media' à la racine de votre projet Django (où se situe le fichier manage.py).

III. Lancer le plugin

A. Migration de la base de données

Maintenant il est nécessaire de préparer la base de données du plugin. Il suffit de lancer une migration depuis votre projet django :

python manage.py migrate

9 tables ont été créées par la migration : h5p_libraries, h5p_content, h5p_libraries_libraries, h5p_libraries_languages, h5p_counters, h5p_points, h5p_content_user_data, h5p_contents_libraries and h5p_events.

B. Installer les librairies h5p

Pour tester la bonne installation du plugin lancer le serveur de développement de votre projet :

python manage.py runserver

Essayer d'accéder à la page d'acceuil du plugin : http://localhost:8000/h5p/home.

A cette étape le plugin est techniquement installé. Cependant il n'y pas encore de type de contenus installés.

Après avoir accédé au site, rendez vous à la page 'Libraries' et mettez en ligne un paquet H5P : Dernière release d'H5P.

Si l'installation s'est bien déroulée vous devriez avoir une liste des types de contenus disponibles.


H5PP est désormais installé et utilisable !