Extension:Attachments/fr
État de la version : stable |
|
|---|---|
| Implémentation | Fonction d'analyseur, Variable, Action de page, Accroche |
| Description | Attacher des sous-pages aux pages, des fichiers, ou des liens externes. |
| Auteur(s) |
|
| Dernière version | 1.0.1 |
| Politique de compatibilité | Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière. |
| MediaWiki | 1.39+ |
| Licence | Licence MIT |
| Téléchargement | GitHub: Note : |
| Exemple | https://vowi.fsinf.at/ |
|
|
|
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
#attachpeut é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. Renvoiefalsepour 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
| Name | Type | Description | Default |
|---|---|---|---|
$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. | true
|
$wgAttachmentsShowSubpageForm
|
booléen | Indique s'il faut afficher ou pas le formulaire de sous-page. | true
|
$wgAttachmentsShowLinkForm
|
booléen | Indique s'il faut afficher ou pas le lien externe. | 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). | 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. | 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. | 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.
- Stable extensions/fr
- Parser function extensions/fr
- Variable extensions/fr
- Page action extensions/fr
- Hook extensions/fr
- MIT licensed extensions/fr
- Extensions in GitHub version control/fr
- ParserFirstCallInit extensions/fr
- BeforePageDisplay extensions/fr
- MagicWordwgVariableIDs extensions/fr
- ParserGetVariableValueSwitch extensions/fr
- SkinTemplateNavigation::Universal extensions/fr
- ListDefinedTags extensions/fr
- ChangeTagsListActive extensions/fr
- All extensions/fr
- Attachment extensions/fr
