Différences

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

--- utilisateurs:fabux:brouillons:ikiwllatsinubfr [Le 06/09/2017, 13:10]
fabux Ajout pour install
+++ 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: @@
+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 conf-avalaible (faire save avant). 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>
-  *Install simple de [[:php]]. Bien activer cgi.fix dans php.ini Pour le moment V7 mais en 5 possible de mixer les deux avec http://drup.org/install-php-56-ubuntu-1604. L'install php5 passe à priori par un ppa et installe apache ou passer par [[:docker]].
-<note>Mix entre la doc et [[https://www.howtoforge.com/tutorial/installing-lighttpd-with-php7-php-fpm-and-mysql-on-ubuntu-16.04-lts/|ça]] pour que php info s'affiche
+===== 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>
-  * Install git puis suivre [[:groupes:ubuntu-fr-webteam:tester_les_outils]] --> FIXME git et plus bzr cf plus bas.
-<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"
+===== Installation de la documentation =====
-<file>server.document-root        = "/var/www/html/"</file>
+==== 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>
-<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.
+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/**.
-  * Parler chown www-data et chmod eventuellement
+<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>
-À minima il faut //static//, //doc// et //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 cepedant à garder en tête que certains liens peuvent ne pas marcher</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
-  * https://launchpad.net/ubuntu-fr-static <code>
+  * attic
-git clone https://git.launchpad.net/ubuntu-fr-static
+  * 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>
+<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>
+Vous aurez alors l'arborescence finale suivante :
+  * var/www/html/ubuntu-fr/ubuntu-fr-doc/
+    * bin/
+    * conf/
+    * data/
+    * inc/
+    * lib/
+    * vendor/
+    * doku.php
+    * index.php
+    * .htaccess.dist
+==== 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>
-  * Doc: https://launchpad.net/ubuntu-fr-doc <code>
-git clone https://git.launchpad.net/ubuntu-fr-doc</code>
-L'arborescence (avec lighgttpd) se présente ainsi:
+Le **seul** fichier de configuration à modifier sera **conf/local.protected.php**. Il est prioritaire sur **local.php**, qui lui-même supplante **dokuwiki.php**.\\
-  * /var/www/html/ubuntu-fr/
+Adaptez-le par exemple comme ceci
-    * ubuntu-fr-doc/
+<file php local.protected.php>
-        * bin
+<?php
-        * conf/
+/*
-        * data/
+ * Paramètres de configuration propres à votre serveur de travail
-        * inc/
+ * Attention les options principales sont dans local.php qu'il ne faut pas modifier
-        * lib/
+ * Penser à en faire une sauvegarde avant une màj
-        * vendor/
+*/
-        * doku.php
-        * index.php
+//Le fichier userscripts.js sert pour les bouton en mode édition (exemple modifier un fichier, installer un paquet)
-        * .htaccess.dist
-    *  ubuntu-fr-static
+//https://www.dokuwiki.org/fr:rewrite pour pas avoir doku.php?id=nompage
-        * css
+//https://www.dokuwiki.org/rewrite#discussion pour php
-        * images
+//0: pas de rewrite / 1:passe par lighttpd.conf/ 2:interne à dokuwiki
-        * lib
+//dans local.php ->= 1 car rewrite fait sur le serveur. Risque 404-not found en localhost
-        * scripts
+// donc:
-        * start
+$conf['userewrite'] = 2;
-        * style
-        * theme2010
+//passer en dev sinon ???
+$conf['is_dev'] = 1;
+//Gestion du thème
+//Choix du template
+//$conf['template']    = 'adoradark';
+//$conf['template']    = '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';
+ //Reactive toutes les actions
+$conf['disableactions']='';
+//* Gestion de connexion utilisateur pour le serveur de DEV.
+$conf['authtype']='authplain'; //pour la connexion sans la base du forum
+//remplir users.auth.php en faisant un sha1 sur le net.
+//par exemple le login+mdp y on été mis à testeur/testeur avec
+//testeur:0dd3d8466da1d1b581d8b1036f24ef43d37c7974:Moi:moi@nawak.og:members
+//pour être admin et pas simple user
+$conf['superuser']= 'testeur';
+// Suivi des modifications non nécessaires en DEV
+$conf['notify'] = '';
+</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>
+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 : Forbidden ====
+Vérifier la présence du dossier **data/** ainsi que les droits (utilisateur et groupe //www-data//) des différents fichiers et dossiers.
+==== 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 ====
+FIXME Erreur de configuration du serveur ?
+==== Problème de thème ====
+Vous avez bien le thème de la documentation ubuntu mais pas le contenu de la page.
+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//
-Modifier **local.protected.php** pour adapter comme suit <file>$conf['tpl']['ubuntu-2010']['static_host'] = '../ubuntu-fr-static/'</file>
+==== Ce site est inaccessible ====
-Usage lien relatif
+Mauvais paramétrage de **/etc/lighttpd/conf-available/15-fastcgi-php.conf**. Le modifier en conséquence pour php7 et relancer lighttpd
-Modifier **users.auth.php** <file>testeur:0dd3d8466da1d1b581d8b1036f24ef43d37c7974:Moi:moi@nawk.org:admin</file> SHA1 pour user testeur
+==== 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