{{tag>Xenial internet wiki}}

----

====== Extensions pour Mediawiki ======

Les extensions sont des ajouts à l'installation de base de [[:Mediawiki]] qui permettent d'en améliorer le fonctionnement, ajouter des tags ou des fonctionnalités.

Aucune de ces extensions n'est propre à Ubuntu.

<note important>
Toutes les extensions demandent une modification de « /var/www/mediawiki/LocalSettings.php » : n'oubliez donc pas de faire une sauvegarde préalable à toute modification de ce fichier.
</note>

===== Pré-requis =====
 
  * Disposer des [[:sudo|droits d'administration]].
  * Disposer d'une connexion à Internet configurée et activée.  * Avoir installé [[mediawiki]]
=====Installation=====
==== PDFexport ====
PdfExport est une extension de MediaWiki particulièrement intéressante : elle permet de demander la traduction de l'article au format PDF. Dans le menu principal apparaît alors dans le panneau de gauche **Imprimer en PDF**.

Page officielle (en) [[https://www.mediawiki.org/wiki/Extension:Pdf_Export|pdfExport]]

=== Installation ===

  - Avec les [[:sudo|droits d'administration]] créer le dossier **/var/www/mediawiki/extensions/PdfExport**.
  - Pour chacun des 4 fichiers ci-dessous :
    * récupérer le code,
    * créer le fichier ennoncé,
    * le placer dans **/var/www/mediawiki/extensions/PdfExport**
    - [[https://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.php|PdfExport.php]]
    - [[https://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport_body.php|PdfExport_body.php]]
    - [[https://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.i18n.php|PdfExport.i18n.php]]
    - [[https://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.i18n.alias.php|PdfExport.i18n.alias.php]]
  - Dans le fichier /var/www/mediawiki/LocalSettings.php  et **avant la ligne** de demande de rafraîchissement du cache<file>
$wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) );
</file>**ajouter la ligne**<file>
require_once("extensions/PdfExport/PdfExport.php");
</file>
  - Cette extension demande  une modification des droits d'accès de **/var/www/mediawiki/images/tmp** pour que cette extension  puisse créer et effacer le fichier temporaire 

=== Utilisation ===

Dans le menu principal apparaît alors dans le menu de gauche "Imprimer en PDF" :

{{:pdfexport.jpg?500}}

=== Particularités rencontrées ===

  - "Imprimer en PDF" n’apparaît que dans certains skin de MediaWiki
  -  lors des tests certaines erreurs d'affichage des quotes sont survenues dans l'export en PDF sans affecter le contenu du PDF.


==== CITE (références /notes de bas de page) ====
CITE est une extension particulièrement utile pour les personnes qui souhaitent référencer ou citer leur sources par des notes de bas de page. Page officielle (en) [[https://www.mediawiki.org/wiki/Extension:Cite/Cite.php|Cite]].
=== Pré-requis ===

  * Avoir [[:tutoriel:comment_installer_un_paquet|installé le paquet]] **[[apt>htmldoc]]**.


=== Installation ===

**Récupérer les fichiers** [[https://www.mediawiki.org/wiki/Special:ExtensionDistributor/Cite|situés ici]].
**copier le répertoire** contenu dans l'archive dans le répertoire /var/www/mediawiki/extensions


Ajouter dans le fichier **/var/www/mediawiki/LocalSettings.php**  la ligne** : <file>
require_once('extensions/Cite/Cite.php');
</file>
avant la ligne : <file>
$wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) );
</file>

=== Utilisation ===

Placez vos références entre les tags %%<ref>%% et %%</ref>%%

exemple : <file>
  <ref>ceci est une référence unique </ref> 

à la fin de votre article placer simplement la balise
  <references/>
</file>

Quand vous citez plusieurs fois la même source, il est particulièrement intéressant de les citer dans un même groupe entre les balises
<file>
  <ref name="nom_de_la_reference">et </ref>
</file>


chaque fois que vous souhaiterez faire appel à ce groupe il vous suffira de faire appel à la balise <ref name="nom_de_la_reference">

exemple:

<file>
Lorem ipsum dolor sit amet,<ref name="groupe1">Souvenez-vous que c'est le texte de la première référence à l'appel du groupe qui est affichée.</ref>

Suspendisse gravida ante a felis.<ref name="groupe1">ce texte est complètement superflu, vous
ne le verrez apparaître nulle part, c'est la première référence du groupe qui sera affichée vous pouvez tout aussi bien laisser en blanc</ref>
</file>

<note tip>Vous ne devez pas prévoir la numérotation de vos notes de bas de page : les effets du code sont automatiques et immédiat et la numérotation reste cohérente à chaque mise à jour de votre article</note>

Illustration : code :

{{tutoriel:tutoriel:mediawiki_reference.jpg?450}}

Illustration : effet du code :

{{tutoriel:tutoriel:mediawiki_reference_affichage.jpeg?450}}

Illustration : apparition en bas de page :

{{tutoriel:tutoriel:mediawiki_reference_resultats.jpeg?450}}

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

La liste exhaustive des extensions et de leur installation se trouve sur le [[http://www.mediawiki.org|site de MediaWiki]].
----

//Contributeur principal : [[:utilisateurs:phira]].//