扩展名:通用语言选择器

来自MediaWiki.org
跳转到导航 跳转到搜索
其他语言:
印度尼西亚语 • ‎德国 • ‎英语 • ‎蒂尔克çe • ‎加泰罗尼亚 • ‎西班牙 • ‎法国 • ‎意大利人 • ‎马扎尔 • ‎波兰语 • ‎葡萄牙语 • ‎西西里努 • ‎русский • ‎سنڌي • ‎अवधी • ‎हिन्दी • ‎中文 • ‎日本語 • ‎ꯃꯤꯇꯩ ꯂꯣꯟ • ‎한국어
MediaWiki扩展手册
OOjs UI icon advanced.svg
通用语言选择器
发布状态: 稳定的
ULS-Display-Settings.png
实施 用户界面,皮肤 ,Beta功能
说明 该工具允许用户以一种简单的方式选择一种语言并配置其支持。
作者 维基媒体语言团队
最新版本 2020年7月20日
兼容性策略 主人
维基百科 1.32个+
作曲家 mediawiki/通用语言选择器
许可证
下载 包含在语言扩展包中
  • $wgULSGeoService公司
  • $wgULSCompactLinksEnableAnon
  • $wgulsnoimemelectors公司
  • $wgULSFontRepositoryBasePath
  • $wgULSEventLogging
  • $wgulsenableenon美元
  • $wgULSLanguageDetection(语言检测)
  • $wgulsanoncanchanange语言
  • $wgULSEnable启用
  • $wGulsimeSelector
  • $wgulsime已启用
  • $wGulsCompactLinksForenWaccounts
  • $wgULSCompactLanguageLinksBetaFeature
  • $WgulsNowWebFontsSelectors
  • $WgulsMobileWebFonts已启用
  • $wgULSPosition美元位置
  • WebFontWeb表格
与Internet Explorer 8或更低版本不兼容.
转换UniversalLanguageSelector扩展如果在translatewiki.net上有
检查使用情况和版本矩阵。
问题 打开的任务·报告错误

这个通用语言选择器是一个工具,它允许用户以一种简单的方式选择一种语言并配置其支持。在使用时,它还提供了两者的功能网络字体纳拉亚姆扩展(这两种扩展都被弃用,转而支持通用语言选择器)。通用语言选择器背景和附加信息。

使用[编辑]

其主要目的是允许用户选择一种语言并以一种简单的方式配置其支持。

扩展提供以下功能:

  1. 从大量的语言中选择一种灵活的方式。
    1. 可根据地理区域进行选择浏览、搜索。
    2. 搜索可以基于ISO语言代码、用当前用户界面语言编写的语言名称或以其自己的脚本(自动命名)进行搜索
    3. 跨语言搜索-使用任何脚本搜索语言名称
    4. 语言名称的自动完成
    5. 自动更正搜索字符串中的拼写错误
    6. 基于Geo-IP的语言建议
    7. 基于用户浏览器/操作系统语言的语言选择
  2. 输入法
    看到了吗帮助:扩展:UniversalLanguageSelector/Input方法 完整的说明。
    1. 一个容易选择的输入法集合,在每个可编辑的字段中都可以使用
    2. 为各种语言提供了大量的输入方法
    3. 按语言输入法首选项
  3. 网络字体
    1. 为每种语言选择用作页面嵌入字体的大量字体集合
    2. 每种语言的字体首选项
为来自西班牙的用户提供基于geoip的语言建议的通用语言选择器
语言设置允许访问英文维基百科的注册用户将用户界面更改为其母语。
一个孟加拉用户可以阅读孟加拉语维基百科的内容,尽管他们的计算机缺少字体。Web字体是为可使用开源字体的非拉丁语脚本自动提供的。用户可以根据每种语言决定使用其系统字体。
没有印地语键盘的印地语使用者可以配置输入法,以便输入他们的语言。
搜索时,用户可以在英语和印地语之间切换。

添加字体[编辑]

