✎ grav [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== Grav ======

Grav est un [[:CMS]] //flat file//. On entend par là qu'il n'utilise pas de base de données. Le contenu dynamique est stocké sous forme de fichiers [[wpfr>YAML|YAML]].

C'est actuellement un des CMS les plus simples à installer et à utiliser. Il propose une interface claire et moderne. [[https://getgrav.org/|Le site officiel]] est en anglais, mais l'interface d'administration est entièrement traduite en français.

Il propose de nombreuse fonctionnalités, en particulier via son [[https://getgrav.org/downloads/plugins|catalogue d'extensions]].

===== Installation =====

<note>Grav étant une solution destinée à être déployée sur un serveur, toutes les méthodes que nous traiterons ici feront intervenir uniquement la ligne de commande.</note>
==== Prérequis ====

Pour installer Grav vous aurez besoin d'un [[:web#serveurs|serveur HTTP]] et de [[:PHP]].

<note>Sur un hébergement web géré par l'hébergeur, ces prérequis devraient déjà être en place, donc toutes ces étapes devraient être inutiles.

N'hésitez pas à contacter le support de l'hébergeur si ce n'est pas le cas.</note>

[[:apache2|Apache]] est le serveur HTTP le plus couramment utilisé, c'est celui que nous choisirons ici.

Pour installer Apache et PHP :
<code>sudo apt install apache2 php libapache2-mod-php</code>

Grav requiert ensuite l'activation de certains modules PHP qui ne sont pas installés par défaut sous Ubuntu :
<code>sudo apt install php-curl php-gd php-intl php-json php-mbstring php-xml php-zip</code>

Grav a aussi besoin du module [[:apache2#mod_rewrite]] :
<code>sudo a2enmod rewrite</code>

Nous allons ensuite créer un [[:apache2#hotes_virtuels|hôte virtuel]] pour Grav, dont la racine sera ///var/www/grav// :
<code>sudo nano /etc/apache2/sites-available/grav.conf</code>
ouvre un fichier dans lequel nous allons coller :
<code><VirtualHost *:80>
        ServerName grav
        DocumentRoot /var/www/grav
        <Directory /var/www/grav>
                AllowOverride all
                Require all granted
        </Directory>
        ErrorLog /var/log/apache2/error.grav.log
        CustomLog /var/log/apache2/access.grav.log combined
</VirtualHost></code>
Si un nom de domaine pointe sur le serveur, on l'indique à la place de //grav// pour la directive //ServerName//.\\
(//Ctrl+X// puis //O// pour quitter en sauvegardant)

Finalement, on active l'hôte virtuel et on recharge la configuration d'Apache :
<code>sudo a2ensite grav
sudo systemctl reload apache2</code>

Si on a pas spécifié de vrai nom de domaine, on édite le fichier ///etc/hosts// côté client afin de renseigner l'IP du serveur pour le domaine //grav// :
<code>127.0.0.1	grav</code>

<note important>Si votre serveur est sur le [[:Web]], pensez à [[:apache2#securite|sécuriser]] l'accès au site en particulier en forçant [[:apache2#HTTPS]].</note>
==== Installation de Grav ====

Tout d'abord téléchargeons la dernière version de Grav :
<code>wget https://getgrav.org/download/core/grav-admin/latest</code>

Ensuite nous allons extraire le contenu du zip à la racine de notre hôte virtuel (///var/www/grav// pour l'exemple) :
<code>sudo unzip latest -d /var/www
sudo mv /var/www/grav-admin /var/www/grav</code>

Attribuons des [[:apache2#permissions|permissions correctes]] au fichiers et répertoires. Grav a besoin de conditions permissives afin de faciliter les mises à jours :
<code>sudo chown $USER:www-data /var/www/grav -R
sudo find /var/www/grav -type d -exec chmod 770 {} \;
sudo find /var/www/grav -type f -exec chmod 660 {} \;</code>

Grav devrait alors être accessible à l'adresse http://grav/

Il reste maintenant à renseigner un nom d'utilisateur, un email et un mot de passe pour l'administrateur du site.

Pour traduire l'interface en français, allez sur la page //Configuration//, restez sur l'onglet //System//, descendez jusqu'à //Languages// puis tapez //fr// (cliquez sur //add fr...//) dans le champs //Supported//.\\
Cliquez ensuite sur //Save// en haut à droite. Après actualisation votre interface devrait apparaître en français.
===== Utilisation =====

Le site est visible sur [[http://grav/]], l'interface d'administration est accessible sur [[http://grav/admin/]].

L'interface est limpide et permet entre autre de parcourir, d'installer et d'activer des thèmes et des plugins.

On peut éditer le contenu des pages depuis l'administration en cliquant sur //Pages// puis sur la page concernée. Le langage d'édition par défaut est le [[wpfr>Markdown]]. Il est possible de changer cela si ça ne vous convient pas, il existe par ex. un plugin //Admin Wysiwyg//, mais le Markdown reste probablement généralement la meilleure solution.

On gère l'ordre des éléments des menus par glisser-déposer depuis l'onglet //Avancé// des pages du même niveau. On structure l'arborescence du site en définissant le paramètre //Parent// de chaque page.

Les contenus modulaires peuvent être de plusieurs types. Il permettent principalement de diviser une page en plusieurs sections, ce qui rend possible par ex. la création de sites sur une seule page.

===== Liens utiles =====

* [[https://learn.getgrav.org/|Documentation officielle]] - Malheureusement seulement en anglais pour le moment.
  * [[:CMS|Autres CMS]]

----

//Contributeurs : [[:utilisateurs:krodelabestiole]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : F E W A B Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported