Руниверсалис:Визуальный редактор

Материал из энциклопедии Руниверсалис
Кнопка «править», после нажатия которой загрузится визуальный редактор.

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

В сравнении с редактором вики-кода, визуальный редактор имеет преимущества. Например, это возможность править без знания вики-разметки, возможность быстрее составлять таблицы, проще подгонять размеры изображений. Страница, которую редактируют через визуальный редактор, в процессе редактирования выглядит практически также, так и после сохранения правки.

К недостаткам визуального редактора можно отнести более медленную скорость загрузки редактора, отсутствие викификатора.

Шаблоны

Чтобы в визуальном редакторе можно было полноценно работать со вставкой шаблонов и занесением данных в их параметры, нужно на страницу его документации (или на страницу самого шаблона внутри тегов <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».
    • NB: если в поле предположительно может использоваться вики-текст или ссылка на источник, то лучше выбирать тип «викитекст» («content»). Тип текст выбирайте если в поле должны быть только буквы без какого-либо оформления.
  • inherits — имя другого поля, чьи параметры это поле может подставлять (скопировать) себе, чтобы не повторять остальные параметры в каждом похожем поле.

Группа:

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

Шаблоны (в пространстве шаблонов), которые строятся на других шаблонах в нём тоже можно при желании нормально собирать/изменять/настраивать при наличии в шаблонах-основах заполненной описательной таблицы, хотя в пространстве шаблонов ВР не включён, код шаблона можно перенести в песочницу и переключиться в ней на визуальный редактор.

См. также