LLM 测试文件

🌐 由 AI 与人类协作翻译

本翻译由人类引导的 AI 生成。🤝

可能存在误解原意或不够自然等问题。🤖

你可以通过帮助我们更好地引导 AI LLM来改进此翻译。

英文版本

本文用于测试用于翻译文档的 LLM 是否理解 scripts/translate.py 中的 general_prompt 以及 docs/{language code}/llm-prompt.md 中的语言特定提示。语言特定提示会追加到 general_prompt 之后。

这里添加的测试会被所有语言特定提示的设计者看到。

用法如下：

• 准备语言特定提示——docs/{language code}/llm-prompt.md。
• 将本文重新翻译为你的目标语言（例如使用 translate.py 的 translate-page 命令）。这会在 docs/{language code}/docs/_llm-test.md 下创建翻译。
• 检查翻译是否正确。
• 如有需要，改进你的语言特定提示、通用提示，或英文文档。
• 然后手动修正翻译中剩余的问题，确保这是一个优秀的译文。
• 重新翻译，在已有的优秀译文基础上进行。理想情况是 LLM 不再对译文做任何更改。这意味着通用提示和你的语言特定提示已经尽可能完善（有时它仍会做一些看似随机的改动，原因是LLM 不是确定性算法）。

测试如下：

代码片段

测试信息

这是一个代码片段：foo。这是另一个代码片段：bar。还有一个：baz quux。

代码片段的内容应保持不变。

参见 scripts/translate.py 中通用提示的 ### Content of code snippets 部分。

引号

测试信息

昨天，我的朋友写道："如果你把 incorrectly 拼对了，你就把它拼错了"。我回答："没错，但 'incorrectly' 错的不是 '"incorrectly"'"。

注意

LLM 很可能会把这段翻错。我们只关心在重新翻译时它是否能保持修正后的译文。

提示词设计者可以选择是否将中性引号转换为排版引号。也可以保持不变。

例如参见 docs/de/llm-prompt.md 中的 ### Quotes 部分。

代码片段中的引号

测试信息

pip install "foo[bar]"

代码片段中的字符串字面量示例："this"，'that'。

一个较难的字符串字面量示例：f"I like {'oranges' if orange else "apples"}"

硬核：Yesterday, my friend wrote: "If you spell incorrectly correctly, you have spelled it incorrectly". To which I answered: "Correct, but 'incorrectly' is incorrectly not '"incorrectly"'"

... 但是，代码片段内的引号必须保持不变。

代码块

测试信息

一个 Bash 代码示例...

# 向宇宙打印问候
echo "Hello universe"

...以及一个控制台代码示例...

$ <font color="#4E9A06">fastapi</font> run <u style="text-decoration-style:solid">main.py</u>
<span style="background-color:#009485"><font color="#D3D7CF"> FastAPI </font></span>  Starting server
        Searching for package file structure

...以及另一个控制台代码示例...

// 创建目录 "code"
$ mkdir code
// 切换到该目录
$ cd code

...以及一个 Python 代码示例...

wont_work()  # 这不会起作用 😱
works(foo="bar")  # 这可行 🎉

...就这些。

代码块中的代码不应被修改，注释除外。

参见 scripts/translate.py 中通用提示的 ### Content of code blocks 部分。

选项卡与彩色提示框

测试信息

信息

Some text

注意

Some text

技术细节

Some text

检查

Some text

提示

Some text

警告

Some text

危险

Some text

选项卡以及 Info/Note/Warning/等提示块，应在竖线（|）后添加其标题的翻译。

参见 scripts/translate.py 中通用提示的 ### Special blocks 与 ### Tab blocks 部分。

Web 与内部链接

测试信息

链接文本应被翻译，链接地址应保持不变：

• 链接到上面的标题
• 内部链接
• 外部链接
• 样式链接
• 脚本链接
• 图片链接

链接文本应被翻译，且链接地址应指向对应的译文页面：

• FastAPI 链接

链接的文本应被翻译，但地址保持不变。唯一的例外是指向 FastAPI 文档页面的绝对链接，此时应指向对应语言的译文。

参见 scripts/translate.py 中通用提示的 ### Links 部分。

HTML "abbr" 元素

测试信息

这里有一些包裹在 HTML "abbr" 元素中的内容（有些是虚构的）：

abbr 提供了完整短语

