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

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

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

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

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

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

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

• медленная загрузка;
• зависание браузеров у некоторых пользователей;
• при попытке открыть в окне редактирования конкретный раздел вместо этого открывается вся статья;
• изменения могут выглядеть странно;
• нет возможности редактировать некоторые структуры (например, математические формулы);
• поддержка лишь некоторых браузеров (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());
});

Статистика

• Hourly edits, visual editor vs wikitext (%)
• Hourly edits, visual editor vs wikitext (% by user group)
• Hourly edits, visual editor vs wikitext (%)
• Hourly edits, visual editor vs wikitext
• Hourly edits, visual editor vs wikitext editor
• Daily unique editors
• Hourly reverted revisions by type

Шаблоны

Чтобы в Визуальном редакторе полноценно редактировать шаблон нужно на страницу его документации (или на страницу самого шаблона внутри тегов <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"]

См. также

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

Ссылки

• Подробное описание (англ.)
• Портал на MediaWiki
• Блог Фонда Викимедиа
• В Башкирской Википедии заработал новый визуальный редактор сообщает ИА Башинформ 22 июля 2013 года