🌐 Add Chinese translation for Tutorial - Schema Extra Example #2411

maoyibo · 2020-11-25T02:36:18Z

Chinese translation add tutorial/schema-extra-example

codecov · 2020-11-25T02:37:55Z

Codecov Report

Merging #2411 (1dd81fb) into master (cc99e23) will not change coverage.
The diff coverage is n/a.

@@            Coverage Diff            @@
##            master     #2411   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files          240       240           
  Lines         7101      7101           
=========================================
  Hits          7101      7101

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update d550738...1dd81fb. Read the comment docs.

github-actions · 2020-11-25T02:40:13Z

📝 Docs preview for commit ca7874a at: https://5fbdc3ba110c133192ff8c1a--fastapi.netlify.app

waynerv

Note the whitespace between English and Chinese characters.

waynerv · 2020-11-25T12:42:07Z

docs/zh/docs/tutorial/schema-extra-example.md

+
+## `Field` 的附加参数
+
+在 `Field`, `Path`, `Query`, `Body` 和其他你之后将会看到的工厂函数，你可以为JSON 模式声明额外信息，你也可以通过给工厂函数传递其他的任意参数来给JSON 模式生命额外信息，比如增加 `example`:


生命 -> 声明

Fixed, thanks.

waynerv · 2020-11-25T12:45:09Z

docs/zh/docs/tutorial/schema-extra-example.md

