帮助:横幅 - 版本历史

2021年10月17日 (日) 04:51 Admin

2021-10-17T04:51:08Z

←上一版本		2021年10月17日 (日) 12:51的版本
第2行：		第2行：
	有几种不同的方法可以在页面上设置横幅图像：		有几种不同的方法可以在页面上设置横幅图像：

	要<code>File:Image_name.jpg</code>用作自定义横幅图像，请将其设置在页面上：{{PAGEBANNER:Image_name.jpg}}		要<code>File:Image_name.jpg</code>用作自定义横幅图像，请将其设置在页面上：<nowiki>{{PAGEBANNER:Image_name.jpg}}</nowiki>
	该扩展可以自动将相同的横幅图像添加到指定命名空间的所有页面，通过设置 $wgWPBImage		该扩展可以自动将相同的横幅图像添加到指定命名空间的所有页面，通过设置 $wgWPBImage
	如果维基连接到维基数据，它还可以从那里获取每个页面的横幅。		如果维基连接到维基数据，它还可以从那里获取每个页面的横幅。

2021年10月17日 (日) 04:50 Admin

2021-10-17T04:50:57Z

←上一版本		2021年10月17日 (日) 12:50的版本
第2行：		第2行：
	有几种不同的方法可以在页面上设置横幅图像：		有几种不同的方法可以在页面上设置横幅图像：

	要<code>File:Image_name.jpg</code>用作自定义横幅图像，请将其设置在页面上：~~<code>~~{{PAGEBANNER:Image_name.jpg}}~~</code>~~		要<code>File:Image_name.jpg</code>用作自定义横幅图像，请将其设置在页面上：{{PAGEBANNER:Image_name.jpg}}
	该扩展可以自动将相同的横幅图像添加到指定命名空间的所有页面，通过设置 $wgWPBImage		该扩展可以自动将相同的横幅图像添加到指定命名空间的所有页面，通过设置 $wgWPBImage
	如果维基连接到维基数据，它还可以从那里获取每个页面的横幅。		如果维基连接到维基数据，它还可以从那里获取每个页面的横幅。

2021年10月17日 (日) 04:50 Admin

2021-10-17T04:50:39Z

←上一版本		2021年10月17日 (日) 12:50的版本
第1行：		第1行：
	== 用法 ==		== 用法 ==
	~~There are a few different ways to set a banner image on a page:~~		有几种不同的方法可以在页面上设置横幅图像：

	~~# To use~~ <code>File:Image_name.jpg</code> ~~as a custom banner image, set it on the page:~~<code~~><nowiki~~>{{PAGEBANNER:Image_name.jpg}}~~</nowiki>~~</code>		要<code>File:Image_name.jpg</code>用作自定义横幅图像，请将其设置在页面上：<code>{{PAGEBANNER:Image_name.jpg}}</code>
	~~# The extension can automatically add the same banner image to all pages of specified namespaces, set via the <code>~~$wgWPBImage~~</code>~~		该扩展可以自动将相同的横幅图像添加到指定命名空间的所有页面，通过设置 $wgWPBImage
	#		如果维基连接到维基数据，它还可以从那里获取每个页面的横幅。
	~~If the wiki is connected to Wikidata, it can also fetch each page's banner from there.~~

	=== Required Template ===		=== Required Template ===

2021年10月17日 (日) 04:49 Admin

2021-10-17T04:49:42Z

←上一版本		2021年10月17日 (日) 12:49的版本
第2行：		第2行：
	There are a few different ways to set a banner image on a page:		There are a few different ways to set a banner image on a page:

	# To use <code>File:Image_name.jpg</code~~></~~> as a custom banner image, set it on the page:~~</translate>~~ <code><nowiki>{{PAGEBANNER:Image_name.jpg}}</nowiki></code>		# To use <code>File:Image_name.jpg</code> as a custom banner image, set it on the page:<code><nowiki>{{PAGEBANNER:Image_name.jpg}}</nowiki></code>
	# The extension can automatically add the same banner image to all pages of specified namespaces, set via the <code>$wgWPBImage</code~~></~~>		# The extension can automatically add the same banner image to all pages of specified namespaces, set via the <code>$wgWPBImage</code>
	#		#
	If the wiki is connected to Wikidata, it can also fetch each page's banner from there.		If the wiki is connected to Wikidata, it can also fetch each page's banner from there.

