Comment copier des modèles sur votre wiki

*Note : Cette page sert de manuel détaillé pour la reproduction de modèles, dans la continuité de la section Copie et mise à jour des modèles de Aide:Modèles. Consultez cette page pour un guide simplifié.*
Modèle:Voir aussi
Les contributeurs ont créé toutes sortes de modèles sur Fandom. Il est souvent plus simple de copier un modèle existant et de le modifier en fonction de vos besoins que d'en créer un à partir de zéro. Dans la plupart des cas, vous êtes libre de copier des modèles d'autres wikis Fandom. Il est indispensable de mentionner le nom de la communauté dont vous avez copié le modèle.

Ce guide en 5 étapes vous montrera un guide détaillé sur **comment copier un modèle sur votre wiki**.

## Étape 1 : Trouver un modèle

Avant de copier un modèle, vous devez d'abord en trouver un ! Si vous en avez déjà un, passez cette étape. Sinon, poursuivez votre lecture.

Il existe de nombreux endroits où trouver des modèles. Par exemple, ce wiki, le Dev Wiki, et d'autres encore. Consultez Aide:Modèles#Où trouver plus de modèles pour d'autres suggestions endroits où trouver des modèles.

Notez que bien que vous puissiez copier des modèles provenant de Wikipédia et d'autres grands wikis (comme Wiki Minecraft, Wiki Star Wars, et autres), vous ne devriez pas vraiment faire cela *à moins* que vous ayez le temps de trouver l'ÉNORME arbre de dépendances des modèles. Vous allez soit : copier tout l'arbre de dépendance (en gros chaque modèle) sur ce wiki, avoir un tas de modèles cassés ou passer beaucoup de temps à les réajuster pour qu'ils fonctionnent sans ces dépendances. Vous aurez simplement besoin de beaucoup d'efforts pour faire cela. Il vaut mieux que vous "appreniez" de ce wiki et que vous fassiez vos modèles "basés sur" le code de ce wiki. Cela dit, si vous le voulez vraiment, vous pouvez le faire. C'est juste un gros défi.

## Étape 2 : Analyser le modèle

**Note importante :** Certains modèles, comme sur Wiki Modèles et le wiki des développeurs Fandom (Dev Wiki), ont des instructions sur la façon de copier le modèle. Il est *fortement* recommandé de suivre ces instructions car ce guide est seulement général. S'il y a des instructions, n'hésitez pas à quitter ce guide ! Vous pouvez toujours revenir ici si vous avez besoin d'aide.
Après avoir trouvé le modèle, vous devez l'analyser et déterminer les éléments suivants :

* Ce qu'il fait
* Comment l'utiliser
* Ses dépendances (sous-modèles, Lua, extensions, etc.)

Il est fortement recommandé de savoir *comment fonctionne le modèle* car cela peut vous donner un avantage lorsque quelque chose ne fonctionne pas et que vous avez déjà copié le modèle. Si le modèle a une page de documentation, vous devriez la lire car il s'agit d'un guide "pré-écrit" sur le fonctionnement du modèle. La documentation peut également aider les autres utilisateurs lorsqu'ils utilisent le modèle. Même avec la documentation, il est préférable de regarder le code du modèle et de le découvrir par vous-même.

Si le modèle a des dépendances CSS ou JS, notez le. Elles seront copiées plus tard, mais ce n'est pas une priorité pour l'instant.

Vous devriez avoir une liste/notes avec quelque chose comme :

```
Modèle à copier : Modèle:Exemple
Wiki : https://exemple.fandom.com/fr

Dépendances :
* Modèle:Foo
* Modèle:Bar
* Module:Bar
* (pages de documentation)

```

Une fois que vous en savez plus sur le modèle et que vous avez dressé une liste comme ci-dessus, vous pouvez procéder à sa copie.

## Étape 3 : Copier le modèle (et ses dépendances)

Maintenant que vous avez (si tout va bien) trouvé un modèle et que vous l'avez analysé, il est temps de le copier ! Il y a 2 méthodes...

* **Exporter/importer les modèles**. C'est la méthode recommandée car elle préserve l'historique des contributions et est aussi une méthode rapide.
* **Copier/coller manuellement les modèles**. Un peu plus lent, mais fonctionne partout.