支持更多的语言只是在代码中包含适当的字体。不过,请注意,我们只支持免费许可字体,例如根据GNU GPL、SIL OFL等授权的字体谷歌字体 [1](此扩展的作者尚未充分研究/利用);另请参见打开字体库.

首先,你需要找到或产生这样一个自由字体(这是最重要的部分,你必须自己做);然后,它必须转换成所需的格式,即eot、ttf、woff;最后,你可以提出请求在里面汽化器要添加到扩展的字体。

#准备Web字体下面解释如何转换字体:需要了解基于GNU/Linux的操作系统的基本知识;如果您在这方面有困难,可以跳过这一步,并在同一个Phabricator请求下让其他人为您完成转换(当然这会减慢过程)。

准备Web字体[编辑]

创建.woff2:

使用https://github.com/google/woff2从ttf生成woff2。这将生成一个压缩的woff2文件。现代浏览器支持这种格式。

创建一个font.ini文件。下面是一个例子:

[阿比西尼卡西尔]
语言=*, ti公司*
版本=1.200
许可证=OFL公司 1.1
许可文件=OFL公司.文本
网址=http协议://scripts.sil.org/abysinicasil

星号(*)在语言代码后,表示此字体将是该语言的默认字体。如果你只想选择使用这种字体的语言,不要使用星号。

创建文件后,请执行以下操作:

  1. 在data/fontrepo/fonts下为字体创建一个目录。
  2. 将ttf、woff、eot和font.ini文件放在该目录下,并将它们添加到源存储库中(git添加).
  3. 转到data/fontrepo/scripts并运行php编译.php.
  4. 将更改提交到存储库(git提交-a)并根据Git工作流.

添加对新键映射(输入法)的支持[编辑]

跟随jquery.ime github wiki上的说明,但文件请求位于Wikimedia extensions UniversalLanguageSelector中汽化器产品。

下载[编辑]

可以直接从Git检索扩展[?]:

  • 浏览代码
  • 一些扩展有稳定版本的标签。
  • 每个分支都与以前的MediaWiki版本相关联。还有一个“主”分支包含最新的alpha版本(可能需要MediaWiki的alpha版本)。

提取快照并将其放入扩展/通用语言选择器/MediaWiki安装目录。

如果您熟悉git,并且对您的服务器具有shell访问权限,您还可以获得如下扩展名:

cd扩展名/
 git克隆https://gerrit.wikimedia.org/r/mediawiki/extensions/UniversalLanguageSelector.git

安装[编辑]

  • 下载并将文件放入名为通用语言选择器在你的扩展/文件夹。

正在更新LanguageNameIndex[编辑]

用于执行跨语言搜索,搜索自动命名,需要填充语言数据。ULS附带了一个预先填充的语言名称索引(data/langnames.ser)。如果您想更新它,请安装分机:CLDR并使用以下命令更新数据。

php通用语言选择器/data/LanguageNameIndexer.php

并核实语言名称.ser文件在ULS/data/folder中生成。

配置[编辑]

以下变量是在初始化过程中自动创建的,可以使用mw.config.get(NAME)从JavaScript中使用:

  • Wguls语言-一种关联数组,其中键是语言代码,值是英语语言名。
  • wgULSAcceptLanguageList-来自用户接受语言值的语言代码数组。这些是在用户的浏览器首选项中选择的语言。

对于提供字体,您可能需要将以下mime类型添加到您的web服务器(如果还没有)。本指南可能会有帮助。

应用程序/x-font-woff.woff 
应用程序/vnd.ms-fontobject.eot 
应用程序/x-font-ttf.ttf

