Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
extensions_mediawiki [Le 01/08/2009, 23:40] phira |
extensions_mediawiki [Le 11/09/2022, 12:12] (Version actuelle) moths-art Suppression des espaces en fin de ligne (détecté et corrigé via le bot wiki-corrector (https://forum.ubuntu-fr.org/viewtopic.php?id=2067892) |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
- | ====== Extensions ====== | + | {{tag>Xenial internet wiki}} |
- | + | ||
- | 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 | + | |
- | + | ||
- | Les Extension décrites ci dessous on été testées sous Ubuntu 9.04 selon les requis de Mediawiki | + | |
- | + | ||
- | <note important>Note importante: | + | |
- | Toutes les extensions demandent une modification de /var/www/mediawiki/LocalSettings.php : n'oubliez donc pas de faire un backup préalable à toute modification de ce fichier | + | |
- | </note> | + | |
- | + | ||
- | + | ||
- | + | ||
- | ===== Pré requis ===== | + | |
- | Avoir installé [[mediawiki]] | + | |
---- | ---- | ||
- | ===== PDFexport ===== | + | ====== Extensions pour Mediawiki ====== |
- | ==== Définition ==== | + | 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. |
- | * Date du test de l'extension: juillet 2009 | + | |
- | * Page officielle (en) [[http://http://www.mediawiki.org/wiki/Extension:Pdf_Export|pdfExport]] | + | |
- | * PdfExport est une extension de MediaWiki particulièrement intéressante: elle permet de demander la traduction de l'article en format PDF. Dans le menu principal apparait alors dans le menu de gauche "Imprimer en PDF" | + | |
- | ==== Pré-requis ==== | + | Aucune de ces extensions n'est propre à Ubuntu. |
- | Avoir installé [[apt://htmldoc]] | + | <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> | ||
- | ou via un terminal : | + | ===== 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**. | ||
- | apt-get install htmldoc | + | Page officielle (en) [[https://www.mediawiki.org/wiki/Extension:Pdf_Export|pdfExport]] |
- | ==== installation ==== | + | === Installation === |
- | a) En mode superuser créer le répertoire | + | - Avec les [[:sudo|droits d'administration]] créer le dossier **/var/www/mediawiki/extensions/PdfExport**. |
- | + | - Pour chacun des 4 fichiers ci-dessous : | |
- | /var/www/mediawiki/extensions/PdfExport | + | * récupérer le code, |
- | + | * créer le fichier ennoncé, | |
- | b) pour chacun des 4 fichiers ci dessous | + | * le placer dans **/var/www/mediawiki/extensions/PdfExport** |
- | + | - [[https://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.php|PdfExport.php]] | |
- | * récupérer le code | + | - [[https://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport_body.php|PdfExport_body.php]] |
- | * créer le fichier ennoncé | + | - [[https://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.i18n.php|PdfExport.i18n.php]] |
- | * le placer dans /var/www/mediawiki/extensions/PdfExport | + | - [[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> | |
- | - [[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]] | + | |
- | + | ||
- | c) dans le fichier /var/www/mediawiki/LocalSettings.php et **avant la ligne** de demande de rafraichissement du cache | + | |
- | + | ||
- | <php> | + | |
$wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) ); | $wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) ); | ||
- | </php> | + | </file>**ajouter la ligne**<file> |
- | + | ||
- | **ajouter la ligne** | + | |
- | + | ||
- | <php> | + | |
require_once("extensions/PdfExport/PdfExport.php"); | require_once("extensions/PdfExport/PdfExport.php"); | ||
- | </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 | ||
- | d) Cette extension demande une modification des droits d'accès de /var/www/mediawiki/im | + | === Utilisation === |
- | ges/tmp pour que cette extension puisse créer et effacer le fichier temporaire | + | |
- | ==== utilisation ==== | + | |
- | Dans le menu principal apparait alors dans le menu de gauche "Imprimer en PDF" | + | |
- | APERCU: | + | Dans le menu principal apparaît alors dans le menu de gauche "Imprimer en PDF" : |
- | {{:pdfexport.jpg}} | + | {{:pdfexport.jpg?500}} |
- | ==== Particularités rencontrées ==== | + | === Particularités rencontrées === |
- | - "Imprimer en PDF" n'apparait que dans certains skin de MediaWiki | + | - "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 | + | - lors des tests certaines erreurs d'affichage des quotes sont survenues dans l'export en PDF sans affecter le contenu du PDF. |
- | ==== Rédaction par: ==== | ||
- | [[:utilisateurs:phira]] | ||
- | |||
- | ---- | ||
+ | ==== 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 === | ||
- | ===== CITE (références /notes de bas de page) ===== | + | * Avoir [[:tutoriel:comment_installer_un_paquet|installé le paquet]] **[[apt>htmldoc]]**. |
- | ==== Définition ==== | ||
- | * Date du test de l'extension: aout 2009 | ||
- | * Page officielle (en) [[http://www.mediawiki.org/wiki/Extension:Cite/Cite.php|Cite]] | ||
- | * 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 . | ||
- | ==== Pré-requis ==== | + | === Installation === |
- | + | ||
- | aucun | + | |
- | + | ||
- | ==== installation ==== | + | |
- | + | ||
- | **Récupérer les fichiers** [[http://www.mediawiki.org/wiki/Special:ExtensionDistributor/Cite|situés ici]] | + | |
- | (j'ai pris la version "trunck") | + | |
+ | **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 | **copier le répertoire** contenu dans l'archive dans le répertoire /var/www/mediawiki/extensions | ||
- | **Ajouter la ligne** | + | Ajouter dans le fichier **/var/www/mediawiki/LocalSettings.php** la ligne** : <file> |
- | dans le fichier /var/www/mediawiki/LocalSettings.php | + | |
- | + | ||
- | <php> | + | |
require_once('extensions/Cite/Cite.php'); | require_once('extensions/Cite/Cite.php'); | ||
- | </php> | + | </file> |
+ | avant la ligne : <file> | ||
+ | $wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) ); | ||
+ | </file> | ||
- | avant la ligne | + | === Utilisation === |
- | <php> | + | Placez vos références entre les tags %%<ref>%% et %%</ref>%% |
- | $wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) ); | + | |
- | </php> | + | |
- | ==== utilisation ==== | + | exemple : <file> |
- | placer vos références entre les tags <ref> et </ref> | + | <ref>ceci est une référence unique </ref> |
à la fin de votre article placer simplement la balise | à la fin de votre article placer simplement la balise | ||
- | <references/> | + | <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 | + | 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 |
- | <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"> | + | <ref name="nom_de_la_reference">et </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 automatique et immédiat et la numérotation reste cohérente</note> | ||
+ | chaque fois que vous souhaiterez faire appel à ce groupe il vous suffira de faire appel à la balise <ref name="nom_de_la_reference"> | ||
- | ===Illustration : code === | + | exemple: |
- | {{tutoriel:tutoriel:mediawiki_reference.jpg}} | + | |
- | + | ||
- | === Illustration:effet du code === | + | |
- | {{tutoriel:tutoriel:mediawiki_reference_affichage.jpeg}} | + | <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> | ||
- | === Illustration: apparition en bas de page === | + | 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> | ||
- | {{tutoriel:tutoriel:mediawiki_reference_resultats.jpeg}} | + | <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}} | ||
- | ==== Particularités rencontrées ==== | + | Illustration : apparition en bas de page : |
- | aucune | + | {{tutoriel:tutoriel:mediawiki_reference_resultats.jpeg?450}} |
- | ==== Rédaction par: ==== | + | ===== Voir aussi ===== |
- | [[:utilisateurs:phira]] | + | |
+ | La liste exhaustive des extensions et de leur installation se trouve sur le [[http://www.mediawiki.org|site de MediaWiki]]. | ||
---- | ---- | ||
- | <note warning>Page en cours de rédaction | ||
- | La liste exhaustive des extensions et de leur installation se trouve sur le site de MediaWiki </note> | + | //Contributeur principal : [[:utilisateurs:phira]].// |