پرش به محتوا

مدیاویکی:Gadget-AncreTitres.js

از دانشنامه علوم انسانی
نسخهٔ تاریخ ۲۹ ژوئیهٔ ۲۰۲۴، ساعت ۰۷:۰۶ توسط imported>Jeeputer (این نسخه را از ویکی‌پدیای فرانسوی به‌روز کردم و قابلیت کپی کردن پیوند پایدار را به آن افزودم (به‌دلیل تغییر ساختار عنوان بخش‌ها، در مقاله‌ها ظاهر نمی‌شد). در نسخهٔ قبلی، پیوند پایدار به‌صورت نشانی وب کپی می‌شد، اما در این نسخه به‌شکل پیوند پایدار داخلی کپی می‌شود و مبنایش هم دریافت شناسه از API است.)

نکته: پس از انتشار ممکن است برای دیدن تغییرات نیاز باشد که حافظهٔ نهانی مرورگر خود را پاک کنید.

  • فایرفاکس / سافاری: کلید Shift را نگه دارید و روی دکمهٔ Reload کلیک کنید، یا کلید‌های Ctrl-F5 یا Ctrl-R را با هم فشار دهید (در رایانه‌های اپل مکینتاش کلید‌های ⌘-R)
  • گوگل کروم: کلیدهای Ctrl+Shift+R را با هم فشار دهید (در رایانه‌های اپل مکینتاش کلید‌های ⌘-Shift-R)
  • Edge: کلید Ctrl را نگه‌دارید و روی دکمهٔ Refresh کلیک کنید، یا کلید‌های Ctrl-F5 را با هم فشار دهید
/**
 * AncreTitres
 *
 * Cette fonction fournit un lien vers une section de page en cliquant
 * sur le lien [URL] ou [[lien]] à droite du titre de section.
 *
 * Auteurs : Pabix, Phe, Bayo, Chphe, Arkanosis, Mah3110, Ash_Crow, Dalba, Jeeputer
 * {{Projet:JavaScript/Script|AncreTitres}}
 */
