帮助:扩展:翻译/页面翻译示例

This page is a translated version of the page Help:Extension:Translate/Page translation example and the translation is 100% complete.
关于如何使用Extension:翻译 的研讨会视频。

欢迎!完成本教程后,您将了解如何使用翻译扩展去创建和管理可翻译页面。 我们尽量在可以介绍清楚所有概念和任务的前提下保持此教程的简洁易懂。 完成本教程后,您还可以阅读关于页面翻译功能的深入文档

还有一套与本教程同方向的视频教程,有助於你学习如何使用翻译扩展。

请注意:
  • 必然地,我们會认为您就是您的wiki上的「翻译管理员」(如果可以,您应该现在就宣告你自己这个权限),否则您可能无法访问这里描述的某些链接或页面。
  • 也请記得,这只是一个简单的教程。 您可以在此处查看由最佳實踐组成的标记代码的例子。
让我们开始吧!

第一步:开始之前

 
初始页面

本教程假定翻译扩展已经安装并调试完成。 可能你已经有一个页面想要翻译了,或者你可以根据下面的演示页面在你自己的wiki中试一试这些步骤。

该页面描述了虚构的 Fréttinga 市政府。

这是与之关联的维基代码:

Fréttinga is a small municipality in MungoLand, located on the BaMungo island.
It hosts a population of about 400 people. It has some agriculture and fishing.
Tourists like to visit it in the summertime.

== Services ==

It doesn't have many services. There is a shop, and a car ferry visits the island
from the mainland once a day.
  • 1. 在你的 Wiki 中,转到页面 [[Fréttinga]](或草稿页面),然后单击创建。
  • 2. 粘贴以上内容并保存。

第二步:准备

 
准备:标记页面以备翻译

现在你有了一个有内容的页面。

页面的原始语言可能是任何一种语言。 如果它与wiki的默认语言不同,那么作为翻译管理员,您必须在进行步骤3之前使用 Special:PageLanguage 正确设置页面语言

如果该页面仍将被大量更改,最好等到编辑工作放缓到正常水平时再将该页面加入翻译系统。 这样可避免翻译者为了保持同步所做的额外工作。

页面可以翻译了吗?那么让我们看看如何准备翻译:

  • 3. 编辑 [[Fréttinga]] 页面
  • 4. 将页面所有内容包裹在 ‎<translate>...‎</translate> 标签内,如下所示
  • 5. 保存该页面
<translate>
Fréttinga is a small municipality in MungoLand, located on the BaMungo island.
It hosts a population of about 400 people. It has some agriculture and fishing.
Tourists like to visit it in the summertime.

== Services ==

It doesn't have many services. There is a shop, and a car ferry visits the island
from the mainland once a day.
</translate>

你不需要向所有的元素添加‎<translate>标签。

永远不要自己添加 <!--T:1--> 之类的标记;翻译扩展会在下一步中为你完成。

第三步:启用翻译

保存页面后,您将在页面顶部看到一个链接,上面写着“标记此页面以备翻译”——如果您不是翻译管理员,则可以看到“此页面有未被标记进行翻译的[$1 更改]。”。 如果您是翻译管理员,点击“标记此页面以备翻译”链接。 这样页面就会被自动分成四个翻译单元。 第一个单元是页面标题、第二个是首段内容、第三个是第二段标题、第四个是第二段内容。 这是最基本的页面可译项:每个翻译单元都是独立的,需要作为一个整体来翻译,页面内容的改变也以一个单元为单位。 每个翻译单元可以删除或重排。

还有一个查看页面翻译的页面模板;这将在后面的步骤中介绍。

  • 6. 点击“标记此页面以备翻译”链接
  • 7. 确保页面正文正确拆分为三个翻译单元
  • 8. 点击“标记此版本进行翻译”按钮 (提醒:要执行这项操作,你必须是翻译管理员
  • 9. 返回该页面

现在,您会在顶部看到一个新链接“翻译本页”,让翻译人员可以翻译该页面。 您可以查看这个翻译教程,它使用此页面作为示例。现在尝试翻译,然后返回本教程进行下一步。

第四步:进行修改

了解更改如何影响翻译和翻译单元

 
处理更改

跟踪更改是一项非常重要的功能,所以让我们进行一些更改,看看它是如何工作的。 当您打开页面进行编辑时,您会看到它已被修改为带有 <!--T:1--> 之类的标记。 这些标记由扩展添加,用来帮助识别哪个翻译单元是哪个。这允许您重新排列和编辑这些单元。 编辑页面时,标记应保持不变,并且它们相对于所属翻译单元的位置不应更改。移动翻译单元时,也要移动该单元的标记。

删除翻译单元时,也删除其标记。 添加新段落时,扩展会添加新的标记。 不要尝试手动执行此操作,否则可能会使软件混淆。 您删除的标记也将被现有翻译中的机器人自动删除。

如果您只对现有翻译单元进行微小更改(添加几个词或段落链接),请保留标记。 如果您更改整个段落(删除并重建它),请删除标记。 这样,译员将有不同的任务,在审查模糊的翻译或创建一个新的翻译之间。

让我们修改一些东西!

你需要做的事情有:

<languages /> <translate> <!--T:1--> Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. It has marvelous beaches with a lot of seagulls. == Services == <!--T:2--> <!--T:3--> It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day. In 2009 January the roof of the church in the island fell down. It was rebuilt collaboratively the following summer. </translate>

  • 10. 按照上面的突出显示内容,补充页面
  • 11. 单击顶部的“标记进行翻译”链接
  • 12. 观察变化
  • 13. 点击“标记进行翻译”按钮 (提醒:要执行这项操作,你必须是翻译管理员
  • 14. 返回原页面

如果您按照上一步中的建议进行了翻译,您现在可以在页面顶部看到这些翻译链接。 您还会看到翻译不是 100% 最新的。 如果转到翻译视图,您会看到该翻译单元被标记为需要更新。

过时的翻译将以粉红色背景突出显示;用户将被告知翻译已过时。

翻译状态查看模板有助于你查看页面翻译单元在所有语言中的翻译状态(即“翻译页面模版”,也就是‎<translate>...‎</translate>标签下面的框框),同时会显示翻译单元的移动和删除。

在更新所有翻译版本之前可能会有轻微的延迟,因为可能有很多页面要更新。

现在你已经知道基本信息了,但教程还会继续介绍一些其他你想知道的信息。

第五步:添加其他 wiki 元素

 
最终结果

向页面添加图像、类别和带有翻译标记的列表

您现在有了一个基本的可翻译页面,但它非常乏味。 让我们添加一张图片和其他一些东西,让它看起来更像一个正常的 wiki 页面,看看这些元素如何与翻译交互。

我们也移除了段落、翻译单元标记,用一个列表来替换,让你看清到底发生了什么。

  • 15. 在页面中添加图像、类别和列表,如下所示
  • 16. 保存该页面
  • 17. 单击顶部的“标记进行翻译”链接
  • 18. 验证更改是否符合预期
  • 19. 点击“标记此版本进行翻译”按钮
  • 20. 返回可译页面

<languages /> [[File:Torsö.jpg|thumb|<translate>A typical view of Fréttinga</translate>]] <translate> <!--T:1--> Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing and tourists like to visit it in the summertime. It has marvelous beaches with a lot of [[Special:MyLanguage/Seagull|seagulls]]. == Services == <!--T:2--> <!--T:3--> It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day. Main events: * The roof of the church fell down in 2009 * New church was built in 1877 [[Category:Municipalities]] </translate>

为翻译撰写文档

只允许翻译图片标题:

[[File:Torsö.jpg|thumb|<translate>A typical view of Fréttinga</translate>]]

或者允许更改翻译页面中的图像文件(例如本地化版本)和标题:

<translate>[[File:Torsö.jpg|thumb|A typical view of Fréttinga]]</translate>

在这里你可以看到我们把所有图片移到翻译单元之外并用翻译模板替换。 (提醒:翻译页面模板不会在不同的翻译页面间变化) 大部分情况下这很OK,但有时候译者需要替换文中的图片,尤其是那些写有某种语音内容(文本)的图片。 这种情况下最简单的办法就是在翻译单元中包含这些图片引动代码(就像分类代码一样)。

当翻译单元中包含这些代码时,写一个短小的说明文件是个不错的选择。 你可以照着下面的步骤去做。

 
你添加给译者看的文档会这样显示
  • 21. 单击顶部的“翻译本页”链接
  • 22. 选择“qqq - 消息文档”语言
  • 23. 单击包含消息“A typical view of Fréttinga”的消息名称
  • 24. 输入“Description of an image”,然后点击“保存”

现在,文档“Description of an image”显示在待翻译的图像标题旁边。

关于链接

[[Special:MyLanguage/Seagull]]

类似的,对于链接我们有许多方法来操作。 我们使用[[Special:MyLanguage/Seagull]]来自动重定向到用户界面语言对应的翻译版本(如果存在的话)。 这不是最好的解决方案,因为用户将始终被重定向到他用户界面的语言,而不是他们当前正在阅读的语言。 Special:MyLanguage还会干扰Special:WhatLinksHere使其无法正常工作。 Special:MyLanguage的优点是就算翻译版并不存在,你也一定会打开该页面的其他版本。

关于分类

在这个例子中,所有的分类被分到同一个翻译单元中。 这使译者可以把分类替换成类似 [[Category:Municipalities/zh]] 的更合适的分类中去。 如果这在翻译模板之外,那么诸如 Foo、Foo/de、Foo/ru、Foo/ta 这样的页面会被分入同一个分类中。 有些时候这没问题,但这样会使用户产生困扰。 确保译者们了解本地的习惯方式。

关于标题

若想要系统识别出标题而不是视为普通文字,别忘了在标题和其后的段落之间添加一个空行(如果原先没有的话)。

以下示例只会创建一个翻译单元:

== Services ==
It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

下面这个则会创建两个,其中一个是标题。

== Services ==

It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.

添加一个空行能让翻译者知道什么时候他们可以告一段落。 另外,它可以防止维基文本出现问题。

后面的话

对整个页面及其翻译进行操作

也可以重命名可翻译页面,包括其所有翻译。 因为可能需要移动很多页面,所以这个操作不是即时的。 您可以删除包括所有翻译的整个页面,也可以只删除页面的一个翻译版本。 你可以从所有其他页面上的相同位置访问这些功能。

使用特殊页面管理所有 wiki 页面的翻译

Special:PageTranslation 列出系统中的所有页面。 除了为您提供所有可翻译页面的概览外,还可以阻止页面翻译。 这将从大多数列表中隐藏该页面。它不会阻止进一步的翻译。

现在,你知道了!

您现在已经创建了一个可翻译页面并尝试了所有可翻译页面的常见操作。

想深入了解?

要获取更多信息,或想更深入地了解该功能,请继续阅读页面翻译功能的深入文档。 它还包含关于处理链接、类别和模板的不同方式的讨论,或者使用更大或更小的翻译单元的利弊。

参见