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

Материал из Викиучебника — открытых книг для открытого мира
↱ ВУ:ВР

Визуальный редактор (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;
}

См. также[править]

Ссылки[править]

Примечания[править]