/* global $, mw */
/* eslint-env browser */
// <nowiki>
mw.loader.using( [ 'mediawiki.util', 'user' ], function () {
	'use strict';

	$( function ( $ ) {
		var lang = mw.config.get( 'wgUserLanguage' ),
			messages = {
				en: {
					'ancretitres-anchor-name': '[URL]',
					'ancretitres-internal-link-name': '[[Link]]',
					'ancretitres-permanent-link-name': '[[Permalink]]',
					'ancretitres-description': 'Get an URL to this section',
					'ancretitres-int-description': 'Get an internal link to this section',
					'ancretitres-int-description': 'Get a permanent link to this section',
					'ancretitres-notif-title': 'Text copied to clipboard',
					'ancretitres-notif-error': 'Could not copy to clipboard'
				},
				fa: {
					'ancretitres-anchor-name': '[نشانی وب]',
					'ancretitres-internal-link-name': '[[ویکی‌پیوند]]',
					'ancretitres-permanent-link-name': '[[پایاپیوند]]',
					'ancretitres-description': 'دریافت نشانی وب برای این بخش',
					'ancretitres-int-description': 'دریافت پیوند داخلی به این بخش',
					'ancretitres-permanent-description': 'دریافت پیوند پایدار به این بخش',
					'ancretitres-notif-title': 'متن به بریده‌دان منتقل شد',
					'ancretitres-notif-error': 'ناتوان از رونویسی در بریده‌دان'
				}
			},
			options = {
				afficheE: true,
				afficheI: true,
				afficheP: true
			};

		mw.messages.set( messages.en );
		if ( lang !== 'en' && lang in messages ) {
			mw.messages.set( messages[ lang ] );
		}

		function copyTextToClipboard( text ) {
			function notifySuccess() {
				mw.notify( text, { title: mw.msg( 'ancretitres-notif-title' ), tag: 'ancretitres', type: 'info', autoHide: true } );
			}

			function notifyError() {
				mw.notify( mw.msg( 'ancretitres-notif-error' ), { tag: 'ancretitres', type: 'error', autoHide: true } );
			}

			if ( navigator.clipboard ) {
				// Clipboard API
				navigator.clipboard.writeText( text ).then( notifySuccess, notifyError );
			} else {
				notifyError();
			}
		}

		if ( typeof window.AncreTitres !== 'undefined' ) {
			Object.assign( options, window.AncreTitres );
		}

		if ( !options.afficheI && !options.afficheE && !options.afficheP ) {
			return;
		}

		// https://phabricator.wikimedia.org/T13555
		// https://www.mediawiki.org/wiki/Heading_HTML_changes

		// old markup (hN > .mw-headline)
		$( '.mw-headline' ).each( function ( _, mwHeadline ) {
			if ( mwHeadline.id ) {
				processHeading( mwHeadline.parentElement, mwHeadline.id );
			}
		} );

		// new markup (.mw-heading > hN)
		$( '.mw-heading' ).each( function ( _, mwHeading ) {
			var heading = mwHeading.querySelector( 'h1, h2, h3, h4, h5, h6' );
			if ( heading && heading.id ) {
				processHeading( mwHeading, heading.id );
			}
		} );

		function processHeading( headingContainer, sectionId ) {
			var $span = $( '<span>' )
				.addClass( 'noprint ancretitres' )
				.css( {
					'font-size': 'xx-small',
					'font-weight': 'normal',
					'user-select': 'none' // jQuery se charge d'ajouter un vendor prefix si nécessaire
				} );

			var sectionUrl = 'https://' + mw.config.get( 'wgServerName' ) + mw.util.getUrl() + '#' + sectionId;

			if ( options.afficheE ) {
				var $linkE = $( '<a>' )
					.attr( 'href', sectionUrl )
					.attr( 'title', mw.msg( 'ancretitres-description' ) )
					.text( mw.msg( 'ancretitres-anchor-name' ) )
					.click( function ( e ) {
						e.preventDefault();
						copyTextToClipboard( sectionUrl );
					} );
				$span.append( ' ', $linkE );
			}

			if ( options.afficheI ) {
				var $linkI = $( '<a>' )
					.attr( 'href', sectionUrl )
					.attr( 'title', mw.msg( 'ancretitres-int-description' ) )
					.text( mw.msg( 'ancretitres-internal-link-name' ) )
					.click( function ( e ) {
						e.preventDefault();
						var escapedAnchor = sectionId
							// escaping caractères spéciaux HTML
							// (partiel, '"& ne sont pas escapés pour ne pas dégrader inutilement la lisibilité du lien)
							.replaceAll( '<', '&lt;' )
							.replaceAll( '>', '&gt;' )
							// escaping caractères spéciaux MediaWiki
							.replaceAll( '[', '&#91;' )
							.replaceAll( ']', '&#93;' )
							.replaceAll( '{', '&#123;' )
							.replaceAll( '|', '&#124;' )
							.replaceAll( '}', '&#125;' );
						var outputText = '[[' + ( mw.config.get( 'wgPageName' ) + '#' + escapedAnchor ).replaceAll( '_', ' ' ) + ']]';
						copyTextToClipboard( outputText );
					} );
				$span.append( ' ', $linkI );
			}
			
			if ( options.afficheP ) {
				var $linkP = $( '<a>' )
					.attr( 'href', sectionUrl )
					.attr( 'title', mw.msg( 'ancretitres-permanent-description' ) )
					.text( mw.msg( 'ancretitres-permanent-link-name' ) )
					.click( function ( e ) {
						e.preventDefault();
						var api = new mw.Api(),
						apiParams = {
							action: 'query',
							prop: 'revisions',
							titles:  mw.config.get( 'wgPageName' ),
							rvprop: 'ids',
							rvslots: 'main',
							formatversion: '2',
							format: 'json'
						},
						escapedAnchor = sectionId
							// escaping caractères spéciaux HTML
							// (partiel, '"& ne sont pas escapés pour ne pas dégrader inutilement la lisibilité du lien)
							.replaceAll( '<', '&lt;' )
							.replaceAll( '>', '&gt;' )
							// escaping caractères spéciaux MediaWiki
							.replaceAll( '[', '&#91;' )
							.replaceAll( ']', '&#93;' )
							.replaceAll( '{', '&#123;' )
							.replaceAll( '|', '&#124;' )
							.replaceAll( '}', '&#125;' ),
						revid;
						api.get( apiParams ).done( function ( data ) {
							revid = data.query.pages[0].revisions[0].revid
							var outputText = '[[ویژه:پیوند دائمی/' + revid + '#' + ( escapedAnchor ).replaceAll( '_', ' ' ) + ']]';
							copyTextToClipboard( outputText );
						});
					} );
				$span.append( ' ', $linkP );
			}

			headingContainer.append( $span[ 0 ] );
		}

	} );

} );