Questionnaire Linux
===================

Ce projet consiste en un questionnaire permettant de déterminer
la distribution Linux (ou BSD) qui vous convient le plus.

Contact et support
------------------

### Gestion de projet

* [Redmine](https://lab.deblan.org/client/projects/linux-questionnaire)

### Arborescense du code

* [Redmine](https://lab.deblan.org/client/projects/linux-questionnaire/repository)
* [WebSVN](https://guest:guest@svn.deblan.org/websvn/listing.php?repname=linux-questionnaire)

### IRC

* Server: `ssl.neutralnetwork.org`
* Channel: `#wiki`
* [Web client](https://ssl.neutralnetwork.org/irc/?channels=%23wiki)

### Forum

* [Official topic](http://www.jeuxvideo.com/forums/1-38-7795760-1-0-1-0-questionnaire-choix-distribution.htm)

Prérequis
---------

* [PHP](https://www.php.net/) >= 5.4
* [Apache Subversion](https://subversion.apache.org/)
* [Composer](https://getcomposer.org/)

Installation
------------

    svn co https://svn.deblan.org/svn/linux-questionnaire
    cd linux-questionnaire
    make

Composer
--------

Composer est peut-être téléchargeable depuis votre gestionnaire de paquets.
Sinon, suivez les instructions suivantes :

### Téléchargement

    # Avec cURL
    curl -sS https://getcomposer.org/installer | php

    # Avec Wget
    wget -O - -q https://getcomposer.org/installer | php

Vous pouvez maintenant l'utiliser avec `php composer.phar [arguments]`.

### Exécutable

    mv composer.phar composer
    chmod +x composer

S'utilise désormais avec `./composer [arguments]`.

### Installation

En partant du principe que le dossier `~/bin` existe et est dans le `$PATH`.

    mv composer ~/bin

### Installation des dépendances (depuis `composer.lock`)

    composer install

### Mise à jour des dépendances (modification de `composer.lock`)

    composer update

Makefile
--------

Un Makefile est intégré pour automatiser certaines tâches.

* `make` installera les dépendances de l'application avec Composer,
* `make prod` installera les dépendances à l'exception de celles nécessaires
  seulement au développement, et lancera `make optimize`,
* `make optimize` exécutera le script d'optimisation de Composer pour convertir
  les chargements dynamiques de classes en *classmap*,
* `make cs` lancera un *code sniffer* PHP avec les conventions PSR-2.

Serveur de développement
------------------------

Vous pouvez utiliser le serveur de développement intégré à PHP, par exemple
sur `localhost`, port 8080 :

    cd web
    php -S localhost:8080

Mise à jour de la page d'accueil
--------------------------------

Quand les `README.*.md` sont modifiés, il faut aussi mettre à jour les
vues correspondantes dans `web/views/Questionnaire/readme.*.html.twig`.
Pour ça, un script a été créé.

### Aide

    app/console generate:readme -h

### Génération de base

    app/console generate:readme