linux-questionnaire/README.fr.md
2015-03-02 20:07:17 +01:00

115 lines
2.8 KiB
Markdown

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