Extension:Attachments/fr
L'extension Attachments permet aux utilisateurs d'attacher des sous-pages, des fichiers ou des liens externes aux pages des espaces de noms actifs.
- Attachments peut facilement être ajouté via l'interface utilisateur.
- Les pièces jointes d'un article sont affichées dans une liste générée automatiquement en bas de la page.
- Cette extension s'intègre aux habillages Vector et Minerva Neue .
Alors comment cela fonctionne ?
- Les sous-pages sont prises en compte automatiquement comme étant rattachées à leur page parente
- Si vous téléversez un fichier via l'action de page Attacher, la fonction d'analyse
{{#attach: Title}}
est ajoutée à la description. - Lorsque vous ajoutez un lien, l'extension crée une sous-page contenant la fonction d'analyse syntaxique
{{#exturl: URL}}
. - Ces deux fonctions d'analyse initialisent les propriétés de page , nécessaires aux sections générées automatiquement.
Fonctionnalités avancées
#attach
peut également être utilisé pour attacher une page régulière à une autre page régulière.- Vous pouvez exclure des sous-pages commençant par un préfixe donné à partir de l'auto-index avec
{{#attachments ignore subpages: prefix}}
sur la page parente. - Vous pouvez accéder aux pièces attachées avant qu'elles ne soient triées avec l'accroche
BeforeSortAttachments(&$links)
où les liens figurent dans un tableau associatif qui lie les clés textuelles aux liens HTML. Renvoiefalse
pour permettre de trier.
Lier un fichier attaché en relatif
L'extension Attachments fournit la fonction d'analyse syntaxique {{FILEPREFIX}}
qui facilite le lien et l'inclusion des fichiers attachés.
Si vous attachez une image Example.jpg à MaPage alors vous pouvez inclure l'image :
- de MaPage avec
[[File:{{FILEPREFIX}}Example.jpg]]
- de MaPage/SousPage avec
[[File:{{FILEPREFIX:..}}Example.jpg]]
- de MaPage/SousPage/SousSousPage avec
[[File:{{FILEPREFIX:../..}}Example.jpg]]
Notez que cela vaut également pour les liens [[Media:...]]
.
Installation
- Activer les téléversements .
- Les développeurs peuvent cloner l'extension à partir du répertoire MediaWiki
extensions
:cd extensions/ git clone https://github.com/vuhuy/Swiki
- Notez que vous devez aussi activer les sous-pages pour ces espaces de noms.
Paramètres de configuration optionnels
$wgAttachmentsChunkListByLetter |
booléen | Indique si la liste des pièces attachées doit s'afficher triée sur la première lettre de chaque nom ou pas. Valeur par défaut : true .. |
$wgAttachmentsShowSubpageForm |
booléen | Indique s'il faut afficher ou pas le formulaire de sous-page. Valeur par défaut : true .. |
$wgAttachmentsShowLinkForm |
booléen | Indique s'il faut afficher ou pas le lien externe. Valeur par défaut : true .. |
$wgAttachmentsShowInNamespaces |
booléen | Indique si le lien vers les pièces jointes doit être affiché ou pas dans les espaces de noms (pages et discussions). Valeur par défaut : false . |
$wgAttachmentsShowInViews |
booléen | Indique s'il faut afficher les liens de ajouter des pièces jointes pour les actions lire, modifier la source, et voir l'historique. Valeur par défaut : false . |
$wgAttachmentsShowEmptySection |
booléen | Indique s'il faut afficher ou pas certains éléments quand il n'y a pas de pièce jointe pour une page. Valeur par défaut : false . |
Astuces
- Activer $wgCountCategorizedImagesAsUsed pour exclure les fichiers attachés de Special:UnusedImages.
- Les pièces jointes et les URLS externes sont mises ensemble en tant que propriété de page, ce qui signifie qu'elles peuvent être récupérées par API:Pageprops et API:Pageswithprop .
- Initialiser $wgForeignUploadTargets à
[]
pour empêcher les utilisateurs de contourner cette extension dans le dialogue du téléversement. - Si les nouvelles pièces jointes ne s'affichent pas, c'est peut-être parce qu'il y a beaucoup de tâches dans la file d'attente des travaux.
Crédits
Cette extension est principalement la réécriture complète de PerPageResources par Mathias Ertl, qui regroupe Extension:Resources, Extension:AddResource et Extension:ExternalRedirects. Cette extension remplace les trois; les différences notables sont :
- les pièces attachées sont stockées dans la table page_props au lieu de pagelinks
- pas de redirection ouverte, lien simplement
- les pièces attachées figurent à la fin de chaque page, à la différence des pages spéciales
Développé initialement et maintenu par Gittenburg.
Voir aussi
- MoinMoinWiki - permet les pièces jointes externes.