Skip to content

docs: 日本語版についてのセクションを追加#329

Open
3w36zj6 wants to merge 11 commits intomainfrom
feature/add-about-project-section
Open

docs: 日本語版についてのセクションを追加#329
3w36zj6 wants to merge 11 commits intomainfrom
feature/add-about-project-section

Conversation

@3w36zj6
Copy link
Member

@3w36zj6 3w36zj6 commented Oct 2, 2025

このPRでは、「Typstドキュメント日本語版」のプロジェクトそのものについてを紹介するセクションを追加します。プロジェクトそのものについての説明を一元管理することによってメンテナンスが簡単になり、Webサイトの利用者にも情報を伝えやすくなると考えます。

@3w36zj6 3w36zj6 requested a review from Copilot October 2, 2025 13:19
Copy link
Contributor

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 adds a new "About" section to the Japanese Typst documentation website to centralize information about the translation project itself. This reorganization improves maintainability and makes project information more accessible to users.

  • Adds a new "About" section with project overview and contribution guidelines
  • Reorganizes the main overview page to reference the new About section
  • Updates README to focus on project description rather than detailed contributor information

Reviewed Changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
docs/about/welcome.md New main About page with project overview and FAQ
docs/about/contributing.md Symlink to CONTRIBUTING.md for contribution guidelines
docs/about/translating_guidelines.md Symlink to TRANSLATING_GUIDELINES.md for translation guidelines
docs/src/lib.rs Adds about_pages function and integration
docs/src/link.rs Adds $about link resolver
docs/overview.md Simplified to reference new About section
website/translation-status.json Adds translation status for new About pages
docs/src/html.rs Adds LinkType::Shortcut support
CONTRIBUTING.md Adds frontmatter for markdown processing
TRANSLATING_GUIDELINES.md Adds frontmatter for markdown processing
README.md Streamlined project description and contributor section

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

@3w36zj6
Copy link
Member Author

3w36zj6 commented Oct 2, 2025

「貢献ガイドライン」と「翻訳ガイドライン」については、一旦シンボリックリンクで/docs/配下に配置しました。
これらはWebサイト上以外の方法で読まれることを想定しているため、サイト内リンクの省略記法を使用していませんが、Webサイト上でのみ読まれることを想定してファイルを移動することもできると思います。こちらご意見はありますでしょうか?

@kimushun1101
Copy link
Member

「貢献ガイドライン」と「翻訳ガイドライン」については、一旦シンボリックリンクで/docs/配下に配置しました。 これらはWebサイト上以外の方法で読まれることを想定しているため、サイト内リンクの省略記法を使用していませんが、Webサイト上でのみ読まれることを想定してファイルを移動することもできると思います。こちらご意見はありますでしょうか?

ひとまず、こちらの対応で問題ないと思います。
基本的にGitHubを使う人がGitHubやクローンしたソースコードを見ることで想定されているものだと思います。Webサイト上で見ることはあくまでオプションという立ち位置でよいと思います。オプションとはいえアクセスがしやすいのは大変助かります。

@3w36zj6 3w36zj6 marked this pull request as draft February 16, 2026 07:39
Comment on lines +31 to +43
### 機械翻訳や大規模言語モデル(LLM)の性能が上がっている中で、なぜ人力で翻訳するのですか?

機械翻訳やLLMは近年大きく進歩していますが、専門的な用語や文脈、ニュアンスの正確な伝達、文化的な配慮などの点で、まだ人間の翻訳者には及ばないと考えています。
特に技術文書では、誤訳や曖昧な表現がユーザーの混乱や誤解につながる可能性があります。
そのため、本プロジェクトでは品質を重視し、原文の意図や日本語としての自然さを担保するために人力で翻訳・校正を行っています。
機械翻訳も参考にしつつ、最終的な品質管理は人間が担っています。

日本語を第一言語とするユーザーは、機械翻訳を介さずに直接情報へアクセスできるようになり、Typstに触れる心理的なハードルが下がります。
その結果、日本語ユーザーの増加が期待され、日本語特有の組版機能や利用事例の改善に寄与する可能性があります。

また、この活動を通じて(当コミュニティ内ではありますが)専門用語や表現を統一し、日本語でTypstの情報を共有できる言葉の基盤を築いています。
これにより、質問・解説記事・教材などの整合性を保ちやすくなり、Typst日本語ユーザー全体の理解が深まります。
さらに、近年のLLMはウェブ上の情報を参照して回答を生成する傾向があるため、日本語ドキュメントを整備しておくこと自体が、将来的にLLMによる日本語回答の質向上にも寄与する可能性があります。
Copy link
Member Author

Choose a reason for hiding this comment

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

この文章は #329 (comment) の提案を反映したものですが、現在の主要なLLMの性能を考慮すると、少し実情とのズレが出てきているように感じました。

