Справка:Изменение модели контента
 |
Примечание: Редактируя эту страницу, вы соглашаетесь на передачу своего вклада по лицензии CC0. Подробнее — в проекте Помощь с общественным достоянием. |
|
| Модели контента и обработчики |
|---|
| MediaWiki допускает использование типов содержимого страниц, отличных от вики-текста. Предлагается встроенная поддержка JavaScript, CSS, JSON и обычного текста. Расширения могут использовать механизм MediaWiki ContentHandler для добавления новых моделей контента для приема различных форматов и управления тем, как они отображаются, хранятся и редактируются. |
 Описание |
|
О ContentHandler Обработчики контента и их реализация |
 Использование |
|
Изменение модели контента страницы Изменение модели контента для пространства имен Расширения, использующие ContentHandler Добавление в расширение моделей контента Примеры: |
 Настройки конфигурации |
|
$wgContentHandlers $wgNamespaceContentModels |
| Поддержка и развитие |
 Последние технические документы (Git) Phabricator |
Страница Special:ChangeContentModel может быть использована для изменения "модели содержания" страницы.
Модель контента, в широком смысле, представляет собой формат или тип данной страницы в вики.
By default a page's content model is wikitext, a rich text format that makes use of wiki markup.
Модели контента, используемые в проектах Викимедиа, включают css и javascript для хранения кода, wikibase-item для записей на Викидатах и Campaign на Викимедиа-коминсах для кампаний загрузки, таких как Wiki Loves Monuments.
По умолчанию модели контента "CSS" и "JavaScript" для страниц пространства имен пользователя, чьи названия заканчиваются соответственно .css и .js, а при установке Расширение:TemplateStyles в пространстве имен шаблона - "Sanitised CSS".
A list of content models is available at content handlers.
Более подробная информация доступна за Manual:ContentHandler.
Все действия записываются на Special:Log/contentmodel, с удобной ссылкой на возврат для отмены изменений, если это необходимо.
Пользователи должны иметь разрешение editcontentmodel для изменения моделей контента.
On Wikimedia projects this permission is granted via user groups: to sysops, interface editors and - on some projects - template editors.
Предыстория
Традиционно единственными видами страниц, которые можно было создать на MediaWiki, были страницы в викитексте: богатые текстовые документы, написанные в маркировке в викитексе. Это приемлемо для написания записей энциклопедии на Википедии, но не подходит для содержания других типов, таких как блоки исходного кода, структурированный контент данных или сложные рабочие процессы.
With the advent of the Wikidata project (and the Wikibase extension) in 2012, the ContentHandler branch was developed to allow the creation of pages other than wikitext documents. Начиная с MediaWiki 1.21, ContentHandler является частью основного программного обеспечения MediaWiki.
Некоторые модели общего контента включают в себя те, которые предназначены для хранения и представления исходного кода, но они также могут быть использованы для создания индивидуальных интерфейсов редактирования. For example, instead of using a horrible mess of templates to structure content on a page, you could store the underlying data in a structured format such as JSON and then write a MediaWiki extension that builds a custom editing interface on top of this structured data. This approach is used by MassMessage to create delivery list pages and by CollaborationKit for creating WikiProjects. Хотя эти расширения имеют свои собственные рабочие процессы для создания страниц, Special:ChangeContentModel также можно использовать.
В качестве альтернативы установке моделей контента на основе страницы по странице, вы можете указать альтернативные дефолты для данного пространства имен. Например, стандартная модель контента в пространстве имен Module - ScribuntoContent. Similarly, you can enforce that a given content model is only used in a given namespace; ScribuntoContent can only be used in the Module namespace.
Viewing a page's current content model
Чтобы просмотреть текущий контент страницы, нажмите Сведения о странице в инструментальном ящике страничного панеля.
Вы также можете добавить ?action=info к URL-адресу, чтобы получить ту же страницу.
Changing a page's content model
Перейдите к Special:ChangeContentModel (или следуйте ссылке "изменить" на странице "Информация о странице"), введите имя страницы, которое вы хотите изменить.
Это может быть несуществующая страница, если вы хотите создать новую страницу, которая использует другую модель контента, чем по умолчанию.
Затем выберите модель контента, на которую вы хотите изменить.
Нажмите на Изменить, чтобы сделать изменение.
Note that not all conversions are possible.
Если вы пытаетесь конвертировать страницу, которая уже существует, и программное обеспечение MediaWiki не может понять, как переосмыслить содержание текущей страницы, модель контента не будет конвертирована, и вы получите сообщение об ошибке.
Когда это происходит, рекомендуется архивировать старую страницу и создать страницу в новой модели контента.
Например, вы можете переименовать Project:Foo в Project:Foo/old и затем использовать Special:ChangeContentModel для создания новой страницы на Project:Foo.
Если это возможно, на новой странице следует включить ссылку на Project:Foo/old .
Отмена изменения
Все изменения в модели контента записываются на Special:Log/contentmodel на вашей вики.
Чтобы отменить изменение, перейдите в соответствующую запись в журнале и нажмите возврат.
Вы увидите заранее заполненную форму; нажмите на Изменить, чтобы произвести обратную версию.
Если вы просматриваете историю страницы и последнее изменение было измененным в модели контента, вы можете использовать функцию отменить, чтобы изменить модель контента обратно.
Rollback также отменит любые изменения в модели контента.
Обратите внимание, что это может не всегда работать, особенно если страница была изменена после изменения модели контента таким образом, чтобы она несовместима с старой моделью контента. Когда это произойдет, вам придется отменить изменения, которые сделали его несовместимым. В качестве альтернативы, вы можете изменить модель контента и архивировать старый контент. В идеале изменения в моделе контента мало. В большинстве случаев странице не нужно менять модель контента более одного раза.