Voici un tableau comparatif à ce sujet :

 Rapidité et facilité de la reproduction
 Droits requis
 Avantages
* Possibilité d'exporter/importer plusieurs modèles à la fois
 Inconvéniants
* Plus facile d'ignorer les dépendances
* Peut être plus compliqué et prendre plus de temps, en particulier avec des modèles multiples ou de nombreux sous-modèles.

Une fois que vous avez choisi une méthode, poursuivez en fonction, comme suit :

### Méthode 1 : Exporter puis importer

Si vous choisissez cette méthode, c'est *vraiment* simple à suivre.

#### Exporter le modèle et ses dépendances

1. D'abord, reprenez la liste que vous aviez réaliser plus tôt.
2. Puis, rendez-vous sur Spécial:Exporter du wiki source (le wiki d'où vient le modèle d'origine). Par exemple, si je veux copier un modèle provenant de "exemple.fandom.com/fr", je me rends simplement sur `https://exemple.fandom.com/fr/wiki/Spécial:Exporter`.
3. Copiez la liste que vous avez réalisée avec le modèle original ET la liste de ses dépendances (en retirant les puces) dans l'énorme zone de texte. Assurez-vous de laisser l'ensemble des paramètres par défaut ! Donc, en reprenant l'exemple ci-dessus, la zone de texte devrait contenir :

```
Modèle:Exemple
Modèle:Foo
Modèle:Bar
Module:Bar
Modèle:Exemple/doc
Modèle:Foo/doc
Modèle:Bar/doc
Module:Bar/doc

```

1. Cliquez sur Exporter et le téléchargement d'un fichier XML devrait se lancer. Une fois le téléchargement terminé, passez à l'étape suivante.

#### Importer le modèle et ses dépendances

