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 03/08/2009, 02:14] Ner0lph bonnes pratiques |
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: | ||
| - | {{tag>Jaunty web BROUILLON}} | + | {{tag>Xenial internet wiki}} |
| ---- | ---- | ||
| - | ====== Extensions ====== | + | ====== 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. | + | 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 | + | Aucune de ces extensions n'est propre à Ubuntu. |
| - | + | ||
| - | Les extensions décrites ci-dessous on été testées sous Ubuntu 9.04 selon les requis de Mediawiki. | + | |
| <note important> | <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. | + | 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> | </note> | ||
| ===== Pré-requis ===== | ===== 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**. | ||
| - | * Avoir installé [[mediawiki]] | + | Page officielle (en) [[https://www.mediawiki.org/wiki/Extension:Pdf_Export|pdfExport]] |
| - | ===== PDFexport ===== | + | === Installation === |
| - | ==== Définition ==== | + | - Avec les [[:sudo|droits d'administration]] créer le dossier **/var/www/mediawiki/extensions/PdfExport**. |
| - | + | ||
| - | * 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 ==== | + | |
| - | + | ||
| - | * Avoir [[:tutoriel:comment_installer_un_paquet|installé le paquet]] [[apt://htmldoc|htmldoc]]. | + | |
| - | + | ||
| - | ==== Installation ==== | + | |
| - | + | ||
| - | - En mode superuser créer le répertoire **/var/www/mediawiki/extensions/PdfExport**. | + | |
| - Pour chacun des 4 fichiers ci-dessous : | - Pour chacun des 4 fichiers ci-dessous : | ||
| - | * récupérer le code | + | * récupérer le code, |
| - | * créer le fichier ennoncé | + | * créer le fichier ennoncé, |
| - | * le placer dans /var/www/mediawiki/extensions/PdfExport | + | * le placer dans **/var/www/mediawiki/extensions/PdfExport** |
| - | - [[http://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.php|PdfExport.php]] | + | - [[https://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]] | + | - [[https://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]] | + | - [[https://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]] | + | - [[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 rafraichissement du cache<code> | + | - 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__ ) ) ); | $wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) ); | ||
| - | </code>**ajouter la ligne**<code> | + | </file>**ajouter la ligne**<file> |
| require_once("extensions/PdfExport/PdfExport.php"); | require_once("extensions/PdfExport/PdfExport.php"); | ||
| - | </code> | + | </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 | + | - 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 ==== | + | === Utilisation === |
| - | Dans le menu principal apparait alors dans le menu de gauche "Imprimer en PDF" | + | Dans le menu principal apparaît alors dans le menu de gauche "Imprimer en PDF" : |
| - | APERÇU : | + | {{:pdfexport.jpg?500}} |
| - | {{:pdfexport.jpg}} | + | === Particularités rencontrées === |
| - | ==== 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. | ||
| - | - "Imprimer en PDF" n'apparait 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 === | ||
| - | ===== 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 | + | === Installation === |
| - | * 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 ==== | + | |
| - | + | ||
| - | aucun | + | |
| - | + | ||
| - | ==== Installation ==== | + | |
| - | + | ||
| - | **Récupérer les fichiers** [[http://www.mediawiki.org/wiki/Special:ExtensionDistributor/Cite|situés ici]] | + | |
| - | (j'ai pris la version "trunk" = version en cours de développement) | + | |
| + | **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 | + | |
| - | + | ||
| - | <code> | + | |
| require_once('extensions/Cite/Cite.php'); | require_once('extensions/Cite/Cite.php'); | ||
| - | </code> | + | </file> |
| - | + | avant la ligne : <file> | |
| - | avant la ligne | + | |
| - | + | ||
| - | <code> | + | |
| $wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) ); | $wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) ); | ||
| - | </code> | + | </file> |
| - | ==== Utilisation ==== | + | === Utilisation === |
| - | placer vos références entre les tags %%<ref>%% et %%</ref>%% | + | Placez vos références entre les tags %%<ref>%% et %%</ref>%% |
| - | exemple: | + | exemple : <file> |
| <ref>ceci est une référence unique </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 |
| + | <file> | ||
| <ref name="nom_de_la_reference">et </ref> | <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"> | chaque fois que vous souhaiterez faire appel à ce groupe il vous suffira de faire appel à la balise <ref name="nom_de_la_reference"> | ||
| Ligne 114: | Ligne 94: | ||
| exemple: | exemple: | ||
| - | <code> | + | <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> | 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 | + | Suspendisse gravida ante a felis.<ref name="groupe1">ce texte est complètement superflu, vous |
| - | ne le verrez apparaitre 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> | + | 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> |
| - | </code> | + | </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> | <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 : | ||
| - | ===Illustration : code === | + | {{tutoriel:tutoriel:mediawiki_reference.jpg?450}} |
| - | + | ||
| - | {{tutoriel:tutoriel:mediawiki_reference.jpg}} | + | |
| - | + | ||
| - | === Illustration : effet du code === | + | |
| - | + | ||
| - | {{tutoriel:tutoriel:mediawiki_reference_affichage.jpeg}} | + | |
| - | + | ||
| - | === Illustration : apparition en bas de page === | + | |
| - | {{tutoriel:tutoriel:mediawiki_reference_resultats.jpeg}} | + | 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}} |
| ===== Voir aussi ===== | ===== Voir aussi ===== | ||
| - | * La liste exhaustive des extensions et de leur installation se trouve sur le [[http://www.mediawiki.org|site de MediaWiki]]. | + | La liste exhaustive des extensions et de leur installation se trouve sur le [[http://www.mediawiki.org|site de MediaWiki]]. |
| ---- | ---- | ||
| //Contributeur principal : [[:utilisateurs:phira]].// | //Contributeur principal : [[:utilisateurs:phira]].// | ||