現在は、適切なコンテキストや用語集、校正ルールを与えれば、文脈やニュアンスの把握、専門用語の翻訳において、LLMが人間を凌駕する精度を出すレベルに達しています。そのため、「LLMはまだ人間に及ばないから人力でやる」というトーンのままだと、少し古く感じられてしまう気がしています。

この部分について、現在の実情(LLMを強力なツールとして前提としつつ、最終的な品質保証やコミュニティでのルール適用を人間が担う点など)に合わせて、改めて修正を加えたいと思うのですがいかがでしょうか?

Copy link
Member Author

Choose a reason for hiding this comment

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

こちらでいかがでしょうか?

Suggested change
### 機械翻訳や大規模言語モデル(LLM)の性能が上がっている中で、なぜ人力で翻訳するのですか?
機械翻訳やLLMは近年大きく進歩していますが、専門的な用語や文脈、ニュアンスの正確な伝達、文化的な配慮などの点で、まだ人間の翻訳者には及ばないと考えています。
特に技術文書では、誤訳や曖昧な表現がユーザーの混乱や誤解につながる可能性があります。
そのため、本プロジェクトでは品質を重視し、原文の意図や日本語としての自然さを担保するために人力で翻訳・校正を行っています。
機械翻訳も参考にしつつ、最終的な品質管理は人間が担っています。
日本語を第一言語とするユーザーは、機械翻訳を介さずに直接情報へアクセスできるようになり、Typstに触れる心理的なハードルが下がります。
その結果、日本語ユーザーの増加が期待され、日本語特有の組版機能や利用事例の改善に寄与する可能性があります。
また、この活動を通じて(当コミュニティ内ではありますが)専門用語や表現を統一し、日本語でTypstの情報を共有できる言葉の基盤を築いています。
これにより、質問・解説記事・教材などの整合性を保ちやすくなり、Typst日本語ユーザー全体の理解が深まります。
さらに、近年のLLMはウェブ上の情報を参照して回答を生成する傾向があるため、日本語ドキュメントを整備しておくこと自体が、将来的にLLMによる日本語回答の質向上にも寄与する可能性があります。
### 機械翻訳や大規模言語モデル(LLM)の性能が上がっている中で、なぜ人力で翻訳するのですか?
機械翻訳やLLMは近年大きく進歩しており、非常に自然な翻訳が可能になっています。しかし、Typstのような専門性の高い技術文書において、プロジェクト固有の用語の統一や、日本語特有の組版文化への深い理解に基づく微妙なニュアンスの調整には、人間の目による最終確認が不可欠だと考えています。
技術文書においては、わずかな誤訳や曖昧な表現がユーザーの大きな混乱につながる可能性があります。
そのため本プロジェクトでは、AIを強力なアシスタントとして最大限活用しつつも、最終的な品質管理と原文の意図の担保は、人間が責任を持って行っています。
このようにして品質を担保することで、日本語を第一言語とするユーザーが直接正確な情報へアクセスできるようになり、Typstに触れる心理的なハードルが下がります。
結果として日本語ユーザーの増加が期待され、日本語特有の組版機能や利用事例の改善への寄与につながると考えています。
また、この活動を通じて専門用語や表現を統一し、日本語でTypstの情報を共有できる「言葉の基盤」を築くことも重要な目的です。
質問や解説記事などの整合性を保ちやすくなるだけでなく、将来的にLLMがウェブ上の情報を参照して回答を生成する際、整備された質の高い日本語ドキュメントが存在すること自体が、LLMによるTypst関連の回答の質向上にも大きく貢献します。

Copy link
Contributor

Choose a reason for hiding this comment

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

私もそのずれは感じていたので改訂版の方が良いと思います。

Copy link
Contributor

Choose a reason for hiding this comment

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

お疲れ様です。修正後のほうがより良いように思います。

@3w36zj6 3w36zj6 marked this pull request as ready for review March 15, 2026 04:59
Copy link
Contributor

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

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


> [!NOTE]
> 当プロジェクトの[README](./README.md)や「[はじめに:Typst Japanese Communityより](https://typst-jp.github.io/docs/)」、[Typst公式](https://typst.app/)の[ライセンス](https://github.com/typst/typst/blob/main/LICENSE)や[コントリビューション・ガイド](https://github.com/typst/typst/blob/main/CONTRIBUTING.md)も併せてご参照ください。
**Note:** 当プロジェクトの[README](https://github.com/typst-jp/docs/blob/main/README.md)や「[はじめに:Typst Japanese Communityより](https://typst-jp.github.io/docs/)」、[Typst公式](https://typst.app/)の[ライセンス](https://github.com/typst/typst/blob/main/LICENSE)や[コントリビューション・ガイド](https://github.com/typst/typst/blob/main/CONTRIBUTING.md)もあわせてご参照ください。
@@ -1,39 +1,44 @@
# Typst 日本語ドキュメント (非公式)
<div align="center">
<img src="https://avatars.githubusercontent.com/u/172375917" width="128" height="128">
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.

5 participants