1. Assurez d'avoir le fichier créé tout à l'heure.
2. Rendez-vous sur Spécial:Importer sur votre wiki (le wiki cible). Par exemple, si votre wiki est nommé "foobar.fandom.com/fr", allez simplement sur `https://foobar.fandom.com/fr/wiki/Spécial:Importer`.
3. Dans le formulaire de la page, complétez comme suit :
	1. Nom du fichier : Cliquez sur "Sélectionner un fichier" puis choisissez le fichier XML.
	2. Préfixe interwiki : Saisissez `w:c:<code interwiki>` (le code interwiki est le sous-domaine)
		* [Si le modèle provient d'une communauté anglophone] donc pour "exemple.fandom.com", c'est `w:c:exemple`.
		* [Si le modèle provient d'une communauté non-anglophone] donc pour "exemple.fandom.com/fr", c'est `w:c:fr.exemple`.
	3. Commentaire : Ajoutez un commentaire, comme `Provient de [[w:c:<interwiki code>:Modèle:<modèle>]], ainsi que de ses dépendances et documentation`. Il existe d'autres façons de créditer correctement le wiki, que nous aborderons dans *Étape 4 : Terminer le modèle*.
	4. Laissez tout le reste inchangé.
4. Cliquez sur Téléverser le fichier. Puis, voilà, c'est fait !

### Méthode 2 : Copier puis coller

C'est *bien plus* compliqué que la méthode précédente puisque vous devez tout faire manuellement, avec un plus grand nombre d'étape :

1. Créer des bases de pages sur le wiki cible
2. Ouvrir les pages sur le wiki source
3. Copier le contenu de la page une par une du wiki source vers la page correspondante sur le wiki cible
4. Répéter jusqu'à ce que tout soit fait.

#### Créer des bases de pages sur le wiki cible

1. Créez différents onglets avec l'URL de votre wiki **cible** ET ajoutez les pages à copier à la fin de l'URL. Ainsi, pour voir le texte à copier depuis Wiki Exemple, vous devez créer 8 onglets aux adresses suivantes :

```
exemple.fandom.com/fr/Modèle:Exemple
exemple.fandom.com/fr/Modèle:Foo
exemple.fandom.com/fr/Modèle:Bar
exemple.fandom.com/fr/Module:Bar
exemple.fandom.com/fr/Modèle:Exemple/doc
exemple.fandom.com/fr/Modèle:Foo/doc
exemple.fandom.com/fr/Modèle:Bar/doc
exemple.fandom.com/fr/Module:Bar/doc

```

1. Cliquez sur le bouton "Modifier" ou le lien "Créer cette page" sur l'ensemble des pages réparties dans les onglets
2. Passez à l'étape suivante

#### Ouvrir les pages sur le wiki source

1. Doublez le nombre d'onglets ouverts en utilisant cette fois l'URL de votre wiki **source** ET ajoutez les pages à copier à la fin de l'URL. Ainsi, pour importer sur Wiki FooBar, vous devez créer 8 onglets aux adresses suivantes :

```
foobar.fandom.com/fr/Modèle:Exemple
foobar.fandom.com/fr/Modèle:Foo
foobar.fandom.com/fr/Modèle:Bar
foobar.fandom.com/fr/Module:Bar
foobar.fandom.com/fr/Modèle:Exemple/doc
foobar.fandom.com/fr/Modèle:Foo/doc
foobar.fandom.com/fr/Modèle:Bar/doc
foobar.fandom.com/fr/Module:Bar/doc

```

1. Cliquez sur le bouton "Modifier" sur l'ensemble des pages réparties dans les onglets. Mais ne faites rien d'autre pour l'instant !

#### Copier le contenu de la page une par une du wiki source vers la page correspondante sur le wiki cible

1. Sur le wiki source, copiez le contenu et collez-le sur la page correspondante du wiki cible. En reprenant notre exemple, vous devez copier le contenu de `exemple.fandom.com/fr/Modèle:Exemple` et le coller sur `foobar.fandom.com/fr/Modèle:Exemple`.
2. Dans le résumé des modifications, *mentionnez le wiki source*. Par exemple, en tapant `Provient de [[w:c:<interwiki code>:Modèle:<modèle>]], ainsi que de ses dépendances et documentation`. Il existe d'autres façons de créditer correctement le wiki, que nous aborderons dans *Étape 4 : Terminer le modèle*.
3. Enregistrez vos modifications sur le wiki cible.
4. Reproduisez le processus avec les pages à copier suivantes. En reprenant notre exemple, vous devez maintenant copier le contenu de `exemple.fandom.com/fr/Modèle:Foo` et le coller sur `foobar.fandom.com/fr/Modèle:Foo`.
5. Répéter le processus autant de fois que nécessaire, jusqu'à ce que tout soit fait.

## Étape 4 : Terminer le modèle

Bravo, vous avez copié le modèle (à l'aide de l'une ou l'autre méthode) ! Mais il se peut qu'il y ait des liens rouges ou des modèles manquants (= modèles demandés), ou que le modèle ne soit pas stylisé. Nous devrions essayer d'y remédier !

### Se débarrasser des liens rouges et modèles demandés

Vous pouvez vous débarrasser des liens rouges des manières suivantes :

* Retirer l'ensemble des liens rouges
* Les transformer en interwiki(s) (voir Aide:Lien\_interwiki#Créer\_un\_lien\_vers\_une\_autre\_communauté\_Fandom)
* Créer les pages (si utiles)

En revanche, concernant les modèles demandés (qui sont très fréquent sur les pages /doc)...

* Si le modèle n'est pas essentiel ou si vous pensez qu'il n'est pas nécessaire, vous pouvez simplement le supprimer.
* Si vous disposez d'un modèle de remplacement, utilisez-le à la place ! Les plus courants consistent à remplacer `{{tl}}`, `{{tlx}}` ou `{{t}}` par `{{m}}` et `{{annonce}}` par `{{Mbox}}`.

### Installer les extensions

Si vous avez suivi correctement toutes les étapes mais que vous vous retrouvez face à du texte étrange identique ou similaire à "<dpl>" or "{{#var:}}" en résultat, il est très probable que le modèle nécessite une extension. Dans le cas présent, le modèle ci-dessus nécessite DPL et Variables. Vous devez contacter le staff pour activer ces extensions ou demander à votre Représentant de Wiki si vous en avez un. Pour plus d'informations, voir Aide:Extensions.

### Copier du CSS ou JS

Si le modèle semble "non stylisé", "destructuré" ou n'est pas *aussi* engageant, vous aurez besoin d'installer du CSS/JS. Nous aborderons ces points de manière succincte mais *Fandom Developers Wiki* propose un guide plus détaillé sur la page Installation.

#### CSS

Pour les modèles avec un lien vers une sous-page `.css`, exporter et importer cette page sur votre wiki. Ajoutez l'import à une page de css principale (ex : Common.css, Fandomdesktop.css ou FandomMobile.css) en suivant les instructions de la page Installation sur Wiki Dev, et voilà !

S'il n'y en a pas, regardez le code du modèle et cherchez quelque chose de similaire à `class=*"foobar"*`. Après avoir trouvé cette classe, regardez la page MediaWiki:Common.css du wiki. Cherchez `foobar` (qui correspond à ce que vous avez trouvé dans le code du modèle) dans le code CSS et copiez cette classe. Par exemple :

```
/\* Classe Foobar \*/
.foobar {
 display:inline;
 border:2px solid green;
}
/\* Mini classe \*/
.foobar .box {
 color:red;
}

/\* Infobox \*/
.pi-infobox {
 padding:10px;
...

```

Copiez toutes les parties liées à `foobar` sur la page `common.css` *de votre wiki*. Assurez-vous de **créditer le wiki que vous avez copié.** Vous pouvez les créditer en utilisant un résumé de modification comme `Provient de [[w:c:<interwiki code>:MediaWiki:Common.css]], ainsi que de ses dépendances et documentation`. Il existe d'autres façons de créditer correctement le wiki, voir la section suivante.

#### JS

Note : Vous devrez activer le JavaScript de la communauté pour pouvoir utiliser du JS sur le wiki.
Pour les modèles avec un lien vers une sous-page `.js`, exporter et importer cette page sur votre wiki ou ajoutez l'import à une page de css principale (ex : Common.css, Fandomdesktop.css ou FandomMobile.css) en suivant les instructions de la page Installation sur Wiki Dev, et voilà !

S'il n'y en a pas, regardez le code du modèle et cherchez quelque chose de similaire à `class=*"foobar"*`. Après avoir trouvé cette classe, regardez la page MediaWiki:Common.js du wiki. Cherchez `foobar` (qui correspond à ce que vous avez trouvé dans le code du modèle) dans le code JS et copiez cette classe. Par exemple :

```
/\* Code Foobar \*/
function foobarCode() {
 let foobar = document.getElementByClassName("foobar");
 foobar.style.fontSize = "10px";
};

/\* Code principal \*/
...

```

**Note :** Certaines pages JS peuvent être complexes. N'hésitez pas à demander des explications aux administrateurs du wiki copié dans ces cas là.

Copiez toutes les parties liées à `foobar` sur la page `common.js` *de votre wiki*. Assurez-vous de **créditer le wiki que vous avez copié.** Vous pouvez les créditer en utilisant un résumé de modification comme `Provient de [[w:c:<interwiki code>:MediaWiki:Common.js]], ainsi que de ses dépendances et documentation`. Il existe d'autres façons de créditer correctement le wiki, voir la section suivante.

### Créditer le wiki

Il existe de nombreuses façons de créditer le wiki source mais vous devez en utiliser au moins une. Une petite note ou même le résumé de modification sont souvent recommandés.

Si vous le souhaitez, vous pouvez créer une bannière qui indique la source originale du wiki. Voici un exemple simple :

Créer "Modèle:Du wiki" avec pour contenu :

```
<div style="padding:1em; display:flex; align-items: center; background-color: #EEE2; border: 1px solid #5556;">
</noinclude>

```

Utilisez le modèle comme ceci : `{{Du wiki|modèles|Modèle:Bienvenue|Wiki Modèles}}`, ce qui affiche :

Ce modèle provient de Wiki Modèle (voir les auteurs).

## Étape 5 : Fin

Et voilà, vous avez copier un ou plusieurs modèles sur votre wiki ! Vous avez maintenant compris comment copier des modèles.

Revenir sur Aide:Modèles

## Voir aussi

* Aide:Copier : Un guide (obsolète) pour copier les modèles de ce wiki.
* Aide:Importer et exporter des pages : Un guide des pages d'importation et d'exportation.
* Installation sur Wiki Dev : Montre comment installer des pages CSS et/ou JS, ainsi que des modules Lua.