Викиучебник:Визуальный редактор
Визуальный редактор (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 — как сделать гаджет для ВР.