{{tag>tutoriel}}

====== Ferme dokuwiki avec dokuwiki-downloader.php et farmer ======

===== Pré-requis =====

Installez un Dokuwiki pour le fermier
<subnumberlist>
  - Ajoutez une ligne à /etc/hosts :<code - /etc/hosts>127.0.1.1	dokuwiki.localhost</code>
  - serveur nginx sur localhost (racine /var/www/html) :<code - /etc/nginx/sites-available/localhost>
# Sites dokuwiki
server {
    listen 80;

    server_name  ~^(?P<sub>doc|perso|magie|kine|dokuwiki)\.localhost$;
    root /var/www/html/$sub;
    
	location / {
		index index.php index.html index.htm dokuwiki-downloader.php;
		try_files $uri $uri/ =404;
	}

	location ~ \.php$ {
		include snippets/fastcgi-php.conf;
		fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
	}

	location ~ /(data|conf|bin|inc)/ {
		deny all;
	}

	location ~ /\.ht {
			deny all;
	}
}
</code>
  - Pensez à relancer nginx
  - Ouvrez Filezilla sur localhost :
    - Créez un répertoire dokuwuki dans la racine
    - Envoyez-y dokuwiki-downloader.php
  - Lancez [[http://localhost/dokuwiki/]]
    - cliquez sur <key>Step 1: Download the TGZ =></key> :{{ :tutoriel:dokuwiki:ferme:ferme_001.jpg?400 |}}
    - cliquez sur <key>Step 2: Extract the TGZ =></key> :{{ :tutoriel:dokuwiki:ferme:ferme_002.jpg?400 |}}
    - cliquez sur <key>Step 3: Clean Up =></key> :{{ :tutoriel:dokuwiki:ferme:ferme_003.jpg?400 |}}Le site s'ouvre sans page de démarrage :{{ :tutoriel:dokuwiki:ferme:ferme_004.jpg?400 |}}
</subnumberlist>

===== Première étape =====

Configurez votre wiki fermier :
<subnumberlist>
  - Lancez l'installateur :[[http://dokuwiki.localhost/install.php]]
    - **Choisissez votre langue:** fr et cliquez sur <key>Mettre à jour</key>
    - Remplissez le formulaire et cliquez sur <key>Enregistrer</key>{{ :tutoriel:dokuwiki:ferme:ferme_005.jpg?400 |}}
    - Avec Filezilla, effacez install.php. Cliquez sur **Continuer avec __votre nouveau wiki__** :{{ :tutoriel:dokuwiki:ferme:ferme_006.jpg?400 |}}
  - Votre nouveau wiki s'ouvre. Comme c'est un wiki fermé, connectez-vous et cliquez sur <key>S'identifier</key> :{{ :tutoriel:dokuwiki:ferme:ferme_007.jpg?400 |}}
  - La page de présentation s'affiche :{{ :tutoriel:dokuwiki:ferme:ferme_008.jpg?400 |}}
  - Cliquez sur __Administrer__ (en haut) et ouvrez le **Gestionnaire d'extensions**, onglet **Rechercher et installer** et installez :
    - **vector** (le thème)
    - le plugin **farmer**
    - tous les autres plugins de la ferme
  - Cliquez sur __Administrer__ (en haut) et ouvrez les **Paramètres de configuration** et réglez tous les paramètres :
    - **thème** : vector
    - **Niveau maximum pour figurer dans la table des matières** : 4
    - **Niveau maximum pour modifier des sections** : 4
    - **Utiliser le titre de premier niveau pour le nom de la page** : Toujours
    - **Manager:- groupe, utilisat...**
    - **Active l'API système distante...** : coché
    - **Restreindre l'accès à l'API...** : nom de l'admin
    - plugin QnA, style : Symbols
    - Paramètres du thème : **Charger 'vector/user/user.js' ?** : coché
  - Avec Filezilla :
    - Mettez dans user : logo.jpg, user.js, screen.css, print.css
    - Éditez lib/scripts/edit.js pour annuler le rétrécissement des icones
</subnumberlist>

===== Autres étapes =====

==== Gestion de l'élevage ====

Revenez à l'administration et cliquez sur **Élevage**
<subnumberlist>
  - **Dossier des animaux** : ../animaux comme suggéré puis cliquez sur <key>Envoyer</key> :{{ :tutoriel:dokuwiki:ferme:ferme_009.jpg?400 |}}
  - **Configuration** : Tous les réglages faits ici sont enregistrés dans le fichier conf/farm.ini du fermier.
    - **Configuration de base** :
      - **Nom d'hôte du fermier** : réglé automatiquement à l'initialisation, mais on peut le changer. Il sera utilisé pour déterminer si une requête est dirigée directement vers le fermier, lors de l'utilisation d'une ferme par nom. Ce devrait être un FQDN, toto.example.com au lieu de simplement toto.
      - **Domaine de base pour les animaux par sous-domaine** : par ex. ferme.parc -> un animal nommé doc est joignable via doc.ferme.parc, à condition que doc.ferme.parc soit associé à localhost par le dns ou le fichier hosts ((Le Domaine de base est simplement ajouté aux noms des animaux ne contenant aucun point))
    - **Réglage dont les animaux vont hériter** : les réglages configurés dans le fermier être utilisés comme valeurs par défaut dans les animaux. Les animaux peuvent toujours écraser ces réglages dans leurs propres fichiers de configuration. Lorsque l'héritage est désactivé, les valeurs par défaut de DokuWiki sont également les valeurs par défaut pour les nouveaux animaux.
  - **Ajouter un animal** :
</subnumberlist> 
===== Conclusion =====

===== Problèmes connus =====

===== Voir aussi =====

  * **(en)** [[http://]]
  * **(fr)** [[http://]]

----
//Basé sur << [[http://|ARTICLE]] >> par AUTEUR.//