构建网站翻译文件

Question

我在构建网站时多次遇到这个问题。 我将以使用 PHP 和 Laravel 为例进行说明，但这个问题在多个平台中很常见。 这已经在几个问题中得到解决（post1、post2、post3、post4 和其他一些问题），但这些帖子并没有真正得到很好的答案。

问题是：在语言文件中构建翻译内容的最佳方式是什么？

我目前正在使用 Laravel（我没有提及版本，因为 Laravel 4 和 Laravel 5 具有相似的本地化功能，至少对于本主题的目的而言足够相似）。

本地化构建跨语言文件（en、es、de、fr...）的内容，其中可以有多个 .php 文件，其中包含返回多级字典结构的 return 语句。

/lang
    /en
        messages.php
    /es
        messages.php

文件包含如下内容：

<?php    
return [

    'example1' => 'example message for value exaple-key',
    'example2' => [
        'sub-example' => 'example message for example1.sub.example',
    ],    
];

并通过执行以下操作来调用它：

//Laravel 5    
trans('messages.example1'); //outputs 'example message for value exaple-key'
trans('messages.example2.sub-example'); //outputs 'example message for example1.sub.example'

//Laravel 4   
Lang::get('messages.example1'); //outputs 'example message for value exaple-key'
Lang::get('messages.example2.sub-example'); //outputs 'example message for example1.sub.example'

我想到了几种分组方法：

1. 按网站内容

   例如：homepage.php, page1.php, page2.php...

2. 按逻辑域：

   例如：auth.php, validation.php, pagination.php...

3. 通过 html：

   示例：buttons.php, popup_messages.php, form_data.php...

4. 直译：

   示例：simple_words.php, phrases.php... 并包含类似 'password-to-short' => 'your password is to long' 的内容

5. 前面提到的一些混合/组合

所有这些都有一些明显的优点和缺点，我不会尝试去理解，但 第 5 个 选项很可能是最好的解决方案，但仍然存在划线的问题尽量减少短语和内容的重复。

另一个问题是如何解决某些情况下首字母大写，另一些情况下小写以及结尾的标点符号的问题。

我对这个问题进行了研究，但没有明确的指导方针和/或可供学习的好例子。

欢迎所有意见。

Answer 1

我倾向于将 Laravel 应用程序中的功能分组为独立的“组件”。例如，我最近一直在为一个应用程序开发电子邮件活动功能，因此将服务提供者类、模型、服务类放在 app/Email 的文件夹中。

考虑到这一点，我以类似的方式组织我的翻译。所以即使在这个项目中我们没有翻译字符串，如果我们是的话，我会创建一个 resources/assets/lang/en/email.php 文件，并将电子邮件组件的翻译字符串放在那里.

所以在另一个项目中，我的目录结构可能是这样的：

• /资源
  • /语言
    • /zh
      • auth.php
      • email.php
      • events.php
      • news.php
      • 分页.php
      • passwords.php
      • validation.php

希望这会有所帮助。

Answer 2

根据我的经验，除了尝试在其他地方使用您的翻译外，没有理由拥有不同的组。我通常将我所有的项目消息放在一个名为 app 的组中，并且对于我的每个共享库，我使用一个单独的组名（因为我可能会在其他项目中使用它们）。 我的网站中的登录失败消息示例如下：

trans('app.username_and_password_do_not_match')

如果它在名为 Auth 的第三方库中，它会是

trans('auth.username_and_password_do_not_match')

并记住将完整的消息写为您的消息密钥，而不是使用短名称（如 app.login.fail）。这样您就不需要检查每个翻译的网站内容。

我没有完全理解你的最后一个问题，所以你可能想澄清一下。

Answer 3

我会选择选项#4，所以你会有这样的东西：

/lang/
    /en 
      messages.php
      words.php
    /fr
      message.php
      words.php
    /de
      messages.php
      words.php

这会做一些事情：

• 它非常清楚地分割了所有内容。您知道在哪里可以找到哪种语言。而且您知道文件中与该语言相关联的内容。
• 以上内容让以后的维护变得更容易，因为你可以找到东西。
• 它按语言为您提供可以单独翻译的文件。
• 它将所有信息放在一个明确定义的位置。

需要注意的一点是，如果您的应用变得非常大并且非常国际化，您可能希望使用 ISO 语言代码。例如，欧洲葡萄牙语 (pt_PT) 和巴西葡萄牙语是不同的，对于全球观众，您可能希望同时涵盖两者。