mirror of
https://framagit.org/la-chariotte/la-chariotte.git
synced 2025-05-02 03:42:26 +02:00
Add instructions on how to install locally.
Exmplain how to create the database and how to run the server with a local settings.py file.
This commit is contained in:
parent
557256ef1d
commit
7b1af75795
2 changed files with 70 additions and 1 deletions
4
.gitignore
vendored
4
.gitignore
vendored
|
@ -4,4 +4,6 @@ coverage.xml
|
||||||
la_chariotte.egg-info/
|
la_chariotte.egg-info/
|
||||||
node_modules
|
node_modules
|
||||||
/static/*
|
/static/*
|
||||||
/media/*
|
/media/*
|
||||||
|
local_settings.py
|
||||||
|
.venv
|
67
README.md
67
README.md
|
@ -46,6 +46,73 @@ pip install -r requirements.txt
|
||||||
pip install -r dev-requirements.txt
|
pip install -r dev-requirements.txt
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Installation d'un environnement virtuel.
|
||||||
|
|
||||||
|
Pour éviter que les bibliothèques nécessaires au projet ne rentrent en conflit avec celles de votre système, il peut être utile d'installer un environnement virtuel :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 -m venv .venv
|
||||||
|
```
|
||||||
|
|
||||||
|
Une fois l'environnement virtuel installé, vous pouvez l'activer :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
source .venv/bin/activate
|
||||||
|
```
|
||||||
|
|
||||||
|
### Installation de la base de données
|
||||||
|
|
||||||
|
Chariotte nécessite une base de données, et est actuellement compatible avec PostgreSQL.
|
||||||
|
|
||||||
|
Pour le développement, nous vous conseillons de créer une base de données nommée ```chariotte``` accessible par l'utilisateur et le mot de passe du même nom.
|
||||||
|
|
||||||
|
```SQL
|
||||||
|
CREATE ROLE chariotte WITH
|
||||||
|
LOGIN
|
||||||
|
NOSUPERUSER
|
||||||
|
CREATEDB
|
||||||
|
NOCREATEROLE
|
||||||
|
INHERIT
|
||||||
|
NOREPLICATION
|
||||||
|
CONNECTION LIMIT -1
|
||||||
|
PASSWORD 'xxxxxx';
|
||||||
|
```
|
||||||
|
```SQL
|
||||||
|
CREATE DATABASE chariotte
|
||||||
|
WITH
|
||||||
|
OWNER = chariotte
|
||||||
|
ENCODING = 'UTF8'
|
||||||
|
CONNECTION LIMIT = -1
|
||||||
|
IS_TEMPLATE = False;
|
||||||
|
```
|
||||||
|
|
||||||
|
## Création du fichier de configuration
|
||||||
|
|
||||||
|
Créez un fichier de configuration dans lequel vous pourrez spécifier la configuration qui est utile pour vous. Nous allons le nommer ici ```local_settings.py```.
|
||||||
|
|
||||||
|
```python
|
||||||
|
from la_chariotte.settings import *
|
||||||
|
|
||||||
|
DATABASES = {
|
||||||
|
'default': {
|
||||||
|
'ENGINE': 'django.db.backends.postgresql',
|
||||||
|
'NAME': 'chariotte',
|
||||||
|
'USER': 'chariotte',
|
||||||
|
'PASSWORD': 'chariotte',
|
||||||
|
'HOST': 'localhost',
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Lancement du serveur
|
||||||
|
|
||||||
|
Tout devrait être maintenant prêt pour pouvoir lancer le serveur :
|
||||||
|
|
||||||
|
```shell
|
||||||
|
python manage.py runserver --settings=local_settings
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
## Travailler sur le frontend
|
## Travailler sur le frontend
|
||||||
|
|
||||||
install bulma
|
install bulma
|
||||||
|
|
Loading…
Reference in a new issue