MediaWiki:Gadget-speechSynthewiki.js: различия между версиями
Перейти к навигации
Перейти к поиску
Ланселот (обсуждение | вклад) Новая страница: «→* * Speech Synthewiki — гаджет озвучки статей браузером пользователя * Версия 0.3 — адаптация под MediaWiki 1.43 (+Vector 2022, MathML): →global mw, $: (function () { 'use strict'; var currentUtterance = null; var currentButton = null; var voicesReady = false; // ---------- утилиты ---------- function getRussianVoice() { var voices = window.spee...» |
Ланселот (обсуждение | вклад) Нет описания правки |
||
| Строка 1: | Строка 1: | ||
/** | /** | ||
* Speech Synthewiki — гаджет озвучки статей браузером пользователя | * Speech Synthewiki — гаджет озвучки статей браузером пользователя | ||
* Версия 0.3 — адаптация под MediaWiki 1.43 ( | * Версия 0.3.1 — адаптация под MediaWiki 1.43 (Vector 2022, MathML) | ||
* Автор оригинала — Урахара (Циклопедия), CC BY-SA 4.0 | |||
* Адаптация: 2026 | |||
*/ | */ | ||
/* global mw, $ */ | /* global mw, $ */ | ||
| Строка 12: | Строка 14: | ||
var voicesReady = false; | var voicesReady = false; | ||
// ---------- | // ---------- служебные элементы, которые не озвучиваем ---------- | ||
var SKIP_SELECTORS = [ | |||
'#siteSub', '#contentSub', '#jump-to-nav', '.mw-jump-link', | |||
'.mw-indicators', '.catlinks', '.printfooter', '.mw-hidden-catlinks', | |||
'.noprint', '.metadata', '.mw-editsection', | |||
'.navbox', '.vertical-navbox', '.sistersitebox', '.ambox', | |||
'.mbox-text-span', '.mw-references-wrap', 'ol.references', | |||
'.reference', 'sup.reference', '.reflist', | |||
'style', 'script', | |||
'.mw-empty-elt', '.mw-kartographer-maplink' | |||
].join(','); | |||
// ---------- голоса ---------- | |||
function getRussianVoice() { | function getRussianVoice() { | ||
var voices = window.speechSynthesis.getVoices() || []; | var voices = window.speechSynthesis.getVoices() || []; | ||
| Строка 32: | Строка 46: | ||
} | } | ||
// | // ---------- очистка клона от мусора ---------- | ||
function cleanClone(cloned) { | function cleanClone(cloned) { | ||
cloned.find([ | cloned.find([ | ||
| Строка 60: | Строка 74: | ||
} | } | ||
// | // ---------- MathML → речь ---------- | ||
function mathToSpeech($math) { | function mathToSpeech($math) { | ||
var $clone = $math.clone(); | |||
// Отсекаем TeX-аннотацию, чтобы не дублировать | // Отсекаем TeX-аннотацию, чтобы не дублировать | ||
$clone.find('annotation').remove(); | $clone.find('annotation').remove(); | ||
var parts = []; | var parts = []; | ||
$clone.find('msqrt').each(function () { | $clone.find('msqrt').each(function () { | ||
parts.push(' корень из ' + $(this).text().trim() + ' '); | parts.push(' корень из ' + $(this).text().trim() + ' '); | ||
| Строка 125: | Строка 138: | ||
} | } | ||
function buildSpeechText($ | // ---------- сбор текста секции между двумя заголовками ---------- | ||
function buildSpeechText($startNode, $stopNode) { | |||
var chunks = []; | var chunks = []; | ||
var $node = $ | var $node = $startNode; | ||
while ($node.length) { | while ($node.length) { | ||
if ($stopNode && $node[0] === $stopNode[0]) break; | |||
if ($node.is('h1, h2, h3, h4, h5, h6') | if (!$stopNode && $node.is('h1, h2, h3, h4, h5, h6') && $node[0] !== $startNode[0]) break; | ||
if (!$stopNode && $node.is('.mw-heading')) break; | |||
var $cloned = cleanClone($node.clone()); | |||
$cloned.find(SKIP_SELECTORS).remove(); | |||
if ($cloned.is(SKIP_SELECTORS)) { | |||
$node = $node.next(); | |||
continue; | |||
} | } | ||
$cloned.find('math').each(function () { | $cloned.find('math').each(function () { | ||
| Строка 151: | Строка 169: | ||
$node = $node.next(); | $node = $node.next(); | ||
} | } | ||
return chunks.join('\n'); | |||
} | |||
// ---------- сбор текста преамбулы ---------- | |||
function buildLeadText() { | |||
var $root = $('#mw-content-text .mw-parser-output'); | |||
if (!$root.length) return ''; | |||
// Первый заголовок — граница преамбулы | |||
var $firstHeader = $root.find('h1, h2, h3, h4, h5, h6, .mw-heading').first(); | |||
var stopEl = $firstHeader.length ? $firstHeader[0] : null; | |||
var chunks = []; | |||
$root.children().each(function () { | |||
if (stopEl && this === stopEl) return false; | |||
var $el = $(this); | |||
// Явно пропускаем заголовок страницы и служебные блоки | |||
if ($el.is('h1.firstHeading, #siteSub, #contentSub, .mw-indicators, .mw-jump-link, .printfooter, .catlinks')) { | |||
return true; | |||
} | |||
var $cloned = cleanClone($el.clone()); | |||
$cloned.find(SKIP_SELECTORS).remove(); | |||
if ($cloned.is(SKIP_SELECTORS)) return true; | |||
$cloned.find('math').each(function () { | |||
var spoken = mathToSpeech($(this)); | |||
if (spoken) { | |||
$(this).replaceWith(document.createTextNode(' формула: ' + spoken + ' ')); | |||
} else { | |||
$(this).remove(); | |||
} | |||
}); | |||
var t = $cloned.text().replace(/\s+/g, ' ').trim(); | |||
if (t) chunks.push(t); | |||
return true; | |||
}); | |||
return chunks.join('\n'); | return chunks.join('\n'); | ||
} | } | ||
| Строка 168: | Строка 226: | ||
} | } | ||
var text; | |||
var $heading = $(a).closest('.mw-heading, h1, h2, h3, h4, h5, h6'); | if ($(a).data('lead')) { | ||
text = buildLeadText(); | |||
$ | } else { | ||
var $heading = $(a).closest('.mw-heading, h1, h2, h3, h4, h5, h6'); | |||
var $realHeader = $heading.is('.mw-heading') | |||
? $heading.children('h1,h2,h3,h4,h5,h6') | |||
: $heading; | |||
var $start = $realHeader.next(); | |||
var $stop = $start.nextAll('.mw-heading, h1, h2, h3, h4, h5, h6').first(); | |||
text = $start.length | |||
? buildSpeechText($start, $stop.length ? $stop : null) | |||
: ''; | |||
} | } | ||
if (!text) { | if (!text) { | ||
mw.notify('Под этим заголовком нет текста для озвучки', { type: 'warn' }); | mw.notify('Под этим заголовком нет текста для озвучки', { type: 'warn' }); | ||
| Строка 224: | Строка 288: | ||
if (!$root.length) return; | if (!$root.length) return; | ||
// | // --- кнопка преамбулы (нулевая секция) --- | ||
var $firstHeader = $root.find('h1, h2, h3, h4, h5, h6').first(); | var $firstHeader = $root.find('h1, h2, h3, h4, h5, h6, .mw-heading').first(); | ||
var hasLead = false; | var hasLead = false; | ||
$root.children().each(function () { | $root.children().each(function () { | ||
if (this === $firstHeader[0]) return false; | if ($firstHeader.length && this === $firstHeader[0]) return false; | ||
if ($(this).is('p, ul, ol, dl, table, blockquote') && $(this).text().trim()) { | if ($(this).is('p, ul, ol, dl, table, blockquote') && $(this).text().trim()) { | ||
hasLead = true; return false; | hasLead = true; | ||
return false; | |||
} | } | ||
return true; | return true; | ||
}); | }); | ||
if (hasLead && !$root.find('.cyclo-tts-lead').length) { | if (hasLead && !$root.find('.cyclo-tts-lead').length) { | ||
var $leadBar = $('<div class="cyclo-tts-lead" style="margin:.5em 0;"></div>'); | var $leadBar = $('<div class="cyclo-tts-lead" style="margin:.5em 0;"></div>'); | ||
var $leadBtn = $('<a href="#" style="cursor:pointer;">🔊 озвучить преамбулу</a>') | var $leadBtn = $('<a href="#" style="cursor:pointer;">🔊 озвучить преамбулу</a>') | ||
.data('lead', true); | |||
$leadBtn.on('click', onClick); | |||
$leadBar.append($leadBtn); | $leadBar.append($leadBtn); | ||
$root.prepend($leadBar); | $root.prepend($leadBar); | ||
} | } | ||
// | // --- кнопки у каждого заголовка --- | ||
$root.find('.mw-heading, h1, h2, h3, h4, h5, h6').each(function () { | $root.find('.mw-heading, h1, h2, h3, h4, h5, h6').each(function () { | ||
var $h = $(this); | var $h = $(this); | ||
| Строка 265: | Строка 326: | ||
mw.loader.using(['jquery'], function () { | mw.loader.using(['jquery'], function () { | ||
$(function () { | $(function () { | ||
if (window.speechSynthesis) { | if (window.speechSynthesis) { | ||
addButtons(); | addButtons(); | ||
Версия от 20:46, 3 ноября 2026
/**
* Speech Synthewiki — гаджет озвучки статей браузером пользователя
* Версия 0.3.1 — адаптация под MediaWiki 1.43 (Vector 2022, MathML)
* Автор оригинала — Урахара (Циклопедия), CC BY-SA 4.0
* Адаптация: 2026
*/
/* global mw, $ */
(function () {
'use strict';
var currentUtterance = null;
var currentButton = null;
var voicesReady = false;
// ---------- служебные элементы, которые не озвучиваем ----------
var SKIP_SELECTORS = [
'#siteSub', '#contentSub', '#jump-to-nav', '.mw-jump-link',
'.mw-indicators', '.catlinks', '.printfooter', '.mw-hidden-catlinks',
'.noprint', '.metadata', '.mw-editsection',
'.navbox', '.vertical-navbox', '.sistersitebox', '.ambox',
'.mbox-text-span', '.mw-references-wrap', 'ol.references',
'.reference', 'sup.reference', '.reflist',
'style', 'script',
'.mw-empty-elt', '.mw-kartographer-maplink'
].join(',');
// ---------- голоса ----------
function getRussianVoice() {
var voices = window.speechSynthesis.getVoices() || [];
return voices.find(function (v) {
return /^ru/i.test(v.lang) || /рус/i.test(v.name);
}) || null;
}
function ensureVoices(cb) {
if (voicesReady) { cb(); return; }
var v = window.speechSynthesis.getVoices();
if (v && v.length) { voicesReady = true; cb(); return; }
var handler = function () {
voicesReady = true;
window.speechSynthesis.removeEventListener('voiceschanged', handler);
cb();
};
window.speechSynthesis.addEventListener('voiceschanged', handler);
}
// ---------- очистка клона от мусора ----------
function cleanClone(cloned) {
cloned.find([
'.thumb', '.thumbinner', '.thumbcaption', '.magnify',
'.floatnone', '.floatleft', '.floatright',
'ul.gallery', 'div.gallery', 'li.gallerybox', 'div.thumb',
'.gallerycaption', 'sup.reference', '.metadata', '.noprint',
'img', 'a.image', 'style', 'script'
].join(',')).remove();
cloned.contents().each(function () {
if (this.nodeType === 3) {
if (/(Файл|File|Image|Изображение|Медиа):/i.test(this.nodeValue)) {
this.nodeValue = '';
}
} else if (this.nodeType === 1) {
var $el = $(this);
var href = $el.attr('href') || '';
if ($el.is('a') && /\.(jpg|jpeg|png|gif|bmp|svg|webp|ogg|mp3|wav|pdf|djvu)(\?|$)/i.test(href)) {
$el.remove();
} else if ($el.hasClass('image') || $el.hasClass('internal') || href.indexOf('Файл:') !== -1) {
$el.remove();
}
}
});
return cloned;
}
// ---------- MathML → речь ----------
function mathToSpeech($math) {
var $clone = $math.clone();
// Отсекаем TeX-аннотацию, чтобы не дублировать
$clone.find('annotation').remove();
var parts = [];
$clone.find('msqrt').each(function () {
parts.push(' корень из ' + $(this).text().trim() + ' ');
$(this).remove();
});
$clone.find('mfrac').each(function () {
var $ch = $(this).children();
var num = $ch.eq(0).text().trim();
var den = $ch.eq(1).text().trim();
parts.push(' дробь ' + num + ' на ' + den + ' ');
$(this).remove();
});
$clone.find('msup').each(function () {
var $ch = $(this).children();
var base = $ch.eq(0).text().trim();
var exp = $ch.eq(1).text().trim();
if (exp === '2') parts.push(base + ' в квадрате ');
else if (exp === '3') parts.push(base + ' в кубе ');
else parts.push(base + ' в степени ' + exp + ' ');
$(this).remove();
});
$clone.find('msub').each(function () {
var $ch = $(this).children();
parts.push($ch.eq(0).text().trim() + ' с индексом ' + $ch.eq(1).text().trim() + ' ');
$(this).remove();
});
var rest = $clone.text().trim()
.replace(/×/g, ' умножить ')
.replace(/÷/g, ' разделить ')
.replace(/≠/g, ' не равно ')
.replace(/≈/g, ' приблизительно равно ')
.replace(/≤/g, ' меньше или равно ')
.replace(/≥/g, ' больше или равно ')
.replace(/±/g, ' плюс минус ')
.replace(/∞/g, ' бесконечность ')
.replace(/√/g, ' корень из ')
.replace(/π/g, ' пи ')
.replace(/∑/g, ' сумма ')
.replace(/∏/g, ' произведение ')
.replace(/∫/g, ' интеграл ')
.replace(/∂/g, ' частная производная ')
.replace(/∇/g, ' набла ')
.replace(/∈/g, ' принадлежит ')
.replace(/∉/g, ' не принадлежит ')
.replace(/∩/g, ' пересечение ')
.replace(/∪/g, ' объединение ')
.replace(/⊂/g, ' подмножество ')
.replace(/⊃/g, ' надмножество ');
if (rest) parts.push(rest);
return parts.join(' ').trim();
}
// ---------- сбор текста секции между двумя заголовками ----------
function buildSpeechText($startNode, $stopNode) {
var chunks = [];
var $node = $startNode;
while ($node.length) {
if ($stopNode && $node[0] === $stopNode[0]) break;
if (!$stopNode && $node.is('h1, h2, h3, h4, h5, h6') && $node[0] !== $startNode[0]) break;
if (!$stopNode && $node.is('.mw-heading')) break;
var $cloned = cleanClone($node.clone());
$cloned.find(SKIP_SELECTORS).remove();
if ($cloned.is(SKIP_SELECTORS)) {
$node = $node.next();
continue;
}
$cloned.find('math').each(function () {
var spoken = mathToSpeech($(this));
if (spoken) {
$(this).replaceWith(document.createTextNode(' формула: ' + spoken + ' '));
} else {
$(this).remove();
}
});
var t = $cloned.text().replace(/\s+/g, ' ').trim();
if (t) chunks.push(t);
$node = $node.next();
}
return chunks.join('\n');
}
// ---------- сбор текста преамбулы ----------
function buildLeadText() {
var $root = $('#mw-content-text .mw-parser-output');
if (!$root.length) return '';
// Первый заголовок — граница преамбулы
var $firstHeader = $root.find('h1, h2, h3, h4, h5, h6, .mw-heading').first();
var stopEl = $firstHeader.length ? $firstHeader[0] : null;
var chunks = [];
$root.children().each(function () {
if (stopEl && this === stopEl) return false;
var $el = $(this);
// Явно пропускаем заголовок страницы и служебные блоки
if ($el.is('h1.firstHeading, #siteSub, #contentSub, .mw-indicators, .mw-jump-link, .printfooter, .catlinks')) {
return true;
}
var $cloned = cleanClone($el.clone());
$cloned.find(SKIP_SELECTORS).remove();
if ($cloned.is(SKIP_SELECTORS)) return true;
$cloned.find('math').each(function () {
var spoken = mathToSpeech($(this));
if (spoken) {
$(this).replaceWith(document.createTextNode(' формула: ' + spoken + ' '));
} else {
$(this).remove();
}
});
var t = $cloned.text().replace(/\s+/g, ' ').trim();
if (t) chunks.push(t);
return true;
});
return chunks.join('\n');
}
// ---------- обработчик клика ----------
function onClick(event) {
event.preventDefault();
var a = event.currentTarget;
// Повторный клик по активной кнопке — стоп
if (currentButton === a && window.speechSynthesis.speaking) {
window.speechSynthesis.cancel();
$(a).text('озвучить');
currentButton = null;
currentUtterance = null;
return;
}
var text;
if ($(a).data('lead')) {
text = buildLeadText();
} else {
var $heading = $(a).closest('.mw-heading, h1, h2, h3, h4, h5, h6');
var $realHeader = $heading.is('.mw-heading')
? $heading.children('h1,h2,h3,h4,h5,h6')
: $heading;
var $start = $realHeader.next();
var $stop = $start.nextAll('.mw-heading, h1, h2, h3, h4, h5, h6').first();
text = $start.length
? buildSpeechText($start, $stop.length ? $stop : null)
: '';
}
if (!text) {
mw.notify('Под этим заголовком нет текста для озвучки', { type: 'warn' });
return;
}
// Остановить предыдущее
if (window.speechSynthesis.speaking) {
window.speechSynthesis.cancel();
if (currentButton) $(currentButton).text('озвучить');
}
currentUtterance = new SpeechSynthesisUtterance(text);
currentUtterance.lang = 'ru-RU';
currentUtterance.rate = 1.0;
currentUtterance.pitch = 1.0;
currentUtterance.volume = 1.0;
ensureVoices(function () {
var v = getRussianVoice();
if (v) currentUtterance.voice = v;
currentUtterance.onstart = function () {
$(a).text('стоп');
currentButton = a;
};
currentUtterance.onend = function () {
$(a).text('озвучить');
if (currentButton === a) { currentButton = null; currentUtterance = null; }
};
currentUtterance.onerror = function (ev) {
if (ev.error !== 'interrupted' && ev.error !== 'canceled') {
$(a).text('озвучить');
if (currentButton === a) { currentButton = null; currentUtterance = null; }
}
};
window.speechSynthesis.speak(currentUtterance);
});
}
// ---------- вставка кнопок ----------
function addButtons() {
var $root = $('#mw-content-text .mw-parser-output');
if (!$root.length) return;
// --- кнопка преамбулы (нулевая секция) ---
var $firstHeader = $root.find('h1, h2, h3, h4, h5, h6, .mw-heading').first();
var hasLead = false;
$root.children().each(function () {
if ($firstHeader.length && this === $firstHeader[0]) return false;
if ($(this).is('p, ul, ol, dl, table, blockquote') && $(this).text().trim()) {
hasLead = true;
return false;
}
return true;
});
if (hasLead && !$root.find('.cyclo-tts-lead').length) {
var $leadBar = $('<div class="cyclo-tts-lead" style="margin:.5em 0;"></div>');
var $leadBtn = $('<a href="#" style="cursor:pointer;">🔊 озвучить преамбулу</a>')
.data('lead', true);
$leadBtn.on('click', onClick);
$leadBar.append($leadBtn);
$root.prepend($leadBar);
}
// --- кнопки у каждого заголовка ---
$root.find('.mw-heading, h1, h2, h3, h4, h5, h6').each(function () {
var $h = $(this);
if ($h.hasClass('cyclo-tts-start')) return;
var $edit = $h.find('.mw-editsection').first();
if (!$edit.length) return; // у h1 без кнопки правки — пропускаем
if ($edit.prev().hasClass('cyclo-tts-start')) return;
var $span = $('<span class="mw-editsection cyclo-tts-start">[<a href="#" style="cursor:pointer;">озвучить</a>]</span> ');
$span.on('click', 'a', onClick);
$edit.before($span);
});
}
// ---------- запуск ----------
mw.loader.using(['jquery'], function () {
$(function () {
if (window.speechSynthesis) {
addButtons();
} else {
console.warn('[Speech Synthewiki] Браузер не поддерживает speechSynthesis');
}
});
});
})();