Skip to content

Conversation

gomazarashi
Copy link
Contributor

@gomazarashi gomazarashi commented Sep 9, 2025

/docs/reference/html/elem/および/docs/reference/html/frame/の翻訳です。気になっている点は以下です。

  • "However, sometimes, it is desirable to retain more control."の訳を「ただし、場合によっては、より強いコントロールを手元に残しておくことが望ましい場合があります。」と訳していますが、もう少し良い訳があるかもしれません。

@gomazarashi gomazarashi marked this pull request as ready for review September 9, 2025 15:27
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR translates the HTML element documentation from English to Japanese for the /docs/reference/html/elem/ page. The translation covers the main documentation comments for the HTML element functionality in Typst, explaining how users can create custom HTML elements with more control over the output.

  • Updates translation status from "untranslated" to "translated" for the HTML elem reference page
  • Translates all documentation comments in the HTML element module from English to Japanese
  • Provides Japanese explanations for HTML element creation, validation rules, and usage examples

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
website/translation-status.json Updates translation status for HTML elem page to "translated"
crates/typst-library/src/html/mod.rs Translates all documentation comments from English to Japanese

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

/// example, when using Typst to generate your blog, you could use this function
/// to wrap each article in an `<article>` tag.
/// TypstのHTMLエクスポートは、ほとんどの要素に対して適切なタグを自動的に生成します。
/// ただし、場合によっては、より強いコントロールを手元に残しておくことが望ましい場合があります。
Copy link
Preview

Copilot AI Sep 9, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[nitpick] The translation feels somewhat awkward. Consider a more natural Japanese expression like 「ただし、場合によってはより詳細な制御が必要になることがあります。」 or 「しかし、時にはより細かい制御を行いたい場合があります。」

Suggested change
/// ただし、場合によっては、より強いコントロールを手元に残しておくことが望ましい場合があります
/// ただし、場合によってはより詳細な制御が必要になることがあります

Copilot uses AI. Check for mistakes.

Copy link
Member

@kimushun1101 kimushun1101 Sep 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

よりシンプルに以下のような訳はいかがでしょうか?

/// ただし、場合によっては、よりより細かく制御したい場合があります。

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpickですがsuggestionの「より」が重複しています。

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

場合によっては、より細かく制御したい場合があります。と「場合」という文字も被っており、次の文も例えば、Typstを使ってブログを生成する場合、と続くため、よりシンプルにしてみました。

Suggested change
/// ただし、場合によっては、より強いコントロールを手元に残しておくことが望ましい場合があります
/// ただし、より細かく制御したい場合もあります

/// タグとその属性は、構文的に有効なHTMLを構成していなければなりません。
/// `meta`のようないくつかのタグはコンテンツを受け付けません。
/// したがって、それらに対して本文を提供してはいけません。
/// 将来的に、この機能に対して更に多くのチェックを追加する可能性があるため、この関数を使用する際は有効なHTMLを生成していることを確認してください。
Copy link
Preview

Copilot AI Sep 9, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[nitpick] The phrase 「この機能に対して」 is redundant. Consider simplifying to 「将来的により多くのチェックを追加する可能性があるため」 for better readability.

Suggested change
/// 将来的に、この機能に対して更に多くのチェックを追加する可能性があるため、この関数を使用する際は有効なHTMLを生成していることを確認してください。
/// 将来的により多くのチェックを追加する可能性があるため、この関数を使用する際は有効なHTMLを生成していることを確認してください。

Copilot uses AI. Check for mistakes.

@gomazarashi gomazarashi changed the title /docs/reference/html/elem/の翻訳 /docs/reference/html/elem/および/docs/reference/html/frame/の翻訳 Sep 9, 2025
Copy link
Member

@kimushun1101 kimushun1101 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

翻訳ありがとうございます。対応が遅くなりすみません。
概ね問題ないと思います。細かいコメントだけ入れました。

Comment on lines +69 to +71
/// TypstのコンテンツをHTMLに変換することが望ましくない場合があります。
/// これは、
/// メッセージの伝達が位置決めやスタイル指定に依存するプロットおよびその他のコンテンツに当てはまります。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Sometimesの感じを出すために「望ましくない場合があります。」の代わりに「望ましくない場合もあります。」とするというのはどうでしょう?
  • plotscontent that relies on positioning and styling to convey its messageの一部かと思います。以下のような訳ではいかがでしょうか?
  • plots自体をどう訳すかも考えましたが、公式ドキュメントを「plot」で検索したところ、「drawings and plots」と表現されていることが多く、グラフプロットのことを指しているのかなと思いました。
Suggested change
/// TypstのコンテンツをHTMLに変換することが望ましくない場合があります。
/// これは、
/// メッセージの伝達が位置決めやスタイル指定に依存するプロットおよびその他のコンテンツに当てはまります。
/// TypstのコンテンツをHTMLに変換することが望ましくない場合もあります。
/// たとえば、グラフプロットなど、位置決めやスタイルに依存して意味を伝えるコンテンツがそれに当たります。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants