维基导游:VCard/install
本页旨在为其他维基导游分支实现 vCard 与 Marker 模块提供支持。
模块导入
[编辑]请将下列所有模块导入至本地维基。注意：请勿更改模块名称；调用模板的名称可自行决定。
导入后，这些模块应已可正常运行。
所需模块
[编辑]Module:Coordinates
、Module:Coordinates/i18n
、Module:CountryData
、Module:CountryData/Currencies
、Module:CountryData/Geography
、Module:Exchange rate
、Module:Hours
、Module:Hours/i18n
、Module:Languages
、Module:Link utilities
、Module:Link utilities/i18n
、Module:LinkMail
、Module:LinkPhone
、Module:Link_utilities/Phone_numbers
、Module:LinkSkype
、Module:Marker utilities
、Module:Marker utilities/Groups
、Module:Marker utilities/i18n
、Module:Marker utilities/Maki icons
、Module:Marker utilities/Types
、Module:PageData
、Module:UrlCheck
、Module:UrlCheck/i18n
、Module:VCard
、Module:VCard/Cards
、Module:VCard/i18n
、Module:VCard/Params
、Module:VCard/Qualifiers
、Module:VCard/Subtypes
、Module:Wikidata utilities
、Module:Yesno
此外，若需安装 Marker 模块，还需额外导入以下模块：
Module:Marker 、Module:Marker/Params
本地化
[编辑]本地化可使两模块适配各本地维基的具体需求，因此代码模块与本地化模块是分离的。
推荐优先翻译并适配以下模块：VCard/i18n、Marker/Params 及 Marker utilities/i18n。
某些模块内包含 Wikidata 实体的标签翻译。这是必要的，因为额外获取 Wikidata 实体的计算开销较大，且每页最多仅允许 400 次实体调用。借助这些本地化表格，通常每次模板调用仅需一次实体请求。考虑到单页最大计算时间为 10 秒，每页可调用约 150 至 200 个 {{vCard}} 模板。
- 高优先级
- 适配
- VCard/Params — 若存在本地参数名，请予以添加。主要工作量不大；但可在
p=列表中修改，以使用本地语言参数名替代英文参数名。 - Marker utilities/i18n — 配置显示与维护选项。
- VCard/Params — 若存在本地参数名，请予以添加。主要工作量不大；但可在
- 翻译
- Marker utilities/i18n
完成 — 其中包含大量维护分类。 - Hours/i18n 完成 — 时间与日期标签，以及部分维护分类。
- VCard/Qualifiers 完成 — 联系方式与价格的限定词。
- Marker utilities/i18n
- 适配
- 中优先级
- 翻译
- Coordinates/i18n 完成 — 坐标相关的错误提示与分类名；需适配方向字母（如 N/S/E/W）。
- CountryData/Geography 完成 — 每个条目需含该国在本地维基语言下的名称（
country=xxx）；改动较小。 - Link utilities/i18n 完成— 主要为维护与错误分类的名称。
- VCard/Subtypes 完成 — 酒店、餐厅等场所的分类与设施（如星级酒店、酒店泳池、餐厅菜系等）。
- Marker utilities/Groups 完成 — 类型标签仅由列表编辑器使用；必要时可添加别名。
- MediaWiki:Gadget-ListingEditor.js — 翻译并补充至注释行 “Stop translation here” 之前的内容。
- Coordinates/i18n
- 翻译
- 低优先级
- 适配
- VCard/i18n — 仅在必要时调整。
- 翻译
- Marker utilities/Types — 分组标签同时被 vCard/列表模块与列表编辑器使用。
map参数由地图图层工具调用，其字符串仅可含 A–Z、a–z 及 0–9 字符；请翻译标签为本地维基语言，并酌情添加别名。 - UrlCheck/i18n — URL 处理相关的错误提示；此类字符串目前仅用于维护，尚未被 vCard/列表模块使用。
- VCard/Cards — 需翻译的字符串较少。
- Marker utilities/Types — 分组标签同时被 vCard/列表模块与列表编辑器使用。
- 适配
在 Wikidata 中注册
[编辑]请将所有模块在 Wikidata 中注册，以便在代码更新时通知管理员。
模板命名
[编辑]模块仅通过模板调用，模板名称可自由选择。
所需样式
[编辑]模板调用方式
[编辑]模板代码可按如下方式编写。第二种调用方式适用于默认不使用 type 参数的模板（例如 see、do 或类似模板）。
<templatestyles src="VCard/styles.css" />{{#invoke: vCard | vCard }}
或
<templatestyles src="VCard/styles.css" />{{#invoke: vCard | vCard | type = see }}
附加工具
[编辑]如需实施附加工具，请参阅 Marker Package，其中列出了相关工具及其样式表。
维护
[编辑]{{Marker}} 与 {{vCard}} 模板使用大量维护分类，应将其归入恰当的高层管理分类中。
- {{Modulversion}} — 用于比对模块内储存的版本号与 Wikidata 中记录的版本号。若二者不一致，该模块将被归入 Wikidata 中模块版本不一致 分类。
- 列表维护 — {{Marker}} 与 {{vCard}} 模板所用分类的维护类别。
- 使用 Wikidata 属性的页面 — 使用 Wikidata 属性的页面相关维护分类。
注意事项
[编辑]- 模板具备最大程度的 Wikidata 支持。由于 Wikidata 数据获取的计算开销巨大，实现过程颇具挑战。我们已优化至多数情况下每模板仅需调用一个 Q 实体（而非原先的 10–30 个），因此执行耗时与此前大致相当。已在 维也纳 与 哈勒（萨勒河畔） 页面完成测试：维也纳页面含 268 个 Listing 与 55 个 Marker 模板，其中 216 个从 Wikidata 获取数据。但耗时主因是
<maplink>调用，约占 40%。 wikipedia模板参数已弃用，请移除或替换为wikidata；但为向后兼容仍保留部分支持。type模板参数含义有变更：旧参数（如see、do等）并非真正类型，仅表示同章节内的机构归类，无法区分章节内不同实体类型；因其不利于自动化导入 Wikidata，已弃用。新版 vCard/列表现采用两个术语：type为更具体的类型（如 restaurant、cafe、church、dam 等），但为便利仍兼容see、do等旧值；所有类型归属一个group，其语义即旧 type（如see、do等）。可通过group参数覆盖自动推断的组归属。旧列表模板中极少使用的group参数需重命名为map-group。- 本地化字符串翻译需一定时间，预计约一周。
- 您将惊讶于过往错误之多——据经验，约 10% 的文章存在错误，主要集中于名称、URL、电话号码、电子邮件地址或参数名拼写错误。修正工作主要需人工完成，或需数周时间。
- 参数名、类型、分组及子类型均可设置别名。
功能
[编辑]- 形式化参数校验，
- Wikidata 数据获取，
- Wikidata 属性与标记类型使用情况的分类分析。