Викиучебник:Визуальный редактор

ВУ:ВР

Визуальный редактор (VisualEditor) — программное обеспечение для редактирования страниц Викиучебника (и других сайтов, использующих MediaWiki) в режиме WYSIWYG. Он позволяет пользователям совершать правки без необходимости изучения синтаксиса вики-разметки.

О Визуальном редакторе

Видеоролик об «альфа»-версии Визуального редактора Википедии (на английском языке)

Визуальный редактор является «визуальным» инструментом редактирования Википедии, по сути новой системой редактирования, которая позволяет вносить правки без знания вики-разметки. Он был доступен в «альфа»-версии в качестве опции в англоязычной Википедии с декабря 2012 года, в 14 других разделах с апреля 2013 года и практически во всех разделах с начала июля^[1].

25 апреля 2013 года Wikimedia Foundation запустил альфа-версию Визуального редактора в 15 языковых разделах Википедии: арабский, китайский, голландский, английский, французский, немецкий, итальянский, японский, корейский, польский, русский, испанский, шведский, иврит, хинди языковые разделы. Классический редактор исходного вики-текста также остается доступным для редактирования страницы и разделов страницы. С 1 по 29 июля 2013 года Визуальный редактор перешёл из альфа-версии в бета-версию^[2].

Текущие ограничения

Медленная первая загрузка. Должен загрузиться js-файл на 1—2 Мб для редактора. В дальнейшем все страницы должны открываться в редакторе очень быстро. Если у вас долго стоит полоска загрузки редактора или вы видите, что этот файл каждый раз загружается (т. е. редактор открывается медленнее, чем открывается просто страница в режиме чтения, даже у маленьких страниц) — попробуйте очистить все куки (для Firefox: меню → настройки → приватность → удалить отдельные куки → удалить все), это должно помочь.
Зависание браузеров у некоторых пользователей.
При попытке открыть в окне редактирования конкретный раздел вместо этого открывается вся статья.
Изменения могут выглядеть странно.
Нет возможности редактировать некоторые структуры.
Поддержка лишь некоторых браузеров (Firefox, Chrome, Yandex, Safari, Internet Explorer).
Возможность редактирования только в пространстве статей и страниц пользователей.

График внедрения

Дата в 2013 году	Этап внедрения	Целевые разделы
1 июля	Визуальный редактор доступен для всех зарегистрированных участников	Англоязычная Википедия
15 июля	Визуальный редактор доступен для всех участников	Англоязычная Википедия
24 июля	Визуальный редактор доступен для всех зарегистрированных участников в разделах 2-й фазы	Немецкий, испанский, французский, на иврите, итальянский, нидерландский, польский, русскоязычный и шведский разделы Википедии
29 июля	Визуальный редактор доступен для всех участников в разделах 2-й фазы
Вторая половина августа	Визуальный редактор доступен для всех зарегистрированных участников в разделах 3-й фазы	Все разделы Википедии, за исключением тех, над чьими письменностями продолжается работа.
Вторая половина августа, через неделю	Визуальный редактор доступен для всех участников в разделах 3-й фазы

Дальнейшие разработки

На данный момент одновременное редактирование одной статьи разными пользователями может привести к конфликтам редактирования. В будущем планируется реализовать возможность совместного редактирования.

Как временно отключить визуальный редактор

Для деактивации редактора необходимо перейти в раздел меню «Настройки» — «Редактирование» — «Бета-возможности» и отметить пункт «Временно отключить Визуальный редактор, пока он находится в бета-версии».

Сокращение названия «Править исходный текст»

Добавить в Special:MyPage/common.js (или vector.js monobook.js) строки:

//Заменяем текст вкладки «Править исходный текст» на «Править текст»
$(document).ready(function(){
	var edit = 'Править текст';
 
	//Перевод в нижний регистр
	String.prototype.lower = function(){
		return this.substring(0, 1).toLowerCase() + this.substring(1);
	}
 
	//Изменение текста на всех ссылках
	$('#ca-edit > span > a').html(edit);
	$('.mw-editsection > a:not([class])').html(edit.lower());
});

Изменение текста кнопок как в en-wiki