• GTD
• lt
• XWT
• PSGI

abbr 提供了完整短语与解释

• MDN
• I/O.

"abbr" 元素的 "title" 属性需要按照特定规则进行翻译。

译文可以自行添加 "abbr" 元素以解释英语单词，LLM 不应删除这些元素。

参见 scripts/translate.py 中通用提示的 ### HTML abbr elements 部分。

HTML "dfn" 元素

• 集群
• 深度学习

标题

测试信息

开发 Web 应用——教程

Hello.

类型提示与注解

Hello again.

超类与子类

Hello again.

关于标题的唯一硬性规则是：LLM 必须保持花括号内的哈希部分不变，以确保链接不会失效。

参见 scripts/translate.py 中通用提示的 ### Headings 部分。

语言特定的说明可参见例如 docs/de/llm-prompt.md 中的 ### Headings 部分。

文档中使用的术语

测试信息

• you

• your

• e.g.

• etc.

• foo as an int

• bar as a str

• baz as a list

• the Tutorial - User guide

• the Advanced User Guide
• the SQLModel docs
• the API docs

• the automatic docs

• Data Science

• Deep Learning
• Machine Learning
• Dependency Injection
• HTTP Basic authentication
• HTTP Digest
• ISO format
• the JSON Schema standard
• the JSON schema
• the schema definition
• Password Flow

• Mobile

• deprecated

• designed
• invalid
• on the fly
• standard
• default
• case-sensitive

• case-insensitive

• to serve the application

• to serve the page

• the app

• the application

• the request

• the response

• the error response

• the path operation

• the path operation decorator

• the path operation function

• the body

• the request body
• the response body
• the JSON body
• the form body
• the file body

• the function body

• the parameter

• the body parameter
• the path parameter
• the query parameter
• the cookie parameter
• the header parameter
• the form parameter

• the function parameter

• the event

• the startup event
• the startup of the server
• the shutdown event

• the lifespan event

• the handler

• the event handler
• the exception handler

• to handle

• the model

• the Pydantic model
• the data model
• the database model
• the form model

• the model object

• the class

• the base class
• the parent class
• the subclass
• the child class
• the sibling class

• the class method

• the header

• the headers
• the authorization header
• the Authorization header

• the forwarded header

• the dependency injection system

• the dependency
• the dependable

• the dependant

• I/O bound

• CPU bound
• concurrency
• parallelism

• multiprocessing

• the env var

• the environment variable
• the PATH

• the PATH variable

• the authentication

• the authentication provider
• the authorization
• the authorization form
• the authorization provider
• the user authenticates

• the system authenticates the user

• the CLI

• the command line interface

• the server

• the client

• the cloud provider

• the cloud service

• the development

• the development stages

• the dict

• the dictionary
• the enumeration
• the enum

• the enum member

• the encoder

• the decoder
• to encode

• to decode

• the exception

• to raise

• the expression

• the statement

• the frontend

• the backend

• the GitHub discussion

• the GitHub issue

• the performance

• the performance optimization

• the return type

• the return value

• the security

• the security scheme

• the task

• the background task

• the task function

• the template

• the template engine

• the type annotation

• the type hint

• the server worker

• the Uvicorn worker
• the Gunicorn Worker
• the worker process
• the worker class

• the workload

• the deployment

• to deploy

• the SDK

• the software development kit

• the APIRouter

• the requirements.txt
• the Bearer Token
• the breaking change
• the bug
• the button
• the callable
• the code
• the commit
• the context manager
• the coroutine
• the database session
• the disk
• the domain
• the engine
• the fake X
• the HTTP GET method
• the item
• the library
• the lifespan
• the lock
• the middleware
• the mobile application
• the module
• the mounting
• the network
• the origin
• the override
• the payload
• the processor
• the property
• the proxy
• the pull request
• the query
• the RAM
• the remote machine
• the status code
• the string
• the tag
• the web framework
• the wildcard
• to return
• to validate

这是一份不完整且非规范性的（主要是）技术术语清单，取自文档中常见的词汇。它可能有助于提示词设计者判断哪些术语需要对 LLM 提供额外指引。例如当它总是把一个好的译法改回次优译法，或在你的语言中对某个术语的词形变化有困难时。

参见例如 docs/de/llm-prompt.md 中的 ### List of English terms and their preferred German translations 部分。