MediaWiki:Gadget-Wyckibaat.js: Difference between revisions

Revision as of 10:41, 3 June 2024

if ( mw.config.get( 'wgPageName' ) === 'Wyckibaat' ) {

// Welcome to the main Wyckibaat JS script.
// This code creates the interface for processing 
// wiki pages of unicode text into structured pages 
// with metadata for a particular Tibetan collection. 
//          __
//  _(\    |@@|
// (__/\__ \--/ __
//    \___|----|  |   __
//        \ }{ /\ )_ / _\ 
//        /\__/\ \__O (__
//       (--/\--)    \__/
//       _)(  )(_
//       ---''---



// Define api functions to use throughout
function createPage(page, content) {
	var createPageParams = {
			action: 'edit',
			title: page,
			text: content,
			format: 'json',
			createonly: true
		},
		createPageApi = new mw.Api();
	createPageApi.postWithToken( 'csrf', createPageParams ).done( function (data) {
		$('#alerts').append('<div class="col-lg-6"><div class="alert alert-success mt-2 mb-0 py-1 px-2" role="alert">Created: <a href="/index.php/' + page + '" title="' + page + '">' + page + '</a>.</div></div>');
		purgePage(page);
	});
};



function createFinalPage(page, content) {
	var createPageParams = {
			action: 'edit',
			title: page,
			text: content,
			format: 'json'
		},
		createPageApi = new mw.Api();
	createPageApi.postWithToken( 'csrf', createPageParams ).done( function (data) {
		$('#alerts').append('<div class="col-lg-6"><div class="alert alert-success mt-2 mb-0 py-1 px-2" role="alert">Created: <a href="/index.php/' + page + '" title="' + page + '">' + page + '</a>.</div></div>');
		purgePage(page);
	});
};



function purgePage(page) {
	var purgeParams = {
			action: 'purge',
			titles: page,
			forcelinkupdate: true,
			format: 'json'
		},
		purgeApi = new mw.Api();
	purgeApi.post( purgeParams ).done( function ( data ) {
		console.log(page + ' purged.');
	} );
};

   

// Get unicode content:
function getUnicode(pagename) {
	var paramsPageParse = {
			action: 'parse',
			page: pagename,
			prop: 'wikitext',
			formatversion: 2
		},
		parsePageApi = new mw.Api();
	parsePageApi.get(paramsPageParse).done( function (data) {
		// Storing parsed unicode from existing text page into variable
		var unicodeContent = data.parse.wikitext;
		getTemplateContent(pagename, unicodeContent);
	});
};



// Get template content
function getTemplateContent(pagename, unicodeContent){
	var paramsTemplateParse = {
			action: 'parse',
			page: 'WB-Text-Stub',
			prop: 'wikitext',
			formatversion: 2
		},
		parseTemplateApi = new mw.Api();
	parseTemplateApi.get(paramsTemplateParse).done( function (data) {
		// Storing parsed template content into variable
		var templateContent = data.parse.wikitext ;
		buildPage(pagename, unicodeContent, templateContent);
	});
};



// Build final page
function buildPage(pagename, unicodeContent, templateContent){

	// Splitting pagename into individual chunks to be reused later: 
	// wiki ID, collection ID, volume number, and text number.
	
	if ( namingScheme === 'noVolume' ) {	
		var pageNameChunk = pagename.match(/^([a-zA-Z0-9]+)-([a-zA-Z0-9]+)-([0-9]+)$/),
			wikiID = pageNameChunk[1],
			colID = pageNameChunk[2],
			textNum = pageNameChunk[3],
			volumePageName = wikiID + "-" + colID
	} else if ( namingScheme === 'volNumOnly' ) {	
		var pageNameChunk = pagename.match(/^([a-zA-Z0-9]+)-([a-zA-Z0-9]+)-([0-9]+)-([a-zA-Z0-9]+)$/),
			wikiID = pageNameChunk[1],
			colID = pageNameChunk[2],
			volNum = pageNameChunk[3],
			textNum = pageNameChunk[4],
			volumePageName = wikiID + "-" + colID + "-Volume-" + volNum
	} else if ( namingScheme === 'volNumAndLet' ) {
		var pageNameChunk = pagename.match(/^([a-zA-Z0-9]+)-([a-zA-Z0-9]+)-([0-9]+)-([a-zA-Z]+)-([a-zA-Z0-9]+)$/),
			wikiID = pageNameChunk[1],
			colID = pageNameChunk[2],
			volNum = pageNameChunk[3],
			volumeLetter = pageNameChunk[4],
			textNum = pageNameChunk[5],
			volumePageName = wikiID + "-" + colID + "-Volume-" + volNum + "-" + volumeLetter
	}
	var subclass;


	if ( textNum === 'Karchag') {
		subclass = 'Karchags';
	} else {
		subclass = 'Tibetan Texts';
	};

	// Build final page content by replacing strings in 
	// template content with actual page values and adding 
	// the unicode to the body of the page.
	var pageContent = templateContent
		.replace( '%subclass%', subclass )
		.replace( '%collectiontitle%', collectionName.value )
		.replace( '%collectiontitletib%', collectionNameTib.value )
		.replace( '%totalvolumes%', totalVolumes.value )
		.replace( '%author%', author.value )
		.replace( '%authortib%', authorTib.value )
		.replace( '%citation%', citation.value )
		.replace( '%volumenumber%', volNum )
		.replace( '%volumeLetter%', volumeLetter )
		.replace( '%textnuminvol%', textNum )
		.replace( '%pagename%', pagename )
		.replace( '%InitCategories%', projectName.value + "; " + volumePageName )
		.replace( '%pagecontent%', unicodeContent )
		.replace( '[[Cate' + 'gory:Wyckibaat]]' , '' );

	// Create final page
	createFinalPage(pagename, pageContent);
};






// Building input elements for processing existing basic unicode pages:
var projectName = new OO.ui.TextInputWidget( {
		icon: 'tag',
		placeholder: 'Project name',
		value: 'Khyentse Lineage Project'
	} ),
	collectionName = new OO.ui.TextInputWidget( {
		icon: 'tag',
		placeholder: 'Collection name',
		value: "mdo mkhyen brtse 'dzin grol"
	} ),
	collectionNameTib = new OO.ui.TextInputWidget( {
		icon: 'tag',
		placeholder: 'Collection name in Tibetan',
		value: 'མདོ་མཁྱེན་བརྩེ་འཛིན་གྲོལ།'
	} ),
	totalVolumes = new OO.ui.NumberInputWidget( {
		placeholder: 'Total volumes in collection',
		value: '1'
	}),
	author = new OO.ui.TextInputWidget( {
		icon: 'tag',
		placeholder: 'Author pagename',
		value: 'Mdo mkhyen brtse'
	} ),
	authorTib = new OO.ui.TextInputWidget( {
		icon: 'tag',
		placeholder: 'Author name in Tibetan',
		value: 'མདོ་མཁྱེན་བརྩེ་'
	} ),
	citation = new OO.ui.TextInputWidget( {
		icon: 'tag',
		placeholder: 'Full citation for collection',
		value: "[[Mdo mkhyen brtse]]. ''''. In ''Mdo mkhyen brtse ye shes rdo rje'i dgongs gter gcod 'dzin pa rang grol gyi 'don chog gi skor'',  (''The Natural Liberation of Grasping, The Chod Teaching of Do Khyentse Yeshe Dorje''): . Delhi: Shechen Publications, 2020."
	} ),
	namingScheme = new OO.ui.RadioSelectInputWidget( {
		value: 'noVolume',
		options: [
			{
				data: 'noVolume',
				label: 'No volume specified. E.g. DKYD-DZINDROL-001.'
			},
			{
				data: 'volNumOnly',
				label: 'Volume number only, no letter specified. E.g. LCP-KABUM-06-002.'
			},
			{
				data: 'volNumAndLet',
				label: 'Volume number and letter specified. E.g. DJYD-KABUM-01-KA-001.'
			}
		]
	} ),
	dryRunButton = new OO.ui.ButtonWidget( {
		label: 'Dry Run',
		flags: [
			'primary',
			'progressive'
		]
	} ),
	processButton = new OO.ui.ButtonWidget( {
		label: 'Process Pages',
		flags: [
			'primary',
			'progressive'
		]
	} );

// Placing input elements on the page:
$( '#wyckibaat' ).append( [
	projectName.$element,
	collectionName.$element, 
	collectionNameTib.$element, 
	totalVolumes.$element, 
	author.$element,
	authorTib.$element,
	citation.$element,
	'<div class="my-2">Text files naming scheme:</div>',
	namingScheme.$element,
	'<div class="mb-3"></div>',
	dryRunButton.$element,
	processButton.$element,
	'<div id="alerts" class="row mt-3"></div>'
] );



// DRY RUN
// Click action for main process button:
dryRunButton.on('click', function dryRunPages() {

	// Check for existence of project pages:
	new mw.Api().get( {
	    action: "query",
	    titles: [ 
	    	'Category:' + projectName.value, 
	    	collectionName.value,
	    	'Category:' + collectionName.value,
	    	author.value,
	    	'Category:' + author.value
	    ],
	} ).then( function( data ) {
	    $.each( data.query.pages, function() {
	        if ( this.missing !== "" ) {} else {
	        	$('#alerts').append('<div class="col-lg-6"><div class="alert alert-info mt-2 mb-0 py-1 px-2" role="alert">Will create: <a class="new" href="/index.php/' + this.title + '" title="' + this.title + '">' + this.title + '</a>.</div></div>');
	        }
	    } );
	}, function( error ) {
	    console.log('Error testing for page existence.')
	});

	// List pages to process
	var queryUrl = 'https://' + mw.config.get( 'wgServerName' ) + '/api.php?action=query&list=categorymembers&cmtitle=Category:Wyckibaat&cmlimit=max&format=json'
	var jsonData = queryUrl;
	$.getJSON(jsonData, function(data){
		$.each(data.query.categorymembers, function(work, field){
			// console.log(field.title);
			$('#alerts').append('<div class="col-lg-6"><div class="alert alert-info mt-2 mb-0 py-1 px-2" role="alert">Will process: <a href="/index.php/' + field.title + '" title="' + field.title + '">' + field.title + '</a> and <a href="/index.php/Category:' + field.title + '" title="Category:' + field.title + '">Category:' + field.title + '</a>.</div></div>');
		});
	});
});



// Click action for main process button:
processButton.on('click', function processPages() {

	// Creation of project's main category page
	var projectCatPageName = 'Category:' + projectName.value,
		projectCatPageContent = "This the project's main category page.";
	createPage(projectCatPageName, projectCatPageContent);

	// Creation of collection page and collection category page
	var collectionPageName = collectionName.value,
		collectionPageContent = '{{Collection\n|author=' + author.value + '\n|title=' + collectionName.value + '\n}}';
	createPage(collectionPageName, collectionPageContent);
	var collectionCatPageName = 'Category:' + collectionName.value,
		collectionCatPageContent = 'This is the category for the collection: {{PAGENAME}}';
	createPage(collectionCatPageName, collectionCatPageContent);

	// Creation of author page and author category page
	var authorPageName = author.value,
		authorPageContent = '{{PersonCall}}';
	createPage(authorPageName, authorPageContent);
	var authorCatPageName = 'Category:' + author.value,
		authorCatPageContent = 'This is the category page for  {{PAGENAME}}';
	createPage(authorCatPageName, authorCatPageContent);

	// Fetching pages using SMW's API's "ask" action, with result formatted in JSON:
	var queryUrl = 'https://' + mw.config.get( 'wgServerName' ) + '/api.php?action=query&list=categorymembers&cmtitle=Category:Wyckibaat&cmlimit=max&format=json'
	var jsonData = queryUrl;

	// Extracting JSON data from file and parsing:
	$.getJSON(jsonData, function(data){

		// Defining what to do for each page returned by the query.
		$.each(data.query.categorymembers, function(pagename, field){

			// Splitting pagename into individual chunks to be reused later: 
			// wiki ID, collection ID, volume number, and text number.
			var pagename = field.title

			// Create volume pages
			if ( namingScheme === 'noVolume' ) {	
				var pageNameChunk = pagename.match(/^([a-zA-Z0-9]+)-([a-zA-Z0-9]+)-([0-9]+)$/),
					wikiID = pageNameChunk[1],
					colID = pageNameChunk[2],
					volumePageName = wikiID + "-" + colID
			} else if ( namingScheme === 'volNumOnly' ) {	
				var pageNameChunk = pagename.match(/^([a-zA-Z0-9]+)-([a-zA-Z0-9]+)-([0-9]+)-([a-zA-Z0-9]+)$/),
					wikiID = pageNameChunk[1],
					colID = pageNameChunk[2],
					volNum = pageNameChunk[3],
					volumePageName = wikiID + "-" + colID + "-Volume-" + volNum
			} else if ( namingScheme === 'volNumAndLet' ) {
				var pageNameChunk = pagename.match(/^([a-zA-Z0-9]+)-([a-zA-Z0-9]+)-([0-9]+)-([a-zA-Z]+)-([a-zA-Z0-9]+)$/),
					wikiID = pageNameChunk[1],
					colID = pageNameChunk[2],
					volNum = pageNameChunk[3],
					volumeLetter = pageNameChunk[4],
					volumePageName = wikiID + "-" + colID + "-Volume-" + volNum + "-" + volumeLetter
			}
			var volumeStub = '{{VolumePage\n|collectiontitle=' + collectionName.value + '\n|collectiontitletib=' + collectionNameTib.value + '\n|volumenumber=' + volNum + '\n}}';
			createPage(volumePageName, volumeStub);
			var volumeCatPage = 'Category:' + volumePageName,
				volumeCatPageContent = '{{VolumeCategoryPage}}';
			createPage(volumeCatPage, volumeCatPageContent);

			// Create category page
			var catPageName = 'Category:' + field.title,
				catPageContent = '{{TextCategoryPage}}';
			createPage(catPageName, catPageContent);

			// Build and process text page
			getUnicode(field.title);

		});
	});
});

};