Différences

Ci-dessous, les différences entre deux révisions de la page.

--- utilisateurs:fabux:brouillons:ikiwllatsinubfr [Le 11/09/2017, 16:25]
fabux Note à la volée
+++ utilisateurs:fabux:brouillons:ikiwllatsinubfr [Le 11/09/2022, 13:14] (Version actuelle)
moths-art Suppression des espaces en fin de ligne (détecté et corrigé via le bot wiki-corrector (https://forum.ubuntu-fr.org/viewtopic.php?id=2067892)
@@ Ligne 1: / Ligne 1: @@
-[[:groupes:ubuntu-fr-webteam:tester_les_outils]]
+FIXME tag
+----
+====== Installation complète de la documentation ubuntu-fr en local ======
-====== Install doc local ======
+L'objectif de cette page est de mettre en place l'outil complet de la documentation sur une machine en local pour :
+  * faire des tests de plugins
+  * installer et tester des thèmes comme expliqué sur [[:utilisateurs:fabux:emeht|cette page]] qui fait suite à celle-ci
+  * faire des essais d'export
+  * connaître un peu plus les arcanes du système
+  * ...
+et pourquoi pas [[:groupes:ubuntu-fr-webteam#comment_nous_aider|nous aider]] à signaler un bug et améliorer le code.
-  *Install virtualbox
+<note important>Si vous souhaitez uniquement avoir une version légère de la documentation, et ce sans connexion internet, orientez-vous plutôt vers l'[[http://download.kiwix.org/zim/other/ubuntudoc_fr_all_2015-12.zim|archive Zim]] qui fait à peine 500Mo mais date de décembre 2015.</note>
-  *install Lubuntu desktop
-  *Addons sur guest pour partage fichier et plein ecran
-  * Update/upgrade
-  *Pour faire marcher [[https://www.dokuwiki.org/requirements|dokuwiki]] il faut un serveur qui supporte php. [[:Lighttpd]] semble plus léger qu'apache. Modifier les fichiers //10-fastgi.conf// et //15-fastcgi-php.conf// dans **/etc/lighttpd/conf-avalaible** (faire save avant) comme indiqué sur la page. Recharger les modules et relancer lighttpd
+<note tip>Pour préserver votre environnement, vous pouvez mettre en place ce qui suit sur [[:virtualbox]]. Cette méthode a d'ailleurs été testé en 64bits sur [[:Lubuntu]] desktop et [[:Budgie]].</note>
-  *Installation minimale de [[:php]]. (7.0) . FIXME Ajouter le [[:services|service]] //php7.0-fpm// au démarrage du système.<code>sudo systemctl enable php7.0-fpm.service</code>
-  * Installer [[:git ]]
-<note important>Pour la suite, les fichiers seront  placés dans ''/var/www/html/ubuntu-fr'' et non ''/var/www/ubuntu-fr'' ou alors définir dans **/etc/lighttpd/lighttpd.conf** le bon "document-root"
+===== Pré-requis =====
+Pour faire marcher [[https://www.dokuwiki.org/requirements|dokuwiki]], il faut :
+  * Un serveur qui supporte php. Pour la suite [[:Lighttpd]] a été choisi pour sa légèreté.
+    * Modifier les fichiers //10-fastgi.conf// et //15-fastcgi-php.conf// dans **/etc/lighttpd/conf-avalaible** (en faire une [[:tutoriel:comment_sauver_et_restaurer_un_fichier|sauvegarde]] avant) comme indiqué sur la page du serveur.
+    *  Recharger les modules et relancer lighttpd
+  * Installation minimale de [[:php]]. Pour la suite il s'agira de la version 7.0.
+  * Installer [[:git]].
+<note important>Pour la suite, les fichiers seront placés dans ''/var/www/html/ubuntu-fr'' et non ''/var/www/ubuntu-fr'' ou alors définir dans **/etc/lighttpd/lighttpd.conf** le bon " document-root "
 <file>server.document-root        = "/var/www/html/"</file>
 </note>
-<note tip>
-  * voir plus tard si ça marche dans un dossier Home avec peut-être des ln. Pour le moment tout dans /var/www/html/ubuntu-fr.\\ Avec l'option $conf['savedir'] = './data'; ça devrait le faire si data est un lien symbolique vers /lieu/des/datas et les bon droits.
+===== Installation de la documentation =====
+==== Les fichiers ====
+Il faudra évidemment les fichiers de la //doc// accessible depuis [[https://launchpad.net/ubuntu-fr-doc|sa page launchpad]].\\
+Depuis le dossier où vous souhaitez installer la documentation (ici ** /var/www/html/ubuntu-fr/**), saisissez dans un [[:terminal]] la [[:commande_shell|commande]] suivante :
+<code>
+git clone https://git.launchpad.net/ubuntu-fr-doc</code>
+<note important>En cas de message d'erreur réessayez après avoir ajouté ceci dans **~/.gitconfig** <file>[url "git+ssh://VotreNomSurLP@git.launchpad.net/"]
+        insteadof = lp:
+[user]
+        email = votreEmail@hebergeur.com
+        name = VotreNomSurLP
+</file>Suivi de <code>source .gitconfig</code>
+</note>
+Il faudra également le dossier des données nommés //data//. Ce dossier au format //[[:tar|.tar.gz]]// ((environ 4Go à demander auprès des administrateurs)) sera à [[:archivage#graphiquement|décompresser]] dans le dossier précédemment créé, à savoir **/var/www/html/ubuntu-fr/ubuntu-fr-doc/**.
+<note tip>Il est possible de positionner les données dans un autre dossier et faire un lien symbolique vers celui-ci nommé **data** <code>ln -s /lieu/des/datas data</code> Attention cependant aux [[:droits]].
+Il existe aussi la solution de modifier dans le fichier **local.protected.php** la ligne ''$conf['savedir'] = './data';''\\
+Dans ce cas également "data" peut-être un lien symbolique vers le dossier contenant les données.
+</note>
+<note tip>À des fins de test uniquement, le dossier //data// doit au minimum contenir les répertoires suivants, même s'ils sont vides
+  * attic
+  * cache
+  * index
+  * locks
+  * media
+  * media_attic
+  * media_meta
+  * meta
+  * pages
+  * tmp
+Vous n'aurez dans ce cas aucune page de la documentation, à moins de copier/coller le contenu depuis le site en ligne.
 </note>
-  * À minima il faudra ensuite évidemment les fichiers de la //doc// accessible depuis [[https://launchpad.net/ubuntu-fr-doc|sa page launchpad]] <code>
+<note>Vous pouvez-ajoutez [[https://launchpad.net/ubuntu-fr-guide|Guide]] et [[https://launchpad.net/ubuntu-fr-tour|Tour]] mais pour avoir une installation minimale de la doc ce n'est pas utile. Attention cependant à garder en tête que certains liens peuvent ne pas marcher</note>
-git clone https://git.launchpad.net/ubuntu-fr-doc</code>et le dossier //data// (tar.bz du dictateur de la doc -cf framateam)
-<note>Vous pouvez-ajoutez [[https://launchpad.net/ubuntu-fr-guide|Guide]] et [[https://launchpad.net/ubuntu-fr-tour|Tour]] mais pour avoir une installation minimal de la doc ce n'est pas utile. Attention cependant à garder en tête que certains liens peuvent ne pas marcher</note>
-  * Modifiez les [[:droits]] <code>sudo chown -R www-data:www-data /var/www/html/ubuntu-fr
+Vous aurez alors l'arborescence finale suivante :
-sudo chmod -R ug+rw /var/www/html/ubuntu-fr</code>
+  * var/www/html/ubuntu-fr/ubuntu-fr-doc/
+    * bin/
-Vous aurez l'arborescence finale comme suit
-  * /var/www/html/ubuntu-fr/ubuntu-fr-doc/
-    * bin
     * conf/
     * data/
@@ Ligne 38: / Ligne 78: @@
     * .htaccess.dist
-Modifier **le fichier conf/local.protected.php** pour adapter comme suit <file>
+==== Paramétrage ====
+Modifiez les [[:droits]] sinon vous risquez d'avoir des [[#erreurs]]
+<code>
+sudo chown -R www-data:www-data /var/www/html/ubuntu-fr
+sudo chmod -R ug+rw /var/www/html/ubuntu-fr
+</code>
+Le **seul** fichier de configuration à modifier sera **conf/local.protected.php**. Il est prioritaire sur **local.php**, qui lui-même supplante **dokuwiki.php**.\\
+Adaptez-le par exemple comme ceci
+<file php local.protected.php>
 <?php
 /*
  * Paramètres de configuration propres à votre serveur de travail
  * Attention les options principales sont dans local.php qu'il ne faut pas modifier
- * Penser à le save avant une màj
+ * Penser à en faire une sauvegarde avant une màj
 */
@@ Ligne 57: / Ligne 106: @@
 //passer en dev sinon ???
-//$conf['is_dev'] = 1;
+$conf['is_dev'] = 1;
 //Gestion du thème
-// Choix du template
+//Choix du template
 //$conf['template']    = 'adoradark';
 //$conf['template']    = 'dokuwiki';
-//Lieux du template (pas trouvé comment mettre en local donc usage des severs pour le template, sinon choisir au dessus dokuwiki
+//Lieux du template (pas trouvé comment mettre en local donc usage des servers pour le template, sinon choisir au dessus dokuwiki
 //$conf['tpl']['ubuntu-2010']['static_host'] = '//www-static.ubuntu-fr.org';
@@ Ligne 84: / Ligne 133: @@
 </file>
+Modifier **users.auth.php** en vous basant sur  **users.auth.php.dist** si vous souhaitez avoir un utilisateur de connecté. Ici le nom choisi est //testeur// en login. La suite alphanumérique est le résultat en SHA1 du mot de passe qui est également //testeur//.
+<file>testeur:0dd3d8466da1d1b581d8b1036f24ef43d37c7974:Moi:moi@nawk.org:admin</file>
-Modifier **users.auth.php** <file>testeur:0dd3d8466da1d1b581d8b1036f24ef43d37c7974:Moi:moi@nawk.org:admin</file> SHA1 pour user testeur
+Pour chiffrer votre mot de passe aller [[http://md5encrypt.net/sha1-encryption/#menu-item-24|ici]].
+À vous de faire vos essais ensuite, comme [[:utilisateurs:fabux:emeht|installer un autre thème]] si vous le souhaitez: vous êtes chez vous 8-)
 =====  Erreurs =====
 ==== Page blanche ====
+Il peut s'agir de :
+  * un mauvais réglage dans le fichier **conf/local.protected.php**. Vérifiez que vous n'avez pas oublié un ''$''  ou un '';'' ou encore fais usage d'un mauvais paramètre.
+  * l'absence du paquet [[apt>php-xml]]. (notamment pour les actions sur les pages)
+  * un [[#probleme_de_theme|problème de thème]]
-==== 403 ====
+==== 403 : Forbidden ====
-Problème de server.directory.root
+Vérifier la présence du dossier **data/** ainsi que les droits (utilisateur et groupe //www-data//) des différents fichiers et dossiers.
-==== 404 ====
-Passer le userewrite à 0
+==== 404 : Not Found ====
+Passer le ''userewrite'' à 0 dans **local.protected.php**. Vérifier également la valeur de //server.document-root// (s'il s'agit de [[:Lighttpd]] dans **/etc/lighttpd/lighttpd.conf**)
 ==== Access Denied ====
-conf du serveur?
+FIXME Erreur de configuration du serveur ?
-==== Problème de template ====
+==== Problème de thème ====
-Vous avez le template mais pas le contenu de la page. Modifier pour avoir la valeur <file>$conf['template'] = 'dokuwiki';
+Vous avez bien le thème de la documentation ubuntu mais pas le contenu de la page.
-</file>
+Commencer par modifier le fichier **local.protected.php** pour avoir la valeur
+<file>$conf['template'] = 'dokuwiki';</file>
+Si vous retrouvez la page c'est que le [[:services|service]] //php7.0-fpm// n'a pas été démarré comme indiqué dans le [[#pré-requis]].
+<note tip>Vous pouvez rester avec le thème dokuwiki, mais attention dans ce mode certaines extensions peuvent fonctionner mais pas avec le template ubuntu.</note>
+Si vous avez toujours le problème, vérifier dans le fichier **/etc/php/7.0/fpm/php.ini** que vous avez bien les valeurs suivantes
+<file>;cgi.fix_pathinfo=1</file>et
+<file>;short_open_tag = Off</file>
+<note important>Les **;** en début de ligne doivent être présents</note>
+En cas de modification, relancer les services //php7.0-fpm// et //lighttpd//
+==== Ce site est inaccessible ====
+Mauvais paramétrage de **/etc/lighttpd/conf-available/15-fastcgi-php.conf**. Le modifier en conséquence pour php7 et relancer lighttpd
+==== 503 - Service Not Available ====
+Le [[:services|service]] //php7.0-fpm// n'est pas démarré. Essayez
+<code>sudo service php7.0-fpm start</code>
+Si besoin ajoutez-le au démarrage du système.<code>sudo systemctl enable php7.0-fpm.service</code>
+==== Writing plugins.local.php failed ====
+Le dossier **data/** n'a pas les bons droits
+===== Sources =====
+  * [[:groupes:ubuntu-fr-webteam:tester_les_outils|Tester les outils]]
+  * [[https://www.howtoforge.com/tutorial/installing-lighttpd-with-php7-php-fpm-and-mysql-on-ubuntu-16.04-lts/|Installer lighttpd et php7]] **<sup>(en)</sup>**
-===== But =====
+----
-  * voir difficulté d'installation
+//Contributeur: [[:utilisateurs:Fabux]]//
-  * voir installation et test de plugin
-  * test export