+```
+
+!!! warning
+    请记住，传递的那些额外参数不会添加任何验证，只会添加注释，用于文档目。


用于文档目。->用于文档的目的

Fixed, thanks.

waynerv · 2020-11-25T12:45:56Z

docs/zh/docs/tutorial/schema-extra-example.md

+
+关于 `example` 和 `examples`...
+
+JSON Schema在最近的一个版本中定义了一个字段 <a href="https://json-schema.org/draft/2019-09/json-schema-validation.html#rfc.section.9.5" class="external-link" target="_blank">`examples`</a> ，但是 OpenAPI 基于之前的一个旧版JSON Schema，并没有 `examples`.


“most recent versions” should not translated to "最近的一个版本中"

Fixed, thanks.

waynerv · 2020-11-25T12:50:44Z

docs/zh/docs/tutorial/schema-extra-example.md

+
+您可以在JSON模式中定义额外的信息。
+
+一个常见的用例是添加一个将在文档中显示的 `示例`。


unnecessary whitespace before 实例.

Fixed, thanks.

github-actions · 2020-11-26T01:06:15Z

📝 Docs preview for commit cfb8185 at: https://5fbeff3fda660a8bd74aa083--fastapi.netlify.app

waynerv · 2020-11-26T02:09:21Z

What do you think about the idea of keeping one space between Chinese and English characters(both left and right), since most documents that have been merged so far respect this convention.

waynerv · 2020-11-26T02:31:22Z

docs/zh/docs/tutorial/schema-extra-example.md

+
+## Pydantic `schema_extra`
+
+您可以使用 `Config` 和 `schema_extra` 为Pydantic模型声明一个示例，如<a href="https://pydantic-docs.helpmanual.io/usage/schema/#schema-customization" class="external-link" target="_blank">Pydantic's docs: Schema customization</a>中所述:


Pydantic's docs: Schema customization -> Pydantic 文档：Schema customization

Fixed, thanks.

waynerv · 2020-11-26T02:33:34Z

docs/zh/docs/tutorial/schema-extra-example.md

+
+您可以在JSON模式中定义额外的信息。
+
+一个常见的用例是添加一个将在文档中显示的`示例`。


It seems better not to translate text in code blocks, e.g example.

Fixed, thanks.

waynerv · 2020-11-26T02:37:51Z

docs/zh/docs/tutorial/schema-extra-example.md

@@ -0,0 +1,58 @@
+# 额外的模式 - 例子


This title is not accurate, for the content below is about extra information in shcema, not extra shcemas.

I revised the translation to “模式的额外信息”, What do you think of this?

maoyibo · 2020-11-26T02:56:23Z

What do you think about the idea of keeping one space between Chinese and English characters(both left and right), since most documents that have been merged so far respect this convention.

I may not pay special attention to this situation in my previous translation, I will pay attention to it in the future, but I think the most important thing is the accuracy of the translation, the whitespace should not affect the generation and reading of the document. We can work on this in future updates.

github-actions · 2020-11-26T03:05:38Z

📝 Docs preview for commit 1dd81fb at: https://5fbf1b375ec11ab6171fc93c--fastapi.netlify.app

waynerv

LGTM. 👍

waynerv · 2020-11-26T03:45:49Z

What do you think about the idea of keeping one space between Chinese and English characters(both left and right), since most documents that have been merged so far respect this convention.

I may not pay special attention to this situation in my previous translation, I will pay attention to it in the future, but I think the most important thing is the accuracy of the translation, the whitespace should not affect the generation and reading of the document. We can work on this in future updates.

It's OK.

tiangolo · 2020-12-03T17:07:51Z

Awesome! Thanks a lot for your contribution @maoyibo ! 🙇 ☕

And thanks @waynerv and @Laineyzhang55 as always for the help and reviews 🍰

Chinese translation add tutorial/schema-extra-example

ca7874a

This was referenced Nov 25, 2020

Chineses translations #1228

Closed

chinese translation add tutorial/sql-databases.md #2379

Closed

waynerv suggested changes Nov 25, 2020

View reviewed changes

tiangolo changed the title ~~Chinese translation add tutorial/schema-extra-example~~ 🌐 Add Chinese translation for Tutorial - Schema Extra Example Nov 25, 2020

tiangolo added awaiting-review lang-all Translations lang-zh Chinese translations labels Nov 25, 2020

schema-extra-example merge upstream d550738 and fix some error

cfb8185

waynerv reviewed Nov 26, 2020

View reviewed changes

Fix the wrong translation

1dd81fb

waynerv approved these changes Nov 26, 2020

View reviewed changes

Laineyzhang55 approved these changes Nov 26, 2020

View reviewed changes

github-actions bot added approved-2 and removed awaiting-review labels Nov 26, 2020

tiangolo merged commit 4236c99 into tiangolo:master Dec 3, 2020

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

🌐 Add Chinese translation for Tutorial - Schema Extra Example #2411

🌐 Add Chinese translation for Tutorial - Schema Extra Example #2411

maoyibo commented Nov 25, 2020

codecov bot commented Nov 25, 2020 •

edited

Loading

github-actions bot commented Nov 25, 2020

waynerv left a comment

waynerv Nov 25, 2020

maoyibo Nov 26, 2020

waynerv Nov 25, 2020

maoyibo Nov 26, 2020

waynerv Nov 25, 2020

maoyibo Nov 26, 2020

waynerv Nov 25, 2020

maoyibo Nov 26, 2020

github-actions bot commented Nov 26, 2020

waynerv commented Nov 26, 2020

waynerv Nov 26, 2020

maoyibo Nov 26, 2020

waynerv Nov 26, 2020

maoyibo Nov 26, 2020

waynerv Nov 26, 2020

maoyibo Nov 26, 2020

maoyibo commented Nov 26, 2020

github-actions bot commented Nov 26, 2020

waynerv left a comment

waynerv commented Nov 26, 2020

tiangolo commented Dec 3, 2020


		## `Field` 的附加参数

		在 `Field`, `Path`, `Query`, `Body` 和其他你之后将会看到的工厂函数，你可以为JSON 模式声明额外信息，你也可以通过给工厂函数传递其他的任意参数来给JSON 模式生命额外信息，比如增加 `example`:


		关于 `example` 和 `examples`...

		JSON Schema在最近的一个版本中定义了一个字段 <a href="https://json-schema.org/draft/2019-09/json-schema-validation.html#rfc.section.9.5" class="external-link" target="_blank">`examples`</a> ，但是 OpenAPI 基于之前的一个旧版JSON Schema，并没有 `examples`.


		您可以在JSON模式中定义额外的信息。

		一个常见的用例是添加一个将在文档中显示的 `示例`。


		## Pydantic `schema_extra`

		您可以使用 `Config` 和 `schema_extra` 为Pydantic模型声明一个示例，如<a href="https://pydantic-docs.helpmanual.io/usage/schema/#schema-customization" class="external-link" target="_blank">Pydantic's docs: Schema customization</a>中所述:


		您可以在JSON模式中定义额外的信息。

		一个常见的用例是添加一个将在文档中显示的`示例`。

🌐 Add Chinese translation for Tutorial - Schema Extra Example #2411

🌐 Add Chinese translation for Tutorial - Schema Extra Example #2411

Conversation

maoyibo commented Nov 25, 2020

codecov bot commented Nov 25, 2020 • edited Loading

Codecov Report

github-actions bot commented Nov 25, 2020

waynerv left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

github-actions bot commented Nov 26, 2020

waynerv commented Nov 26, 2020

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

maoyibo commented Nov 26, 2020

github-actions bot commented Nov 26, 2020

waynerv left a comment

Choose a reason for hiding this comment

waynerv commented Nov 26, 2020

tiangolo commented Dec 3, 2020

codecov bot commented Nov 25, 2020 •

edited

Loading