还可以配置以下变量:

  • $wgULSGeoService公司-ULS可以使用地理定位服务,根据用户访问的国家来建议语言。将此设置为false将阻止使用内置地理位置。您可以通过将window.Geo设置为键为“country_code”或“country”的对象来提供自己的地理位置。如果设置为true,它将查询Wikimedia的geoip服务。服务应该返回使用提供的回调参数的jsonp。默认为http://freegoip.net/json/并期望相同的格式。
  • $wgULSEnable启用-为每个人启用语言选择、压缩语言链接、输入方法和webfonts,除非行为被下面的配置变量覆盖。即使为false,类和资源加载程序模块也注册为使用其他扩展。无法通过cookie或setlang查询参数更改语言。
  • $wgulsanoncanchanange语言-允许匿名用户使用cookie和setlang query param更改语言。如果缓存匿名页面视图时不考虑cookie,请不要使用。没有任何影响,如果$wgULSEnable启用$wgulsenableenon美元设置为false。
  • $wgulsime已启用-默认情况下,对所有用户禁用输入法功能。仍然可以由用户手动启用。
  • $wgULSPosition美元位置-语言选择触发器的位置和形式。可能的值是:个人的:作为个人工具栏中用户名或登录链接附近的链接(默认)。中介语:作为侧栏中中介语链接列表标题附近的图标。
  • $wgulsnoimemelectors公司-不能在其上启用IME的元素的jQuery选择器数组。如:['#wpCaptchaWord'];

ULS触发器位置[编辑]

  • $wgULSPosition美元位置-语言选择触发器的位置和形式。可能的值是:个人的:作为个人工具栏中用户名或登录链接附近的链接(默认)。中介语链接:在标题栏的图标旁边的链接。

也可以在屏幕的任何地方触发ULS。具有uls设置触发将充当ULS触发器。

替代默认字体[编辑]

ULS有一个大字体库作为web字体。有时一种语言有多种字体,每种语言/脚本都有一个默认字体。可使用以下特殊字体(myjs)覆盖myjs或通用字体(默认为:通用或通用字体):

缓存配置[编辑]

要确保web字体文件缓存在客户端计算机上,必须将字体文件类型添加到web服务器配置中。在Apache2中,这包括:

  • 将字体文件扩展名添加到相关目录的FileTimes regex的filematch,例如:

<FilesMatch“\(gif |日元?g | png | css | js | woff | svg | eot | ttf)$“>

  • 将ExpiresByType值添加到相关的MIME类型,类似于图像MIME类型。
    • 注意,TTF没有标准的MIME类型。application/x-font-ttf用于Wikimedia。
  • 添加MIME类型:
AddType应用程序/x-woff.woff 
 AddType应用程序/vnd.ms-fontobject.eot 
添加类型应用程序/x-font-ttf.ttf

有关完整示例,请参见Wikimedia群集的缓存配置更新已完成.

页面翻译[编辑]

UniversalLanguageSelector是翻译扩展名,它将其用于多个语言选择功能。其中之一是我的语言系统的链接,这取决于用户的界面语言,但可以配置更多:请参阅页面翻译功能.

使用网络字体[编辑]

用户可以从语言设置->显示设置中选择语言的Web字体。默认情况下,将在该菜单中首先应用该字体。用户可以在页面上改变字体。用户也可以选择系统字体来禁用字体嵌入。

如果该字体在用户的本地系统中可用,不会下载字体从mediawiki服务器。从用户的电脑上取下来。否则,将只从服务器下载一次字体。当用户第一次选择字体时。下一次以后,字体将从本地缓存中获取。

加载字体的其他方法[编辑]

通过指定字体系列[编辑]

在wiki文本<span style=“font-family:'YourFontName';”>YourText</span>中,webfonts扩展将检查该字体是否与扩展一起可用,如果有,它将下载到客户端。因此,即使指定的字体在计算机中不可用,读者在阅读文本时也不会遇到任何困难。

通过指定语言[编辑]

在wiki文本<span lang=“my”>yourtextension中,webfonts extension将检查是否有任何字体可用于具有扩展名的给定语言,如果有,它将下载到客户端。因此,即使指定的字体在计算机中不可用,读者在阅读文本时也不会遇到任何困难。如果该语言有多个字体,则将使用默认字体。如果默认字体不是首选字体,请使用字体系列方法指定字体。如果标记同时具有lang和font-family定义,则字体系列优先。

例子:

<span lang=sux>𒄖𒉈𒅁𒌨𒅎</span>

给出使用阿卡迪亚字体以楔形文字呈现的文本

𒄖𒉈𒅁𒌨𒅎

另请参见[编辑]