GTranslate TDN文档

免费安装可用

请联系我们,我们将免费为您进行配置。

更新:现在您可以在用户仪表板上运行设置向导来配置 GTranslate。

1。 选择URL结构

您的订阅支持子域名 URL 结构(例如 https://es.example.com)或子目录 URL 结构(例如 https://example.com/fr/)。如果您拥有企业版订阅,并希望将您的语言网站托管在顶级国家/地区域名(例如 https://example.fr)上,请联系我们。

注意: 对于Shopify商店,您只能使用子域网址结构。

配置子目录的URL

WordPress:如果您使用的是 WordPress,请安装 GTranslate 插件,并在 GTranslate 设置页面中启用“子目录 URL 结构”选项。然后转到步骤 3。

要使用此选项,您的服务器上必须安装 PHP 和 Apache。如果您使用的是其他 Web 服务器,请与我们联系。

  1. 下载 GTranslate网址加载项 并解压缩
  2. 编辑gtranslate / config.php文件以设置正确的main_lang语言代码
  3. 将gttranslate文件夹上传到www根目录
  4. 在www根目录中编辑/创建.htaccess文件,并将以下内容添加到文件的顶部:
    # gtranslate config
    RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-CN|zh-TW|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu)/(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-CN|zh-TW|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu)/(.*)$ /$1/$3 [R=301,L]
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-CN|zh-TW|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu)/(.*)$ /gtranslate/gtranslate.php?glang=$1&gurl=$2 [L,QSA]
    RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-CN|zh-TW|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu)$ /$1/ [R=301,L]
    
    

 

配置子域网址

要使用子域名 URL,您只需为每种语言添加DNS CNAME记录。完成订单后,您将在说明邮件中收到 CNAME 记录列表。添加完成后,您的翻译将在几分钟内生效。请转至步骤 2。

2。 添加语言选择器

下载我们的GTranslate 免费语言选择器并将其添加到您的网站,然后根据您的选择使用子域名或子目录 URL 结构选项。

3。 最后检查

如果您订阅的套餐包含网址翻译功能,并且您想要启用该功能,请按照“启用网址翻译”说明进行操作。

注意:不要同时进行子目录和子域名配置。

如果您有任何问题,我们可以为您提供配置,请与我们联系。


添加CNAME记录

DNS是互联网的一个组成部分,它将人类可读的域名(例如example.com)转换为计算机可读的IP地址(例如192.0.32.10)。它根据服务器上的DNS区域文件来完成这一转换,这些文件将域名与IP地址关联起来。

CNAME 记录代表“规范名称记录”。该记录创建一个别名,允许查询服务器使用新名称继续进行 DNS 查询。

添加记录最多可能需要 48 小时。通常只需不到 5 分钟。您可以使用 nslookup 命令行工具来测试记录是否已添加。

完成订单后,您将在说明电子邮件中收到CNAME记录的列表。

您可以查看这个很棒的资源,了解如何添加 CNAME 记录,其中包含大多数域名注册商的具体说明。

cPanel主机

  1. 登录您的cPanel帐户
  2. 在“域名”下打开简易DNS区域编辑器。

    ALT

  3. 从下拉框中和标记的部分中选择您的域 Add a CNAME Record 输入 Name (语言代码)和 CNAME 的记录(GTranslate服务器名称),然后单击 Add CNAME Record 按钮。

    ALT

Plesk主办

  1. 转到DNS设置页面。
  2. 添加记录

    ALT

  3. 选择CNAME记录类型。

  4. 输入记录的域名(语言代码)和规范名称(GTranslate 服务器名称)。按“确定”按钮添加记录。

  5. ALT

其他控制面板

如果您在主机控制面板中找不到 DNS 管理选项,请咨询您的主机提供商,了解如何添加新的 DNS 记录。如果主机控制面板中没有管理 DNS 记录的选项,他们应该可以帮您完成。

启用网址翻译

WordPress:在 GTranslate 插件设置页面中启用“URL 翻译”选项。

Shopify:在 GTranslate 应用的设置页面中启用“URL 翻译”选项。

Joomla,Drupal和其他平台:

要为您的网站启用URL翻译功能,您需要将以下代码添加到页面的标题中。

<meta name="uri-translation" content="on">

确保它位于头标中的其他标签之上。

编辑翻译

要编辑翻译,您需要进入要编辑的语言页面,然后在 URL 中添加`?language_edit=1` 。如果 URL 中已经包含问号(`?`),则需要添加`&language_edit=1`。例如,要编辑首页上的西班牙语文本,您需要访问`http://es.example.com/?language_edit=1` 或 `http://example.com/es/?language_edit=1`,这将打开编辑界面。

在编辑模式下,您可以直观地看到已编辑文本和自动翻译文本之间的区别。带有红色铅笔图标的文本为已编辑文本,带有绿色铅笔图标的文本为自动翻译文本。

使用箭头图标,您可以编辑翻译的网址。

检测所选语言

如果你想为单个语言编写一些特殊的东西,你可以检测当前选择的语言,并根据这些语言编写代码。

您可以从 X-GT-Lang 请求头中找到当前选定的语言代码。如果您的网站是用 PHP 编写的,则可以在 _SERVER['HTTP_X_GT_LANG'] 变量中找到它。

将子目录的URL结构重定向到子域的URL结构

将此规则添加到.htaccess文件中的其他规则之上。

RewriteRule ^([a-z]{2}|zh-CN|zh-TW)/(.*)$ http://$1.domain.com/$2 [R=301,L,QSA]

启用JSON格式转换

在现代 Web 应用程序中,数据通过 AJAX 请求以 JSON 格式传输。为了能够转换 JSON 数据,我们需要知道哪些键可以转换,以免破坏应用程序。假设您有以下需要转换的 JSON 数据:

{
    "name":"test",
    "description":"test description",
    "id":500,
    "months": ["January","February","March"],
    "content":"<i>Hello world</i>",
    "user": {
        "login":"test",
        "bio":"test user"
    }
}

您需要使用特殊键 ` gt_translate_keys`来指定 JSON 对象中需要翻译的键。例如:

{
    "name":"test",
    "description":"test description",
    "id":500,
    "months": ["January","February","March"],
    "content":"<i>Hello world</i>",
    "gt_translate_keys": ["name", "description", {"key": "months", "format": "list"}, {"key": "content", "format": "html"}],
    "user": {
        "login":"test",
        "bio":"test user",
        "gt_translate_keys": [{"key": "bio", "format": "text"}]
    }
}

如本例所示,gt_translate_keys 应该是一个数组。它可以简单地指定要翻译的键名,也可以同时指定值的格式。可选格式包括列表、HTML 或文本(如果未指定,则为文本格式)。

翻译后会看起来像这样:

{
    "name":"тест",
    "description":"тестовое описание",
    "id":500,
    "months": ["Январь","Февраль","Март"],
    "content":"<i>Привет мир</i>",
    "user": {
        "login":"test",
        "bio":"тестовый пользователь"
    }
}

尝试使用免费的15日试验GTranslate