7. 翻译 - Phlo

7: 翻译

Phlo 将翻译视为渲染问题：您在源语言中编写视图文本，进行标记，lang 资源在请求时提供正确的语言，并在后台翻译缺失的条目。在本章中，投票在 /nl 前缀下学习荷兰语。

7.1: Source-language markers

Static view text gets a marker keyed by the language the text is written in. This app's source language is English, so the key is en:

view:
<main#app.poll>
	<h1>{en: Which stack wins?}</h1>
	{{ $this->results }}
	{{ $this->choices }}
</main>

{en: ...} transpiles to a call to the en() helper, which asks the translation layer for the text in the active language. If the active language is English, the text passes through untouched. If you were writing a Dutch-source app you would use {nl: ...} with the same mechanics; the marker always names the source language of that specific string. Outside views, the same helpers work in code: method title => en('Phlo Poll').

Update the <h1> in poll.phlo now; the page still renders identically, because the active language is still English.

7.2: 配置语言层

三个小配置。首先，data/app.json 中的资源（lang 资源带来了 cookie 检测、INI 文件缓存和 AI 支持的翻译）：

{
    "resources": [
        "DB/DB",
        "DB/model",
        "DB/JSONDB",
        "DB/JSON.result",
        "payload",
        "phlo.async",
        "DOM/form",
        "lang",
        "cookies",
        "files/INI",
        "AI/AI",
        "AI/OpenAI",
        "security/creds"
    ]
}

其次，在 www/app.php 中告诉运行时翻译文件的位置：

phlo_app(
	id:    'Poll',
	host:  'localhost',
	build: true,
	debug: true,
	app:   dirname(__DIR__).'/',
	langs: dirname(__DIR__).'/langs/',
);

传递给 phlo_app() 的每个命名参数都成为应用程序范围的常量，因此 langs 现在是您（和 lang 资源）可以在任何地方使用的路径。创建文件夹：mkdir app/langs。

第三，在 app.phlo 中声明应用程序的语言：

prop lang = 'en'
prop langs = ['en' => 'English', 'nl' => 'Nederlands']

重新构建并进行 lint；两者都以 [] 结束。

7.3: 一个 /nl 路由前缀

活动语言存储在 %app->lang 中。可以通过在 poll.phlo 中设置第二个路由来从 URL 中设置它：

route GET poll => $this->home

route GET $lang:nl poll {
	%app->lang = $lang
	$this->home
}

$lang:nl 是一个值列表段：只有当第一个路径段字面上是 nl 时，它才会匹配。要添加更多语言，可以扩展列表：$lang:nl,de,fr。英语路由保持干净的 URL；带前缀的路由设置语言并渲染相同的页面。

打开 http://localhost/nl/poll。<html lang="nl"> 属性遵循 %app->lang，但标题仍然是英语：尚未有荷兰语翻译。

7.4: 翻译缓存

翻译存储在 langs/<lang>.ini 中，每个字符串占一行，按源文本的哈希值进行键控。当一个标记字符串在活动语言中没有条目时，页面会显示源文本并通过 OpenAI 安排后台翻译；下一个请求会读取缓存结果。为了使该回填工作正常，请在 data/creds.ini 中放入 API 密钥：

OpenAI = sk-...

没有密钥？一切仍然可以正常工作，缺失的字符串将保持在源语言中。您也可以自己编写文件；在第一次回填后，langs/nl.ini 看起来像这样：

enWhichStad3 = "Welke stack wint?"

该键编码了源语言加上确切文本的哈希值，因此更改的源文本会获得一个新的条目。条目存在后，请重新加载 http://localhost/nl/poll：

<h1>Welke stack wint?</h1>

相同的视图，相同的路由逻辑，第二种语言。投票距离完成还有一章：它仍然无法将结果推送给其他查看者。