扩展:维基媒体消息

MediaWiki扩展手册

WikimediaMessages 发行状态： 稳定版
实现	用户界面
描述	添加维基媒体基金会特定消息及语法，以及维基媒体基金会特定的覆盖许可证或法律相关的消息
作者	Tim Starling Siebrand Mazeland James D. Forrrester Multichill
MediaWiki	1.25+
数据库更改	否
许可协议	GNU通用公眾授權條款2.0或更新版本
下載	下載扩展 Git [?]: 浏览存储库 (GitHub) Gerrit代码复核 Git提交日誌 下載原始碼(tarball壓縮)
参数 $wgWikimediaMessagesLicensing $wgWikimediaMessagesAnonDonateLink $wgWikimediaStylesSkins
使用的函数钩 BeforePageDisplay CampaignEventsGetPolicyMessageForRegistration CampaignEventsGetPolicyMessageForRegistrationForm DiscussionToolsTermsOfUseMessages EditPageCopyrightWarning FlowTermsOfUseMessages MessageCacheFetchOverrides ResourceLoaderRegisterModules SidebarBeforeOutput SkinAddFooterLinks SkinCopyrightFooterMessage SkinTemplateNavigation::Universal SpecialPageBeforeExecute TorBlockBlockedMsg UploadForm:initial
季度下載量	4 (Ranked 73rd)
正在使用的公开wiki数	933 (Ranked 263rd)
前往translatewiki.net翻譯WikimediaMessages扩展
問題	开启的任务 · 报告错误

维基媒体消息（WikimediaMessages）添加维基媒体基金会特定消息及语法，以及维基媒体基金会特定的覆盖许可证或法律相关的消息

安裝

• 下载文件，并将解压后的WikimediaMessages文件夹移动到extensions/目录中。
  开发者和代码贡献人员应从Git安装扩展，输入：

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/WikimediaMessages
  

• 将下列代码放置在您的LocalSettings.php 文件的底部：

  wfLoadExtension( 'WikimediaMessages' );
  

• 完成 – 在您的wiki上导航至Special:Version，以验证已成功安装扩展。

Responsibilities

WikimediaMessages has several responsibilities which are documented here.

Cross-project message modification

The WikimediaMessages extension can be used to alter messages so they apply across sites. For example, to set the donate URL to point to "https://donate.wikimedia.org/" the sitesupport-url message can be modified by editing MediaWiki:sitesupport-url, however this will only apply to one wiki. The WikimediaMessages allows you to set the message for all wikis without needing to modify every site.

Note after changing a message you may need to rebuild the localization cache.

Defining new messages

You can define messages that are not defined in any other repository by modifying the associated language JSON files in i18n/wikimedia

Note if you want to override a message defined elsewhere, follow the guidelines for overrides.

Overriding existing messages

If a message exists in a repo and you want to override the message:

1. Define these messages in the wikimediaoverrides folder. Make sure to append the message key of the message you want to override with "wikimedia-". For example: The message "foo" can be overridden using a key "wikimedia-foo"
2. Update the hook onMessageCacheFetchOverrides in Hook.php so that the message for overriding is in the array of messages to override. Make sure to list the key of the message you are wanting to override (e.g. without the "wikimedia-" prefix)

Contact page styles

The WikimediaMessages extension adds the ext.wikimediamessages.contactpage module which adds Wikimedia-specific customisation to Extension:ContactPage.

Site admin helper

Many templates and associated styles were defined over a decade ago, and in many cases for many projects lack maintainers. The ext.wikimediamessages.styles module allows shipping of global styles for common templates across Wikimedia to apply Recommendations_for_night_mode_compatibility_on_Wikimedia_wikis and Recommendations for mobile friendly articles on Wikimedia wikis. The expectation is that community members at their own pace should upstream styles from this module into their own templates.

Finding styles

The styles provided are listed in the modules/ext.wikimediamessage.styles folder. Each file name corresponds with a "key".

The styles are expressed using LESS which is not available on wiki but an administrator can adapt these styles locally.

Disabling styles

In some cases styles won't apply to a project. For example the navbox and hatnote styles are not applicable to a project which uses neither of these templates. To disable the styles in hatnote.less and navbox.less an interface administrator can modify MediaWiki:wikimedia-styles-exclude with the text hatnote|navbox.

When disabling styles we recommend understanding what the styles are doing and first upstreaming relevant styles first.

To disable all styles provided by Wikimedia (not recommended unless you know what you are doing) the message can be set to:

ambox|hatnote|infobox|navbox|theme-night-mainpage|theme-night|theme-night-portal

Applying styles only to specific skins

If you want the styles to not apply to a certain skin, you generate the raw stylesheet prior to disabling a package of styles and copy and paste relevant styles to one of the skin site CSS pages e.g. MediaWiki:Minerva.css, MediaWiki:Vector-2022.css etc..

You can generate the full list of styles by visiting /w/load.php?lang=en&modules=ext.wikimediamessages.styles&debug=1&only=styles on your wiki. For example on English Wikipedia: https://en.wikipedia.org/w/load.php?lang=en&modules=ext.wikimediamessages.styles&debug=1&only=styles.