Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Prochaine révision
Révision précédente
extensions_mediawiki [Le 27/07/2009, 07:09] – créée phiraextensions_mediawiki [Le 16/04/2017, 20:59] (Version actuelle) – Maj de la page L'Africain
Ligne 1: Ligne 1:
 +{{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) [[http://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**
 +    - [[http://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.php|PdfExport.php]]
 +    - [[http://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport_body.php|PdfExport_body.php]]
 +    - [[http://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.i18n.php|PdfExport.i18n.php]]
 +    - [[http://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) [[http://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** [[http://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]].//