linux-questionnaire/views/Questionnaire/readme.fr.html.twig
2015-03-02 20:07:17 +01:00

132 lines
3.9 KiB
Twig
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="panel panel-default">
<div class="panel-heading"><h1>Questionnaire Linux</h1></div>
<div class="panel-body"><p>Ce projet consiste en un questionnaire permettant de déterminer
la distribution Linux (ou BSD) qui vous convient le plus.</p>{% block start %}{% endblock %}</div><ul class="list-group">
<li class="list-group-item"><h2>Contact et support</h2>
<h3>Gestion de projet</h3>
<ul>
<li><a href="https://lab.deblan.org/client/projects/linux-questionnaire">Redmine</a></li>
</ul>
<h3>Arborescense du code</h3>
<ul>
<li><a href="https://lab.deblan.org/client/projects/linux-questionnaire/repository">Redmine</a></li>
<li><a href="https://guest:guest@svn.deblan.org/websvn/listing.php?repname=linux-questionnaire">WebSVN</a></li>
</ul>
<h3>IRC</h3>
<ul>
<li>Server: <code>ssl.neutralnetwork.org</code>
</li>
<li>Channel: <code>#wiki</code>
</li>
<li><a href="https://ssl.neutralnetwork.org/irc/?channels=%23wiki">Web client</a></li>
</ul>
<h3>Forum</h3>
<ul>
<li><a href="http://www.jeuxvideo.com/forums/1-38-7795760-1-0-1-0-questionnaire-choix-distribution.htm">Official topic</a></li>
</ul>
</li><li class="list-group-item"><h2>Prérequis</h2>
<ul>
<li>
<a href="https://www.php.net/">PHP</a> &gt;= 5.4</li>
<li><a href="https://subversion.apache.org/">Apache Subversion</a></li>
<li><a href="https://getcomposer.org/">Composer</a></li>
</ul>
</li><li class="list-group-item"><h2>Installation</h2>
<pre><code>svn co https://svn.deblan.org/svn/linux-questionnaire
cd linux-questionnaire
make
</code></pre>
</li><li class="list-group-item"><h2>Composer</h2>
<p>Composer est peut-être téléchargeable depuis votre gestionnaire de paquets.
Sinon, suivez les instructions suivantes :</p>
<h3>Téléchargement</h3>
<pre><code># Avec cURL
curl -sS https://getcomposer.org/installer | php
# Avec Wget
wget -O - -q https://getcomposer.org/installer | php
</code></pre>
<p>Vous pouvez maintenant l'utiliser avec <code>php composer.phar [arguments]</code>.</p>
<h3>Exécutable</h3>
<pre><code>mv composer.phar composer
chmod +x composer
</code></pre>
<p>S'utilise désormais avec <code>./composer [arguments]</code>.</p>
<h3>Installation</h3>
<p>En partant du principe que le dossier <code>~/bin</code> existe et est dans le <code>$PATH</code>.</p>
<pre><code>mv composer ~/bin
</code></pre>
<h3>Installation des dépendances (depuis <code>composer.lock</code>)</h3>
<pre><code>composer install
</code></pre>
<h3>Mise à jour des dépendances (modification de <code>composer.lock</code>)</h3>
<pre><code>composer update
</code></pre>
</li><li class="list-group-item"><h2>Makefile</h2>
<p>Un Makefile est intégré pour automatiser certaines tâches.</p>
<ul>
<li>
<code>make</code> installera les dépendances de l'application avec Composer,</li>
<li>
<code>make prod</code> installera les dépendances à l'exception de celles nécessaires
seulement au développement, et lancera <code>make optimize</code>,</li>
<li>
<code>make optimize</code> exécutera le script d'optimisation de Composer pour convertir
les chargements dynamiques de classes en <em>classmap</em>,</li>
<li>
<code>make cs</code> lancera un <em>code sniffer</em> PHP avec les conventions PSR-2.</li>
</ul>
</li><li class="list-group-item"><h2>Serveur de développement</h2>
<p>Vous pouvez utiliser le serveur de développement intégré à PHP, par exemple
sur <code>localhost</code>, port 8080 :</p>
<pre><code>cd web
php -S localhost:8080
</code></pre>
</li><li class="list-group-item"><h2>Mise à jour de la page d'accueil</h2>
<p>Quand les <code>README.*.md</code> sont modifiés, il faut aussi mettre à jour les
vues correspondantes dans <code>web/views/Questionnaire/readme.*.html.twig</code>.
Pour ça, un script a été créé.</p>
<h3>Aide</h3>
<pre><code>app/console generate:readme -h
</code></pre>
<h3>Génération de base</h3>
<pre><code>app/console generate:readme
</code></pre>
</li></ul></div>