func.sgml の 18.0 対応です#3582
Conversation
higuchi-daisuke
changed the title
There was a problem hiding this comment.
Pull request overview
This PR updates the Japanese translations in PostgreSQL's function documentation files (func.sgml and related files) for version 18.0 compatibility. The primary purpose is to replace machine-translated text with improved, more natural Japanese translations.
Key changes:
- Removes "《機械翻訳》" (machine translation) markers throughout the documentation
- Improves translation quality and naturalness of Japanese text
- Adds missing translations for section titles and table headers
- Standardizes terminology (e.g., consistently using "関数" for "function", "統計情報" for "statistics")
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| doc/src/sgml/func4.sgml | Updates administrative function descriptions, improving translations for module loading, privilege checking, and statistics manipulation functions |
| doc/src/sgml/func3.sgml | Improves translations for JSON functions, array functions, multirange functions, and aggregate functions |
| doc/src/sgml/func2.sgml | Enhances translations for date/time formatting, UUID functions, and formatting functions |
| doc/src/sgml/func1.sgml | Updates translations for mathematical functions, string functions, and pattern matching descriptions |
| doc/src/sgml/func.sgml | Combined file containing all the translation improvements from the other func*.sgml files |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
doc/src/sgml/func3.sgml
Outdated
| <parameter>strip_in_arrays</parameter>がtrue（デフォルトはfalse）の場合、NULL配列要素も削除されます。 | ||
| それ以外の場合は削除されません。 | ||
| 裸のNULL値は削除されません。 | ||
| 空のNULL値は決して削除されません。 |
There was a problem hiding this comment.
Translation issue: "空のNULL値" (empty NULL value) is unclear in Japanese. The English original says "Bare null values" which means standalone/isolated NULL values. A better translation would be "単独のNULL値" or "裸のNULL値" (using the literal translation that was removed).
| 空のNULL値は決して削除されません。 | |
| 単独のNULL値は決して削除されません。 |
doc/src/sgml/func.sgml
Outdated
| <parameter>strip_in_arrays</parameter>がtrue（デフォルトはfalse）の場合、NULL配列要素も削除されます。 | ||
| それ以外の場合は削除されません。 | ||
| 裸のNULL値は削除されません。 | ||
| 空のNULL値は決して削除されません。 |
There was a problem hiding this comment.
Translation consistency: The same translation problem occurs here - "空のNULL値" (empty NULL value) should be "単独のNULL値" or "裸のNULL値" to correctly convey "bare null values", matching the correction needed in func3.sgml.
doc/src/sgml/func.sgml
Outdated
| 《機械翻訳》ケースに従って、入力された文字列の照合順序・フォールディングを実行します。 | ||
| ケース・フォールディングはケース・変換に似ていますが、ケース・フォールディングの目的は、文字列のケースを意識しないマッチングを容易にすることであり、ケース・変換の目的は、特定のケースのフォームに変換することです。 | ||
| この関数は、サーバエンコーディングが<literal>UTF8</literal>である場合にのみ使用できます。 | ||
| 照合順序に従い、入力文字列の大文字小文字の折りたたみを行います。 |
There was a problem hiding this comment.
「case folding 」は「折りたたみ」で良いのか？という問題がありますね。
phpでは「大文字変換」にしてるようです。
ご意見下さい＞皆様
There was a problem hiding this comment.
反応が遅くなりました。
・ref/psql-ref.sgmlでは「大文字小文字変換」でした。
・Web上ではあまりcase foldingを日本語で表現しているサイトがあまりなさそうです。
が、見つかった限りではfoldは「変換」としているものが多いようです。
ということで「大文字小文字変換」でどうでしょうか。
noborus
left a comment
noborus
left a comment
There was a problem hiding this comment.
一応最後まで見ました。
単純に間違いとは言えないところにコメントしてます。
| 《機械翻訳》また、この関数は引数名前<literal>version</literal>タイプ<type>integer</type>も通っており、統計処理の起点となったサーババージョンを示している。 | ||
| これは、古いバージョンの<productname>PostgreSQL</productname>から統計処理を移植する際に役立つと期待されています。 | ||
| さらに、この関数は、統計情報取得元のサーババージョンを指定する<type>integer</type>型の引数名<literal>version</literal>を受け入れます。 | ||
| これは、古いバージョンの<productname>PostgreSQL</productname>から統計情報を移植する際に役立つことが期待されています。 |
There was a problem hiding this comment.
そのまま訳すと移植ですが、日本語で読むと不自然に感じられるかも。
古いバージョンのPostgreSQLから引き継ぐ際に役立つことが期待されています。
か、この後で復元としているので復元する際とするか...復元にすると原文側にそれに該当するrestoreがないので、後で翻訳を見直すときに引っかかるかも...
There was a problem hiding this comment.
ありがとうございます。
「移植する」を提案いただいた「引き継ぐ」に変更しました。
|
レビューありがとうございます。また、確認が遅くなりすみません。 |
KenichiroTanaka
left a comment
KenichiroTanaka
left a comment
There was a problem hiding this comment.
一通り確認しました。
「折りたたみ」のところだけ、再考をお願いできないでしょうか。
「大文字変換」か「大文字小文字変換」か、それ以外に良いものがあれば検討できればと思います。
|
ありがとうございます。
ただし、原文ではcase foldingとcase conversionの違いについても述べています。case foldingを「大文字小文字変換」と訳すと、これら二つの言葉の区別がつかなくなってしまう気がしており、こちらの内容を考えると、そのまま翻訳するのは難しいと感じています。 https://www.postgresql.org/docs/current/functions-string.html#FUNCTIONS-STRING-OTHER そのため、こちらの文については多少言葉を加え、以下のようにすると二つの区別がつくと考えたのですが、いかがでしょうか。（原文にはない言葉を足しているため、少々抵抗感もあり、他の方の意見を聞きたいという思いです） もしこのような方針でよければ、case foldingについては「大文字小文字変換」と訳すようにしたいと思います。 |
|
「大文字小文字変換」に賛成です。 |
|
すみません、反応が遅くなりました。 |
|
お二人ともコメントありがとうございます。 |
KenichiroTanaka
left a comment
KenichiroTanaka
left a comment
There was a problem hiding this comment.
対応いただきありがとうございました。本件はこの辺りでマージします。
3 participants
No description provided.