1===== À propos de l'élevage =====
2
3L'élevage est une technique qui permet, à partir d'une unique
4installation de DokuWiki, connue comme le <<fermier>>, de propulser
5un nombre quelconque d'autres wikis appelés les animaux. Vous installez les
6greffons et thèmes uniquement dans le fermier, et les rendez disponibles
7à votre guise dans des animaux. Il suffit de mettre à jour le wiki principal et
8tous les autres wikis, qui partagent la même base de code, sont également mis
9à jour.
10
11Après avoir complété cette étape de configuration, votre wiki actuel,
12celui que vous lisez en ce moment même, sera connu comme le <<fermier>>.
13
14===== Que fait cette initialisation ?  =====
15
16Cet assistant de configuration fera trois choses :
17
18  - Créer un fichier ''inc/preload.php'',
19  - créer un fichier ''conf/farm.ini''
20  - facultativement, ajouter un fichier ''.htaccess''.
21
22''preload.php'' est un fichier qui est chargé au tout début du chargement de DokuWiki.
23Là, le mécanisme de ferme est initialisé. Le greffon //farmer// détectera si la requête
24doit être adressée à un animal ou au fermier, et reconfigurera l'ensemble de manière
25appropriée.
26
27''conf/farm.ini'' contient les configurations de base du système de ferme. En particulier,
28ce fichier contient l'emplacement où les données des animaux seront
29enregistrées.
30
31La modification du fichier ''.htaccess'' permet de rendre accessible les animaux via
32le mécanisme ''!bang'' (voir ci-dessous).
33
34===== Que remplir ? =====
35
36Le **Dossier des animaux** est le dossier où un nouveau dossier est créé pour
37chaque nouvel animal. Ce dossier **doit** se trouver en dehors de l'arborescence
38de votre DokuWiki actuel. Vous pouvez utiliser un dossier relatif, tel que
39''../animaux'' ou un chemin absolu.
40
41Il est recommandé d'activer l'utilisation du fichier ''.htaccess''. Cette fonctionnalité
42nécessite un serveur [[https://httpd.apache.org/|Apache]] avec le module
43mod_rewrite et la prise en charge des fichiers .htaccess.
44
45Lorsque vous activez le .htaccess, les animaux sont accessibles sous l'URL du
46wiki fermier en utilisant le suffixe //!bang//. Par exemple, si votre fermier
47est accessible à l'URL
48''%%http://www.example.com/dokuwiki/%%'', l'animal toto sera accessible à
49l'URL ''%%http://www.example.com/dokuwiki/!toto%%''.
50
51Si vous n'activez pas ce mécanisme, vous devrez configurer votre serveur web
52et votre DNS pour pouvoir accéder aux animaux.
53