Tools 是非官方社区Wiki。社区文档正在编写中,欢迎参与。 Wiki编辑答疑群:717421103
版本250722.2
全站通知:

帮助:解析函数/seo

来自WIKI实验室WIKI_BWIKI_哔哩哔哩
跳到导航 跳到搜索

seo是一个解析函数。帮助:解析函数页列出了所有解析函数的说明。

seo

设置页面的SEO元数据,包括HTML标题、搜索引擎指令和社交媒体卡片信息。出自扩展 WikiSEO

语法

{{#seo:|可选参数=值|...}}

  • title:设置HTML页面标题,影响搜索引擎结果和社交媒体分享。也会设置meta og:title(<meta property="og:title" content="指定的title"/>
  • title_mode:标题修改模式(replace 替换,默认值;prepend 前置;append 追加)
  • title_separator:标题分隔符(默认"-"),当标题修改模式为前置/追加时,使用的分隔符
  • keywords:页面关键词(逗号分隔)。部分搜索引擎收录页面时会参考。(会向页面添加<meta name="keywords" content="页面关键词"/>
  • description:页面描述。部分搜索引擎收录页面时会参考。(会向页面添加<meta name="description" content="页面描述"/>

OpenGraph相关参数。参阅ogp.me。共享到社交媒体时,提供额外的信息。

  • image:社交媒体卡片图片(og:image),本地文件名或URL。分享时,社媒通常会优先使用此图片展示分享内容
  • image_alt:图片描述(og:image:alt)
  • image_width 和 image_height:图片宽高(og:image:width、og:image:height),以像素为单位。如果设置了image,这两个属性会自动设置
  • type:内容类型(og:type),常见值:website / article / video.movie / music.song / book
    type=article时,支持参数
    • author:作者
    • section:本内容所在章节
    • published_time:发布时间(ISO 8601格式,如2012-01-25)
  • locale:OpenGraph相关参数使用的语言(og:locale),如"en-US"
  • site_name:网站名,仅用于 og:site_name

爬虫相关参数

  • robots:搜索引擎爬虫指令(如"noindex,nofollow")。部分搜索引擎不会遵循。
  • googlebot:谷歌搜索引擎爬虫指令(如"noindex,nofollow")。
  • hreflang_xx-xx: 告诉搜索引擎当前页面有其他语言或针对不同地区的版本,xx-xx是语言代码。相当于为页面添加<link rel="alternate" href="url" hreflang="xx-xx">

引用相关参数(Citation generator)

  • 由于BWiki没有启用,相关参数无效。有需要请参考官方文档

示例

  • {{#seo:|title=自定义标题|description=页面描述}} → 设置独立标题和描述
  • {{#seo:|title=前缀|title_mode=prepend|title_separator=-}} → 生成"前缀-原标题"格式
  • 多参数使用
{{#seo:
|title=Tools Wiki_BWIKI_哔哩哔哩
|title_mode=replace
|keywords=bwiki, bwiki文档, 解析函数, 模板, 小工具,mediawiki
|description=由BWiki平台用户编辑维护,这个非官方社区提供BWiki常用的模板、组件、文档。交流群可互助答疑。
|image=Tools_icon.png
}}

底层代码

请参考:https://github.com/wikimedia/mediawiki-extensions-WikiSEO/tree/cef70c87aff126765dccbfecab9b83cb792cc07e

实际用例

一些Wiki使用了相关特性,如下所示这个静态列表可能在下列页面更改后过时仅供批判性参考