README.md 1.82 KB
Newer Older
Christophe Siraut's avatar
Christophe Siraut committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
dpconfig
========

*   [Apperçu](#user-content-apperçu)
*   [Fonctionnement](#user-content-fonctionnement)
*   [Développement](#user-content-développement)
    *   [Tests](#user-content-tests)
*   [Versions](#user-content-versions)

<h2 id="ap">Apperçu</h2>

Ce dépot contient le site web de Domaine Public.

<h2 id="fo">Fonctionnement</h2>

16
Le site utilise la dernière version de [Spip](http://www.spip.net/) avec des squelettes propres.
Christophe Siraut's avatar
Christophe Siraut committed
17
18
19

<h2 id="de">Développement</h2>

20
Pour tester ou modifier le site, vous pouvez cloner le projet:
Christophe Siraut's avatar
Christophe Siraut committed
21

22
    git clone git@gitlab.domainepublic.net:domainepublic/www.domainepublic.net.git
Christophe Siraut's avatar
Christophe Siraut committed
23

24
25
26
La commande `vagrant up` lance une machine virtuelle avec apache, mysql et
spip, et tente d'importer la base de donnée. Vous pouvez copier un *dump* de
la base-de-donnée via:
Christophe Siraut's avatar
Christophe Siraut committed
27

28
    scp ginger.domainepublic.net:/srv/domainepublic.sql .
Christophe Siraut's avatar
Christophe Siraut committed
29

30
Vous pouvez ensuite travailler en local. Le port HTTP de la machine virtuelle est redirigé vers:
Christophe Siraut's avatar
Christophe Siraut committed
31

32
    http://localhost:8000
Christophe Siraut's avatar
Christophe Siraut committed
33

34
Afin de pousserr vos modifications, demandez l'accès en écriture au dépot via gitlab.
Christophe Siraut's avatar
Christophe Siraut committed
35
36
37
38
39
40

<h3 id="te">Tests</h3>

Nous recommandons l'utilisation de *vagrant* pour tester les changements.

Avant de pousser une modification en production veuillez la tester dans une
41
machine virtuelle. Pour démarrer une machine virtuelle et servir le site:
Christophe Siraut's avatar
Christophe Siraut committed
42
43
44
45
46
47

    vagrant up

(note: la première fois que cette commande est invoquée, une image de debian de
300Mo est téléchargée)

48
Pour reconfigurer une machine virtuelle allumée, par exemple pour (ré)importer la base de données:
Christophe Siraut's avatar
Christophe Siraut committed
49
50
51
52
53
54
55
56
57

    vagrant provision

Pour se connecter à la machine:

    vagrant ssh

Plus d'info sur la documentation officielle de [vagrant](https://www.vagrantup.com/docs/)

58
59
60
61
62
<h3 id="so">Branches et sous-modules</h3>

Les développements de Pierre sont accessibles dans un sous-module:

    git submodule init