ドキュメントのガイドライン

This page describes the rules to follow if you want to contribute to Godot Engine by writing or reviewing documentation, or by translating existing documentation. Also, have a look at README of the godot-docs GitHub repository and the docs front page on what steps to follow and how to contact the docs team.

貢献する方法

ドキュメントページの作成または変更は、主にgodot-docs GitHub リポジトリを介して行われます。HTML(またはPDFおよびEPUB)ドキュメントは、そのリポジトリの.rst ファイル (reStructuredTextマークアップ言語) から生成されます。プルリクエストでこれらのページを変更し、マージすると、オンラインドキュメントの再構築がトリガーされます。

参考

Gitの使用状況とプル要求ワークフローの詳細については、プルリクエスト・ワークフローページを参照してください。メインの godotengine/godot リポジトリに関する記述のほとんどは、ドキュメントリポジトリにも有効です。

README.mdファイルには、あなたが開始するために必要なすべての情報が含まれていますので、それを読んでください。特に、reStructuredTextマークアップ言語に関する参考資料へのヒントとコツとリンクが含まれています。

警告

APIリファレンスを編集する場合は、godot-docsリポジトリで行ってはならないことに注意してください。 代わりに、Godotのメインリポジトリの doc/classes/* XMLファイルを編集する必要があります。 これらのファイルは、後でエディタ内のドキュメントとオンラインドキュメントのAPIリファレンスを生成するために使用されます。 詳細はこちら:クラスリファレンスへの貢献

優れたドキュメントとは何ですか?

Documentation should be well written in plain English, using well-formed sentences and various levels of sections and subsections. It should be clear and objective. Also, have a look at the ドキュメント作成ガイドライン.

チュートリアルページを他のドキュメントページと区別します:

  • チュートリアル:学習目的で特定の目標を達成するためにエディタまたはスクリプトで1つ以上の概念を使用する方法を説明することを目的としたページ(例:「シンプルな2D卓球ゲームを作る」、「オブジェクトに力を適用する」など)。
  • ドキュメント:可能であれば、一度に1つだけの概念を正確に記述するページ (Spriteクラスのメソッドの一覧やGodotの入力管理の概要など)。

次のルール(およびレポのルール)を尊重する限り、希望する種類のドキュメントを自由に作成できます。

タイトル

常にタイトルと Sphinx参照名でページを開始します:

.. _doc_insert_your_title_here:

Insert your title here
======================

The reference allows linking to this page using the :ref: format, e.g. :ref:`doc_insert_your_title_here` would link to the above example page (note the lack of leading underscore in the reference).

また、アメリカのキャメルケースのタイトルは避けてください。タイトルの最初の単語は大文字で始める必要があり、その後に続く単語はすべて大文字で始めるべきではありません。たとえば、次のようになります:

  • Insert your title here (注:これは英文専用の留意項目です)

これは悪い例です:

  • Insert Your Title Here (注:これは英文専用の留意項目です)

プロジェクト名、ユーザー名、およびノードクラス名だけは先頭を大文字にしてください。

既存のページの翻訳

`Hosted Weblate <https://hosted.weblate.org/engage/godot-engine/>`_でGodotの公式ドキュメントを翻訳することができます。

Translation state

There also is the official Godot i18n repository where you can see when the data was last synchronized.

ライセンス

このコンテンツは、"Juan Linietsky"、 "Ariel Manzur " そして "Godot Engine community" によって、クリエイティブ・コモンズ-表示 3.0( CC-BY 3.0)ライセンスの下、管理されております。

GitHubリポジトリのドキュメントに投稿することで、変更がこのライセンスの下で配布されることに同意します。