Utilisateur:Sabrsl/TriModeles.js
Note : après avoir enregistré la page, vous devrez forcer le rechargement complet du cache de votre navigateur pour voir les changements.
Mozilla / Firefox / Konqueror / Safari : maintenez la touche Majuscule (Shift) en cliquant sur le bouton Actualiser (Reload) ou pressez Maj-Ctrl-R (Cmd-R sur Apple Mac) ;
Firefox (sur GNU/Linux) / Chrome / Internet Explorer / Opera : maintenez la touche Ctrl en cliquant sur le bouton Actualiser ou pressez Ctrl-F5.// <nowiki>
/**
* TriModeles.js —
*
* RÈGLE
* - le modèle a une page de documentation (/Documentation, /Doc ou celle donnée à {{Documentation|…}})
* → la catégorie va dans le <includeonly> de CETTE page, et est retirée du code du modèle ;
* - pas de documentation → la catégorie va dans le <noinclude> du modèle ;
* - jamais de doublon.
*
* SÉCURITÉ : le script ne clique JAMAIS sur « Publier
*
* Paramètres d'URL posés par l'outil : ?tricat=Catégorie&trimode=tpl|doc|rm|docrm
*/
( function () {
'use strict';
var DOC_RE = /\/(Documentation|Doc)$/i;
function escRe( s ) { return s.replace( /[.*+?^${}()|[\]\\]/g, '\\$&' ); }
/** Page de documentation déclarée par {{Documentation|…}} (null = nom par défaut /Documentation). */
function customDocTitle( pageName, text ) {
var m = text.match( /\{\{\s*(?:Modèle:|Template:)?Documentation\s*\|\s*([^}|]+)/i );
if ( !m ) { return null; }
var p = m[ 1 ].trim().replace( /^1\s*=\s*/, '' ).replace( /_/g, ' ' );
if ( !p || /^[^=]*=/.test( p ) ) { return null; }
if ( p.charAt( 0 ) === '/' ) { p = pageName + p; } else if ( !/^[^:]+:/.test( p ) ) { p = 'Modèle:' + p; }
return p === pageName + '/Documentation' ? null : p;
}
/**
* Transformation pure du wikicode.
* Retourne { text, summary, msg } (modification) ou { skip: message, warn: bool } (rien à faire).
*/
function transform( txt, cat, mode, isDoc ) {
var e = escRe( cat ).replace( /[ _]/g, '[ _]' );
var core = '\\[\\[\\s*Cat[ée]gorie\\s*:\\s*' + e + '\\s*(\\|[^\\]]*)?\\]\\]';
var re = new RegExp( core, 'i' ), reG = new RegExp( '\\n?' + core, 'gi' );
var tag = '[' + '[Catégorie:' + cat + ']]';
var sum = 'Catégorisation du modèle dans [' + '[:Catégorie:' + cat + ']]';
function blockRe( n ) { return new RegExp( '<' + n + '\\s*>[\\s\\S]*?</' + n + '\\s*>', 'gi' ); }
function lastIdx( rx, s ) { var r = -1, m; while ( ( m = rx.exec( s ) ) ) { r = m.index; } return r; }
var CMT = '<!' + '-- Catégories pour le modèle -->';
function addToIncludeonly( t ) {
var j = lastIdx( /<\/includeonly\s*>/gi, t );
if ( j < 0 ) { return t.replace( /\s*$/, '' ) + '\n<includeonly>\n' + CMT + '\n' + tag + '\n</includeonly>\n'; }
var head = t.slice( 0, j ), o = Math.max( 0, lastIdx( /<includeonly\s*>/gi, head ) ), k = head.indexOf( CMT, o );
if ( k > -1 ) { var e = k + CMT.length; return head.slice( 0, e ) + '\n' + tag + head.slice( e ) + t.slice( j ); }
return head.replace( /\s*$/, '' ) + '\n' + CMT + '\n' + tag + '\n' + t.slice( j );
}
function inBlocks( t, n ) {
var out = false;
( t.match( blockRe( n ) ) || [] ).forEach( function ( b ) {
if ( re.test( b ) ) { out = true; }
} );
return out;
}
if ( /^\s*#(redirect|redirection)/i.test( txt ) ) { return { skip: 'redirection, ignorée.', warn: true }; }
// Documentation → <includeonly> (catégorie mal placée dans <noinclude> déplacée)
if ( isDoc || mode.indexOf( 'doc' ) === 0 ) {
var dI = inBlocks( txt, 'includeonly' ), dR = 0, b2 = txt;
if ( inBlocks( txt, 'noinclude' ) ) {
b2 = txt.replace( blockRe( 'noinclude' ), function ( b ) {
return b.replace( reG, function () { dR++; return ''; } );
} );
}
if ( dI && !dR ) { return { skip: 'déjà catégorisé dans <includeonly> (doublon évité).', warn: false }; }
if ( !dI && !dR && re.test( txt ) ) { return { skip: 'catégorie présente hors <includeonly>, à vérifier à la main.', warn: true }; }
if ( dI ) {
return { text: b2, summary: 'Retrait de la catégorie mal placée dans <noinclude> (déjà dans <includeonly>)', msg: 'catégorie retirée de <noinclude> (déjà dans <includeonly>).' };
}
var nd = addToIncludeonly( b2 );
return { text: nd, summary: sum, msg: 'catégorie ' + ( dR ? 'déplacée vers' : 'ajoutée dans' ) + ' <includeonly> de la documentation.' };
}
// Retrait du code du modèle (la catégorie est dans la documentation)
if ( mode === 'rm' ) {
var n = 0, nb = txt.replace( reG, function () { n++; return ''; } );
if ( !n ) { return { skip: 'rien à retirer.', warn: false }; }
return { text: nb, summary: 'Retrait de la catégorie (catégorisation via la documentation)', msg: 'catégorie retirée du code du modèle (elle est dans la documentation).' };
}
// Pas de documentation → <noinclude> du modèle
var removed = 0;
var base = txt.replace( blockRe( 'includeonly' ), function ( b ) {
return b.replace( reG, function () { removed++; return ''; } );
} );
if ( inBlocks( txt, 'noinclude' ) ) { return { skip: 'déjà catégorisé dans <noinclude> (doublon évité).', warn: false }; }
if ( !removed && re.test( txt ) ) { return { skip: 'catégorie présente hors <noinclude>, à vérifier à la main.', warn: true }; }
var i = base.lastIndexOf( '</noinclude>' ), nt;
if ( i > -1 ) {
nt = base.slice( 0, i ).replace( /\s*$/, '' ) + '\n' + tag + '\n' + base.slice( i );
} else {
nt = base.replace( /\s*$/, '' ) + '<noinclude>\n' + tag + '\n</noinclude>';
}
return { text: nt, summary: sum, msg: 'catégorie ' + ( removed ? 'déplacée dans' : 'ajoutée dans' ) + ' <noinclude> du modèle.' };
}
// Export pour les tests (hors MediaWiki)
if ( typeof module !== 'undefined' && module.exports ) {
module.exports = { transform: transform, customDocTitle: customDocTitle };
return;
}
if ( typeof mw === 'undefined' ) { return; }
mw.loader.using( [ 'jquery.textSelection', 'mediawiki.api', 'mediawiki.util' ] ).then( function () {
$( function () {
var q = new URLSearchParams( location.search );
var cat = q.get( 'tricat' ), mode = q.get( 'trimode' ) || 'tpl';
if ( !cat || mw.config.get( 'wgAction' ) !== 'edit' ) { return; }
function start( tries ) {
if ( $( '#wpTextbox1' ).length ) { return run(); }
if ( tries > 50 ) { mw.notify( 'Tri : zone de texte introuvable (éditeur visuel ?). Ouvre avec action=edit.', { type: 'warn' } ); return; }
setTimeout( function () { start( tries + 1 ); }, 100 );
}
start( 0 );
function run() {
var $t = $( '#wpTextbox1' );
var txt = $t.val(), page = mw.config.get( 'wgPageName' ).replace( /_/g, ' ' );
var isDoc = DOC_RE.test( page );
function banner( msg, warn ) {
$( '#trimodeles-banner' ).remove();
$( '<div id="trimodeles-banner">' )
.css( { margin: '0 0 12px', padding: '8px 12px', borderLeft: '4px solid ' + ( warn ? '#ac6600' : '#36c' ),
background: warn ? '#fef6e7' : '#eaf3ff', color: '#202122', fontSize: '14px' } )
.text( 'Tri des modèles · « ' + cat + ' » : ' + msg )
.prependTo( '#content' );
mw.notify( 'Tri : ' + msg, warn ? { type: 'warn' } : {} );
}
function apply() {
var r = transform( $t.val(), cat, mode, isDoc );
if ( r.skip ) { banner( r.skip, r.warn ); return; }
var orig = $t.val();
function put() {
if ( r.text !== $t.val() ) {
if ( $.fn.textSelection ) { $t.textSelection( 'setContents', r.text ); } else { $t.val( r.text ); }
}
if ( !$( '#wpSummary' ).val() ) { $( '#wpSummary' ).val( r.summary ); }
}
put();
// Filet : un éditeur (coloration, restauration du navigateur) peut remettre l'ancien texte après coup.
[ 400, 1200, 2500, 4500 ].forEach( function ( ms ) {
setTimeout( function () { if ( $t.val() === orig && orig !== r.text ) { put(); } }, ms );
} );
banner( r.msg + ' Vérifie avec « Afficher les modifications », puis publie toi-même.', false );
$( '#wpDiff' ).trigger( 'focus' ); // jamais de clic automatique
}
// Filet de sécurité : si on arrive sur le modèle alors qu'il a une documentation, on bascule sur elle.
if ( !isDoc && mode === 'tpl' ) {
var docTitle = customDocTitle( page, txt ) || ( page + '/Documentation' );
new mw.Api().get( { action: 'query', titles: docTitle, prop: 'info', formatversion: 2 } ).then( function ( d ) {
var p = d.query && d.query.pages && d.query.pages[ 0 ];
if ( p && !p.missing && !p.invalid ) {
mw.notify( 'Tri : documentation trouvée, bascule sur ' + docTitle + '…' );
location.replace( mw.util.getUrl( docTitle, { action: 'edit', tricat: cat, trimode: 'doc' } ) );
} else {
apply();
}
}, apply );
return;
}
apply();
}
} );
} );
}() );
// </nowiki>