2021年10月17日 (日) 04:49 Admin

2021-10-17T04:49:23Z

←上一版本		2021年10月17日 (日) 12:49的版本
第2行：		第2行：
	There are a few different ways to set a banner image on a page:		There are a few different ways to set a banner image on a page:

	# To use ~~<tvar\|1>~~<code>File:Image_name.jpg</code></> as a custom banner image, set it on the page:</translate> <code><nowiki>{{PAGEBANNER:Image_name.jpg}}</nowiki></code>		# To use <code>File:Image_name.jpg</code></> as a custom banner image, set it on the page:</translate> <code><nowiki>{{PAGEBANNER:Image_name.jpg}}</nowiki></code>
	# The extension can automatically add the same banner image to all pages of specified namespaces, set via the ~~<tvar\|1>~~<code>$wgWPBImage</code></> ~~[[<tvar\|2>#config</>\|configuration variable]].~~		# The extension can automatically add the same banner image to all pages of specified namespaces, set via the <code>$wgWPBImage</code></>
	#		#
	If the wiki is connected to Wikidata, it can also fetch each page's banner from there.		If the wiki is connected to Wikidata, it can also fetch each page's banner from there.

2021年10月17日 (日) 04:48 Admin

2021-10-17T04:48:48Z

←上一版本		2021年10月17日 (日) 12:48的版本
第1行：		第1行：
			== 用法 ==
	~~<!--T:2-->~~
	~~The <tvar name~~=~~1>'''WikidataPageBanner'''</tvar> extension adds pagewide banners on every page of specified namespaces of the wiki.~~
	~~</translate>~~

	~~<translate><!--T:3--> Pagewide banners are extensively used on Wikivoyage projects.</translate>~~
	~~<translate><!--T:4--> This extension is majorly inspired by [[voy:Template:Pagebanner\|Wikivoyage's Template:pagebanner]].</translate>~~

	~~<translate>~~
	==~~Installation~~=~~= <!--T:5-->~~
	~~</translate>~~
	~~{{ExtensionInstall\|WikidataPageBanner\|registration=required}}~~

	~~<translate>~~
	~~==Usage== <!--T:6-->~~
	~~</translate>~~
	There are a few different ways to set a banner image on a page:		There are a few different ways to set a banner image on a page:

	# ~~<translate><!--T:8-->~~ To use <tvar\|1><code>File:Image_name.jpg</code></> as a custom banner image, set it on the page:</translate> <code><nowiki>{{PAGEBANNER:Image_name.jpg}}</nowiki></code>		# To use <tvar\|1><code>File:Image_name.jpg</code></> as a custom banner image, set it on the page:</translate> <code><nowiki>{{PAGEBANNER:Image_name.jpg}}</nowiki></code>
	# ~~<translate><!--T:7-->~~ The extension can automatically add the same banner image to all pages of specified namespaces, set via the <tvar\|1><code>$wgWPBImage</code></> [[<tvar\|2>#config</>\|configuration variable]].~~</translate>~~		# The extension can automatically add the same banner image to all pages of specified namespaces, set via the <tvar\|1><code>$wgWPBImage</code></> [[<tvar\|2>#config</>\|configuration variable]].
	# ~~<translate><!--T:9-->~~		#
	If the wiki is connected to Wikidata, it can also fetch each page's banner from there.		If the wiki is connected to Wikidata, it can also fetch each page's banner from there.

	=== Required Template === ~~<!--T:10-->~~		=== Required Template ===
	</translate>		</translate>
	<translate><!--T:11--> Template:PAGEBANNER must exist.</translate>		<translate><!--T:11--> Template:PAGEBANNER must exist.</translate>

2021年10月17日 (日) 04:47 Admin

2021-10-17T04:47:50Z

@@ 第1行： / 第1行： @@
-<languages/>
 <!--T:2-->
 The <tvar name=1>'''WikidataPageBanner'''</tvar> extension adds pagewide banners on every page of specified namespaces of the wiki.

Admin：创建页面，内容为“ {{ReadingWebExtension}} {{Extension |status = stable |type1 = Parser Function |type2 = |username = Sumit |author…”

2021-10-17T04:46:39Z

创建页面，内容为“<languages/> {{ReadingWebExtension}} {{Extension |status = stable |type1 = Parser Function |type2 = |username = Sumit |author…”

新页面

<languages/>
{{ReadingWebExtension}}
{{Extension
|status = stable
|type1 = Parser Function
|type2 =
|username = Sumit
|author = (under the mentorship of [[User:Jdlrobson]] and [[User:Syced]]).
|description = <translate> Adds pagewide banners at the top of pages in specified namespaces</translate>
|image = banner_ex.png
|imagesize = 350px
|version preview =
|update preview =
|mediawiki =
|php = 5.4+
|composer =
|table1 =
|table2 =
|download = {{WikimediaDownload}}
|readme = {{git file|project=mediawiki/extensions/WikidataPageBanner|branch=HEAD|file=README|text=README}}
|changelog =
|example =
|namespace =
|tags = pagebanner
|compatibility =
|phabricator = wikidata-page-banner
}}
<translate>

The <tvar name=1>'''WikidataPageBanner'''</tvar> extension adds pagewide banners on every page of specified namespaces of the wiki.
</translate>

<translate> Pagewide banners are extensively used on Wikivoyage projects.</translate>
<translate> This extension is majorly inspired by [[voy:Template:Pagebanner|Wikivoyage's Template:pagebanner]].</translate>

<translate>
==Installation== 
</translate>
{{ExtensionInstall|WikidataPageBanner|registration=required}}

<translate>
==Usage== 
</translate>
There are a few different ways to set a banner image on a page:

# <translate> To use <tvar|1><code>File:Image_name.jpg</code></> as a custom banner image, set it on the page:</translate> <code><nowiki>{{PAGEBANNER:Image_name.jpg}}</nowiki></code>
# <translate> The extension can automatically add the same banner image to all pages of specified namespaces, set via the <tvar|1><code>$wgWPBImage</code></> [[<tvar|2>#config</>|configuration variable]].</translate>
# <translate>
If the wiki is connected to Wikidata, it can also fetch each page's banner from there.

=== Required Template === 
</translate>
<translate> Template:PAGEBANNER must exist.</translate>
<translate> It can be empty.</translate>
<translate> Wikivoyage has an example of a [[voy:Template:Pagebanner|complex Template:PAGEBANNER]] with rendering logic and additional template dependencies.</translate>

<translate>
==Parameters to the <tvar name=1><nowiki>{{PAGEBANNER}}</nowiki></tvar> function== 


The following parameters are supported to the <tvar name=1><code><nowiki>{{PAGEBANNER}}</nowiki></code></tvar> parser function:
</translate>
* <code>pgname</code> — <translate> Adds a custom title to the banner.</translate>
* <code>icon-*</code> — To add custom icons, add the parameter <code>icon-<icon_name>=<Article about icon></code> (where <code><icon_name></code> is any icon name that you want). Then define a background-image on <code>.oo-ui-icon-<icon_name></code>, in MediaWiki:Common.css to use as the icon. Do this for any number of icons to add to the page.
* <code>tooltip</code> — Use <code>tooltip=image-caption</code> to show image description on hovering over image.
* <code>toc</code> — Use <code>toc=yes</code> to enable a Table Of Contents within banner.
* <code>bottomtoc</code> — Use <code>bottomtoc=yes</code> to push Table Of Contents below banner. This will affect only the page on which its used. To set site-wide ToC at bottom, see [[#Styling]] below.
* <code>extraClass</code> — Use <code>extraClass=<css-class names></code> (separated by spaces) to add additional classes to banners which can be used to customize it using styles in MediaWiki:Common.css
* <code>origin</code> — See [[#origin]] parameter below.
* <code>link</code> — Sets the target of the banner link and operates the same as the [[Help:Images#Altering_the_default_link_target|link parameter]] for images (e.g. <code>link=Event name</code> will link to the 'Event name' page rather than the banner image page). Set to no value to remove the link, i.e. <code>link=</code>.

{{anchor|origin}}
<translate>
=== <tvar name=1>'origin'</tvar> parameter === 
</translate>
[[File:WikidataPageBanner coordinates, landscape.svg|thumb|Banner coordinate system.]]
<translate> Use this parameter to define a suggested focal area of the image.</translate>
<translate> This is used to crop the banner appropriately on small screens.</translate>
<translate> The value of the parameter should consist of an X and a Y coordinate separated by a comma.</translate>
<translate> Each coordinate represents the distance from the center of the image as a value from -1 to 1.</translate>
<translate> For example, <tvar name=1><code>origin=1,1</code></tvar> is the top right corner and <tvar name=2><code>origin=-1,1</code></tvar> is the bottom right corner.</translate>
<translate> See the image at right for a graphical representation of the coordinates.</translate>

<translate> Note, as currently implemented, the origin parameter is meant for images that are much larger than the target banner (e.g. panoramas or portrait photos).</translate>
<translate> It will not reposition banners where the repositioning leads to empty whitespace within the banner space.</translate>
<translate> For example, if the banner is being rendered at 320px width and 180px height, an image that is also 320px and 180px cannot be repositioned at all; an image that is 600px width by 180px height can be repositioned horizontally and an image that is 320px width and 1000px height can be repositioned vertically.</translate>

{{anchor|config}}
<translate>
==Configuration variables == 

</translate>
<translate> <tvar name=1>'''$wgWPBImage'''</tvar> is used to set the default banner image to be used.</translate>
<translate> Add image name without prefixing 'File:' namespace.</translate>
<translate> If the wiki does not need default banners, do not edit this field.</translate>

<syntaxhighlight lang="php">
$wgWPBImage = "foo.jpg";
</syntaxhighlight>

'''$wgWPBBannerProperty''' Banner property on Wikidata which holds a commons media file. Essential if Wikidata is enabled.

<syntaxhighlight lang="php">
$wgWPBBannerProperty = "P948";
</syntaxhighlight>

'''$wgWPBEnableDefaultBanner''' enables the default banner image on pages without the use of <code><nowiki>{{PAGEBANNER}}</nowiki></code>.

<syntaxhighlight lang="php">
$wgWPBEnableDefaultBanner = true;
</syntaxhighlight>

<translate> <tvar name=1>'''$wgWPBNamespaces'''</tvar> array of namespaces on which to display the banner.</translate>
<translate> Default is Main namespace.</translate>
<translate> It can also be set to <tvar name=2>{{php|true}}</tvar>, in which case it'll enable banner on all Namespaces, except those excluded by <tvar name=1>'''$wgWPBDisabledNamespaces'''</tvar>.</translate>

<syntaxhighlight lang="php">
$wgWPBNamespaces = [ NS_MAIN ];
</syntaxhighlight>

<translate> <tvar name=1>'''$wgWPBDisabledNamespaces'''</tvar> excludes certain namespaces from showing banner.</translate>
<translate> Note that this parameter only has effect if <tvar name=1>{{phpi|$wgWPBNamespaces}}</tvar> is <tvar name=2>{{phpi|true}}</tvar>.</translate>
<translate> Otherwise, this parameter is disregarded and only namespaces in <tvar name=1>$wgWPBNamespaces</tvar> are considered.</translate>

<syntaxhighlight lang="php">
$wgWPBDisabledNamespaces = [ NS_FILE ];
</syntaxhighlight>

'''$wgWPBStandardSizes''' is an array of standard predefined screen widths in increasing order of size.

<syntaxhighlight lang="php">
$wgWPBStandardSizes = [ 320, 640, 1280, 2560 ];
</syntaxhighlight>

'''$wgWPBEnablePageImagesBanners''' when set to true and {{ll|Extension:PageImages}} is installed will use a page image when no Wikidata image or locally defined image is set.

<syntaxhighlight lang="php">
$wgWPBEnablePageImagesBanners = true;
</syntaxhighlight>

'''$wgWPBDisplaySubtitleAfterBannerSkins''' is an array of names of skins that should have the banner displayed in the site-notice area, instead of in the page subtitle (which is the default).

<syntaxhighlight lang="php">
$wgWPBDisplaySubtitleAfterBannerSkins = [ 'minerva' ];
</syntaxhighlight>

'''$wgWPBEnableHeadingOverride''' determines whether the page title is displayed overlayed on the banner image. Defaults to true.

<syntaxhighlight lang="php">
$wgWPBEnableHeadingOverride = true;
</syntaxhighlight>

'''$wgWPBEnableMainPage''' determines whether a banner is allowed to be shown on the {{manual|Main Page}}. Defaults to false.

<syntaxhighlight lang="php">
$wgWPBEnableMainPage = false;
</syntaxhighlight>

==Examples==

A few use examples with explanation:

<syntaxhighlight lang="php">
{{PAGEBANNER:Grand_canyon.jpg}}
</syntaxhighlight>

Will add a banner using image [[commons:Grand_canyon.jpg|Grand_canyon.jpg]] as source locally or from wikimedia commons.

<syntaxhighlight lang="php">
{{PAGEBANNER:Grand_canyon.jpg|icon-star=<Name of star article>|icon-unesco=<Name of Unesco Article>}}
</syntaxhighlight>

Will add a banner using image Grand_canyon.jpg as source locally or from wikimedia commons.
Additionally will add icons with class names oo-ui-icon-star, oo-ui-icon-unesco.
Set '''background-image''' property on theses classes in MediaWiki:Common.css to your desired icon.

<syntaxhighlight lang="php">
{{PAGEBANNER:Grand_canyon.jpg|toc=yes|pgname=Some page}}
</syntaxhighlight>

Will add a banner using image Grand_canyon.jpg as source locally or from Wikimedia Commons.
Additionally adds a Table of Contents inside banner.
Sets the name displayed on banner as '''Some page'''.

<syntaxhighlight lang="php">
{{PAGEBANNER:Grand_canyon.jpg|extraClass=class1 class2}}
</syntaxhighlight>

This will add a banner using the ''Grand_canyon.jpg'' image as source either locally or from Wikimedia Commons.
It additionally adds CSS classes ''class1'' and ''class2'' to the '''.wpb-topbanner''' div.

==Example usage for banner from Wikidata==

Make sure <code>$wgWPBBannerProperty</code> is set to correct Wikidata banner property.
Then leave the image name empty, and set any other required parameters:

<syntaxhighlight lang="text">
{{PAGEBANNER:|other options...}}
</syntaxhighlight>

This will use the banner image as set on the page's Wikidata item.
If there is no banner image set for that item, or the page doesn't have a Wikidata item,
a default image may be used (if <code>$wgWPBImage</code> is set).

==Styling==

The extension has ample scope for styling the banner via [[Common.css]].
Here are some examples of common CSS changes.

<syntaxhighlight lang="css">
.wpb-topbanner-toc {
position: relative;
}
</syntaxhighlight>

This sets the ToC to appear just below the banner in case it's long.
Note that doing this would cause every banner page on a wiki to have the ToC at the bottom of the banner.
However, using <code>bottomtoc=yes</code> as a paramter would only show the ToC at the bottom on the page it's used.

<syntaxhighlight lang="css">
.wpb-topbanner .wpb-name {
font-size: 1em;
}
</syntaxhighlight>

Would set the font size of the banner name to 1 em (smaller than the default 2.2 em).

<syntaxhighlight lang="css">
.wpb-banner-toc {
line-height: 1em;
}
</syntaxhighlight>

Would reduce the vertical spacing between lines of the ToC.

<syntaxhighlight lang="css">
.wpb-topbanner-toc {
margin-top: 5px;
}
</syntaxhighlight>

Would set some blank space between the banner and ToC.

{{OnWikimedia}}

[[Category:Advertising extensions{{#translation:}}]]
[[Category:Notification extensions{{#translation:}}]]
[[Category:Wikibase extensions{{#translation:}}]]

帮助:横幅 - 版本历史

2021年10月17日 (日) 04:51 Admin

2021年10月17日 (日) 04:50 Admin

2021年10月17日 (日) 04:50 Admin

2021年10月17日 (日) 04:49 Admin

2021年10月17日 (日) 04:49 Admin

2021年10月17日 (日) 04:48 Admin

2021年10月17日 (日) 04:47 Admin

Admin：​创建页面，内容为“ {{ReadingWebExtension}} {{Extension |status = stable |type1 = Parser Function |type2 = |username = Sumit |author…”

Admin：创建页面，内容为“ {{ReadingWebExtension}} {{Extension |status = stable |type1 = Parser Function |type2 = |username = Sumit |author…”