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