//Изменение текста на кнопках как в en-wiki «Править» и «Править<sup>бета</sup>»
$(document).ready(function(){
	var edit = {
		def:'Править',
		ve:'Править<sup>бета</sup>'
	};
 
	//Перевод в нижний регистр
	String.prototype.lower = function(){
		return this.substring(0, 1).toLowerCase() + this.substring(1);
	}
 
	//Изменение текста на вкладхах
	$('#ca-edit > span > a').html(edit.def);
	$('#ca-ve-edit > span > a').html(edit.ve);
	//Изменение текста на ссылках в заголовках разделов
	$('.mw-editsection > a:not([class])').html(edit.def.lower());
	$('.mw-editsection-visualeditor').html(edit.ve.lower());
});

Статистика

Шаблоны

Чтобы в Визуальном редакторе полноценно редактировать шаблон, нужно на страницу его документации (или на страницу самого шаблона внутри тегов <noinclude></noinclude>) вставить таблицу mw:Extension:TemplateData.

Сделать таблицу TemplateData автоматически можно, записав в /doc документацию шаблона эту строку (подстановка) {{subst:#invoke:TemplateDataGenerator|f}} и сохранив страницу.

Чтобы удобно создавать TemplateData, потребуется добавить в Special:MyPage/common.js (или vector.js monobook.js) строки:

//Формирование TemplateData
//На страницах шаблонов слева, в инструментах появляется строка TD Skeleton
mw.loader.load('//en.wikipedia.org/w/index.php?title=User:Salix alba/TDSkell.js&action=raw&ctype=text/javascript');

//Редактор TemplateData [[:en:User:NicoV/TemplateDataEditor]]
//На страницах шаблонов в редактировании на панель инструментов добавляется кнопка [TDE]
//Для начала работы тег <templatedata></templatedata> должен быть уже размещен в тексте
mw.loader.load('//fr.wikipedia.org/w/index.php?title=Utilisateur:Ltrlg/scripts/TemplateDataEditor.js&action=raw&ctype=text/javascript');

Основное:

description — текст о самом шаблоне.
params — поля шаблона.
sets — объединение полей в группы.

Поле:

label — видимое в редакторе имя для поля (до 20 знаков).
description — текст описания поля.
required — должно ли поле быть заполнено обязательно, его нельзя удалить из списка используемых полей (false/true).
suggested — помечает поле как рекомендуемое (false/true).
deprecated — помечает поле как устаревшее (false/true).
aliases — другие названия поля. Например, для поля можно добавить название на английском ( [ "2", "Caption", "imagecaption" ] ).
default — подсказка, что использует шаблон(сам по умолчанию), если это поле остается пустым. Не влияет на шаблон и не подставляется само в шаблон.
type — "unknown" "number" "string" "line" "wiki-page-name" (ограничивается общими правилами названия статей) "wiki-file-name" (с проверкой на "Foo.svg", не пропускает "File:Foo.svg") "wiki-user-name" (с проверкой на "Foo" , не пропускает "User:Foo") "content" "unbalanced-wikitext".
inherits — имя другого поля, чьи параметры это поле может подставлять (скопировать) себе, чтобы не повторять остальные параметры в каждом похожем поле.

Группа:

label м видимое в редакторе имя для группы.
params — перечисление полей в группе ["year", "month", "day"].

Панель вставки символов

увеличение высоты

.ve-ui-toolbarDialog.oo-ui-window-ready {
   max-height: 350px !important;
}
.ve-ui-specialCharacterDialog .oo-ui-bookletLayout {
   height: 350px !important;
}

См. также

mw:VisualEditor/Feedback — общение с разработчиками (на любом языке).
m:VisualEditor/Newsletter — главные новости.
mw:VisualEditor/Roadmap — текущая работа.
mw:VisualEditor/status — еженедельные отчёты о работе.
meta:IRC office hours — часы и способ для общения онлайн с разработчиками (на английском).
mw:VisualEditor gadgets — как сделать гаджет для ВР.

Ссылки

Примечания

[1] Визуальный редактор/Портал

[2] VisualEditor

[1]

[2]